diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 4060d0c..b0e75bc 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -21,6 +21,11 @@ jobs: run: | pip install -r requirements.txt pip install pyinstaller + - name: Debug Python lib + run: | + echo "Python version: $(python --version)" + find /opt/hostedtoolcache -name "libpython*.so" 2>/dev/null || echo "Not found in toolcache" + ls -la /lib/x86_64-linux-gnu/libpython* 2>/dev/null || echo "Not found in /lib" - name: Build binary run: pyinstaller gotify-tray.spec - name: Install fpm diff --git a/gotify-tray.spec b/gotify-tray.spec index 311a21e..99e387c 100644 --- a/gotify-tray.spec +++ b/gotify-tray.spec @@ -10,7 +10,7 @@ logo = "gotify_tray/gui/images/logo.ico" if platform.system() != "Darwin" else " a = Analysis(['gotify_tray/__main__.py'], pathex=[os.getcwd()], - binaries=[(f'/lib/x86_64-linux-gnu/libpython3.{py_version}.so', '.'), (f'/lib/x86_64-linux-gnu/libpython3.{py_version}.so.1', '.')], + binaries=[], datas=[('gotify_tray/gui/images', 'gotify_tray/gui/images'), ('gotify_tray/gui/themes', 'gotify_tray/gui/themes')], hiddenimports=[], hookspath=[], diff --git a/venv/bin/pyi-archive_viewer b/venv/bin/pyi-archive_viewer new file mode 100755 index 0000000..52eb825 --- /dev/null +++ b/venv/bin/pyi-archive_viewer @@ -0,0 +1,8 @@ +#!/home/kadu/scripts/gotify-tray/venv/bin/python3 +# -*- coding: utf-8 -*- +import re +import sys +from PyInstaller.utils.cliutils.archive_viewer import run +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(run()) diff --git a/venv/bin/pyi-bindepend b/venv/bin/pyi-bindepend new file mode 100755 index 0000000..5c859c2 --- /dev/null +++ b/venv/bin/pyi-bindepend @@ -0,0 +1,8 @@ +#!/home/kadu/scripts/gotify-tray/venv/bin/python3 +# -*- coding: utf-8 -*- +import re +import sys +from PyInstaller.utils.cliutils.bindepend import run +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(run()) diff --git a/venv/bin/pyi-grab_version b/venv/bin/pyi-grab_version new file mode 100755 index 0000000..479a06b --- /dev/null +++ b/venv/bin/pyi-grab_version @@ -0,0 +1,8 @@ +#!/home/kadu/scripts/gotify-tray/venv/bin/python3 +# -*- coding: utf-8 -*- +import re +import sys +from PyInstaller.utils.cliutils.grab_version import run +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(run()) diff --git a/venv/bin/pyi-makespec b/venv/bin/pyi-makespec new file mode 100755 index 0000000..1433df4 --- /dev/null +++ b/venv/bin/pyi-makespec @@ -0,0 +1,8 @@ +#!/home/kadu/scripts/gotify-tray/venv/bin/python3 +# -*- coding: utf-8 -*- +import re +import sys +from PyInstaller.utils.cliutils.makespec import run +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(run()) diff --git a/venv/bin/pyi-set_version b/venv/bin/pyi-set_version new file mode 100755 index 0000000..8fa6a08 --- /dev/null +++ b/venv/bin/pyi-set_version @@ -0,0 +1,8 @@ +#!/home/kadu/scripts/gotify-tray/venv/bin/python3 +# -*- coding: utf-8 -*- +import re +import sys +from PyInstaller.utils.cliutils.set_version import run +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(run()) diff --git a/venv/bin/pyinstaller b/venv/bin/pyinstaller new file mode 100755 index 0000000..7ac2469 --- /dev/null +++ b/venv/bin/pyinstaller @@ -0,0 +1,8 @@ +#!/home/kadu/scripts/gotify-tray/venv/bin/python3 +# -*- coding: utf-8 -*- +import re +import sys +from PyInstaller.__main__ import _console_script_run +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(_console_script_run()) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/__init__.py new file mode 100755 index 0000000..41ff6c7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/__init__.py @@ -0,0 +1,44 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +__all__ = ('HOMEPATH', 'PLATFORM', '__version__', 'DEFAULT_DISTPATH', 'DEFAULT_SPECPATH', 'DEFAULT_WORKPATH') + +import os + +from PyInstaller import compat + +# Note: Keep this variable as plain string so it could be updated automatically when doing a release. +__version__ = '6.17.0' + +# Absolute path of this package's directory. Save this early so all submodules can use the absolute path. This is +# required for example if the current directory changes prior to loading the hooks. +PACKAGEPATH = os.path.abspath(os.path.dirname(__file__)) + +HOMEPATH = os.path.dirname(PACKAGEPATH) + +# Default values of paths where to put files created by PyInstaller. If changing these, do not forget to update the +# help text for corresponding command-line options, defined in build_main. + +# Where to put created .spec file. +DEFAULT_SPECPATH = os.getcwd() +# Where to put the final frozen application. +DEFAULT_DISTPATH = os.path.join(os.getcwd(), 'dist') +# Where to put all the temporary files; .log, .pyz, etc. +DEFAULT_WORKPATH = os.path.join(os.getcwd(), 'build') + +PLATFORM = compat.system + '-' + compat.architecture +# Include machine name in path to bootloader for some machines (e.g., 'arm'). Explicitly avoid doing this on macOS, +# where we keep universal2 bootloaders in Darwin-64bit folder regardless of whether we are on x86_64 or arm64. +if compat.machine and not compat.is_darwin: + PLATFORM += '-' + compat.machine +# Similarly, disambiguate musl Linux from glibc Linux. +if compat.is_musl: + PLATFORM += '-musl' diff --git a/venv/lib/python3.12/site-packages/PyInstaller/__main__.py b/venv/lib/python3.12/site-packages/PyInstaller/__main__.py new file mode 100755 index 0000000..f36090b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/__main__.py @@ -0,0 +1,321 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Main command-line interface to PyInstaller. +""" +from __future__ import annotations + +import argparse +import os +import platform +import sys +import pathlib +from collections import defaultdict + +from PyInstaller import __version__ +from PyInstaller import log as logging +# Note: do not import anything else until compat.check_requirements function is run! +from PyInstaller import compat + +try: + from argcomplete import autocomplete +except ImportError: + + def autocomplete(parser): + return None + + +logger = logging.getLogger(__name__) + +# Taken from https://stackoverflow.com/a/22157136 to format args more flexibly: any help text which beings with ``R|`` +# will have all newlines preserved; the help text will be line wrapped. See +# https://docs.python.org/3/library/argparse.html#formatter-class. + + +# This is used by the ``--debug`` option. +class _SmartFormatter(argparse.HelpFormatter): + def _split_lines(self, text, width): + if text.startswith('R|'): + # The underlying implementation of ``RawTextHelpFormatter._split_lines`` invokes this; mimic it. + return text[2:].splitlines() + else: + # Invoke the usual formatter. + return super()._split_lines(text, width) + + +def run_makespec(filenames, **opts): + # Split pathex by using the path separator + temppaths = opts['pathex'][:] + pathex = opts['pathex'] = [] + for p in temppaths: + pathex.extend(p.split(os.pathsep)) + + import PyInstaller.building.makespec + + spec_file = PyInstaller.building.makespec.main(filenames, **opts) + logger.info('wrote %s' % spec_file) + return spec_file + + +def run_build(pyi_config, spec_file, **kwargs): + import PyInstaller.building.build_main + PyInstaller.building.build_main.main(pyi_config, spec_file, **kwargs) + + +def __add_options(parser): + parser.add_argument( + '-v', + '--version', + action='version', + version=__version__, + help='Show program version info and exit.', + ) + + +class _PyiArgumentParser(argparse.ArgumentParser): + def __init__(self, *args, **kwargs): + self._pyi_action_groups = defaultdict(list) + super().__init__(*args, **kwargs) + + def _add_options(self, __add_options: callable, name: str = ""): + """ + Mutate self with the given callable, storing any new actions added in a named group + """ + n_actions_before = len(getattr(self, "_actions", [])) + __add_options(self) # preserves old behavior + new_actions = getattr(self, "_actions", [])[n_actions_before:] + self._pyi_action_groups[name].extend(new_actions) + + def _option_name(self, action): + """ + Get the option name(s) associated with an action + + For options that define both short and long names, this function will + return the long names joined by "/" + """ + longnames = [name for name in action.option_strings if name.startswith("--")] + if longnames: + name = "/".join(longnames) + else: + name = action.option_strings[0] + return name + + def _forbid_options(self, args: argparse.Namespace, group: str, errmsg: str = ""): + """Forbid options from a named action group""" + options = defaultdict(str) + for action in self._pyi_action_groups[group]: + dest = action.dest + name = self._option_name(action) + if getattr(args, dest) is not self.get_default(dest): + if dest in options: + options[dest] += "/" + options[dest] += name + + # if any options from the forbidden group are not the default values, + # the user must have passed them in, so issue an error report + if options: + sep = "\n " + bad = sep.join(options.values()) + if errmsg: + errmsg = "\n" + errmsg + raise SystemExit(f"ERROR: option(s) not allowed:{sep}{bad}{errmsg}") + + +def generate_parser() -> _PyiArgumentParser: + """ + Build an argparse parser for PyInstaller's main CLI. + """ + + import PyInstaller.building.build_main + import PyInstaller.building.makespec + import PyInstaller.log + + parser = _PyiArgumentParser(formatter_class=_SmartFormatter) + parser.prog = "pyinstaller" + + parser._add_options(__add_options) + parser._add_options(PyInstaller.building.makespec.__add_options, name="makespec") + parser._add_options(PyInstaller.building.build_main.__add_options, name="build_main") + parser._add_options(PyInstaller.log.__add_options, name="log") + + parser.add_argument( + 'filenames', + metavar='scriptname', + nargs='+', + help="Name of scriptfiles to be processed or exactly one .spec file. If a .spec file is specified, most " + "options are unnecessary and are ignored.", + ) + + return parser + + +def run(pyi_args: list | None = None, pyi_config: dict | None = None): + """ + pyi_args allows running PyInstaller programmatically without a subprocess + pyi_config allows checking configuration once when running multiple tests + """ + compat.check_requirements() + check_unsafe_privileges() + + import PyInstaller.log + + old_sys_argv = sys.argv + try: + parser = generate_parser() + autocomplete(parser) + if pyi_args is None: + pyi_args = sys.argv[1:] + try: + index = pyi_args.index("--") + except ValueError: + index = len(pyi_args) + args = parser.parse_args(pyi_args[:index]) + spec_args = pyi_args[index + 1:] + PyInstaller.log.__process_options(parser, args) + + # Print PyInstaller version, Python version, and platform as the first line to stdout. This helps us identify + # PyInstaller, Python, and platform version when users report issues. + try: + from _pyinstaller_hooks_contrib import __version__ as contrib_hooks_version + except Exception: + contrib_hooks_version = 'unknown' + + logger.info('PyInstaller: %s, contrib hooks: %s', __version__, contrib_hooks_version) + logger.info('Python: %s%s', platform.python_version(), " (conda)" if compat.is_conda else "") + logger.info('Platform: %s', platform.platform()) + logger.info('Python environment: %s', sys.prefix) + + # Skip creating .spec when .spec file is supplied. + if args.filenames[0].endswith('.spec'): + parser._forbid_options( + args, group="makespec", errmsg="makespec options not valid when a .spec file is given" + ) + spec_file = args.filenames[0] + else: + # Ensure that the given script files exist, before trying to generate the .spec file. + # This prevents us from overwriting an existing (and customized) .spec file if user makes a typo in the + # .spec file's suffix when trying to build it, for example, `pyinstaller program.cpes` (see #8276). + # It also prevents creation of a .spec file when `pyinstaller program.py` is accidentally ran from a + # directory that does not contain the script (for example, due to failing to change the directory prior + # to running the command). + for filename in args.filenames: + if not os.path.isfile(filename): + raise SystemExit(f"ERROR: Script file {filename!r} does not exist.") + spec_file = run_makespec(**vars(args)) + + sys.argv = [spec_file, *spec_args] + run_build(pyi_config, spec_file, **vars(args)) + + except KeyboardInterrupt: + raise SystemExit("Aborted by user request.") + except RecursionError: + from PyInstaller import _recursion_too_deep_message + _recursion_too_deep_message.raise_with_msg() + finally: + sys.argv = old_sys_argv + + +def _console_script_run(): + # Python prepends the main script's parent directory to sys.path. When PyInstaller is ran via the usual + # `pyinstaller` CLI entry point, this directory is $pythonprefix/bin which should not be in sys.path. + if os.path.basename(sys.path[0]) in ("bin", "Scripts"): + sys.path.pop(0) + run() + + +def check_unsafe_privileges(): + """ + Forbid dangerous usage of PyInstaller with escalated privileges + """ + if compat.is_win and not compat.is_win_wine: + # Discourage (with the intention to eventually block) people using *run as admin* with PyInstaller. + # There are 4 cases, block case 3 but be careful not to also block case 2. + # 1. User has no admin access: TokenElevationTypeDefault + # 2. User is an admin/UAC disabled (common on CI/VMs): TokenElevationTypeDefault + # 3. User has used *run as administrator* to elevate: TokenElevationTypeFull + # 4. User can escalate but hasn't: TokenElevationTypeLimited + # https://techcommunity.microsoft.com/t5/windows-blog-archive/how-to-determine-if-a-user-is-a-member-of-the-administrators/ba-p/228476 + import ctypes + + advapi32 = ctypes.CDLL("Advapi32.dll") + kernel32 = ctypes.CDLL("kernel32.dll") + + kernel32.GetCurrentProcess.restype = ctypes.c_void_p + process = kernel32.GetCurrentProcess() + + token = ctypes.c_void_p() + try: + TOKEN_QUERY = 8 + assert advapi32.OpenProcessToken(ctypes.c_void_p(process), TOKEN_QUERY, ctypes.byref(token)) + + elevation_type = ctypes.c_int() + TokenElevationType = 18 + assert advapi32.GetTokenInformation( + token, TokenElevationType, ctypes.byref(elevation_type), ctypes.sizeof(elevation_type), + ctypes.byref(ctypes.c_int()) + ) + finally: + kernel32.CloseHandle(token) + + if elevation_type.value == 2: # TokenElevationTypeFull + logger.log( + logging.DEPRECATION, + "Running PyInstaller as admin is not necessary nor sensible. Run PyInstaller from a non-administrator " + "terminal. PyInstaller 7.0 will block this." + ) + + elif compat.is_darwin or compat.is_linux: + # Discourage (with the intention to eventually block) people using *sudo* with PyInstaller. + # Again there are 4 cases, block only case 4. + # 1. Non-root: os.getuid() != 0 + # 2. Logged in as root (usually a VM): os.getlogin() == "root", os.getuid() == 0 + # 3. No named users (e.g. most Docker containers): os.getlogin() fails + # 4. Regular user using escalation: os.getlogin() != "root", os.getuid() == 0 + try: + user = os.getlogin() + except OSError: + user = "" + if os.getuid() == 0 and user and user != "root": + logger.log( + logging.DEPRECATION, + "Running PyInstaller as root is not necessary nor sensible. Do not use PyInstaller with sudo. " + "PyInstaller 7.0 will block this." + ) + + if compat.is_win: + # Do not let people run PyInstaller from admin cmd's default working directory (C:\Windows\system32) + cwd = pathlib.Path.cwd() + + try: + win_dir = compat.win32api.GetWindowsDirectory() + except Exception: + win_dir = None + win_dir = None if win_dir is None else pathlib.Path(win_dir).resolve() + + inside_win_dir = cwd == win_dir or win_dir in cwd.parents + + # The only exception to the above is if user's home directory is also located under %WINDIR%, which happens + # when PyInstaller is ran under SYSTEM user. + if inside_win_dir: + home_dir = pathlib.Path.home().resolve() + if cwd == home_dir or home_dir in cwd.parents: + inside_win_dir = False + + if inside_win_dir: + raise SystemExit( + f"ERROR: Do not run pyinstaller from {cwd}. cd to where your code is and run pyinstaller from there. " + "Hint: You can open a terminal where your code is by going to the parent folder in Windows file " + "explorer and typing cmd into the address bar." + ) + + +if __name__ == '__main__': + run() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/_recursion_too_deep_message.py b/venv/lib/python3.12/site-packages/PyInstaller/_recursion_too_deep_message.py new file mode 100755 index 0000000..e62c20d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/_recursion_too_deep_message.py @@ -0,0 +1,45 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +msg = """ +============================================================= +A RecursionError (maximum recursion depth exceeded) occurred. +For working around please follow these instructions +============================================================= + +1. In your program's .spec file add this line near the top:: + + import sys ; sys.setrecursionlimit(sys.getrecursionlimit() * 5) + +2. Build your program by running PyInstaller with the .spec file as + argument:: + + pyinstaller myprog.spec + +3. If this fails, you most probably hit an endless recursion in + PyInstaller. Please try to track this down as far as possible, + create a minimal example so we can reproduce and open an issue at + https://github.com/pyinstaller/pyinstaller/issues following the + instructions in the issue template. Many thanks. + +Explanation: Python's stack-limit is a safety-belt against endless recursion, +eating up memory. PyInstaller imports modules recursively. If the structure +how modules are imported within your program is awkward, this leads to the +nesting being too deep and hitting Python's stack-limit. + +With the default recursion limit (1000), the recursion error occurs at about +115 nested imported, with limit 2000 at about 240, with limit 5000 at about +660. +""" + + +def raise_with_msg(): + raise SystemExit(msg) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/_shared_with_waf.py b/venv/lib/python3.12/site-packages/PyInstaller/_shared_with_waf.py new file mode 100755 index 0000000..ed2615c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/_shared_with_waf.py @@ -0,0 +1,92 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Code to be shared by PyInstaller and the bootloader/wscript file. + +This code must not assume that either PyInstaller or any of its dependencies installed. I.e., the only imports allowed +in here are standard library ones. Within reason, it is preferable that this file should still run under Python 2.7 as +many compiler docker images still have only Python 2 installed. +""" + +import platform +import re + + +def _pyi_machine(machine, system): + # type: (str, str) -> str + """ + Choose an intentionally simplified architecture identifier to be used in the bootloader's directory name. + + Args: + machine: + The output of ``platform.machine()`` or any known architecture alias or shorthand that may be used by a + C compiler. + system: + The output of ``platform.system()`` on the target machine. + Returns: + Either a string tag or, on platforms that don't need an architecture tag, ``None``. + + Ideally, we would just use ``platform.machine()`` directly, but that makes cross-compiling the bootloader almost + impossible, because you need to know at compile time exactly what ``platform.machine()`` will be at run time, based + only on the machine name alias or shorthand reported by the C compiler at the build time. Rather, use a loose + differentiation, and trust that anyone mixing armv6l with armv6h knows what they are doing. + """ + # See the corresponding tests in tests/unit/test_compat.py for examples. + + if platform.machine() == "sw_64" or platform.machine() == "loongarch64": + # This explicitly inhibits cross compiling the bootloader for or on SunWay and LoongArch machine. + return platform.machine() + + if system == "Windows": + if machine.lower().startswith("arm"): + return "arm" + else: + return "intel" + + if system == "SunOS": + if machine.lower() in ("x86_64", "x86", "i86pc"): + return "intel" + else: + return "sparc" + + if system != "Linux": + # No architecture specifier for anything par Linux. + # - macOS is on two 64 bit architectures, but they are merged into one "universal2" bootloader. + # - BSD supports a wide range of architectures, but according to PyPI's download statistics, every one of our + # BSD users are on x86_64. This may change in the distant future. + return + + if machine.startswith(("arm", "aarch")): + # ARM has a huge number of similar and aliased sub-versions, such as armv5, armv6l armv8h, aarch64. + return "arm" + if machine in ("thumb"): + # Reported by waf/gcc when Thumb instruction set is enabled on 32-bit ARM. The platform.machine() returns "arm" + # regardless of the instruction set. + return "arm" + if machine in ("x86_64", "x64", "x86"): + return "intel" + if re.fullmatch("i[1-6]86", machine): + return "intel" + if machine.startswith(("ppc", "powerpc")): + # PowerPC comes in 64 vs 32 bit and little vs big endian variants. + return "ppc" + if machine in ("mips64", "mips"): + return "mips" + if machine.startswith("riscv"): + return "riscv" + # Machines with no known aliases :) + if machine in ("s390x",): + return machine + + # Unknown architectures are allowed by default, but will all be placed under one directory. In theory, trying to + # have multiple unknown architectures in one copy of PyInstaller will not work, but that should be sufficiently + # unlikely to ever happen. + return "unknown" diff --git a/venv/lib/python3.12/site-packages/PyInstaller/archive/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/archive/__init__.py new file mode 100755 index 0000000..a7501ae --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/archive/__init__.py @@ -0,0 +1 @@ +__author__ = 'martin' diff --git a/venv/lib/python3.12/site-packages/PyInstaller/archive/pyz_crypto.py b/venv/lib/python3.12/site-packages/PyInstaller/archive/pyz_crypto.py new file mode 100755 index 0000000..a16905f --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/archive/pyz_crypto.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +class PyiBlockCipher: + def __init__(self, key=None): + from PyInstaller.exceptions import RemovedCipherFeatureError + raise RemovedCipherFeatureError("Please remove cipher and block_cipher parameters from your spec file.") diff --git a/venv/lib/python3.12/site-packages/PyInstaller/archive/readers.py b/venv/lib/python3.12/site-packages/PyInstaller/archive/readers.py new file mode 100755 index 0000000..3ddc160 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/archive/readers.py @@ -0,0 +1,238 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Python-based CArchive (PKG) reader implementation. Used only in the archive_viewer utility. +""" + +import os +import struct + +from PyInstaller.loader.pyimod01_archive import ZlibArchiveReader, ArchiveReadError + + +class NotAnArchiveError(TypeError): + pass + + +# Type codes for CArchive TOC entries +PKG_ITEM_BINARY = 'b' # binary +PKG_ITEM_DEPENDENCY = 'd' # runtime option +PKG_ITEM_PYZ = 'z' # zlib (pyz) - frozen Python code +PKG_ITEM_ZIPFILE = 'Z' # zlib (pyz) - frozen Python code +PKG_ITEM_PYPACKAGE = 'M' # Python package (__init__.py) +PKG_ITEM_PYMODULE = 'm' # Python module +PKG_ITEM_PYSOURCE = 's' # Python script (v3) +PKG_ITEM_DATA = 'x' # data +PKG_ITEM_RUNTIME_OPTION = 'o' # runtime option +PKG_ITEM_SPLASH = 'l' # splash resources + + +class CArchiveReader: + """ + Reader for PyInstaller's CArchive (PKG) archive. + """ + + # Cookie - holds some information for the bootloader. C struct format definition. '!' at the beginning means network + # byte order. C struct looks like: + # + # typedef struct _archive_cookie + # { + # char magic[8]; + # uint32_t pkg_length; + # uint32_t toc_offset; + # uint32_t toc_length; + # uint32_t python_version; + # char python_libname[64]; + # } ARCHIVE_COOKIE; + # + _COOKIE_MAGIC_PATTERN = b'MEI\014\013\012\013\016' + + _COOKIE_FORMAT = '!8sIIII64s' + _COOKIE_LENGTH = struct.calcsize(_COOKIE_FORMAT) + + # TOC entry: + # + # typedef struct _toc_entry + # { + # uint32_t entry_length; + # uint32_t offset; + # uint32_t length; + # uint32_t uncompressed_length; + # unsigned char compression_flag; + # char typecode; + # char name[1]; /* Variable-length name, padded to multiple of 16 */ + # } TOC_ENTRY; + # + _TOC_ENTRY_FORMAT = '!IIIIBc' + _TOC_ENTRY_LENGTH = struct.calcsize(_TOC_ENTRY_FORMAT) + + def __init__(self, filename): + self._filename = filename + self._start_offset = 0 + self._end_offset = 0 + self._toc_offset = 0 + self._toc_length = 0 + + self.toc = {} + self.options = [] + + # Load TOC + with open(self._filename, "rb") as fp: + # Find cookie MAGIC pattern + cookie_start_offset = self._find_magic_pattern(fp, self._COOKIE_MAGIC_PATTERN) + if cookie_start_offset == -1: + raise ArchiveReadError("Could not find COOKIE magic pattern!") + + # Read the whole cookie + fp.seek(cookie_start_offset, os.SEEK_SET) + cookie_data = fp.read(self._COOKIE_LENGTH) + + magic, archive_length, toc_offset, toc_length, pyvers, pylib_name = \ + struct.unpack(self._COOKIE_FORMAT, cookie_data) + + # Compute start and end offset of the the archive + self._end_offset = cookie_start_offset + self._COOKIE_LENGTH + self._start_offset = self._end_offset - archive_length + + # Verify that Python shared library name is set + if not pylib_name: + raise ArchiveReadError("Python shared library name not set in the archive!") + + # Read whole toc + fp.seek(self._start_offset + toc_offset) + toc_data = fp.read(toc_length) + + self.toc, self.options = self._parse_toc(toc_data) + + @staticmethod + def _find_magic_pattern(fp, magic_pattern): + # Start at the end of file, and scan back-to-start + fp.seek(0, os.SEEK_END) + end_pos = fp.tell() + + # Scan from back + SEARCH_CHUNK_SIZE = 8192 + magic_offset = -1 + while end_pos >= len(magic_pattern): + start_pos = max(end_pos - SEARCH_CHUNK_SIZE, 0) + chunk_size = end_pos - start_pos + # Is the remaining chunk large enough to hold the pattern? + if chunk_size < len(magic_pattern): + break + # Read and scan the chunk + fp.seek(start_pos, os.SEEK_SET) + buf = fp.read(chunk_size) + pos = buf.rfind(magic_pattern) + if pos != -1: + magic_offset = start_pos + pos + break + # Adjust search location for next chunk; ensure proper overlap + end_pos = start_pos + len(magic_pattern) - 1 + + return magic_offset + + @classmethod + def _parse_toc(cls, data): + options = [] + toc = {} + cur_pos = 0 + while cur_pos < len(data): + # Read and parse the fixed-size TOC entry header + entry_length, entry_offset, data_length, uncompressed_length, compression_flag, typecode = \ + struct.unpack(cls._TOC_ENTRY_FORMAT, data[cur_pos:(cur_pos + cls._TOC_ENTRY_LENGTH)]) + cur_pos += cls._TOC_ENTRY_LENGTH + # Read variable-length name + name_length = entry_length - cls._TOC_ENTRY_LENGTH + name, *_ = struct.unpack(f'{name_length}s', data[cur_pos:(cur_pos + name_length)]) + cur_pos += name_length + # Name string may contain up to 15 bytes of padding + name = name.rstrip(b'\0').decode('utf-8') + + typecode = typecode.decode('ascii') + + # The TOC should not contain duplicates, except for OPTION entries. Therefore, keep those + # in a separate list. With options, the rest of the entries do not make sense, anyway. + if typecode == 'o': + options.append(name) + else: + toc[name] = (entry_offset, data_length, uncompressed_length, compression_flag, typecode) + + return toc, options + + def extract(self, name): + """ + Extract data for the given entry name. + """ + + entry = self.toc.get(name) + if entry is None: + raise KeyError(f"No entry named {name!r} found in the archive!") + + entry_offset, data_length, uncompressed_length, compression_flag, typecode = entry + with open(self._filename, "rb") as fp: + fp.seek(self._start_offset + entry_offset, os.SEEK_SET) + data = fp.read(data_length) + + if compression_flag: + import zlib + data = zlib.decompress(data) + + return data + + def raw_pkg_data(self): + """ + Extract complete PKG/CArchive archive from the parent file (executable). + """ + total_length = self._end_offset - self._start_offset + with open(self._filename, "rb") as fp: + fp.seek(self._start_offset, os.SEEK_SET) + return fp.read(total_length) + + def open_embedded_archive(self, name): + """ + Open new archive reader for the embedded archive. + """ + + entry = self.toc.get(name) + if entry is None: + raise KeyError(f"No entry named {name!r} found in the archive!") + + entry_offset, data_length, uncompressed_length, compression_flag, typecode = entry + + if typecode == PKG_ITEM_PYZ: + # Open as embedded archive, without extraction. + return ZlibArchiveReader(self._filename, self._start_offset + entry_offset) + elif typecode == PKG_ITEM_ZIPFILE: + raise NotAnArchiveError("Zipfile archives not supported yet!") + else: + raise NotAnArchiveError(f"Entry {name!r} is not a supported embedded archive!") + + +def pkg_archive_contents(filename, recursive=True): + """ + List the contents of the PKG / CArchive. If `recursive` flag is set (the default), the contents of the embedded PYZ + archive is included as well. + + Used by the tests. + """ + + contents = [] + + pkg_archive = CArchiveReader(filename) + for name, toc_entry in pkg_archive.toc.items(): + *_, typecode = toc_entry + contents.append(name) + if typecode == PKG_ITEM_PYZ and recursive: + pyz_archive = pkg_archive.open_embedded_archive(name) + for name in pyz_archive.toc.keys(): + contents.append(name) + + return contents diff --git a/venv/lib/python3.12/site-packages/PyInstaller/archive/writers.py b/venv/lib/python3.12/site-packages/PyInstaller/archive/writers.py new file mode 100755 index 0000000..041410f --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/archive/writers.py @@ -0,0 +1,445 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Utilities to create data structures for embedding Python modules and additional files into the executable. +""" + +import marshal +import os +import shutil +import struct +import sys +import zlib + +from PyInstaller.building.utils import get_code_object, replace_filename_in_code_object +from PyInstaller.compat import BYTECODE_MAGIC, is_win, strict_collect_mode +from PyInstaller.loader.pyimod01_archive import PYZ_ITEM_MODULE, PYZ_ITEM_NSPKG, PYZ_ITEM_PKG + + +class ZlibArchiveWriter: + """ + Writer for PyInstaller's PYZ (ZlibArchive) archive. The archive is used to store collected byte-compiled Python + modules, as individually-compressed entries. + """ + _PYZ_MAGIC_PATTERN = b'PYZ\0' + _HEADER_LENGTH = 12 + 5 + _COMPRESSION_LEVEL = 6 # zlib compression level + + def __init__(self, filename, entries, code_dict=None): + """ + filename + Target filename of the archive. + entries + An iterable containing entries in the form of tuples: (name, src_path, typecode), where `name` is the name + under which the resource is stored (e.g., python module name, without suffix), `src_path` is name of the + file from which the resource is read, and `typecode` is the Analysis-level TOC typecode (`PYMODULE`). + code_dict + Optional code dictionary containing code objects for analyzed/collected python modules. + """ + code_dict = code_dict or {} + + with open(filename, "wb") as fp: + # Reserve space for the header. + fp.write(b'\0' * self._HEADER_LENGTH) + + # Write entries' data and collect TOC entries + toc = [] + for entry in entries: + toc_entry = self._write_entry(fp, entry, code_dict) + toc.append(toc_entry) + + # Write TOC + toc_offset = fp.tell() + toc_data = marshal.dumps(toc) + fp.write(toc_data) + + # Write header: + # - PYZ magic pattern (4 bytes) + # - python bytecode magic pattern (4 bytes) + # - TOC offset (32-bit int, 4 bytes) + # - 4 unused bytes + fp.seek(0, os.SEEK_SET) + + fp.write(self._PYZ_MAGIC_PATTERN) + fp.write(BYTECODE_MAGIC) + fp.write(struct.pack('!i', toc_offset)) + + @classmethod + def _write_entry(cls, fp, entry, code_dict): + name, src_path, typecode = entry + assert typecode in {'PYMODULE', 'PYMODULE-1', 'PYMODULE-2'} + + if src_path in {'-', None}: + # PEP-420 namespace package; these do not have code objects, but we still need an entry in PYZ to inform our + # run-time module finder/loader of the package's existence. So create a TOC entry for 0-byte data blob, + # and write no data. + return (name, (PYZ_ITEM_NSPKG, fp.tell(), 0)) + + code_object = code_dict[name] + + src_basename, _ = os.path.splitext(os.path.basename(src_path)) + if src_basename == '__init__': + typecode = PYZ_ITEM_PKG + co_filename = os.path.join(*name.split('.'), '__init__.py') + else: + typecode = PYZ_ITEM_MODULE + co_filename = os.path.join(*name.split('.')) + '.py' + + # Replace co_filename on code object with anonymized version without absolute path to the module. + code_object = replace_filename_in_code_object(code_object, co_filename) + + # Serialize + data = marshal.dumps(code_object) + + # First compress, then encrypt. + obj = zlib.compress(data, cls._COMPRESSION_LEVEL) + + # Create TOC entry + toc_entry = (name, (typecode, fp.tell(), len(obj))) + + # Write data blob + fp.write(obj) + + return toc_entry + + +class CArchiveWriter: + """ + Writer for PyInstaller's CArchive (PKG) archive. + + This archive contains all files that are bundled within an executable; a PYZ (ZlibArchive), DLLs, Python C + extensions, and other data files that are bundled in onefile mode. + + The archive can be read from either C (bootloader code at application's run-time) or Python (for debug purposes). + """ + _COOKIE_MAGIC_PATTERN = b'MEI\014\013\012\013\016' + + # For cookie and TOC entry structure, see `PyInstaller.archive.readers.CArchiveReader`. + _COOKIE_FORMAT = '!8sIIII64s' + _COOKIE_LENGTH = struct.calcsize(_COOKIE_FORMAT) + + _TOC_ENTRY_FORMAT = '!IIIIBc' + _TOC_ENTRY_LENGTH = struct.calcsize(_TOC_ENTRY_FORMAT) + + _COMPRESSION_LEVEL = 9 # zlib compression level + + def __init__(self, filename, entries, pylib_name): + """ + filename + Target filename of the archive. + entries + An iterable containing entries in the form of tuples: (dest_name, src_name, compress, typecode), where + `dest_name` is the name under which the resource is stored in the archive (and name under which it is + extracted at runtime), `src_name` is name of the file from which the resouce is read, `compress` is a + boolean compression flag, and `typecode` is the Analysis-level TOC typecode. + pylib_name + Name of the python shared library. + """ + self._collected_names = set() # Track collected names for strict package mode. + + with open(filename, "wb") as fp: + # Write entries' data and collect TOC entries + toc = [] + for entry in entries: + toc_entry = self._write_entry(fp, entry) + toc.append(toc_entry) + + # Write TOC + toc_offset = fp.tell() + toc_data = self._serialize_toc(toc) + toc_length = len(toc_data) + + fp.write(toc_data) + + # Write cookie + archive_length = toc_offset + toc_length + self._COOKIE_LENGTH + pyvers = sys.version_info[0] * 100 + sys.version_info[1] + cookie_data = struct.pack( + self._COOKIE_FORMAT, + self._COOKIE_MAGIC_PATTERN, + archive_length, + toc_offset, + toc_length, + pyvers, + pylib_name.encode('ascii'), + ) + + fp.write(cookie_data) + + def _write_entry(self, fp, entry): + dest_name, src_name, compress, typecode = entry + + # Write OPTION entries as-is, without normalizing them. This also exempts them from duplication check, + # allowing them to be specified multiple times. + if typecode == 'o': + return self._write_blob(fp, b"", dest_name, typecode) + + # Ensure forward slashes in paths are on Windows converted to back slashes '\\', as on Windows the bootloader + # works only with back slashes. + dest_name = os.path.normpath(dest_name) + if is_win and os.path.sep == '/': + # When building under MSYS, the above path normalization uses Unix-style separators, so replace them + # manually. + dest_name = dest_name.replace(os.path.sep, '\\') + + # For symbolic link entries, also ensure that the symlink target path (stored in src_name) is using + # Windows-style back slash separators. + if typecode == 'n': + src_name = src_name.replace(os.path.sep, '\\') + + # Strict pack/collect mode: keep track of the destination names, and raise an error if we try to add a duplicate + # (a file with same destination name, subject to OS case normalization rules). + if strict_collect_mode: + normalized_dest = None + if typecode in {'s', 's1', 's2', 'm', 'M'}: + # Exempt python source scripts and modules from the check. + pass + else: + # Everything else; normalize the case + normalized_dest = os.path.normcase(dest_name) + # Check for existing entry, if applicable + if normalized_dest: + if normalized_dest in self._collected_names: + raise ValueError( + f"Attempting to collect a duplicated file into CArchive: {normalized_dest} (type: {typecode})" + ) + self._collected_names.add(normalized_dest) + + if typecode == 'd': + # Dependency; merge src_name (= reference path prefix) and dest_name (= name) into single-string format that + # is parsed by bootloader. + return self._write_blob(fp, b"", f"{src_name}:{dest_name}", typecode) + elif typecode in {'s', 's1', 's2'}: + # If it is a source code file, compile it to a code object and marshal the object, so it can be unmarshalled + # by the bootloader. For that, we need to know target optimization level, which is stored in typecode. + optim_level = {'s': 0, 's1': 1, 's2': 2}[typecode] + code = get_code_object(dest_name, src_name, optimize=optim_level) + # Construct new `co_filename` by taking destination name, and replace its suffix with the one from the code + # object's co_filename; this should cover all of the following cases: + # - run-time hook script: the source name has a suffix (that is also present in `co_filename` produced by + # `get_code_object`), destination name has no suffix. + # - entry-point script with a suffix: both source name and destination name have the same suffix (and the + # same suffix is also in `co_filename` produced by `get_code_object`) + # - entry-point script without a suffix: neither source name nor destination name have a suffix, but + # `get_code_object` adds a .py suffix to `co_filename` to mitigate potential issues with POSIX + # executables and `traceback` module; we want to preserve this behavior. + co_filename = os.path.splitext(dest_name)[0] + os.path.splitext(code.co_filename)[1] + code = replace_filename_in_code_object(code, co_filename) + return self._write_blob(fp, marshal.dumps(code), dest_name, 's', compress=compress) + elif typecode in ('m', 'M'): + # Read the PYC file. We do not perform compilation here (in contrast to script files in the above branch), + # so typecode does not contain optimization level information. + with open(src_name, "rb") as in_fp: + data = in_fp.read() + assert data[:4] == BYTECODE_MAGIC + # Skip the PYC header, load the code object. + code = marshal.loads(data[16:]) + co_filename = dest_name + '.py' # Use dest name with added .py suffix. + code = replace_filename_in_code_object(code, co_filename) + # These module entries are loaded and executed within the bootloader, which requires only the code + # object, without the PYC header. + return self._write_blob(fp, marshal.dumps(code), dest_name, typecode, compress=compress) + elif typecode == 'n': + # Symbolic link; store target name (as NULL-terminated string) + data = src_name.encode('utf-8') + b'\x00' + return self._write_blob(fp, data, dest_name, typecode, compress=compress) + else: + return self._write_file(fp, src_name, dest_name, typecode, compress=compress) + + def _write_blob(self, out_fp, blob: bytes, dest_name, typecode, compress=False): + """ + Write the binary contents (**blob**) of a small file to the archive and return the corresponding CArchive TOC + entry. + """ + data_offset = out_fp.tell() + data_length = len(blob) + if compress: + blob = zlib.compress(blob, level=self._COMPRESSION_LEVEL) + out_fp.write(blob) + + return (data_offset, len(blob), data_length, int(compress), typecode, dest_name) + + def _write_file(self, out_fp, src_name, dest_name, typecode, compress=False): + """ + Stream copy a large file into the archive and return the corresponding CArchive TOC entry. + """ + data_offset = out_fp.tell() + data_length = os.stat(src_name).st_size + with open(src_name, 'rb') as in_fp: + if compress: + tmp_buffer = bytearray(16 * 1024) + compressor = zlib.compressobj(self._COMPRESSION_LEVEL) + while True: + num_read = in_fp.readinto(tmp_buffer) + if not num_read: + break + out_fp.write(compressor.compress(tmp_buffer[:num_read])) + out_fp.write(compressor.flush()) + else: + shutil.copyfileobj(in_fp, out_fp) + + return (data_offset, out_fp.tell() - data_offset, data_length, int(compress), typecode, dest_name) + + @classmethod + def _serialize_toc(cls, toc): + serialized_toc = [] + for toc_entry in toc: + data_offset, compressed_length, data_length, compress, typecode, name = toc_entry + + # Encode names as UTF-8. This should be safe as standard python modules only contain ASCII-characters (and + # standard shared libraries should have the same), and thus the C-code still can handle this correctly. + name = name.encode('utf-8') + name_length = len(name) + 1 # Add 1 for string-terminating zero byte. + + # Ensure TOC entries are aligned on 16-byte boundary, so they can be read by bootloader (C code) on + # platforms with strict data alignment requirements (for example linux on `armhf`/`armv7`, such as 32-bit + # Debian Buster on Raspberry Pi). + entry_length = cls._TOC_ENTRY_LENGTH + name_length + if entry_length % 16 != 0: + padding_length = 16 - (entry_length % 16) + name_length += padding_length + + # Serialize + serialized_entry = struct.pack( + cls._TOC_ENTRY_FORMAT + f"{name_length}s", # "Ns" format automatically pads the string with zero bytes. + cls._TOC_ENTRY_LENGTH + name_length, + data_offset, + compressed_length, + data_length, + compress, + typecode.encode('ascii'), + name, + ) + serialized_toc.append(serialized_entry) + + return b''.join(serialized_toc) + + +class SplashWriter: + """ + Writer for the splash screen resources archive. + + The resulting archive is added as an entry into the CArchive with the typecode PKG_ITEM_SPLASH. + """ + # This struct describes the splash resources as it will be in an buffer inside the bootloader. All necessary parts + # are bundled, the *_len and *_offset fields describe the data beyond this header definition. + # Whereas script and image fields are binary data, the requirements fields describe an array of strings. Each string + # is null-terminated in order to easily iterate over this list from within C. + # + # typedef struct _splash_data_header + # { + # char tcl_libname[16]; + # char tk_libname[16]; + # char tk_lib[16]; + # + # uint32_t script_len; + # uint32_t script_offset; + # + # uint32_t image_len; + # uint32_t image_offset; + # + # uint32_t requirements_len; + # uint32_t requirements_offset; + # } SPLASH_DATA_HEADER; + # + _HEADER_FORMAT = '!32s 32s 16s II II II' + _HEADER_LENGTH = struct.calcsize(_HEADER_FORMAT) + + # The created archive is compressed by the CArchive, so no need to compress the data here. + + def __init__(self, filename, name_list, tcl_libname, tk_libname, tklib, image, script): + """ + Writer for splash screen resources that are bundled into the CArchive as a single archive/entry. + + :param filename: The filename of the archive to create + :param name_list: List of filenames for the requirements array + :param str tcl_libname: Name of the tcl shared library file + :param str tk_libname: Name of the tk shared library file + :param str tklib: Root of tk library (e.g. tk/) + :param Union[str, bytes] image: Image like object + :param str script: The tcl/tk script to execute to create the screen. + """ + + # Ensure forward slashes in dependency names are on Windows converted to back slashes '\\', as on Windows the + # bootloader works only with back slashes. + def _normalize_filename(filename): + filename = os.path.normpath(filename) + if is_win and os.path.sep == '/': + # When building under MSYS, the above path normalization uses Unix-style separators, so replace them + # manually. + filename = filename.replace(os.path.sep, '\\') + return filename + + name_list = [_normalize_filename(name) for name in name_list] + + with open(filename, "wb") as fp: + # Reserve space for the header. + fp.write(b'\0' * self._HEADER_LENGTH) + + # Serialize the requirements list. This list (more an array) contains the names of all files the bootloader + # needs to extract before the splash screen can be started. The implementation terminates every name with a + # null-byte, that keeps the list short memory wise and makes it iterable from C. + requirements_len = 0 + requirements_offset = fp.tell() + for name in name_list: + name = name.encode('utf-8') + b'\0' + fp.write(name) + requirements_len += len(name) + + # Write splash script + script_offset = fp.tell() + script_len = len(script) + fp.write(script.encode("utf-8")) + + # Write splash image. If image is a bytes buffer, it is written directly into the archive. Otherwise, it + # is assumed to be a path and the file is copied into the archive. + image_offset = fp.tell() + if isinstance(image, bytes): + # Image was converted by PIL/Pillow and is already in buffer + image_len = len(image) + fp.write(image) + else: + # Read image into buffer + with open(image, 'rb') as image_fp: + image_data = image_fp.read() + image_len = len(image_data) + fp.write(image_data) + del image_data + + # The following strings are written to 16-character fields with zero-padding, which means that we need to + # ensure that their length is strictly below 16 characters (if it were exactly 16, the field would have no + # terminating NULL character!). + def _encode_str(value, field_name, limit): + enc_value = value.encode("utf-8") + if len(enc_value) >= limit: + raise ValueError( + f"Length of the encoded field {field_name!r} ({len(enc_value)}) is greater or equal to the " + f"limit of {limit} characters!" + ) + + return enc_value + + # Write header + header_data = struct.pack( + self._HEADER_FORMAT, + _encode_str(tcl_libname, 'tcl_libname', 32), + _encode_str(tk_libname, 'tk_libname', 32), + _encode_str(tklib, 'tklib', 16), + script_len, + script_offset, + image_len, + image_offset, + requirements_len, + requirements_offset, + ) + + fp.seek(0, os.SEEK_SET) + fp.write(header_data) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/bootloader/Linux-64bit-intel/run b/venv/lib/python3.12/site-packages/PyInstaller/bootloader/Linux-64bit-intel/run new file mode 100755 index 0000000..5e983ee Binary files /dev/null and b/venv/lib/python3.12/site-packages/PyInstaller/bootloader/Linux-64bit-intel/run differ diff --git a/venv/lib/python3.12/site-packages/PyInstaller/bootloader/Linux-64bit-intel/run_d b/venv/lib/python3.12/site-packages/PyInstaller/bootloader/Linux-64bit-intel/run_d new file mode 100755 index 0000000..a1151ba Binary files /dev/null and b/venv/lib/python3.12/site-packages/PyInstaller/bootloader/Linux-64bit-intel/run_d differ diff --git a/venv/lib/python3.12/site-packages/PyInstaller/building/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/building/__init__.py new file mode 100755 index 0000000..792d600 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/building/__init__.py @@ -0,0 +1 @@ +# diff --git a/venv/lib/python3.12/site-packages/PyInstaller/building/api.py b/venv/lib/python3.12/site-packages/PyInstaller/building/api.py new file mode 100755 index 0000000..becea2c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/building/api.py @@ -0,0 +1,1334 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +This module contains classes that are available for the .spec files. + +Spec file is generated by PyInstaller. The generated code from .spec file +is a way how PyInstaller does the dependency analysis and creates executable. +""" + +import os +import subprocess +import sys +import time +import pathlib +import shutil +from operator import itemgetter + +from PyInstaller import HOMEPATH, PLATFORM +from PyInstaller import log as logging +from PyInstaller.archive.writers import CArchiveWriter, ZlibArchiveWriter +from PyInstaller.building.datastruct import Target, _check_guts_eq, normalize_pyz_toc, normalize_toc +from PyInstaller.building.utils import ( + _check_guts_toc, _make_clean_directory, _rmtree, process_collected_binary, get_code_object, compile_pymodule +) +from PyInstaller.building.splash import Splash # argument type validation in EXE +from PyInstaller.compat import is_cygwin, is_darwin, is_linux, is_win, strict_collect_mode, is_nogil, is_aix +from PyInstaller.depend import bindepend +from PyInstaller.depend.analysis import get_bootstrap_modules +import PyInstaller.utils.misc as miscutils + +logger = logging.getLogger(__name__) + +if is_win: + from PyInstaller.utils.win32 import (icon, versioninfo, winmanifest, winresource, winutils) + +if is_darwin: + import PyInstaller.utils.osx as osxutils + + +class PYZ(Target): + """ + Creates a zlib-based PYZ archive that contains byte-compiled pure Python modules. + """ + def __init__(self, *tocs, **kwargs): + """ + tocs + One or more TOC (Table of Contents) lists, usually an `Analysis.pure`. + + kwargs + Possible keyword arguments: + + name + A filename for the .pyz. Normally not needed, as the generated name will do fine. + """ + if kwargs.get("cipher"): + from PyInstaller.exceptions import RemovedCipherFeatureError + raise RemovedCipherFeatureError( + "Please remove the 'cipher' arguments to PYZ() and Analysis() in your spec file." + ) + + from PyInstaller.config import CONF + + super().__init__() + + name = kwargs.get('name', None) + + self.name = name + if name is None: + self.name = os.path.splitext(self.tocfilename)[0] + '.pyz' + + # PyInstaller bootstrapping modules. + bootstrap_dependencies = get_bootstrap_modules() + + # Compile the python modules that are part of bootstrap dependencies, so that they can be collected into the + # CArchive/PKG and imported by the bootstrap script. + self.dependencies = [] + workpath = os.path.join(CONF['workpath'], 'localpycs') + for name, src_path, typecode in bootstrap_dependencies: + if typecode == 'PYMODULE': + # Compile pymodule and include the compiled .pyc file. + pyc_path = compile_pymodule( + name, + src_path, + workpath, + # Never optimize bootstrap dependencies! + optimize=0, + code_cache=None, + ) + self.dependencies.append((name, pyc_path, typecode)) + else: + # Include as is (extensions). + self.dependencies.append((name, src_path, typecode)) + + # Merge input TOC(s) and their code object dictionaries (if available). Skip the bootstrap modules, which will + # be passed on to CArchive/PKG. + bootstrap_module_names = set(name for name, _, typecode in self.dependencies if typecode == 'PYMODULE') + self.toc = [] + self.code_dict = {} + for toc in tocs: + # Check if code cache association exists for the given TOC list + code_cache = CONF['code_cache'].get(id(toc)) + if code_cache is not None: + self.code_dict.update(code_cache) + + for entry in toc: + name, _, typecode = entry + # PYZ expects only PYMODULE entries (python code objects). + assert typecode in {'PYMODULE', 'PYMODULE-1', 'PYMODULE-2'}, f"Invalid entry passed to PYZ: {entry}!" + # Module required during bootstrap; skip to avoid collecting a duplicate. + if name in bootstrap_module_names: + continue + self.toc.append(entry) + + # Normalize TOC + self.toc = normalize_pyz_toc(self.toc) + + # Alphabetically sort the TOC to enable reproducible builds. + self.toc.sort() + + self.__postinit__() + + _GUTS = ( + # input parameters + ('name', _check_guts_eq), + ('toc', _check_guts_toc), + # no calculated/analysed values + ) + + def assemble(self): + logger.info("Building PYZ (ZlibArchive) %s", self.name) + + # Ensure code objects are available for all modules we are about to collect. + # NOTE: PEP-420 namespace packages (marked by src_path being set to '-') do not have code objects. + # NOTE: `self.toc` is already sorted by names. + archive_toc = [] + for entry in self.toc: + name, src_path, typecode = entry + if src_path not in {'-', None} and name not in self.code_dict: + # The code object is not available from the ModuleGraph's cache; re-create it. + optim_level = {'PYMODULE': 0, 'PYMODULE-1': 1, 'PYMODULE-2': 2}[typecode] + try: + self.code_dict[name] = get_code_object(name, src_path, optimize=optim_level) + except SyntaxError: + # The module was likely written for different Python version; exclude it + continue + archive_toc.append(entry) + + # Create the archive + ZlibArchiveWriter(self.name, archive_toc, code_dict=self.code_dict) + logger.info("Building PYZ (ZlibArchive) %s completed successfully.", self.name) + + +class PKG(Target): + """ + Creates a CArchive. CArchive is the data structure that is embedded into the executable. This data structure allows + to include various read-only data in a single-file deployment. + """ + xformdict = { + # PYMODULE entries are already byte-compiled, so we do not need to encode optimization level in the low-level + # typecodes. PYSOURCE entries are byte-compiled by the underlying writer, so we need to pass the optimization + # level via low-level typecodes. + 'PYMODULE': 'm', + 'PYMODULE-1': 'm', + 'PYMODULE-2': 'm', + 'PYSOURCE': 's', + 'PYSOURCE-1': 's1', + 'PYSOURCE-2': 's2', + 'EXTENSION': 'b', + 'PYZ': 'z', + 'PKG': 'a', + 'DATA': 'x', + 'BINARY': 'b', + 'ZIPFILE': 'Z', + 'EXECUTABLE': 'b', + 'DEPENDENCY': 'd', + 'SPLASH': 'l', + 'SYMLINK': 'n', + } + + def __init__( + self, + toc, + python_lib_name, + name=None, + cdict=None, + exclude_binaries=False, + strip_binaries=False, + upx_binaries=False, + upx_exclude=None, + target_arch=None, + codesign_identity=None, + entitlements_file=None + ): + """ + toc + A TOC (Table of Contents) list. + python_lib_name + Name of the python shared library to store in PKG. Required by bootloader. + name + An optional filename for the PKG. + cdict + Dictionary that specifies compression by typecode. For Example, PYZ is left uncompressed so that it + can be accessed inside the PKG. The default uses sensible values. If zlib is not available, no + compression is used. + exclude_binaries + If True, EXTENSIONs and BINARYs will be left out of the PKG, and forwarded to its container (usually + a COLLECT). + strip_binaries + If True, use 'strip' command to reduce the size of binary files. + upx_binaries + """ + super().__init__() + + self.toc = normalize_toc(toc) # Ensure guts contain normalized TOC + self.python_lib_name = python_lib_name + self.cdict = cdict + self.name = name + if name is None: + self.name = os.path.splitext(self.tocfilename)[0] + '.pkg' + self.exclude_binaries = exclude_binaries + self.strip_binaries = strip_binaries + self.upx_binaries = upx_binaries + self.upx_exclude = upx_exclude or [] + self.target_arch = target_arch + self.codesign_identity = codesign_identity + self.entitlements_file = entitlements_file + + # This dict tells PyInstaller what items embedded in the executable should be compressed. + if self.cdict is None: + self.cdict = { + 'EXTENSION': COMPRESSED, + 'DATA': COMPRESSED, + 'BINARY': COMPRESSED, + 'EXECUTABLE': COMPRESSED, + 'PYSOURCE': COMPRESSED, + 'PYMODULE': COMPRESSED, + 'SPLASH': COMPRESSED, + # Do not compress PYZ as a whole, as it contains individually-compressed modules. + 'PYZ': UNCOMPRESSED, + # Do not compress target names in symbolic links. + 'SYMLINK': UNCOMPRESSED, + } + + self.__postinit__() + + _GUTS = ( # input parameters + ('name', _check_guts_eq), + ('cdict', _check_guts_eq), + ('toc', _check_guts_toc), # list unchanged and no newer files + ('python_lib_name', _check_guts_eq), + ('exclude_binaries', _check_guts_eq), + ('strip_binaries', _check_guts_eq), + ('upx_binaries', _check_guts_eq), + ('upx_exclude', _check_guts_eq), + ('target_arch', _check_guts_eq), + ('codesign_identity', _check_guts_eq), + ('entitlements_file', _check_guts_eq), + # no calculated/analysed values + ) + + def assemble(self): + logger.info("Building PKG (CArchive) %s", os.path.basename(self.name)) + + pkg_file = pathlib.Path(self.name).resolve() # Used to detect attempts at PKG feeding itself + + bootstrap_toc = [] # TOC containing bootstrap scripts and modules, which must not be sorted. + archive_toc = [] # TOC containing all other elements. Sorted to enable reproducible builds. + + for dest_name, src_name, typecode in self.toc: + # Ensure that the source file exists, if necessary. Skip the check for OPTION entries, where 'src_name' is + # None. Also skip DEPENDENCY entries due to special contents of 'dest_name' and/or 'src_name'. Same for the + # SYMLINK entries, where 'src_name' is relative target name for symbolic link. + if typecode not in {'OPTION', 'DEPENDENCY', 'SYMLINK'}: + if not os.path.exists(src_name): + if strict_collect_mode: + raise ValueError(f"Non-existent resource {src_name}, meant to be collected as {dest_name}!") + else: + logger.warning( + "Ignoring non-existent resource %s, meant to be collected as %s", src_name, dest_name + ) + continue + + # Detect attempt at collecting PKG into itself, as it results in and endless feeding loop and exhaustion + # of all available storage space. + if pathlib.Path(src_name).resolve() == pkg_file: + raise ValueError(f"Trying to collect PKG file {src_name} into itself!") + + if typecode in ('BINARY', 'EXTENSION'): + if self.exclude_binaries: + # This is onedir-specific codepath - the EXE and consequently PKG should not be passed the Analysis' + # `datas` and `binaries` TOCs (unless the user messes up the .spec file). However, EXTENSION entries + # might still slip in via `PYZ.dependencies`, which are merged by EXE into its TOC and passed on to + # PKG here. Such entries need to be passed to the parent container (the COLLECT) via + # `PKG.dependencies`. + # + # This codepath formerly performed such pass-through only for EXTENSION entries, but in order to + # keep code simple, we now also do it for BINARY entries. In a sane world, we do not expect to + # encounter them here; but if they do happen to pass through here and we pass them on, the + # container's TOC de-duplication should take care of them (same as with EXTENSION ones, really). + self.dependencies.append((dest_name, src_name, typecode)) + else: + # This is onefile-specific codepath. The binaries (both EXTENSION and BINARY entries) need to be + # processed using `process_collected_binary` helper. + src_name = process_collected_binary( + src_name, + dest_name, + use_strip=self.strip_binaries, + use_upx=self.upx_binaries, + upx_exclude=self.upx_exclude, + target_arch=self.target_arch, + codesign_identity=self.codesign_identity, + entitlements_file=self.entitlements_file, + strict_arch_validation=(typecode == 'EXTENSION'), + ) + archive_toc.append((dest_name, src_name, self.cdict.get(typecode, False), self.xformdict[typecode])) + elif typecode in ('DATA', 'ZIPFILE'): + # Same logic as above for BINARY and EXTENSION; if `exclude_binaries` is set, we are in onedir mode; + # we should exclude DATA (and ZIPFILE) entries and instead pass them on via PKG's `dependencies`. This + # prevents a onedir application from becoming a broken onefile one if user accidentally passes datas + # and binaries TOCs to EXE instead of COLLECT. + if self.exclude_binaries: + self.dependencies.append((dest_name, src_name, typecode)) + else: + if typecode == 'DATA' and os.access(src_name, os.X_OK): + # DATA with executable bit set (e.g., shell script); turn into binary so that executable bit is + # restored on the extracted file. + carchive_typecode = 'b' + else: + carchive_typecode = self.xformdict[typecode] + archive_toc.append((dest_name, src_name, self.cdict.get(typecode, False), carchive_typecode)) + elif typecode == 'OPTION': + archive_toc.append((dest_name, '', False, 'o')) + elif typecode in {'PYSOURCE', 'PYSOURCE-1', 'PYSOURCE-2', 'PYMODULE', 'PYMODULE-1', 'PYMODULE-2'}: + # Collect python script and modules in a TOC that will not be sorted. + bootstrap_toc.append((dest_name, src_name, self.cdict.get(typecode, False), self.xformdict[typecode])) + elif typecode == 'PYZ': + # Override PYZ name in the PKG archive into PYZ.pyz, regardless of what the original name was. The + # bootloader looks for PYZ via the typecode and implicitly expects a single entry, so the name does + # not matter. However, having a fixed name matters if we want reproducibility in scenarios where + # multiple builds are performed within the same process (for example, on our CI). + archive_toc.append(('PYZ.pyz', src_name, self.cdict.get(typecode, False), self.xformdict[typecode])) + else: + # PKG, DEPENDENCY, SPLASH, SYMLINK + archive_toc.append((dest_name, src_name, self.cdict.get(typecode, False), self.xformdict[typecode])) + + # Sort content alphabetically by type and name to enable reproducible builds. + archive_toc.sort(key=itemgetter(3, 0)) + # Do *not* sort modules and scripts, as their order is important. + # TODO: Think about having all modules first and then all scripts. + CArchiveWriter(self.name, bootstrap_toc + archive_toc, pylib_name=self.python_lib_name) + + logger.info("Building PKG (CArchive) %s completed successfully.", os.path.basename(self.name)) + + +class EXE(Target): + """ + Creates the final executable of the frozen app. This bundles all necessary files together. + """ + def __init__(self, *args, **kwargs): + """ + args + One or more arguments that are either an instance of `Target` or an iterable representing TOC list. + kwargs + Possible keyword arguments: + + bootloader_ignore_signals + Non-Windows only. If True, the bootloader process will ignore all ignorable signals. If False (default), + it will forward all signals to the child process. Useful in situations where for example a supervisor + process signals both the bootloader and the child (e.g., via a process group) to avoid signalling the + child twice. + console + On Windows or macOS governs whether to use the console executable or the windowed executable. Always + True on Linux/Unix (always console executable - it does not matter there). + hide_console + Windows only. In console-enabled executable, hide or minimize the console window if the program owns the + console window (i.e., was not launched from existing console window). Depending on the setting, the + console is hidden/mininized either early in the bootloader execution ('hide-early', 'minimize-early') or + late in the bootloader execution ('hide-late', 'minimize-late'). The early option takes place as soon as + the PKG archive is found. In onefile builds, the late option takes place after application has unpacked + itself and before it launches the child process. In onedir builds, the late option takes place before + starting the embedded python interpreter. + disable_windowed_traceback + Disable traceback dump of unhandled exception in windowed (noconsole) mode (Windows and macOS only), + and instead display a message that this feature is disabled. + debug + Setting to True gives you progress messages from the executable (for console=False there will be + annoying MessageBoxes on Windows). + name + The filename for the executable. On Windows suffix '.exe' is appended. + exclude_binaries + Forwarded to the PKG the EXE builds. + icon + Windows and macOS only. icon='myicon.ico' to use an icon file or icon='notepad.exe,0' to grab an icon + resource. Defaults to use PyInstaller's console or windowed icon. Use icon=`NONE` to not add any icon. + version + Windows only. version='myversion.txt'. Use grab_version.py to get a version resource from an executable + and then edit the output to create your own. (The syntax of version resources is so arcane that I would + not attempt to write one from scratch). + uac_admin + Windows only. Setting to True creates a Manifest with will request elevation upon application start. + uac_uiaccess + Windows only. Setting to True allows an elevated application to work with Remote Desktop. + argv_emulation + macOS only. Enables argv emulation in macOS .app bundles (i.e., windowed bootloader). If enabled, the + initial open document/URL Apple Events are intercepted by bootloader and converted into sys.argv. + target_arch + macOS only. Used to explicitly specify the target architecture; either single-arch ('x86_64' or 'arm64') + or 'universal2'. Used in checks that the collected binaries contain the requires arch slice(s) and/or + to convert fat binaries into thin ones as necessary. If not specified (default), a single-arch build + corresponding to running architecture is assumed. + codesign_identity + macOS only. Use the provided identity to sign collected binaries and the generated executable. If + signing identity is not provided, ad-hoc signing is performed. + entitlements_file + macOS only. Optional path to entitlements file to use with code signing of collected binaries + (--entitlements option to codesign utility). + contents_directory + Onedir mode only. Specifies the name of the directory where all files par the executable will be placed. + Setting the name to '.' (or '' or None) re-enables old onedir layout without contents directory. + """ + from PyInstaller.config import CONF + + super().__init__() + + # Available options for EXE in .spec files. + self.exclude_binaries = kwargs.get('exclude_binaries', False) + self.bootloader_ignore_signals = kwargs.get('bootloader_ignore_signals', False) + self.console = kwargs.get('console', True) + self.hide_console = kwargs.get('hide_console', None) + self.disable_windowed_traceback = kwargs.get('disable_windowed_traceback', False) + self.debug = kwargs.get('debug', False) + self.name = kwargs.get('name', None) + self.icon = kwargs.get('icon', None) + self.versrsrc = kwargs.get('version', None) + self.manifest = kwargs.get('manifest', None) + self.resources = kwargs.get('resources', []) + self.strip = kwargs.get('strip', False) + self.upx_exclude = kwargs.get("upx_exclude", []) + self.runtime_tmpdir = kwargs.get('runtime_tmpdir', None) + self.contents_directory = kwargs.get("contents_directory", "_internal") + # If ``append_pkg`` is false, the archive will not be appended to the exe, but copied beside it. + self.append_pkg = kwargs.get('append_pkg', True) + + # On Windows allows the exe to request admin privileges. + self.uac_admin = kwargs.get('uac_admin', False) + self.uac_uiaccess = kwargs.get('uac_uiaccess', False) + + # macOS argv emulation + self.argv_emulation = kwargs.get('argv_emulation', False) + + # Target architecture (macOS only) + self.target_arch = kwargs.get('target_arch', None) + if is_darwin: + if self.target_arch is None: + import platform + self.target_arch = platform.machine() + else: + assert self.target_arch in {'x86_64', 'arm64', 'universal2'}, \ + f"Unsupported target arch: {self.target_arch}" + logger.info("EXE target arch: %s", self.target_arch) + else: + self.target_arch = None # explicitly disable + + # Code signing identity (macOS only) + self.codesign_identity = kwargs.get('codesign_identity', None) + if is_darwin: + logger.info("Code signing identity: %s", self.codesign_identity) + else: + self.codesign_identity = None # explicitly disable + # Code signing entitlements + self.entitlements_file = kwargs.get('entitlements_file', None) + + # UPX needs to be both available and enabled for the target. + self.upx = CONF['upx_available'] and kwargs.get('upx', False) + + # Catch and clear options that are unsupported on specific platforms. + if self.versrsrc and not is_win: + logger.warning('Ignoring version information; supported only on Windows!') + self.versrsrc = None + if self.manifest and not is_win: + logger.warning('Ignoring manifest; supported only on Windows!') + self.manifest = None + if self.resources and not is_win: + logger.warning('Ignoring resources; supported only on Windows!') + self.resources = [] + if self.icon and not (is_win or is_darwin): + logger.warning('Ignoring icon; supported only on Windows and macOS!') + self.icon = None + if self.hide_console and not is_win: + logger.warning('Ignoring hide_console; supported only on Windows!') + self.hide_console = None + + if self.contents_directory in ("", "."): + self.contents_directory = None # Re-enable old onedir layout without contents directory. + elif self.contents_directory == ".." or "/" in self.contents_directory or "\\" in self.contents_directory: + raise SystemExit( + f'ERROR: Invalid value "{self.contents_directory}" passed to `--contents-directory` or ' + '`contents_directory`. Exactly one directory level is required (or just "." to disable the ' + 'contents directory).' + ) + + if not kwargs.get('embed_manifest', True): + from PyInstaller.exceptions import RemovedExternalManifestError + raise RemovedExternalManifestError( + "Please remove the 'embed_manifest' argument to EXE() in your spec file." + ) + + # Old .spec format included in 'name' the path where to put created app. New format includes only exename. + # + # Ignore fullpath in the 'name' and prepend DISTPATH or WORKPATH. + # DISTPATH - onefile + # WORKPATH - onedir + if self.exclude_binaries: + # onedir mode - create executable in WORKPATH. + self.name = os.path.join(CONF['workpath'], os.path.basename(self.name)) + else: + # onefile mode - create executable in DISTPATH. + self.name = os.path.join(CONF['distpath'], os.path.basename(self.name)) + + # Old .spec format included on Windows in 'name' .exe suffix. + if is_win or is_cygwin: + # Append .exe suffix if it is not already there. + if not self.name.endswith('.exe'): + self.name += '.exe' + base_name = os.path.splitext(os.path.basename(self.name))[0] + else: + base_name = os.path.basename(self.name) + # Create the CArchive PKG in WORKPATH. When instancing PKG(), set name so that guts check can test whether the + # file already exists. + self.pkgname = os.path.join(CONF['workpath'], base_name + '.pkg') + + self.toc = [] + + for arg in args: + # Valid arguments: PYZ object, Splash object, and TOC-list iterables + if isinstance(arg, (PYZ, Splash)): + # Add object as an entry to the TOC, and merge its dependencies TOC + if isinstance(arg, PYZ): + self.toc.append((os.path.basename(arg.name), arg.name, "PYZ")) + else: + self.toc.append((os.path.basename(arg.name), arg.name, "SPLASH")) + self.toc.extend(arg.dependencies) + elif miscutils.is_iterable(arg): + # TOC-like iterable + self.toc.extend(arg) + else: + raise TypeError(f"Invalid argument type for EXE: {type(arg)!r}") + + if is_nogil: + # Signal to bootloader that python was built with Py_GIL_DISABLED, in order to select correct `PyConfig` + # structure layout at run-time. + self.toc.append(("pyi-python-flag Py_GIL_DISABLED", "", "OPTION")) + + if self.runtime_tmpdir is not None: + self.toc.append(("pyi-runtime-tmpdir " + self.runtime_tmpdir, "", "OPTION")) + + if self.bootloader_ignore_signals: + # no value; presence means "true" + self.toc.append(("pyi-bootloader-ignore-signals", "", "OPTION")) + + if self.disable_windowed_traceback: + # no value; presence means "true" + self.toc.append(("pyi-disable-windowed-traceback", "", "OPTION")) + + if self.argv_emulation: + # no value; presence means "true" + self.toc.append(("pyi-macos-argv-emulation", "", "OPTION")) + + if self.contents_directory: + self.toc.append(("pyi-contents-directory " + self.contents_directory, "", "OPTION")) + + if self.hide_console: + # Validate the value + _HIDE_CONSOLE_VALUES = {'hide-early', 'minimize-early', 'hide-late', 'minimize-late'} + self.hide_console = self.hide_console.lower() + if self.hide_console not in _HIDE_CONSOLE_VALUES: + raise ValueError( + f"Invalid hide_console value: {self.hide_console}! Allowed values: {_HIDE_CONSOLE_VALUES}" + ) + self.toc.append((f"pyi-hide-console {self.hide_console}", "", "OPTION")) + + # If the icon path is relative, make it relative to the .spec file. + if self.icon and self.icon != "NONE": + if isinstance(self.icon, list): + self.icon = [self._makeabs(ic) for ic in self.icon] + else: + self.icon = [self._makeabs(self.icon)] + + if is_win: + if not self.icon: + # --icon not specified; use default from bootloader folder + if self.console: + ico = 'icon-console.ico' + else: + ico = 'icon-windowed.ico' + self.icon = os.path.join(os.path.dirname(os.path.dirname(__file__)), 'bootloader', 'images', ico) + + # Prepare manifest for the executable by creating minimal manifest or modifying the supplied one. + if self.manifest: + # Determine if we were given a filename or an XML string. + if "<" in self.manifest: + self.manifest = self.manifest.encode("utf-8") + else: + self.manifest = self._makeabs(self.manifest) + with open(self.manifest, "rb") as fp: + self.manifest = fp.read() + self.manifest = winmanifest.create_application_manifest(self.manifest, self.uac_admin, self.uac_uiaccess) + + if self.versrsrc: + if isinstance(self.versrsrc, versioninfo.VSVersionInfo): + # We were passed a valid versioninfo.VSVersionInfo structure + pass + elif isinstance(self.versrsrc, (str, bytes, os.PathLike)): + # File path; either absolute, or relative to the spec file + self.versrsrc = self._makeabs(self.versrsrc) + logger.debug("Loading version info from file: %r", self.versrsrc) + self.versrsrc = versioninfo.load_version_info_from_text_file(self.versrsrc) + else: + raise TypeError(f"Unsupported type for version info argument: {type(self.versrsrc)!r}") + + # Identify python shared library. This is needed both for PKG (where we need to store the name so that + # bootloader can look it up), and for macOS-specific processing of the generated executable (adjusting the SDK + # version). + # + # NOTE: we already performed an equivalent search (using the same `get_python_library_path` helper) during the + # analysis stage to ensure that the python shared library is collected. Unfortunately, with the way data passing + # works in onedir builds, we cannot look up the value in the TOC at this stage, and we need to search again. + self.python_lib = bindepend.get_python_library_path() + if self.python_lib is None: + from PyInstaller.exceptions import PythonLibraryNotFoundError + raise PythonLibraryNotFoundError() + + # On AIX, the python shared library might in fact be an ar archive with shared object inside it, and needs to + # be `dlopen`'ed with full name (for example, `libpython3.9.a(libpython3.9.so)`. So if the library's suffix is + # .a, adjust the name accordingly, assuming fixed format for the shared object name. NOTE: the information about + # shared object name is in fact available from `ldd` but not propagated from our binary dependency analysis. If + # we ever need to determine the shared object's name dynamically, we could write a simple ar parser, based on + # information from `https://www.ibm.com/docs/en/aix/7.3?topic=formats-ar-file-format-big`. + if is_aix: + _, ext = os.path.splitext(self.python_lib) + if ext == '.a': + _py_major, _py_minor = sys.version_info[:2] + self.python_lib += f"(libpython{_py_major}.{_py_minor}.so)" + + # Normalize TOC + self.toc = normalize_toc(self.toc) + + self.pkg = PKG( + toc=self.toc, + python_lib_name=os.path.basename(self.python_lib), + name=self.pkgname, + cdict=kwargs.get('cdict', None), + exclude_binaries=self.exclude_binaries, + strip_binaries=self.strip, + upx_binaries=self.upx, + upx_exclude=self.upx_exclude, + target_arch=self.target_arch, + codesign_identity=self.codesign_identity, + entitlements_file=self.entitlements_file + ) + self.dependencies = self.pkg.dependencies + + # Get the path of the bootloader and store it in a TOC, so it can be checked for being changed. + exe = self._bootloader_file('run', '.exe' if is_win or is_cygwin else '') + self.exefiles = [(os.path.basename(exe), exe, 'EXECUTABLE')] + + self.__postinit__() + + _GUTS = ( + # input parameters + ('name', _check_guts_eq), + ('console', _check_guts_eq), + ('debug', _check_guts_eq), + ('exclude_binaries', _check_guts_eq), + ('icon', _check_guts_eq), + ('versrsrc', _check_guts_eq), + ('uac_admin', _check_guts_eq), + ('uac_uiaccess', _check_guts_eq), + ('manifest', _check_guts_eq), + ('append_pkg', _check_guts_eq), + ('argv_emulation', _check_guts_eq), + ('target_arch', _check_guts_eq), + ('codesign_identity', _check_guts_eq), + ('entitlements_file', _check_guts_eq), + # for the case the directory is shared between platforms: + ('pkgname', _check_guts_eq), + ('toc', _check_guts_eq), + ('resources', _check_guts_eq), + ('strip', _check_guts_eq), + ('upx', _check_guts_eq), + ('mtm', None), # checked below + # derived values + ('exefiles', _check_guts_toc), + ('python_lib', _check_guts_eq), + ) + + def _check_guts(self, data, last_build): + if not os.path.exists(self.name): + logger.info("Rebuilding %s because %s missing", self.tocbasename, os.path.basename(self.name)) + return True + if not self.append_pkg and not os.path.exists(self.pkgname): + logger.info("Rebuilding because %s missing", os.path.basename(self.pkgname)) + return True + + if Target._check_guts(self, data, last_build): + return True + + mtm = data['mtm'] + if mtm != miscutils.mtime(self.name): + logger.info("Rebuilding %s because mtimes don't match", self.tocbasename) + return True + if mtm < miscutils.mtime(self.pkg.tocfilename): + logger.info("Rebuilding %s because pkg is more recent", self.tocbasename) + return True + + return False + + @staticmethod + def _makeabs(path): + """ + Helper for anchoring relative paths to spec file location. + """ + from PyInstaller.config import CONF + if os.path.isabs(path): + return path + else: + return os.path.join(CONF['specpath'], path) + + def _bootloader_file(self, exe, extension=None): + """ + Pick up the right bootloader file - debug, console, windowed. + """ + # Having console/windowed bootloader makes sense only on Windows and macOS. + if is_win or is_darwin: + if not self.console: + exe = exe + 'w' + # There are two types of bootloaders: + # run - release, no verbose messages in console. + # run_d - contains verbose messages in console. + if self.debug: + exe = exe + '_d' + if extension: + exe = exe + extension + bootloader_file = os.path.join(HOMEPATH, 'PyInstaller', 'bootloader', PLATFORM, exe) + logger.info('Bootloader %s' % bootloader_file) + return bootloader_file + + def assemble(self): + # On Windows, we used to append .notanexecutable to the intermediate/temporary file name to (attempt to) + # prevent interference from anti-virus programs with the build process (see #6467). This is now disabled + # as we wrap all processing steps that modify the executable in the `_retry_operation` helper; however, + # we keep around the `build_name` variable instead of directly using `self.name`, just in case we need + # to re-enable it... + build_name = self.name + + logger.info("Building EXE from %s", self.tocbasename) + if os.path.exists(self.name): + if os.path.isdir(self.name): + _rmtree(self.name) # will prompt for confirmation if --noconfirm is not given + else: + os.remove(self.name) + if not os.path.exists(os.path.dirname(self.name)): + os.makedirs(os.path.dirname(self.name)) + bootloader_exe = self.exefiles[0][1] # pathname of bootloader + if not os.path.exists(bootloader_exe): + raise SystemExit(_MISSING_BOOTLOADER_ERRORMSG) + + # Step 1: copy the bootloader file, and perform any operations that need to be done prior to appending the PKG. + logger.info("Copying bootloader EXE to %s", build_name) + self._retry_operation(shutil.copyfile, bootloader_exe, build_name) + self._retry_operation(os.chmod, build_name, 0o755) + + if is_win: + # First, remove all resources from the file. This ensures that no manifest is embedded, even if bootloader + # was compiled with a toolchain that forcibly embeds a default manifest (e.g., mingw toolchain from msys2). + self._retry_operation(winresource.remove_all_resources, build_name) + # Embed icon. + if self.icon != "NONE": + logger.info("Copying icon to EXE") + self._retry_operation(icon.CopyIcons, build_name, self.icon) + # Embed version info. + if self.versrsrc: + logger.info("Copying version information to EXE") + self._retry_operation(versioninfo.write_version_info_to_executable, build_name, self.versrsrc) + # Embed/copy other resources. + logger.info("Copying %d resources to EXE", len(self.resources)) + for resource in self.resources: + self._retry_operation(self._copy_windows_resource, build_name, resource) + # Embed the manifest into the executable. + logger.info("Embedding manifest in EXE") + self._retry_operation(winmanifest.write_manifest_to_executable, build_name, self.manifest) + elif is_darwin: + # Convert bootloader to the target arch + logger.info("Converting EXE to target arch (%s)", self.target_arch) + osxutils.binary_to_target_arch(build_name, self.target_arch, display_name='Bootloader EXE') + + # Step 2: append the PKG, if necessary + if self.append_pkg: + append_file = self.pkg.name # Append PKG + append_type = 'PKG archive' # For debug messages + else: + # In onefile mode, copy the stand-alone PKG next to the executable. In onedir, this will be done by the + # COLLECT() target. + if not self.exclude_binaries: + pkg_dst = os.path.join(os.path.dirname(build_name), os.path.basename(self.pkgname)) + logger.info("Copying stand-alone PKG archive from %s to %s", self.pkg.name, pkg_dst) + shutil.copyfile(self.pkg.name, pkg_dst) + else: + logger.info("Stand-alone PKG archive will be handled by COLLECT") + + # The bootloader requires package side-loading to be explicitly enabled, which is done by embedding custom + # signature to the executable. This extra signature ensures that the sideload-enabled executable is at least + # slightly different from the stock bootloader executables, which should prevent antivirus programs from + # flagging our stock bootloaders due to sideload-enabled applications in the wild. + + # Write to temporary file + pkgsig_file = self.pkg.name + '.sig' + with open(pkgsig_file, "wb") as f: + # 8-byte MAGIC; slightly changed PKG MAGIC pattern + f.write(b'MEI\015\013\012\013\016') + + append_file = pkgsig_file # Append PKG-SIG + append_type = 'PKG sideload signature' # For debug messages + + if is_linux: + # Linux: append data into custom ELF section using objcopy. + logger.info("Appending %s to custom ELF section in EXE", append_type) + cmd = ['objcopy', '--add-section', f'pydata={append_file}', build_name] + p = subprocess.run(cmd, stderr=subprocess.STDOUT, stdout=subprocess.PIPE, encoding='utf-8') + if p.returncode: + raise SystemError(f"objcopy Failure: {p.returncode} {p.stdout}") + + elif is_darwin: + # macOS: remove signature, append data, and fix-up headers so that the appended data appears to be part of + # the executable (which is required by strict validation during code-signing). + + # Strip signatures from all arch slices. Strictly speaking, we need to remove signature (if present) from + # the last slice, because we will be appending data to it. When building universal2 bootloaders natively on + # macOS, only arm64 slices have a (dummy) signature. However, when cross-compiling with osxcross, we seem to + # get dummy signatures on both x86_64 and arm64 slices. While the former should not have any impact, it does + # seem to cause issues with further binary signing using real identity. Therefore, we remove all signatures + # and re-sign the binary using dummy signature once the data is appended. + logger.info("Removing signature(s) from EXE") + osxutils.remove_signature_from_binary(build_name) + + # Fix Mach-O image UUID(s) in executable to ensure uniqueness across different builds. + # NOTE: even if PKG is side-loaded, use the hash of its contents to generate the new UUID. + # NOTE: this step is performed *before* PKG is appended and sizes are fixed in the executable's headers; + # this ensures that we are operating only on original header size instead of enlarged one (which could + # be significantly larger in large onefile builds). + logger.info("Modifying Mach-O image UUID(s) in EXE") + osxutils.update_exe_identifier(build_name, self.pkg.name) + + # Append the data + logger.info("Appending %s to EXE", append_type) + self._append_data_to_exe(build_name, append_file) + + # Fix Mach-O headers + logger.info("Fixing EXE headers for code signing") + osxutils.fix_exe_for_code_signing(build_name) + else: + # Fall back to just appending data at the end of the file + logger.info("Appending %s to EXE", append_type) + self._retry_operation(self._append_data_to_exe, build_name, append_file) + + # Step 3: post-processing + if is_win: + # Set checksum to appease antiviral software. Also set build timestamp to current time to increase entropy + # (but honor SOURCE_DATE_EPOCH environment variable for reproducible builds). + logger.info("Fixing EXE headers") + build_timestamp = int(os.environ.get('SOURCE_DATE_EPOCH', time.time())) + self._retry_operation(winutils.set_exe_build_timestamp, build_name, build_timestamp) + self._retry_operation(winutils.update_exe_pe_checksum, build_name) + elif is_darwin: + # If the version of macOS SDK used to build bootloader exceeds that of macOS SDK used to built Python + # library (and, by extension, bundled Tcl/Tk libraries), force the version declared by the frozen executable + # to match that of the Python library. + # Having macOS attempt to enable new features (based on SDK version) for frozen application has no benefit + # if the Python library does not support them as well. + # On the other hand, there seem to be UI issues in tkinter due to failed or partial enablement of dark mode + # (i.e., the bootloader executable being built against SDK 10.14 or later, which causes macOS to enable dark + # mode, and Tk libraries being built against an earlier SDK version that does not support the dark mode). + # With python.org Intel macOS installers, this manifests as black Tk windows and UI elements (see issue + # #5827), while in Anaconda python, it may result in white text on bright background. + pylib_version = osxutils.get_macos_sdk_version(self.python_lib) + exe_version = osxutils.get_macos_sdk_version(build_name) + if pylib_version < exe_version: + logger.info( + "Rewriting the executable's macOS SDK version (%d.%d.%d) to match the SDK version of the Python " + "library (%d.%d.%d) in order to avoid inconsistent behavior and potential UI issues in the " + "frozen application.", *exe_version, *pylib_version + ) + osxutils.set_macos_sdk_version(build_name, *pylib_version) + + # Re-sign the binary (either ad-hoc or using real identity, if provided). + logger.info("Re-signing the EXE") + osxutils.sign_binary(build_name, self.codesign_identity, self.entitlements_file) + + # Ensure executable flag is set + self._retry_operation(os.chmod, build_name, 0o755) + # Get mtime for storing into the guts + self.mtm = self._retry_operation(miscutils.mtime, build_name) + if build_name != self.name: + self._retry_operation(os.rename, build_name, self.name) + logger.info("Building EXE from %s completed successfully.", self.tocbasename) + + def _copy_windows_resource(self, build_name, resource_spec): + import pefile + + # Helper for optionally converting integer strings to values; resource types and IDs/names can be specified as + # either numeric values or custom strings... + def _to_int(value): + try: + return int(value) + except Exception: + return value + + logger.debug("Processing resource: %r", resource_spec) + resource = resource_spec.split(",") # filename,[type],[name],[language] + + if len(resource) < 1 or len(resource) > 4: + raise ValueError( + f"Invalid Windows resource specifier {resource_spec!r}! " + f"Must be in format 'filename,[type],[name],[language]'!" + ) + + # Anchor resource file to spec file location, if necessary. + src_filename = self._makeabs(resource[0]) + + # Ensure file exists. + if not os.path.isfile(src_filename): + raise ValueError(f"Resource file {src_filename!r} does not exist!") + + # Check if src_filename points to a PE file or an arbitrary (data) file. + try: + with pefile.PE(src_filename, fast_load=True): + is_pe_file = True + except Exception: + is_pe_file = False + + if is_pe_file: + # If resource file is PE file, copy all resources from it, subject to specified type, name, and language. + logger.debug("Resource file %r is a PE file...", src_filename) + + # Resource type, name, and language serve as filters. If not specified, use "*". + resource_type = _to_int(resource[1]) if len(resource) >= 2 else "*" + resource_name = _to_int(resource[2]) if len(resource) >= 3 else "*" + resource_lang = _to_int(resource[3]) if len(resource) >= 4 else "*" + + try: + winresource.copy_resources_from_pe_file( + build_name, + src_filename, + [resource_type], + [resource_name], + [resource_lang], + ) + except Exception as e: + raise IOError(f"Failed to copy resources from PE file {src_filename!r}") from e + else: + logger.debug("Resource file %r is an arbitrary data file...", src_filename) + + # For arbitrary data file, resource type and name need to be provided. + if len(resource) < 3: + raise ValueError( + f"Invalid Windows resource specifier {resource_spec!r}! " + f"For arbitrary data file, the format is 'filename,type,name,[language]'!" + ) + + resource_type = _to_int(resource[1]) + resource_name = _to_int(resource[2]) + resource_lang = _to_int(resource[3]) if len(resource) >= 4 else 0 # LANG_NEUTRAL + + # Prohibit wildcards for resource type and name. + if resource_type == "*": + raise ValueError( + f"Invalid Windows resource specifier {resource_spec!r}! " + f"For arbitrary data file, resource type cannot be a wildcard (*)!" + ) + if resource_name == "*": + raise ValueError( + f"Invalid Windows resource specifier {resource_spec!r}! " + f"For arbitrary data file, resource ma,e cannot be a wildcard (*)!" + ) + + try: + with open(src_filename, 'rb') as fp: + data = fp.read() + + winresource.add_or_update_resource( + build_name, + data, + resource_type, + [resource_name], + [resource_lang], + ) + except Exception as e: + raise IOError(f"Failed to embed data file {src_filename!r} as Windows resource") from e + + def _append_data_to_exe(self, build_name, append_file): + with open(build_name, 'ab') as outf: + with open(append_file, 'rb') as inf: + shutil.copyfileobj(inf, outf, length=64 * 1024) + + @staticmethod + def _retry_operation(func, *args, max_attempts=20): + """ + Attempt to execute the given function `max_attempts` number of times while catching exceptions that are usually + associated with Windows anti-virus programs temporarily locking the access to the executable. + """ + def _is_allowed_exception(e): + """ + Helper to determine whether the given exception is eligible for retry or not. + """ + if isinstance(e, PermissionError): + # Always retry on all instances of PermissionError + return True + elif is_win: + from PyInstaller.compat import pywintypes + + # Windows-specific errno and winerror codes. + # https://learn.microsoft.com/en-us/cpp/c-runtime-library/errno-constants + _ALLOWED_ERRNO = { + 13, # EACCES (would typically be a PermissionError instead) + 22, # EINVAL (reported to be caused by Crowdstrike; see #7840) + } + # https://learn.microsoft.com/en-us/windows/win32/debug/system-error-codes--0-499- + _ALLOWED_WINERROR = { + 5, # ERROR_ACCESS_DENIED (reported in #7825) + 32, # ERROR_SHARING_VIOLATION (exclusive lock via `CreateFileW` flags, or via `_locked`). + 110, # ERROR_OPEN_FAILED (reported in #8138) + } + if isinstance(e, OSError): + # For OSError exceptions other than PermissionError, validate errno. + if e.errno in _ALLOWED_ERRNO: + return True + # OSError typically translates `winerror` into `errno` equivalent; but try to match the original + # values as a fall back, just in case. `OSError.winerror` attribute exists only on Windows. + if e.winerror in _ALLOWED_WINERROR: + return True + elif isinstance(e, pywintypes.error): + # pywintypes.error is raised by helper functions that use win32 C API bound via pywin32-ctypes. + if e.winerror in _ALLOWED_WINERROR: + return True + return False + + func_name = func.__name__ + for attempt in range(max_attempts): + try: + return func(*args) + except Exception as e: + # Check if exception is eligible for retry; if not, also check its immediate cause (in case the + # exception was thrown from an eligible exception). + if not _is_allowed_exception(e) and not _is_allowed_exception(e.__context__): + raise + + # Retry after sleep (unless this was our last attempt) + if attempt < max_attempts - 1: + sleep_duration = 1 / (max_attempts - 1 - attempt) + logger.warning( + f"Execution of {func_name!r} failed on attempt #{attempt + 1} / {max_attempts}: {e!r}. " + f"Retrying in {sleep_duration:.2f} second(s)..." + ) + time.sleep(sleep_duration) + else: + logger.warning( + f"Execution of {func_name!r} failed on attempt #{attempt + 1} / {max_attempts}: {e!r}." + ) + raise RuntimeError(f"Execution of {func_name!r} failed - no more attempts left!") from e + + +class COLLECT(Target): + """ + In one-dir mode creates the output folder with all necessary files. + """ + def __init__(self, *args, **kwargs): + """ + args + One or more arguments that are either an instance of `Target` or an iterable representing TOC list. + kwargs + Possible keyword arguments: + + name + The name of the directory to be built. + """ + from PyInstaller.config import CONF + + super().__init__() + + self.strip_binaries = kwargs.get('strip', False) + self.upx_exclude = kwargs.get("upx_exclude", []) + self.console = True + self.target_arch = None + self.codesign_identity = None + self.entitlements_file = None + + # UPX needs to be both available and enabled for the taget. + self.upx_binaries = CONF['upx_available'] and kwargs.get('upx', False) + + # The `name` should be the output directory name, without the parent path (the directory is created in the + # DISTPATH). Old .spec formats included parent path, so strip it away. + self.name = os.path.join(CONF['distpath'], os.path.basename(kwargs.get('name'))) + + for arg in args: + if isinstance(arg, EXE): + self.contents_directory = arg.contents_directory + break + else: + raise ValueError("No EXE() instance was passed to COLLECT()") + + self.toc = [] + for arg in args: + # Valid arguments: EXE object and TOC-like iterables + if isinstance(arg, EXE): + # Add EXE as an entry to the TOC, and merge its dependencies TOC + self.toc.append((os.path.basename(arg.name), arg.name, 'EXECUTABLE')) + self.toc.extend(arg.dependencies) + # Inherit settings + self.console = arg.console + self.target_arch = arg.target_arch + self.codesign_identity = arg.codesign_identity + self.entitlements_file = arg.entitlements_file + # Search for the executable's external manifest, and collect it if available + for dest_name, src_name, typecode in arg.toc: + if dest_name == os.path.basename(arg.name) + ".manifest": + self.toc.append((dest_name, src_name, typecode)) + # If PKG is not appended to the executable, we need to collect it. + if not arg.append_pkg: + self.toc.append((os.path.basename(arg.pkgname), arg.pkgname, 'PKG')) + elif miscutils.is_iterable(arg): + # TOC-like iterable + self.toc.extend(arg) + else: + raise TypeError(f"Invalid argument type for COLLECT: {type(arg)!r}") + + # Normalize TOC + self.toc = normalize_toc(self.toc) + + self.__postinit__() + + _GUTS = ( + # COLLECT always builds, we just want the TOC to be written out. + ('toc', None), + ) + + def _check_guts(self, data, last_build): + # COLLECT always needs to be executed, in order to clean the output directory. + return True + + def assemble(self): + _make_clean_directory(self.name) + logger.info("Building COLLECT %s", self.tocbasename) + for dest_name, src_name, typecode in self.toc: + # Ensure that the source file exists, if necessary. Skip the check for DEPENDENCY entries due to special + # contents of 'dest_name' and/or 'src_name'. Same for the SYMLINK entries, where 'src_name' is relative + # target name for symbolic link. + if typecode not in {'DEPENDENCY', 'SYMLINK'} and not os.path.exists(src_name): + # If file is contained within python egg, it will be added with the egg. + if strict_collect_mode: + raise ValueError(f"Non-existent resource {src_name}, meant to be collected as {dest_name}!") + else: + logger.warning( + "Ignoring non-existent resource %s, meant to be collected as %s", src_name, dest_name + ) + continue + # Disallow collection outside of the dist directory. + if os.pardir in os.path.normpath(dest_name).split(os.sep) or os.path.isabs(dest_name): + raise SystemExit( + 'ERROR: attempting to store file outside of the dist directory: %r. Aborting.' % dest_name + ) + # Create parent directory structure, if necessary + if typecode in ("EXECUTABLE", "PKG"): + dest_path = os.path.join(self.name, dest_name) + else: + dest_path = os.path.join(self.name, self.contents_directory or "", dest_name) + dest_dir = os.path.dirname(dest_path) + try: + os.makedirs(dest_dir, exist_ok=True) + except FileExistsError: + raise SystemExit( + f"ERROR: Pyinstaller needs to create a directory at {dest_dir!r}, " + "but there already exists a file at that path!" + ) + if typecode in ('EXTENSION', 'BINARY'): + src_name = process_collected_binary( + src_name, + dest_name, + use_strip=self.strip_binaries, + use_upx=self.upx_binaries, + upx_exclude=self.upx_exclude, + target_arch=self.target_arch, + codesign_identity=self.codesign_identity, + entitlements_file=self.entitlements_file, + strict_arch_validation=(typecode == 'EXTENSION'), + ) + if typecode == 'SYMLINK': + # On Windows, ensure that symlink target path (stored in src_name) is using Windows-style back slash + # separators. + if is_win and os.path.sep == '/': + src_name = src_name.replace(os.path.sep, '\\') + + os.symlink(src_name, dest_path) # Create link at dest_path, pointing at (relative) src_name + elif typecode != 'DEPENDENCY': + # At this point, `src_name` should be a valid file. + if not os.path.isfile(src_name): + raise ValueError(f"Resource {src_name!r} is not a valid file!") + # If strict collection mode is enabled, the destination should not exist yet. + if strict_collect_mode and os.path.exists(dest_path): + raise ValueError( + f"Attempting to collect a duplicated file into COLLECT: {dest_name} (type: {typecode})" + ) + # Use `shutil.copyfile` to copy file with default permissions. We do not attempt to preserve original + # permissions nor metadata, as they might be too restrictive and cause issues either during subsequent + # re-build attempts or when trying to move the application bundle. For binaries (and data files with + # executable bit set), we manually set the executable bits after copying the file. + shutil.copyfile(src_name, dest_path) + if ( + typecode in ('EXTENSION', 'BINARY', 'EXECUTABLE') + or (typecode == 'DATA' and os.access(src_name, os.X_OK)) + ): + os.chmod(dest_path, 0o755) + logger.info("Building COLLECT %s completed successfully.", self.tocbasename) + + +class MERGE: + """ + Given Analysis objects for multiple executables, replace occurrences of data and binary files with references to the + first executable in which they occur. The actual data and binary files are then collected only once, thereby + reducing the disk space used by multiple executables. Every executable (even onedir ones!) obtained from a + MERGE-processed Analysis gains onefile semantics, because it needs to extract its referenced dependencies from other + executables into temporary directory before they can run. + """ + def __init__(self, *args): + """ + args + Dependencies as a list of (analysis, identifier, path_to_exe) tuples. `analysis` is an instance of + `Analysis`, `identifier` is the basename of the entry-point script (without .py suffix), and `path_to_exe` + is path to the corresponding executable, relative to the `dist` directory (without .exe suffix in the + filename component). For onefile executables, `path_to_exe` is usually just executable's base name + (e.g., `myexecutable`). For onedir executables, `path_to_exe` usually comprises both the application's + directory name and executable name (e.g., `myapp/myexecutable`). + """ + self._dependencies = {} + self._symlinks = set() + + # Process all given (analysis, identifier, path_to_exe) tuples + for analysis, identifier, path_to_exe in args: + # Process analysis.binaries and analysis.datas TOCs. self._process_toc() call returns two TOCs; the first + # contains entries that remain within this analysis, while the second contains entries that reference + # an entry in another executable. + binaries, binaries_refs = self._process_toc(analysis.binaries, path_to_exe) + datas, datas_refs = self._process_toc(analysis.datas, path_to_exe) + # Update `analysis.binaries`, `analysis.datas`, and `analysis.dependencies`. + # The entries that are found in preceding executable(s) are removed from `binaries` and `datas`, and their + # DEPENDENCY entry counterparts are added to `dependencies`. We cannot simply update the entries in + # `binaries` and `datas`, because at least in theory, we need to support both onefile and onedir mode. And + # while in onefile, `a.datas`, `a.binaries`, and `a.dependencies` are passed to `EXE` (and its `PKG`), with + # onedir, `a.datas` and `a.binaries` need to be passed to `COLLECT` (as they were before the MERGE), while + # `a.dependencies` needs to be passed to `EXE`. This split requires DEPENDENCY entries to be in a separate + # TOC. + analysis.binaries = normalize_toc(binaries) + analysis.datas = normalize_toc(datas) + analysis.dependencies += binaries_refs + datas_refs + + def _process_toc(self, toc, path_to_exe): + # NOTE: unfortunately, these need to keep two separate lists. See the comment in the calling code on why this + # is so. + toc_keep = [] + toc_refs = [] + for entry in toc: + dest_name, src_name, typecode = entry + + # Special handling and bookkeeping for symbolic links. We need to account both for dest_name and src_name, + # because src_name might be the same in different contexts. For example, when collecting Qt .framework + # bundles on macOS, there are multiple relative symbolic links `Current -> A` (one in each .framework). + if typecode == 'SYMLINK': + key = dest_name, src_name + if key not in self._symlinks: + # First occurrence; keep the entry in "for-keep" TOC, same as we would for binaries and datas. + logger.debug("Keeping symbolic link %r entry in original TOC.", entry) + self._symlinks.add(key) + toc_keep.append(entry) + else: + # Subsequent occurrence; keep the SYMLINK entry intact, but add it to the references TOC instead of + # "for-keep" TOC, so it ends up in `a.dependencies`. + logger.debug("Moving symbolic link %r entry to references TOC.", entry) + toc_refs.append(entry) + del key # Block-local variable + continue + + # In fact, we need to accout for both dest_name and src_name with regular entries as well; previous + # approach that considered only src_name ended tripped up when same file was collected in different + # locations (i.e., same src_name but different dest_names). + key = dest_name, src_name + if key not in self._dependencies: + logger.debug("Adding dependency %r located in %s", key, path_to_exe) + self._dependencies[key] = path_to_exe + # Add entry to list of kept TOC entries + toc_keep.append(entry) + else: + # Construct relative dependency path; i.e., the relative path from this executable (or rather, its + # parent directory) to the executable that contains the dependency. + dep_path = os.path.relpath(self._dependencies[key], os.path.dirname(path_to_exe)) + # Ignore references that point to the origin package. This can happen if the same resource is listed + # multiple times in TOCs (e.g., once as binary and once as data). + if dep_path.endswith(path_to_exe): + logger.debug( + "Ignoring self-reference of %r for %s, located in %s - duplicated TOC entry?", key, path_to_exe, + dep_path + ) + # The entry is a duplicate, and should be ignored (i.e., do not add it to either of output TOCs). + continue + logger.debug("Referencing %r to be a dependency for %s, located in %s", key, path_to_exe, dep_path) + # Create new DEPENDENCY entry; under destination path (first element), we store the original destination + # path, while source path contains the relative reference path. + toc_refs.append((dest_name, dep_path, "DEPENDENCY")) + + return toc_keep, toc_refs + + +UNCOMPRESSED = False +COMPRESSED = True + +_MISSING_BOOTLOADER_ERRORMSG = """Fatal error: PyInstaller does not include a pre-compiled bootloader for your +platform. For more details and instructions how to build the bootloader see +""" diff --git a/venv/lib/python3.12/site-packages/PyInstaller/building/build_main.py b/venv/lib/python3.12/site-packages/PyInstaller/building/build_main.py new file mode 100755 index 0000000..ff830ff --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/building/build_main.py @@ -0,0 +1,1272 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Build packages using spec files. + +NOTE: All global variables, classes and imported modules create API for .spec files. +""" + +import glob +import os +import pathlib +import pprint +import shutil +import enum +import re +import sys + +from PyInstaller import DEFAULT_DISTPATH, DEFAULT_WORKPATH, HOMEPATH, compat +from PyInstaller import log as logging +from PyInstaller.building.api import COLLECT, EXE, MERGE, PYZ +from PyInstaller.building.datastruct import ( + TOC, Target, Tree, _check_guts_eq, normalize_toc, normalize_pyz_toc, toc_process_symbolic_links +) +from PyInstaller.building.osx import BUNDLE +from PyInstaller.building.splash import Splash +from PyInstaller.building.utils import ( + _check_guts_toc, _check_guts_toc_mtime, _should_include_system_binary, format_binaries_and_datas, compile_pymodule, + destination_name_for_extension, postprocess_binaries_toc_pywin32, postprocess_binaries_toc_pywin32_anaconda, + create_base_library_zip +) +from PyInstaller.compat import is_win, is_conda, is_darwin, is_linux +from PyInstaller.depend import bindepend +from PyInstaller.depend.analysis import initialize_modgraph, HOOK_PRIORITY_USER_HOOKS +from PyInstaller.depend.utils import scan_code_for_ctypes +from PyInstaller import isolated +from PyInstaller.utils.misc import absnormpath, get_path_to_toplevel_modules, mtime +from PyInstaller.utils.hooks import get_package_paths +from PyInstaller.utils.hooks.gi import compile_glib_schema_files + +if is_darwin: + from PyInstaller.utils import osx as osxutils + +logger = logging.getLogger(__name__) + +STRINGTYPE = type('') +TUPLETYPE = type((None,)) + +rthooks = {} + +# Place where the loader modules and initialization scripts live. +_init_code_path = os.path.join(HOMEPATH, 'PyInstaller', 'loader') + +IMPORT_TYPES = [ + 'top-level', 'conditional', 'delayed', 'delayed, conditional', 'optional', 'conditional, optional', + 'delayed, optional', 'delayed, conditional, optional' +] + +WARNFILE_HEADER = """\ + +This file lists modules PyInstaller was not able to find. This does not +necessarily mean this module is required for running your program. Python and +Python 3rd-party packages include a lot of conditional or optional modules. For +example the module 'ntpath' only exists on Windows, whereas the module +'posixpath' only exists on Posix systems. + +Types if import: +* top-level: imported at the top-level - look at these first +* conditional: imported within an if-statement +* delayed: imported within a function +* optional: imported within a try-except-statement + +IMPORTANT: Do NOT post this list to the issue-tracker. Use it as a basis for + tracking down the missing module yourself. Thanks! + +""" + + +@isolated.decorate +def discover_hook_directories(): + """ + Discover hook directories via pyinstaller40 entry points. Perform the discovery in an isolated subprocess + to avoid importing the package(s) in the main process. + + :return: list of discovered hook directories. + """ + + from traceback import format_exception_only + from PyInstaller.log import logger + from PyInstaller.compat import importlib_metadata + from PyInstaller.depend.analysis import HOOK_PRIORITY_CONTRIBUTED_HOOKS, HOOK_PRIORITY_UPSTREAM_HOOKS + + # The “selectable” entry points (via group and name keyword args) were introduced in importlib_metadata 4.6 and + # Python 3.10. The compat module ensures we are using a compatible version. + entry_points = importlib_metadata.entry_points(group='pyinstaller40', name='hook-dirs') + + # Ensure that pyinstaller_hooks_contrib comes last so that hooks from packages providing their own take priority. + # In pyinstaller-hooks-contrib >= 2024.8, the entry-point module is `_pyinstaller_hooks_contrib`; in earlier + # versions, it was `_pyinstaller_hooks_contrib.hooks`. + entry_points = sorted(entry_points, key=lambda x: x.module.startswith("_pyinstaller_hooks_contrib")) + + hook_directories = [] + for entry_point in entry_points: + # Query hook directory location(s) from entry point + try: + hook_directory_entries = entry_point.load()() + except Exception as e: + msg = "".join(format_exception_only(type(e), e)).strip() + logger.warning("discover_hook_directories: Failed to process hook entry point '%s': %s", entry_point, msg) + continue + + # Determine location-based priority: upstream hooks vs. hooks from contributed hooks package. + location_priority = ( + HOOK_PRIORITY_CONTRIBUTED_HOOKS + if entry_point.module.startswith("_pyinstaller_hooks_contrib") else HOOK_PRIORITY_UPSTREAM_HOOKS + ) + + # Append entries + hook_directories.extend([(hook_directory_entry, location_priority) + for hook_directory_entry in hook_directory_entries]) + + logger.debug("discover_hook_directories: Hook directories: %s", hook_directories) + + return hook_directories + + +def find_binary_dependencies(binaries, import_packages, symlink_suppression_patterns): + """ + Find dynamic dependencies (linked shared libraries) for the provided list of binaries. + + On Windows, this function performs additional pre-processing in an isolated environment in an attempt to handle + dynamic library search path modifications made by packages during their import. The packages from the given list + of collected packages are imported one by one, while keeping track of modifications made by `os.add_dll_directory` + calls and additions to the `PATH` environment variable. The recorded additional search paths are then passed to + the binary dependency analysis step. + + binaries + List of binaries to scan for dynamic dependencies. + import_packages + List of packages to import prior to scanning binaries. + symlink_suppression_patterns + Set of paths and/or path patterns for which binary dependency analysis should not create symbolic links + to the top-level application directory (when the discovered shared library's parent directory structure + is preserved). When binary dependency analysis discovers a shared library, it matches its *source path* + against all symlink suppression patterns (using `pathlib.PurePath.match`) to determine whether to create + a symbolic link to top-level application directory or not. + + :return: expanded list of binaries and then dependencies. + """ + + # Extra library search paths (used on Windows to resolve DLL paths). + extra_libdirs = [] + if compat.is_win: + # Always search `sys.base_prefix`, and search it first. This ensures that we resolve the correct version of + # `python3X.dll` and `python3.dll` (a PEP-0384 stable ABI stub that forwards symbols to the fully versioned + # `python3X.dll`), regardless of other python installations that might be present in the PATH. + extra_libdirs.append(compat.base_prefix) + + # When using python built from source, `sys.base_prefix` does not point to the directory that contains python + # executable, `python3X.dll`, and `python3.dll`. To accommodate such case, also add the directory in which + # python executable is located to the extra search paths. On the off-chance that this is a combination of venv + # and python built from source, prefer `sys._base_executable` over `sys.executable`. + extra_libdirs.append(os.path.dirname(getattr(sys, '_base_executable', sys.executable))) + + # If `pywin32` is installed, resolve the path to the `pywin32_system32` directory. Most `pywin32` extensions + # reference the `pywintypes3X.dll` in there. Based on resolved `pywin32_system32` directory, also add other + # `pywin32` directory, in case extensions in different directories reference each other (the ones in the same + # directory should already be resolvable due to binary dependency analysis passing the analyzed binary's + # location to the `get_imports` function). This allows us to avoid searching all paths in `sys.path`, which + # may lead to other corner-case issues (e.g., #5560). + pywin32_system32_dir = None + try: + # Look up the directory by treating it as a namespace package. + _, pywin32_system32_dir = get_package_paths('pywin32_system32') + except Exception: + pass + + if pywin32_system32_dir: + pywin32_base_dir = os.path.dirname(pywin32_system32_dir) + extra_libdirs += [ + pywin32_system32_dir, # .../pywin32_system32 + # based on pywin32.pth + os.path.join(pywin32_base_dir, 'win32'), # .../win32 + os.path.join(pywin32_base_dir, 'win32', 'lib'), # .../win32/lib + os.path.join(pywin32_base_dir, 'Pythonwin'), # .../Pythonwin + ] + + # On Windows, packages' initialization code might register additional DLL search paths, either by modifying the + # `PATH` environment variable, or by calling `os.add_dll_directory`. Therefore, we import all collected packages, + # and track changes made to the environment. + if compat.is_win: + # Helper functions to be executed in isolated environment. + def setup(suppressed_imports): + """ + Prepare environment for change tracking + """ + import os + import sys + + os._added_dll_directories = [] + os._original_path_env = os.environ.get('PATH', '') + + _original_add_dll_directory = os.add_dll_directory + + def _pyi_add_dll_directory(path): + os._added_dll_directories.append(path) + return _original_add_dll_directory(path) + + os.add_dll_directory = _pyi_add_dll_directory + + # Suppress import of specified packages + for name in suppressed_imports: + sys.modules[name] = None + + def import_library(package): + """ + Import collected package to set up environment. + """ + try: + __import__(package) + except Exception: + pass + + def process_search_paths(): + """ + Obtain lists of added search paths. + """ + import os + + # `os.add_dll_directory` might be called with a `pathlib.Path`, which cannot be marhsalled out of the helper + # process. So explicitly convert all entries to strings. + dll_directories = [str(path) for path in os._added_dll_directories] + + orig_path = set(os._original_path_env.split(os.pathsep)) + modified_path = os.environ.get('PATH', '').split(os.pathsep) + path_additions = [path for path in modified_path if path and path not in orig_path] + + return dll_directories, path_additions + + # Pre-process the list of packages to import. + # Check for Qt bindings packages, and put them at the front of the packages list. This ensures that they are + # always imported first, which should prevent packages that support multiple bindings (`qtypy`, `pyqtgraph`, + # `matplotlib`, etc.) from trying to auto-select bindings. + _QT_BINDINGS = ('PySide2', 'PyQt5', 'PySide6', 'PyQt6') + + qt_packages = [] + other_packages = [] + for package in import_packages: + if package.startswith(_QT_BINDINGS): + qt_packages.append(package) + else: + other_packages.append(package) + import_packages = qt_packages + other_packages + + # Just in case, explicitly suppress imports of Qt bindings that we are *not* collecting - if multiple bindings + # are available and some were excluded from our analysis, a package imported here might still try to import an + # excluded bindings package (and succeed at doing so). + suppressed_imports = [package for package in _QT_BINDINGS if package not in qt_packages] + + # If we suppressed PySide2 or PySide6, we must also suppress their corresponding shiboken package + if "PySide2" in suppressed_imports: + suppressed_imports += ["shiboken2"] + if "PySide6" in suppressed_imports: + suppressed_imports += ["shiboken6"] + + # Suppress import of `pyqtgraph.canvas`, which is known to crash python interpreter. See #7452 and #8322, as + # well as https://github.com/pyqtgraph/pyqtgraph/issues/2838. + suppressed_imports += ['pyqtgraph.canvas'] + + # PySimpleGUI 5.x displays a "first-run" dialog when imported for the first time, which blocks the loop below. + # This is a problem for building on CI, where the dialog cannot be closed, and where PySimpleGUI runs "for the + # first time" every time. See #8396. + suppressed_imports += ['PySimpleGUI'] + + # Processing in isolated environment. + with isolated.Python() as child: + child.call(setup, suppressed_imports) + for package in import_packages: + try: + child.call(import_library, package) + except isolated.SubprocessDiedError as e: + # Re-raise as `isolated.SubprocessDiedError` again, to trigger error-handling codepath in + # `isolated.Python.__exit__()`. + raise isolated.SubprocessDiedError( + f"Isolated subprocess crashed while importing package {package!r}! " + f"Package import list: {import_packages!r}" + ) from e + added_dll_directories, added_path_directories = child.call(process_search_paths) + + # Process extra search paths... + logger.info("Extra DLL search directories (AddDllDirectory): %r", added_dll_directories) + extra_libdirs += added_dll_directories + + logger.info("Extra DLL search directories (PATH): %r", added_path_directories) + extra_libdirs += added_path_directories + + # Deduplicate search paths + # NOTE: `list(set(extra_libdirs))` does not preserve the order of search paths (which matters here), so we need to + # de-duplicate using `list(dict.fromkeys(extra_libdirs).keys())` instead. + extra_libdirs = list(dict.fromkeys(extra_libdirs).keys()) + + # Search for dependencies of the given binaries + return bindepend.binary_dependency_analysis( + binaries, + search_paths=extra_libdirs, + symlink_suppression_patterns=symlink_suppression_patterns, + ) + + +class _ModuleCollectionMode(enum.IntFlag): + """ + Module collection mode flags. + """ + PYZ = enum.auto() # Collect byte-compiled .pyc into PYZ archive + PYC = enum.auto() # Collect byte-compiled .pyc as external data file + PY = enum.auto() # Collect source .py file as external data file + + +_MODULE_COLLECTION_MODES = { + "pyz": _ModuleCollectionMode.PYZ, + "pyc": _ModuleCollectionMode.PYC, + "py": _ModuleCollectionMode.PY, + "pyz+py": _ModuleCollectionMode.PYZ | _ModuleCollectionMode.PY, + "py+pyz": _ModuleCollectionMode.PYZ | _ModuleCollectionMode.PY, +} + + +def _get_module_collection_mode(mode_dict, name, noarchive=False): + """ + Determine the module/package collection mode for the given module name, based on the provided collection + mode settings dictionary. + """ + # Default mode: collect into PYZ, unless noarchive is enabled. In that case, collect as pyc. + mode_flags = _ModuleCollectionMode.PYC if noarchive else _ModuleCollectionMode.PYZ + + # If we have no collection mode settings, end here and now. + if not mode_dict: + return mode_flags + + # Search the parent modules/packages in top-down fashion, and take the last given setting. This ensures that + # a setting given for the top-level package is recursively propagated to all its subpackages and submodules, + # but also allows individual sub-modules to override the setting again. + mode = 'pyz' + + name_parts = name.split('.') + for i in range(len(name_parts)): + modlevel = ".".join(name_parts[:i + 1]) + modlevel_mode = mode_dict.get(modlevel, None) + if modlevel_mode is not None: + mode = modlevel_mode + + # Convert mode string to _ModuleCollectionMode flags + try: + mode_flags = _MODULE_COLLECTION_MODES[mode] + except KeyError: + raise ValueError(f"Unknown module collection mode for {name!r}: {mode!r}!") + + # noarchive flag being set means that we need to change _ModuleCollectionMode.PYZ into _ModuleCollectionMode.PYC + if noarchive and _ModuleCollectionMode.PYZ in mode_flags: + mode_flags ^= _ModuleCollectionMode.PYZ + mode_flags |= _ModuleCollectionMode.PYC + + return mode_flags + + +class Analysis(Target): + """ + Class that performs analysis of the user's main Python scripts. + + An Analysis contains multiple TOC (Table of Contents) lists, accessed as attributes of the analysis object. + + scripts + The scripts you gave Analysis as input, with any runtime hook scripts prepended. + pure + The pure Python modules. + binaries + The extension modules and their dependencies. + datas + Data files collected from packages. + zipfiles + Deprecated - always empty. + zipped_data + Deprecated - always empty. + """ + _old_scripts = { + absnormpath(os.path.join(HOMEPATH, "support", "_mountzlib.py")), + absnormpath(os.path.join(HOMEPATH, "support", "useUnicode.py")), + absnormpath(os.path.join(HOMEPATH, "support", "useTK.py")), + absnormpath(os.path.join(HOMEPATH, "support", "unpackTK.py")), + absnormpath(os.path.join(HOMEPATH, "support", "removeTK.py")) + } + + def __init__( + self, + scripts, + pathex=None, + binaries=None, + datas=None, + hiddenimports=None, + hookspath=None, + hooksconfig=None, + excludes=None, + runtime_hooks=None, + cipher=None, + win_no_prefer_redirects=False, + win_private_assemblies=False, + noarchive=False, + module_collection_mode=None, + optimize=-1, + **_kwargs, + ): + """ + scripts + A list of scripts specified as file names. + pathex + An optional list of paths to be searched before sys.path. + binaries + An optional list of additional binaries (dlls, etc.) to include. + datas + An optional list of additional data files to include. + hiddenimport + An optional list of additional (hidden) modules to include. + hookspath + An optional list of additional paths to search for hooks. (hook-modules). + hooksconfig + An optional dict of config settings for hooks. (hook-modules). + excludes + An optional list of module or package names (their Python names, not path names) that will be + ignored (as though they were not found). + runtime_hooks + An optional list of scripts to use as users' runtime hooks. Specified as file names. + cipher + Deprecated. Raises an error if not None. + win_no_prefer_redirects + Deprecated. Raises an error if not False. + win_private_assemblies + Deprecated. Raises an error if not False. + noarchive + If True, do not place source files in a archive, but keep them as individual files. + module_collection_mode + An optional dict of package/module names and collection mode strings. Valid collection mode strings: + 'pyz' (default), 'pyc', 'py', 'pyz+py' (or 'py+pyz') + optimize + Optimization level for collected bytecode. If not specified or set to -1, it is set to the value of + `sys.flags.optimize` of the running build process. + """ + if cipher is not None: + from PyInstaller.exceptions import RemovedCipherFeatureError + raise RemovedCipherFeatureError( + "Please remove the 'cipher' arguments to PYZ() and Analysis() in your spec file." + ) + if win_no_prefer_redirects: + from PyInstaller.exceptions import RemovedWinSideBySideSupportError + raise RemovedWinSideBySideSupportError( + "Please remove the 'win_no_prefer_redirects' argument to Analysis() in your spec file." + ) + if win_private_assemblies: + from PyInstaller.exceptions import RemovedWinSideBySideSupportError + raise RemovedWinSideBySideSupportError( + "Please remove the 'win_private_assemblies' argument to Analysis() in your spec file." + ) + super().__init__() + from PyInstaller.config import CONF + + self.inputs = [] + spec_dir = os.path.dirname(CONF['spec']) + for script in scripts: + # If path is relative, it is relative to the location of .spec file. + if not os.path.isabs(script): + script = os.path.join(spec_dir, script) + if absnormpath(script) in self._old_scripts: + logger.warning('Ignoring obsolete auto-added script %s', script) + continue + # Normalize script path. + script = os.path.normpath(script) + if not os.path.exists(script): + raise SystemExit("ERROR: script '%s' not found" % script) + self.inputs.append(script) + + # Django hook requires this variable to find the script manage.py. + CONF['main_script'] = self.inputs[0] + + site_packages_pathex = [] + for path in (pathex or []): + if pathlib.Path(path).name == "site-packages": + site_packages_pathex.append(str(path)) + if site_packages_pathex: + logger.log( + logging.DEPRECATION, "Foreign Python environment's site-packages paths added to --paths/pathex:\n%s\n" + "This is ALWAYS the wrong thing to do. If your environment's site-packages is not in PyInstaller's " + "module search path then you are running PyInstaller from a different environment to the one your " + "packages are in. Run print(sys.prefix) without PyInstaller to get the environment you should be using " + "then install and run PyInstaller from that environment instead of this one. This warning will become " + "an error in PyInstaller 7.0.", pprint.pformat(site_packages_pathex) + ) + + self.pathex = self._extend_pathex(pathex, self.inputs) + # Set global config variable 'pathex' to make it available for PyInstaller.utils.hooks and import hooks. Path + # extensions for module search. + CONF['pathex'] = self.pathex + # Extend sys.path so PyInstaller could find all necessary modules. + sys.path.extend(self.pathex) + logger.info('Module search paths (PYTHONPATH):\n' + pprint.pformat(sys.path)) + + self.hiddenimports = hiddenimports or [] + # Include hidden imports passed via CONF['hiddenimports']; these might be populated if user has a wrapper script + # that calls `build_main.main()` with custom `pyi_config` dictionary that contains `hiddenimports`. + self.hiddenimports.extend(CONF.get('hiddenimports', [])) + + for modnm in self.hiddenimports: + if re.search(r"[\\/]", modnm): + raise SystemExit( + f"ERROR: Invalid hiddenimport '{modnm}'. Hidden imports should be importable module names – not " + "file paths. i.e. use --hiddenimport=foo.bar instead of --hiddenimport=.../site-packages/foo/bar.py" + ) + + self.hookspath = [] + # Prepend directories in `hookspath` (`--additional-hooks-dir`) to take precedence over those from the entry + # points. Expand starting tilde into user's home directory, as a work-around for tilde not being expanded by + # shell when using `--additional-hooks-dir=~/path/abc` instead of `--additional-hooks-dir ~/path/abc` (or when + # the path argument is quoted). + if hookspath: + self.hookspath.extend([(os.path.expanduser(path), HOOK_PRIORITY_USER_HOOKS) for path in hookspath]) + + # Add hook directories from PyInstaller entry points. + self.hookspath += discover_hook_directories() + + self.hooksconfig = {} + if hooksconfig: + self.hooksconfig.update(hooksconfig) + + # Custom runtime hook files that should be included and started before any existing PyInstaller runtime hooks. + self.custom_runtime_hooks = runtime_hooks or [] + + self._input_binaries = [] + self._input_datas = [] + + self.excludes = excludes or [] + self.scripts = [] + self.pure = [] + self.binaries = [] + self.zipfiles = [] + self.zipped_data = [] + self.datas = [] + self.dependencies = [] + self._python_version = sys.version + self.noarchive = noarchive + self.module_collection_mode = module_collection_mode or {} + self.optimize = sys.flags.optimize if optimize in {-1, None} else optimize + + self._modules_outside_pyz = [] + + # Validate the optimization level to avoid errors later on... + if self.optimize not in {0, 1, 2}: + raise ValueError(f"Unsupported bytecode optimization level: {self.optimize!r}") + + # Expand the `binaries` and `datas` lists specified in the .spec file, and ensure that the lists are normalized + # and sorted before guts comparison. + # + # While we use these lists to initialize `Analysis.binaries` and `Analysis.datas`, at this point, we need to + # store them in separate variables, which undergo *full* guts comparison (`_check_guts_toc`) as opposed to + # just mtime-based comparison (`_check_guts_toc_mtime`). Changes to these initial list *must* trigger a rebuild + # (and due to the way things work, a re-analysis), otherwise user might end up with a cached build that fails to + # reflect the changes. + if binaries: + logger.info("Appending 'binaries' from .spec") + self._input_binaries = [(dest_name, src_name, 'BINARY') + for dest_name, src_name in format_binaries_and_datas(binaries, workingdir=spec_dir)] + self._input_binaries = sorted(normalize_toc(self._input_binaries)) + + if datas: + logger.info("Appending 'datas' from .spec") + self._input_datas = [(dest_name, src_name, 'DATA') + for dest_name, src_name in format_binaries_and_datas(datas, workingdir=spec_dir)] + self._input_datas = sorted(normalize_toc(self._input_datas)) + + self.__postinit__() + + _GUTS = ( # input parameters + ('inputs', _check_guts_eq), # parameter `scripts` + ('pathex', _check_guts_eq), + ('hiddenimports', _check_guts_eq), + ('hookspath', _check_guts_eq), + ('hooksconfig', _check_guts_eq), + ('excludes', _check_guts_eq), + ('custom_runtime_hooks', _check_guts_eq), + ('noarchive', _check_guts_eq), + ('module_collection_mode', _check_guts_eq), + ('optimize', _check_guts_eq), + + ('_input_binaries', _check_guts_toc), + ('_input_datas', _check_guts_toc), + + # calculated/analysed values + ('_python_version', _check_guts_eq), + ('scripts', _check_guts_toc_mtime), + ('pure', _check_guts_toc_mtime), + ('binaries', _check_guts_toc_mtime), + ('zipfiles', _check_guts_toc_mtime), + ('zipped_data', None), # TODO check this, too + ('datas', _check_guts_toc_mtime), + # TODO: Need to add "dependencies"? + + ('_modules_outside_pyz', _check_guts_toc_mtime), + ) + + def _extend_pathex(self, spec_pathex, scripts): + """ + Normalize additional paths where PyInstaller will look for modules and add paths with scripts to the list of + paths. + + :param spec_pathex: Additional paths defined defined in .spec file. + :param scripts: Scripts to create executable from. + :return: list of updated paths + """ + # Based on main supplied script - add top-level modules directory to PYTHONPATH. + # Sometimes the main app script is not top-level module but submodule like 'mymodule.mainscript.py'. + # In that case PyInstaller will not be able find modules in the directory containing 'mymodule'. + # Add this directory to PYTHONPATH so PyInstaller could find it. + pathex = [] + # Add scripts paths first. + for script in scripts: + logger.debug('script: %s' % script) + script_toplevel_dir = get_path_to_toplevel_modules(script) + if script_toplevel_dir: + pathex.append(script_toplevel_dir) + # Append paths from .spec. + if spec_pathex is not None: + pathex.extend(spec_pathex) + # Normalize paths in pathex and make them absolute. + return list(dict.fromkeys(absnormpath(p) for p in pathex)) + + def _check_guts(self, data, last_build): + if Target._check_guts(self, data, last_build): + return True + for filename in self.inputs: + if mtime(filename) > last_build: + logger.info("Building because %s changed", filename) + return True + # Now we know that none of the input parameters and none of the input files has changed. So take the values + # that were calculated / analyzed in the last run and store them in `self`. These TOC lists should already + # be normalized. + self.scripts = data['scripts'] + self.pure = data['pure'] + self.binaries = data['binaries'] + self.zipfiles = data['zipfiles'] + self.zipped_data = data['zipped_data'] + self.datas = data['datas'] + + return False + + def assemble(self): + """ + This method is the MAIN method for finding all necessary files to be bundled. + """ + from PyInstaller.config import CONF + + # Search for python shared library, which we need to collect into frozen application. Do this as the very + # first step, to minimize the amount of processing when the shared library cannot be found. + logger.info('Looking for Python shared library...') + python_lib = bindepend.get_python_library_path() # Raises PythonLibraryNotFoundError + logger.info('Using Python shared library: %s', python_lib) + + logger.info("Running Analysis %s", self.tocbasename) + logger.info("Target bytecode optimization level: %d", self.optimize) + + for m in self.excludes: + logger.debug("Excluding module '%s'" % m) + self.graph = initialize_modgraph(excludes=self.excludes, user_hook_dirs=self.hookspath) + + # Initialize `binaries` and `datas` with `_input_binaries` and `_input_datas`. Make sure to copy the lists + # to prevent modifications of original lists, which we need to store in original form for guts comparison. + self.datas = [entry for entry in self._input_datas] + self.binaries = [entry for entry in self._input_binaries] + + # Expand sys.path of module graph. The attribute is the set of paths to use for imports: sys.path, plus our + # loader, plus other paths from e.g. --path option). + self.graph.path = self.pathex + self.graph.path + + # Scan for legacy namespace packages. + self.graph.scan_legacy_namespace_packages() + + # Add python shared library to `binaries`. + if is_darwin and osxutils.is_framework_bundle_lib(python_lib): + # If python library is located in macOS .framework bundle, collect the bundle, and create symbolic link to + # top-level directory. + src_path = pathlib.PurePath(python_lib) + dst_path = pathlib.PurePath(src_path.relative_to(src_path.parent.parent.parent.parent)) + self.binaries.append((str(dst_path), str(src_path), 'BINARY')) + self.binaries.append((os.path.basename(python_lib), str(dst_path), 'SYMLINK')) + else: + self.binaries.append((os.path.basename(python_lib), python_lib, 'BINARY')) + + # -- Module graph. -- + # + # Construct the module graph of import relationships between modules required by this user's application. For + # each entry point (top-level user-defined Python script), all imports originating from this entry point are + # recursively parsed into a subgraph of the module graph. This subgraph is then connected to this graph's root + # node, ensuring imported module nodes will be reachable from the root node -- which is is (arbitrarily) chosen + # to be the first entry point's node. + + # List of graph nodes corresponding to program scripts. + program_scripts = [] + + # Assume that if the script does not exist, Modulegraph will raise error. Save the graph nodes of each in + # sequence. + for script in self.inputs: + logger.info("Analyzing %s", script) + program_scripts.append(self.graph.add_script(script)) + + # Analyze the script's hidden imports (named on the command line) + self.graph.add_hiddenimports(self.hiddenimports) + + # -- Post-graph hooks. -- + self.graph.process_post_graph_hooks(self) + + # Update 'binaries' and 'datas' TOC lists with entries collected from hooks. + self.binaries += self.graph.make_hook_binaries_toc() + self.datas += self.graph.make_hook_datas_toc() + + # We do not support zipped eggs anymore (PyInstaller v6.0), so `zipped_data` and `zipfiles` are always empty. + self.zipped_data = [] + self.zipfiles = [] + + # -- Automatic binary vs. data reclassification. -- + # + # At this point, `binaries` and `datas` contain TOC entries supplied by user via input arguments, and by hooks + # that were ran during the analysis. Neither source can be fully trusted regarding the DATA vs BINARY + # classification (no thanks to our hookutils not being 100% reliable, either!). Therefore, inspect the files and + # automatically reclassify them as necessary. + # + # The proper classification is important especially for collected binaries - to ensure that they undergo binary + # dependency analysis and platform-specific binary processing. On macOS, the .app bundle generation code also + # depends on files to be properly classified. + # + # For entries added to `binaries` and `datas` after this point, we trust their typecodes due to the nature of + # their origin. + combined_toc = normalize_toc(self.datas + self.binaries) + + logger.info('Performing binary vs. data reclassification (%d entries)', len(combined_toc)) + + self.datas = [] + self.binaries = [] + + for dest_name, src_name, typecode in combined_toc: + # Returns 'BINARY' or 'DATA', or None if file cannot be classified. + detected_typecode = bindepend.classify_binary_vs_data(src_name) + if detected_typecode is not None: + if detected_typecode != typecode: + logger.debug( + "Reclassifying collected file %r from %s to %s...", src_name, typecode, detected_typecode + ) + typecode = detected_typecode + + # Put back into corresponding TOC list. + if typecode in {'BINARY', 'EXTENSION'}: + self.binaries.append((dest_name, src_name, typecode)) + else: + self.datas.append((dest_name, src_name, typecode)) + + # -- Look for dlls that are imported by Python 'ctypes' module. -- + # First get code objects of all modules that import 'ctypes'. + logger.info('Looking for ctypes DLLs') + # dict like: {'module1': code_obj, 'module2': code_obj} + ctypes_code_objs = self.graph.get_code_using("ctypes") + + for name, co in ctypes_code_objs.items(): + # Get dlls that might be needed by ctypes. + logger.debug('Scanning %s for ctypes-based references to shared libraries', name) + try: + ctypes_binaries = scan_code_for_ctypes(co) + # As this scan happens after automatic binary-vs-data classification, we need to validate the binaries + # ourselves, just in case. + for dest_name, src_name, typecode in set(ctypes_binaries): + # Allow for `None` in case re-classification is not supported on the given platform. + if bindepend.classify_binary_vs_data(src_name) not in (None, 'BINARY'): + logger.warning("Ignoring %s found via ctypes - not a valid binary!", src_name) + continue + self.binaries.append((dest_name, src_name, typecode)) + except Exception as ex: + raise RuntimeError(f"Failed to scan the module '{name}'. This is a bug. Please report it.") from ex + + self.datas.extend((dest, source, "DATA") + for (dest, source) in format_binaries_and_datas(self.graph.metadata_required())) + + # Analyze run-time hooks. + rhtook_scripts = self.graph.analyze_runtime_hooks(self.custom_runtime_hooks) + + # -- Extract the nodes of the graph as TOCs for further processing. -- + + # Initialize the scripts list: run-time hooks (custom ones, followed by regular ones), followed by program + # script(s). + + # We do not optimize bytecode of run-time hooks. + rthook_toc = self.graph.nodes_to_toc(rhtook_scripts) + + # Override the typecode of program script(s) to include bytecode optimization level. + program_toc = self.graph.nodes_to_toc(program_scripts) + optim_typecode = {0: 'PYSOURCE', 1: 'PYSOURCE-1', 2: 'PYSOURCE-2'}[self.optimize] + program_toc = [(name, src_path, optim_typecode) for name, src_path, typecode in program_toc] + + self.scripts = rthook_toc + program_toc + self.scripts = normalize_toc(self.scripts) # Should not really contain duplicates, but just in case... + + # Extend the binaries list with all the Extensions modulegraph has found. + self.binaries += self.graph.make_binaries_toc() + + # Convert extension module names into full filenames, and append suffix. Ensure that extensions that come from + # the lib-dynload are collected into _MEIPASS/python3.x/lib-dynload instead of directly into _MEIPASS. + for idx, (dest, source, typecode) in enumerate(self.binaries): + if typecode != 'EXTENSION': + continue + dest = destination_name_for_extension(dest, source, typecode) + self.binaries[idx] = (dest, source, typecode) + + # Perform initial normalization of `datas` and `binaries` + self.datas = normalize_toc(self.datas) + self.binaries = normalize_toc(self.binaries) + + # Post-process GLib schemas + self.datas = compile_glib_schema_files(self.datas, os.path.join(CONF['workpath'], "_pyi_gschema_compilation")) + self.datas = normalize_toc(self.datas) + + # Process the pure-python modules list. Depending on the collection mode, these entries end up either in "pure" + # list for collection into the PYZ archive, or in the "datas" list for collection as external data files. + assert len(self.pure) == 0 + pure_pymodules_toc = self.graph.make_pure_toc() + + # Merge package collection mode settings from .spec file. These are applied last, so they override the + # settings previously applied by hooks. + self.graph._module_collection_mode.update(self.module_collection_mode) + logger.debug("Module collection settings: %r", self.graph._module_collection_mode) + + # If target bytecode optimization level matches the run-time bytecode optimization level (i.e., of the running + # build process), we can re-use the modulegraph's code-object cache. + if self.optimize == sys.flags.optimize: + logger.debug( + "Target optimization level %d matches run-time optimization level %d - using modulegraph's code-object " + "cache.", + self.optimize, + sys.flags.optimize, + ) + code_cache = self.graph.get_code_objects() + else: + logger.debug( + "Target optimization level %d differs from run-time optimization level %d - ignoring modulegraph's " + "code-object cache.", + self.optimize, + sys.flags.optimize, + ) + code_cache = None + + # Construct a set for look-up of modules that should end up in base_library.zip. The list of corresponding + # modulegraph nodes is stored in `PyiModuleGraph._base_modules` (see `PyiModuleGraph._analyze_base_modules`). + base_modules = set(node.identifier for node in self.graph._base_modules) + base_modules_toc = [] + + pycs_dir = os.path.join(CONF['workpath'], 'localpycs') + optim_level = self.optimize # We could extend this with per-module settings, similar to `collect_mode`. + for name, src_path, typecode in pure_pymodules_toc: + assert typecode == 'PYMODULE' + collect_mode = _get_module_collection_mode(self.graph._module_collection_mode, name, self.noarchive) + + # Collect byte-compiled .pyc into PYZ archive or base_library.zip. Embed optimization level into typecode. + in_pyz = False + if _ModuleCollectionMode.PYZ in collect_mode: + optim_typecode = {0: 'PYMODULE', 1: 'PYMODULE-1', 2: 'PYMODULE-2'}[optim_level] + toc_entry = (name, src_path, optim_typecode) + if name in base_modules: + base_modules_toc.append(toc_entry) + else: + self.pure.append(toc_entry) + in_pyz = True + + # If module is not collected into PYZ archive (and is consequently not tracked in the `self.pure` TOC list), + # add it to the `self._modules_outside_pyz` TOC list, in order to be able to detect modifications in those + # modules. + if not in_pyz: + self._modules_outside_pyz.append((name, src_path, typecode)) + + # Pure namespace packages have no source path, and cannot be collected as external data file. + if src_path in (None, '-'): + continue + + # Collect source .py file as external data file + if _ModuleCollectionMode.PY in collect_mode: + basename, ext = os.path.splitext(os.path.basename(src_path)) + # If the module is available only as a byte-compiled .pyc, we cannot collect its source. + if ext.lower() == '.pyc': + logger.warning( + 'Cannot collect source .py file for module %r - module is available only as .pyc: %r', + name, + src_path, + ) + continue + dest_path = name.replace('.', os.sep) + if basename == '__init__': + dest_path += os.sep + '__init__' + ext + else: + dest_path += ext + self.datas.append((dest_path, src_path, "DATA")) + + # Collect byte-compiled .pyc file as external data file + if _ModuleCollectionMode.PYC in collect_mode: + basename, ext = os.path.splitext(os.path.basename(src_path)) + dest_path = name.replace('.', os.sep) + if basename == '__init__': + dest_path += os.sep + '__init__' + # Append the extension for the compiled result. In python 3.5 (PEP-488) .pyo files were replaced by + # .opt-1.pyc and .opt-2.pyc. However, it seems that for bytecode-only module distribution, we always + # need to use the .pyc extension. + dest_path += '.pyc' + + # Compile - use optimization-level-specific sub-directory in local working directory. + obj_path = compile_pymodule( + name, + src_path, + workpath=os.path.join(pycs_dir, str(optim_level)), + optimize=optim_level, + code_cache=code_cache, + ) + + self.datas.append((dest_path, obj_path, "DATA")) + + # Construct base_library.zip, if applicable (the only scenario where it is not is if we are building with + # noarchive mode). Always remove the file before the build. + base_library_zip = os.path.join(CONF['workpath'], 'base_library.zip') + if os.path.exists(base_library_zip): + os.remove(base_library_zip) + if base_modules_toc: + logger.info('Creating %s...', os.path.basename(base_library_zip)) + create_base_library_zip(base_library_zip, base_modules_toc, code_cache) + self.datas.append((os.path.basename(base_library_zip), base_library_zip, 'DATA')) # Bundle as data file. + + # Normalize list of pure-python modules (these will end up in PYZ archive, so use specific normalization). + self.pure = normalize_pyz_toc(self.pure) + + # Associate the `pure` TOC list instance with code cache in the global `CONF`; this is used by `PYZ` writer + # to obtain modules' code from cache instead + # + # (NOTE: back when `pure` was an instance of `TOC` class, the code object was passed by adding an attribute + # to the `pure` itself; now that `pure` is plain `list`, we cannot do that anymore. But the association via + # object ID should have the same semantics as the added attribute). + from PyInstaller.config import CONF + global_code_cache_map = CONF['code_cache'] + global_code_cache_map[id(self.pure)] = code_cache + + # Add remaining binary dependencies - analyze Python C-extensions and what DLLs they depend on. + # + # Up until this point, we did very best not to import the packages into the main process. However, a package + # may set up additional library search paths during its import (e.g., by modifying PATH or calling the + # add_dll_directory() function on Windows, or modifying LD_LIBRARY_PATH on Linux). In order to reliably + # discover dynamic libraries, we therefore require an environment with all packages imported. We achieve that + # by gathering list of all collected packages, and spawn an isolated process, in which we first import all + # the packages from the list, and then perform search for dynamic libraries. + logger.info('Looking for dynamic libraries') + + collected_packages = self.graph.get_collected_packages() + self.binaries.extend( + find_binary_dependencies(self.binaries, collected_packages, self.graph._bindepend_symlink_suppression) + ) + + # Apply work-around for (potential) binaries collected from `pywin32` package... + if is_win: + self.binaries = postprocess_binaries_toc_pywin32(self.binaries) + # With anaconda, we need additional work-around... + if is_conda: + self.binaries = postprocess_binaries_toc_pywin32_anaconda(self.binaries) + + # On linux, check for HMAC files accompanying shared library files and, if available, collect them. + # These are present on Fedora and RHEL, and are used in FIPS-enabled configurations to ensure shared + # library's file integrity. + if is_linux: + for dest_name, src_name, typecode in self.binaries: + if typecode not in {'BINARY', 'EXTENSION'}: + continue # Skip symbolic links + + src_lib_path = pathlib.Path(src_name) + + # Check for .name.hmac file next to the shared library. + src_hmac_path = src_lib_path.with_name(f".{src_lib_path.name}.hmac") + if src_hmac_path.is_file(): + dest_hmac_path = pathlib.PurePath(dest_name).with_name(src_hmac_path.name) + self.datas.append((str(dest_hmac_path), str(src_hmac_path), 'DATA')) + + # Alternatively, check the fipscheck directory: fipscheck/name.hmac + src_hmac_path = src_lib_path.parent / "fipscheck" / f"{src_lib_path.name}.hmac" + if src_hmac_path.is_file(): + dest_hmac_path = pathlib.PurePath("fipscheck") / src_hmac_path.name + self.datas.append((str(dest_hmac_path), str(src_hmac_path), 'DATA')) + + # Similarly, look for .chk files that are used by NSS libraries. + src_chk_path = src_lib_path.with_suffix(".chk") + if src_chk_path.is_file(): + dest_chk_path = pathlib.PurePath(dest_name).with_name(src_chk_path.name) + self.datas.append((str(dest_chk_path), str(src_chk_path), 'DATA')) + + # Final normalization of `datas` and `binaries`: + # - normalize both TOCs together (to avoid having duplicates across the lists) + # - process the combined normalized TOC for symlinks + # - split back into `binaries` (BINARY, EXTENSION) and `datas` (everything else) + combined_toc = normalize_toc(self.datas + self.binaries) + combined_toc = toc_process_symbolic_links(combined_toc) + + # On macOS, look for binaries collected from .framework bundles, and collect their Info.plist files. + if is_darwin: + combined_toc += osxutils.collect_files_from_framework_bundles(combined_toc) + + self.datas = [] + self.binaries = [] + for entry in combined_toc: + dest_name, src_name, typecode = entry + if typecode in {'BINARY', 'EXTENSION'}: + self.binaries.append(entry) + else: + self.datas.append(entry) + + # On macOS, the Finder app seems to litter visited directories with `.DS_Store` files. These cause issues with + # codesigning when placed in mixed-content directories, where our .app bundle generator cross-links data files + # from `Resources` to `Frameworks` tree, and the `codesign` utility explicitly forbids a `.DS_Store` file to be + # a symbolic link. + # But there is no reason for `.DS_Store` files to be collected in the first place, so filter them out. + if is_darwin: + self.datas = [(dest_name, src_name, typecode) for dest_name, src_name, typecode in self.datas + if os.path.basename(src_name) != '.DS_Store'] + + # Write warnings about missing modules. + self._write_warnings() + # Write debug information about the graph + self._write_graph_debug() + + # On macOS, check the SDK version of the binaries to be collected, and warn when the SDK version is either + # invalid or too low. Such binaries will likely refuse to be loaded when hardened runtime is enabled and + # while we cannot do anything about it, we can at least warn the user about it. + # See: https://developer.apple.com/forums/thread/132526 + if is_darwin: + binaries_with_invalid_sdk = [] + for dest_name, src_name, typecode in self.binaries: + try: + sdk_version = osxutils.get_macos_sdk_version(src_name) + except Exception: + logger.warning("Failed to query macOS SDK version of %r!", src_name, exc_info=True) + binaries_with_invalid_sdk.append((dest_name, src_name, "unavailable")) + continue + + if sdk_version < (10, 9, 0): + binaries_with_invalid_sdk.append((dest_name, src_name, sdk_version)) + if binaries_with_invalid_sdk: + logger.warning("Found one or more binaries with invalid or incompatible macOS SDK version:") + for dest_name, src_name, sdk_version in binaries_with_invalid_sdk: + logger.warning(" * %r, collected as %r; version: %r", src_name, dest_name, sdk_version) + logger.warning("These binaries will likely cause issues with code-signing and hardened runtime!") + + def _write_warnings(self): + """ + Write warnings about missing modules. Get them from the graph and use the graph to figure out who tried to + import them. + """ + def dependency_description(name, dep_info): + if not dep_info or dep_info == 'direct': + imptype = 0 + else: + imptype = (dep_info.conditional + 2 * dep_info.function + 4 * dep_info.tryexcept) + return '%s (%s)' % (name, IMPORT_TYPES[imptype]) + + from PyInstaller.config import CONF + miss_toc = self.graph.make_missing_toc() + with open(CONF['warnfile'], 'w', encoding='utf-8') as wf: + wf.write(WARNFILE_HEADER) + for (n, p, status) in miss_toc: + importers = self.graph.get_importers(n) + print( + status, + 'module named', + n, + '- imported by', + ', '.join(dependency_description(name, data) for name, data in importers), + file=wf + ) + logger.info("Warnings written to %s", CONF['warnfile']) + + def _write_graph_debug(self): + """ + Write a xref (in html) and with `--log-level DEBUG` a dot-drawing of the graph. + """ + from PyInstaller.config import CONF + with open(CONF['xref-file'], 'w', encoding='utf-8') as fh: + self.graph.create_xref(fh) + logger.info("Graph cross-reference written to %s", CONF['xref-file']) + if logger.getEffectiveLevel() > logging.DEBUG: + return + # The `DOT language's `_ default character encoding (see the end + # of the linked page) is UTF-8. + with open(CONF['dot-file'], 'w', encoding='utf-8') as fh: + self.graph.graphreport(fh) + logger.info("Graph drawing written to %s", CONF['dot-file']) + + def exclude_system_libraries(self, list_of_exceptions=None): + """ + This method may be optionally called from the spec file to exclude any system libraries from the list of + binaries other than those containing the shell-style wildcards in list_of_exceptions. Those that match + '*python*' or are stored under 'lib-dynload' are always treated as exceptions and not excluded. + """ + + self.binaries = [ + entry for entry in self.binaries if _should_include_system_binary(entry, list_of_exceptions or []) + ] + + +class ExecutableBuilder: + """ + Class that constructs the executable. + """ + # TODO wrap the 'main' and 'build' function into this class. + + +def build(spec, distpath, workpath, clean_build): + """ + Build the executable according to the created SPEC file. + """ + from PyInstaller.config import CONF + + # Ensure starting tilde in distpath / workpath is expanded into user's home directory. This is to work around for + # tilde not being expanded when using `--workpath=~/path/abc` instead of `--workpath ~/path/abc` (or when the path + # argument is quoted). See https://github.com/pyinstaller/pyinstaller/issues/696 + distpath = os.path.abspath(os.path.expanduser(distpath)) + workpath = os.path.abspath(os.path.expanduser(workpath)) + + CONF['spec'] = os.path.abspath(spec) + CONF['specpath'], CONF['specnm'] = os.path.split(CONF['spec']) + CONF['specnm'] = os.path.splitext(CONF['specnm'])[0] + + # Add 'specname' to workpath and distpath if they point to PyInstaller homepath. + if os.path.dirname(distpath) == HOMEPATH: + distpath = os.path.join(HOMEPATH, CONF['specnm'], os.path.basename(distpath)) + CONF['distpath'] = distpath + if os.path.dirname(workpath) == HOMEPATH: + workpath = os.path.join(HOMEPATH, CONF['specnm'], os.path.basename(workpath), CONF['specnm']) + else: + workpath = os.path.join(workpath, CONF['specnm']) + CONF['workpath'] = workpath + + CONF['warnfile'] = os.path.join(workpath, 'warn-%s.txt' % CONF['specnm']) + CONF['dot-file'] = os.path.join(workpath, 'graph-%s.dot' % CONF['specnm']) + CONF['xref-file'] = os.path.join(workpath, 'xref-%s.html' % CONF['specnm']) + + CONF['code_cache'] = dict() + + # Clean PyInstaller cache (CONF['cachedir']) and temporary files (workpath) to be able start a clean build. + if clean_build: + logger.info('Removing temporary files and cleaning cache in %s', CONF['cachedir']) + for pth in (CONF['cachedir'], workpath): + if os.path.exists(pth): + # Remove all files in 'pth'. + for f in glob.glob(pth + '/*'): + # Remove dirs recursively. + if os.path.isdir(f): + shutil.rmtree(f) + else: + os.remove(f) + + # Create DISTPATH and workpath if they does not exist. + for pth in (CONF['distpath'], CONF['workpath']): + os.makedirs(pth, exist_ok=True) + + # Construct NAMESPACE for running the Python code from .SPEC file. + # NOTE: Passing NAMESPACE allows to avoid having global variables in this module and makes isolated environment for + # running tests. + # NOTE: Defining NAMESPACE allows to map any class to a apecific name for .SPEC. + # FIXME: Some symbols might be missing. Add them if there are some failures. + # TODO: What from this .spec API is deprecated and could be removed? + spec_namespace = { + # Set of global variables that can be used while processing .spec file. Some of them act as configuration + # options. + 'DISTPATH': CONF['distpath'], + 'HOMEPATH': HOMEPATH, + 'SPEC': CONF['spec'], + 'specnm': CONF['specnm'], + 'SPECPATH': CONF['specpath'], + 'WARNFILE': CONF['warnfile'], + 'workpath': CONF['workpath'], + # PyInstaller classes for .spec. + 'TOC': TOC, # Kept for backward compatibility even though `TOC` class is deprecated. + 'Analysis': Analysis, + 'BUNDLE': BUNDLE, + 'COLLECT': COLLECT, + 'EXE': EXE, + 'MERGE': MERGE, + 'PYZ': PYZ, + 'Tree': Tree, + 'Splash': Splash, + # Python modules available for .spec. + 'os': os, + } + + # Execute the specfile. Read it as a binary file... + try: + with open(spec, 'rb') as f: + # ... then let Python determine the encoding, since ``compile`` accepts byte strings. + code = compile(f.read(), spec, 'exec') + except FileNotFoundError: + raise SystemExit(f'ERROR: Spec file "{spec}" not found!') + exec(code, spec_namespace) + + logger.info("Build complete! The results are available in: %s", CONF['distpath']) + + +def __add_options(parser): + parser.add_argument( + "--distpath", + metavar="DIR", + default=DEFAULT_DISTPATH, + help="Where to put the bundled app (default: ./dist)", + ) + parser.add_argument( + '--workpath', + default=DEFAULT_WORKPATH, + help="Where to put all the temporary work files, .log, .pyz and etc. (default: ./build)", + ) + parser.add_argument( + '-y', + '--noconfirm', + action="store_true", + default=False, + help="Replace output directory (default: %s) without asking for confirmation" % + os.path.join('SPECPATH', 'dist', 'SPECNAME'), + ) + parser.add_argument( + '--upx-dir', + default=None, + help="Path to UPX utility (default: search the execution path)", + ) + parser.add_argument( + '--clean', + dest='clean_build', + action='store_true', + default=False, + help="Clean PyInstaller cache and remove temporary files before building.", + ) + + +def main( + pyi_config, + specfile, + noconfirm=False, + distpath=DEFAULT_DISTPATH, + workpath=DEFAULT_WORKPATH, + upx_dir=None, + clean_build=False, + **kw +): + from PyInstaller.config import CONF + CONF['noconfirm'] = noconfirm + + # If configuration dict is supplied - skip configuration step. + if pyi_config is None: + import PyInstaller.configure as configure + CONF.update(configure.get_config(upx_dir=upx_dir)) + else: + CONF.update(pyi_config) + + CONF['ui_admin'] = kw.get('ui_admin', False) + CONF['ui_access'] = kw.get('ui_uiaccess', False) + + build(specfile, distpath, workpath, clean_build) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/building/datastruct.py b/venv/lib/python3.12/site-packages/PyInstaller/building/datastruct.py new file mode 100755 index 0000000..ca16286 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/building/datastruct.py @@ -0,0 +1,459 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import os +import pathlib +import warnings + +from PyInstaller import log as logging +from PyInstaller.building.utils import _check_guts_eq +from PyInstaller.utils import misc + +logger = logging.getLogger(__name__) + + +def unique_name(entry): + """ + Return the filename used to enforce uniqueness for the given TOC entry. + + Parameters + ---------- + entry : tuple + + Returns + ------- + unique_name: str + """ + name, path, typecode = entry + if typecode in ('BINARY', 'DATA', 'EXTENSION', 'DEPENDENCY'): + name = os.path.normcase(name) + + return name + + +# This class is deprecated and has been replaced by plain lists with explicit normalization (de-duplication) via +# `normalize_toc` and `normalize_pyz_toc` helper functions. +class TOC(list): + """ + TOC (Table of Contents) class is a list of tuples of the form (name, path, typecode). + + typecode name path description + -------------------------------------------------------------------------------------- + EXTENSION Python internal name. Full path name in build. Extension module. + PYSOURCE Python internal name. Full path name in build. Script. + PYMODULE Python internal name. Full path name in build. Pure Python module (including __init__ modules). + PYZ Runtime name. Full path name in build. A .pyz archive (ZlibArchive data structure). + PKG Runtime name. Full path name in build. A .pkg archive (Carchive data structure). + BINARY Runtime name. Full path name in build. Shared library. + DATA Runtime name. Full path name in build. Arbitrary files. + OPTION The option. Unused. Python runtime option (frozen into executable). + + A TOC contains various types of files. A TOC contains no duplicates and preserves order. + PyInstaller uses TOC data type to collect necessary files bundle them into an executable. + """ + def __init__(self, initlist=None): + super().__init__() + + # Deprecation warning + warnings.warn( + "TOC class is deprecated. Use a plain list of 3-element tuples instead.", + DeprecationWarning, + stacklevel=2, + ) + + self.filenames = set() + if initlist: + for entry in initlist: + self.append(entry) + + def append(self, entry): + if not isinstance(entry, tuple): + logger.info("TOC found a %s, not a tuple", entry) + raise TypeError("Expected tuple, not %s." % type(entry).__name__) + + unique = unique_name(entry) + + if unique not in self.filenames: + self.filenames.add(unique) + super().append(entry) + + def insert(self, pos, entry): + if not isinstance(entry, tuple): + logger.info("TOC found a %s, not a tuple", entry) + raise TypeError("Expected tuple, not %s." % type(entry).__name__) + unique = unique_name(entry) + + if unique not in self.filenames: + self.filenames.add(unique) + super().insert(pos, entry) + + def __add__(self, other): + result = TOC(self) + result.extend(other) + return result + + def __radd__(self, other): + result = TOC(other) + result.extend(self) + return result + + def __iadd__(self, other): + for entry in other: + self.append(entry) + return self + + def extend(self, other): + # TODO: look if this can be done more efficient with out the loop, e.g. by not using a list as base at all. + for entry in other: + self.append(entry) + + def __sub__(self, other): + # Construct new TOC with entries not contained in the other TOC + other = TOC(other) + return TOC([entry for entry in self if unique_name(entry) not in other.filenames]) + + def __rsub__(self, other): + result = TOC(other) + return result.__sub__(self) + + def __setitem__(self, key, value): + if isinstance(key, slice): + if key == slice(None, None, None): + # special case: set the entire list + self.filenames = set() + self.clear() + self.extend(value) + return + else: + raise KeyError("TOC.__setitem__ doesn't handle slices") + + else: + old_value = self[key] + old_name = unique_name(old_value) + self.filenames.remove(old_name) + + new_name = unique_name(value) + if new_name not in self.filenames: + self.filenames.add(new_name) + super(TOC, self).__setitem__(key, value) + + +class Target: + invcnum = 0 + + def __init__(self): + from PyInstaller.config import CONF + + # Get a (per class) unique number to avoid conflicts between toc objects + self.invcnum = self.__class__.invcnum + self.__class__.invcnum += 1 + self.tocfilename = os.path.join(CONF['workpath'], '%s-%02d.toc' % (self.__class__.__name__, self.invcnum)) + self.tocbasename = os.path.basename(self.tocfilename) + self.dependencies = [] + + def __postinit__(self): + """ + Check if the target need to be rebuild and if so, re-assemble. + + `__postinit__` is to be called at the end of `__init__` of every subclass of Target. `__init__` is meant to + setup the parameters and `__postinit__` is checking if rebuild is required and in case calls `assemble()` + """ + logger.info("checking %s", self.__class__.__name__) + data = None + last_build = misc.mtime(self.tocfilename) + if last_build == 0: + logger.info("Building %s because %s is non existent", self.__class__.__name__, self.tocbasename) + else: + try: + data = misc.load_py_data_struct(self.tocfilename) + except Exception: + logger.info("Building because %s is bad", self.tocbasename) + else: + # create a dict for easier access + data = dict(zip((g[0] for g in self._GUTS), data)) + # assemble if previous data was not found or is outdated + if not data or self._check_guts(data, last_build): + self.assemble() + self._save_guts() + + _GUTS = [] + + def _check_guts(self, data, last_build): + """ + Returns True if rebuild/assemble is required. + """ + if len(data) != len(self._GUTS): + logger.info("Building because %s is bad", self.tocbasename) + return True + for attr, func in self._GUTS: + if func is None: + # no check for this value + continue + if func(attr, data[attr], getattr(self, attr), last_build): + return True + return False + + def _save_guts(self): + """ + Save the input parameters and the work-product of this run to maybe avoid regenerating it later. + """ + data = tuple(getattr(self, g[0]) for g in self._GUTS) + misc.save_py_data_struct(self.tocfilename, data) + + +class Tree(Target, list): + """ + This class is a way of creating a TOC (Table of Contents) list that describes some or all of the files within a + directory. + """ + def __init__(self, root=None, prefix=None, excludes=None, typecode='DATA'): + """ + root + The root of the tree (on the build system). + prefix + Optional prefix to the names of the target system. + excludes + A list of names to exclude. Two forms are allowed: + + name + Files with this basename will be excluded (do not include the path). + *.ext + Any file with the given extension will be excluded. + typecode + The typecode to be used for all files found in this tree. See the TOC class for for information about + the typcodes. + """ + Target.__init__(self) + list.__init__(self) + self.root = root + self.prefix = prefix + self.excludes = excludes + self.typecode = typecode + if excludes is None: + self.excludes = [] + self.__postinit__() + + _GUTS = ( # input parameters + ('root', _check_guts_eq), + ('prefix', _check_guts_eq), + ('excludes', _check_guts_eq), + ('typecode', _check_guts_eq), + ('data', None), # tested below + # no calculated/analysed values + ) + + def _check_guts(self, data, last_build): + if Target._check_guts(self, data, last_build): + return True + # Walk the collected directories as check if they have been changed - which means files have been added or + # removed. There is no need to check for the files, since `Tree` is only about the directory contents (which is + # the list of files). + stack = [data['root']] + while stack: + d = stack.pop() + if misc.mtime(d) > last_build: + logger.info("Building %s because directory %s changed", self.tocbasename, d) + return True + for nm in os.listdir(d): + path = os.path.join(d, nm) + if os.path.isdir(path): + stack.append(path) + self[:] = data['data'] # collected files + return False + + def _save_guts(self): + # Use the attribute `data` to save the list + self.data = self + super()._save_guts() + del self.data + + def assemble(self): + logger.info("Building Tree %s", self.tocbasename) + stack = [(self.root, self.prefix)] + excludes = set() + xexcludes = set() + for name in self.excludes: + if name.startswith('*'): + xexcludes.add(name[1:]) + else: + excludes.add(name) + result = [] + while stack: + dir, prefix = stack.pop() + for filename in os.listdir(dir): + if filename in excludes: + continue + ext = os.path.splitext(filename)[1] + if ext in xexcludes: + continue + fullfilename = os.path.join(dir, filename) + if prefix: + resfilename = os.path.join(prefix, filename) + else: + resfilename = filename + if os.path.isdir(fullfilename): + stack.append((fullfilename, resfilename)) + else: + result.append((resfilename, fullfilename, self.typecode)) + self[:] = result + + +def normalize_toc(toc): + # Default priority: 0 + _TOC_TYPE_PRIORITIES = { + # DEPENDENCY entries need to replace original entries, so they need the highest priority. + 'DEPENDENCY': 3, + # SYMLINK entries have higher priority than other regular entries + 'SYMLINK': 2, + # BINARY/EXTENSION entries undergo additional processing, so give them precedence over DATA and other entries. + 'BINARY': 1, + 'EXTENSION': 1, + } + + def _type_case_normalization_fcn(typecode): + # Case-normalize all entries except OPTION. + return typecode not in { + "OPTION", + } + + return _normalize_toc(toc, _TOC_TYPE_PRIORITIES, _type_case_normalization_fcn) + + +def normalize_pyz_toc(toc): + # Default priority: 0 + _TOC_TYPE_PRIORITIES = { + # Ensure that entries with higher optimization level take precedence. + 'PYMODULE-2': 2, + 'PYMODULE-1': 1, + 'PYMODULE': 0, + } + + return _normalize_toc(toc, _TOC_TYPE_PRIORITIES) + + +def _normalize_toc(toc, toc_type_priorities, type_case_normalization_fcn=lambda typecode: False): + options_toc = [] + tmp_toc = dict() + for dest_name, src_name, typecode in toc: + # Exempt OPTION entries from de-duplication processing. Some options might allow being specified multiple times. + if typecode == 'OPTION': + options_toc.append(((dest_name, src_name, typecode))) + continue + + # Always sanitize the dest_name with `os.path.normpath` to remove any local loops with parent directory path + # components. `pathlib` does not seem to offer equivalent functionality. + dest_name = os.path.normpath(dest_name) + + # Normalize the destination name for uniqueness. Use `pathlib.PurePath` to ensure that keys are both + # case-normalized (on OSes where applicable) and directory-separator normalized (just in case). + if type_case_normalization_fcn(typecode): + entry_key = pathlib.PurePath(dest_name) + else: + entry_key = dest_name + + existing_entry = tmp_toc.get(entry_key) + if existing_entry is None: + # Entry does not exist - insert + tmp_toc[entry_key] = (dest_name, src_name, typecode) + else: + # Entry already exists - replace if its typecode has higher priority + _, _, existing_typecode = existing_entry + if toc_type_priorities.get(typecode, 0) > toc_type_priorities.get(existing_typecode, 0): + tmp_toc[entry_key] = (dest_name, src_name, typecode) + + # Return the items as list. The order matches the original order due to python dict maintaining the insertion order. + # The exception are OPTION entries, which are now placed at the beginning of the TOC. + return options_toc + list(tmp_toc.values()) + + +def toc_process_symbolic_links(toc): + """ + Process TOC entries and replace entries whose files are symbolic links with SYMLINK entries (provided original file + is also being collected). + """ + # Dictionary of all destination names, for a fast look-up. + all_dest_files = set([dest_name for dest_name, src_name, typecode in toc]) + + # Process the TOC to create SYMLINK entries + new_toc = [] + for entry in toc: + dest_name, src_name, typecode = entry + + # Skip entries that are already symbolic links + if typecode == 'SYMLINK': + new_toc.append(entry) + continue + + # Skip entries without valid source name (e.g., OPTION) + if not src_name: + new_toc.append(entry) + continue + + # Source path is not a symbolic link (i.e., it is a regular file or directory) + if not os.path.islink(src_name): + new_toc.append(entry) + continue + + # Try preserving the symbolic link, under strict relative-relationship-preservation check + symlink_entry = _try_preserving_symbolic_link(dest_name, src_name, all_dest_files) + + if symlink_entry: + new_toc.append(symlink_entry) + else: + new_toc.append(entry) + + return new_toc + + +def _try_preserving_symbolic_link(dest_name, src_name, all_dest_files): + seen_src_files = set() + + # Set initial values for the loop + ref_src_file = src_name + ref_dest_file = dest_name + + while True: + # Guard against cyclic links... + if ref_src_file in seen_src_files: + break + seen_src_files.add(ref_src_file) + + # Stop when referenced source file is not a symbolic link anymore. + if not os.path.islink(ref_src_file): + break + + # Read the symbolic link's target, but do not fully resolve it using os.path.realpath(), because there might be + # other symbolic links involved as well (for example, /lib64 -> /usr/lib64 whereas we are processing + # /lib64/liba.so -> /lib64/liba.so.1) + symlink_target = os.readlink(ref_src_file) + if os.path.isabs(symlink_target): + break # We support only relative symbolic links. + + ref_dest_file = os.path.join(os.path.dirname(ref_dest_file), symlink_target) + ref_dest_file = os.path.normpath(ref_dest_file) # remove any '..' + + ref_src_file = os.path.join(os.path.dirname(ref_src_file), symlink_target) + ref_src_file = os.path.normpath(ref_src_file) # remove any '..' + + # Check if referenced destination file is valid (i.e., we are collecting a file under referenced name). + if ref_dest_file in all_dest_files: + # Sanity check: original source name and current referenced source name must, after complete resolution, + # point to the same file. + if os.path.realpath(src_name) == os.path.realpath(ref_src_file): + # Compute relative link for the destination file (might be modified, if we went over non-collected + # intermediate links). + rel_link = os.path.relpath(ref_dest_file, os.path.dirname(dest_name)) + return dest_name, rel_link, 'SYMLINK' + + # If referenced destination is not valid, do another iteration in case we are dealing with chained links and we + # are not collecting an intermediate link... + + return None diff --git a/venv/lib/python3.12/site-packages/PyInstaller/building/icon.py b/venv/lib/python3.12/site-packages/PyInstaller/building/icon.py new file mode 100755 index 0000000..de298f2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/building/icon.py @@ -0,0 +1,90 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2022-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from typing import Tuple + +import os +import hashlib + + +def normalize_icon_type(icon_path: str, allowed_types: Tuple[str], convert_type: str, workpath: str) -> str: + """ + Returns a valid icon path or raises an Exception on error. + Ensures that the icon exists, and, if necessary, attempts to convert it to correct OS-specific format using Pillow. + + Takes: + icon_path - the icon given by the user + allowed_types - a tuple of icon formats that should be allowed through + EX: ("ico", "exe") + convert_type - the type to attempt conversion too if necessary + EX: "icns" + workpath - the temp directory to save any newly generated image files + """ + + # explicitly error if file not found + if not os.path.exists(icon_path): + raise FileNotFoundError(f"Icon input file {icon_path} not found") + + _, extension = os.path.splitext(icon_path) + extension = extension[1:] # get rid of the "." in ".whatever" + + # if the file is already in the right format, pass it back unchanged + if extension in allowed_types: + # Check both the suffix and the header of the file to guard against the user confusing image types. + signatures = hex_signatures[extension] + with open(icon_path, "rb") as f: + header = f.read(max(len(s) for s in signatures)) + if any(list(header)[:len(s)] == s for s in signatures): + return icon_path + + # The icon type is wrong! Let's try and import PIL + try: + from PIL import Image as PILImage + import PIL + + except ImportError: + raise ValueError( + f"Received icon image '{icon_path}' which exists but is not in the correct format. On this platform, " + f"only {allowed_types} images may be used as icons. If Pillow is installed, automatic conversion will " + f"be attempted. Please install Pillow or convert your '{extension}' file to one of {allowed_types} " + f"and try again." + ) + + # Let's try to use PIL to convert the icon file type + try: + _generated_name = f"generated-{hashlib.sha256(icon_path.encode()).hexdigest()}.{convert_type}" + generated_icon = os.path.join(workpath, _generated_name) + with PILImage.open(icon_path) as im: + # If an image uses a custom palette + transparency, convert it to RGBA for a better alpha mask depth. + if im.mode == "P" and im.info.get("transparency", None) is not None: + # The bit depth of the alpha channel will be higher, and the images will look better when eventually + # scaled to multiple sizes (16,24,32,..) for the ICO format for example. + im = im.convert("RGBA") + im.save(generated_icon) + icon_path = generated_icon + except PIL.UnidentifiedImageError: + raise ValueError( + f"Something went wrong converting icon image '{icon_path}' to '.{convert_type}' with Pillow, " + f"perhaps the image format is unsupported. Try again with a different file or use a file that can " + f"be used without conversion on this platform: {allowed_types}" + ) + + return icon_path + + +# Possible initial bytes of icon types PyInstaller needs to be able to recognise. +# Taken from: https://en.wikipedia.org/wiki/List_of_file_signatures +hex_signatures = { + "png": [[0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A]], + "exe": [[0x4D, 0x5A], [0x5A, 0x4D]], + "ico": [[0x00, 0x00, 0x01, 0x00]], + "icns": [[0x69, 0x63, 0x6e, 0x73]], +} diff --git a/venv/lib/python3.12/site-packages/PyInstaller/building/makespec.py b/venv/lib/python3.12/site-packages/PyInstaller/building/makespec.py new file mode 100755 index 0000000..0aad832 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/building/makespec.py @@ -0,0 +1,909 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Automatically build spec files containing a description of the project. +""" + +import argparse +import os +import re +import sys + +from PyInstaller import DEFAULT_SPECPATH, HOMEPATH +from PyInstaller import log as logging +from PyInstaller.building.templates import bundleexetmplt, bundletmplt, onedirtmplt, onefiletmplt, splashtmpl +from PyInstaller.compat import is_darwin, is_win + +logger = logging.getLogger(__name__) + +# This list gives valid choices for the ``--debug`` command-line option, except for the ``all`` choice. +DEBUG_ARGUMENT_CHOICES = ['imports', 'bootloader', 'noarchive'] +# This is the ``all`` choice. +DEBUG_ALL_CHOICE = ['all'] + + +def escape_win_filepath(path): + # escape all \ with another \ after using normpath to clean up the path + return os.path.normpath(path).replace('\\', '\\\\') + + +def make_path_spec_relative(filename, spec_dir): + """ + Make the filename relative to the directory containing .spec file if filename is relative and not absolute. + Otherwise keep filename untouched. + """ + if os.path.isabs(filename): + return filename + else: + filename = os.path.abspath(filename) + # Make it relative. + filename = os.path.relpath(filename, start=spec_dir) + return filename + + +# Support for trying to avoid hard-coded paths in the .spec files. Eg, all files rooted in the Installer directory tree +# will be written using "HOMEPATH", thus allowing this spec file to be used with any Installer installation. Same thing +# could be done for other paths too. +path_conversions = ((HOMEPATH, "HOMEPATH"),) + + +class SourceDestAction(argparse.Action): + """ + A command line option which takes multiple source:dest pairs. + """ + def __init__(self, *args, default=None, metavar=None, **kwargs): + super().__init__(*args, default=[], metavar='SOURCE:DEST', **kwargs) + + def __call__(self, parser, namespace, value, option_string=None): + try: + # Find the only separator that isn't a Windows drive. + separator, = (m for m in re.finditer(rf"(^\w:[/\\])|[:{os.pathsep}]", value) if not m[1]) + except ValueError: + # Split into SRC and DEST failed, wrong syntax + raise argparse.ArgumentError(self, f'Wrong syntax, should be {self.option_strings[0]}=SOURCE:DEST') + src = value[:separator.start()] + dest = value[separator.end():] + if not src or not dest: + # Syntax was correct, but one or both of SRC and DEST was not given + raise argparse.ArgumentError(self, "You have to specify both SOURCE and DEST") + + # argparse is not particularly smart with copy by reference typed defaults. If the current list is the default, + # replace it before modifying it to avoid changing the default. + if getattr(namespace, self.dest) is self.default: + setattr(namespace, self.dest, []) + getattr(namespace, self.dest).append((src, dest)) + + +def make_variable_path(filename, conversions=path_conversions): + if not os.path.isabs(filename): + # os.path.commonpath can not compare relative and absolute paths, and if filename is not absolute, none of the + # paths in conversions will match anyway. + return None, filename + for (from_path, to_name) in conversions: + assert os.path.abspath(from_path) == from_path, ("path '%s' should already be absolute" % from_path) + try: + common_path = os.path.commonpath([filename, from_path]) + except ValueError: + # Per https://docs.python.org/3/library/os.path.html#os.path.commonpath, this raises ValueError in several + # cases which prevent computing a common path. + common_path = None + if common_path == from_path: + rest = filename[len(from_path):] + if rest.startswith(('\\', '/')): + rest = rest[1:] + return to_name, rest + return None, filename + + +def removed_key_option(x): + from PyInstaller.exceptions import RemovedCipherFeatureError + raise RemovedCipherFeatureError("Please remove your --key=xxx argument.") + + +class _RemovedFlagAction(argparse.Action): + def __init__(self, *args, **kwargs): + kwargs["help"] = argparse.SUPPRESS + kwargs["nargs"] = 0 + super().__init__(*args, **kwargs) + + +class _RemovedNoEmbedManifestAction(_RemovedFlagAction): + def __call__(self, *args, **kwargs): + from PyInstaller.exceptions import RemovedExternalManifestError + raise RemovedExternalManifestError("Please remove your --no-embed-manifest argument.") + + +class _RemovedWinPrivateAssembliesAction(_RemovedFlagAction): + def __call__(self, *args, **kwargs): + from PyInstaller.exceptions import RemovedWinSideBySideSupportError + raise RemovedWinSideBySideSupportError("Please remove your --win-private-assemblies argument.") + + +class _RemovedWinNoPreferRedirectsAction(_RemovedFlagAction): + def __call__(self, *args, **kwargs): + from PyInstaller.exceptions import RemovedWinSideBySideSupportError + raise RemovedWinSideBySideSupportError("Please remove your --win-no-prefer-redirects argument.") + + +# An object used in place of a "path string", which knows how to repr() itself using variable names instead of +# hard-coded paths. +class Path: + def __init__(self, *parts): + self.path = os.path.join(*parts) + self.variable_prefix = self.filename_suffix = None + + def __repr__(self): + if self.filename_suffix is None: + self.variable_prefix, self.filename_suffix = make_variable_path(self.path) + if self.variable_prefix is None: + return repr(self.path) + return "os.path.join(" + self.variable_prefix + "," + repr(self.filename_suffix) + ")" + + +# An object used to construct extra preamble for the spec file, in order to accommodate extra collect_*() calls from the +# command-line +class Preamble: + def __init__( + self, datas, binaries, hiddenimports, collect_data, collect_binaries, collect_submodules, collect_all, + copy_metadata, recursive_copy_metadata + ): + # Initialize with literal values - will be switched to preamble variable name later, if necessary + self.binaries = binaries or [] + self.hiddenimports = hiddenimports or [] + self.datas = datas or [] + # Preamble content + self.content = [] + + # Import statements + if collect_data: + self._add_hookutil_import('collect_data_files') + if collect_binaries: + self._add_hookutil_import('collect_dynamic_libs') + if collect_submodules: + self._add_hookutil_import('collect_submodules') + if collect_all: + self._add_hookutil_import('collect_all') + if copy_metadata or recursive_copy_metadata: + self._add_hookutil_import('copy_metadata') + if self.content: + self.content += [''] # empty line to separate the section + # Variables + if collect_data or copy_metadata or collect_all or recursive_copy_metadata: + self._add_var('datas', self.datas) + self.datas = 'datas' # switch to variable + if collect_binaries or collect_all: + self._add_var('binaries', self.binaries) + self.binaries = 'binaries' # switch to variable + if collect_submodules or collect_all: + self._add_var('hiddenimports', self.hiddenimports) + self.hiddenimports = 'hiddenimports' # switch to variable + # Content - collect_data_files + for entry in collect_data: + self._add_collect_data(entry) + # Content - copy_metadata + for entry in copy_metadata: + self._add_copy_metadata(entry) + # Content - copy_metadata(..., recursive=True) + for entry in recursive_copy_metadata: + self._add_recursive_copy_metadata(entry) + # Content - collect_binaries + for entry in collect_binaries: + self._add_collect_binaries(entry) + # Content - collect_submodules + for entry in collect_submodules: + self._add_collect_submodules(entry) + # Content - collect_all + for entry in collect_all: + self._add_collect_all(entry) + # Merge + if self.content and self.content[-1] != '': + self.content += [''] # empty line + self.content = '\n'.join(self.content) + + def _add_hookutil_import(self, name): + self.content += ['from PyInstaller.utils.hooks import {0}'.format(name)] + + def _add_var(self, name, initial_value): + self.content += ['{0} = {1}'.format(name, initial_value)] + + def _add_collect_data(self, name): + self.content += ['datas += collect_data_files(\'{0}\')'.format(name)] + + def _add_copy_metadata(self, name): + self.content += ['datas += copy_metadata(\'{0}\')'.format(name)] + + def _add_recursive_copy_metadata(self, name): + self.content += ['datas += copy_metadata(\'{0}\', recursive=True)'.format(name)] + + def _add_collect_binaries(self, name): + self.content += ['binaries += collect_dynamic_libs(\'{0}\')'.format(name)] + + def _add_collect_submodules(self, name): + self.content += ['hiddenimports += collect_submodules(\'{0}\')'.format(name)] + + def _add_collect_all(self, name): + self.content += [ + 'tmp_ret = collect_all(\'{0}\')'.format(name), + 'datas += tmp_ret[0]; binaries += tmp_ret[1]; hiddenimports += tmp_ret[2]' + ] + + +def __add_options(parser): + """ + Add the `Makespec` options to a option-parser instance or a option group. + """ + g = parser.add_argument_group('What to generate') + g.add_argument( + "-D", + "--onedir", + dest="onefile", + action="store_false", + default=None, + help="Create a one-folder bundle containing an executable (default)", + ) + g.add_argument( + "-F", + "--onefile", + dest="onefile", + action="store_true", + default=None, + help="Create a one-file bundled executable.", + ) + g.add_argument( + "--specpath", + metavar="DIR", + help="Folder to store the generated spec file (default: current directory)", + ) + g.add_argument( + "-n", + "--name", + help="Name to assign to the bundled app and spec file (default: first script's basename)", + ) + g.add_argument( + "--contents-directory", + help="For onedir builds only, specify the name of the directory in which all supporting files (i.e. everything " + "except the executable itself) will be placed in. Use \".\" to re-enable old onedir layout without contents " + "directory.", + ) + + g = parser.add_argument_group('What to bundle, where to search') + g.add_argument( + '--add-data', + action=SourceDestAction, + dest='datas', + help="Additional data files or directories containing data files to be added to the application. The argument " + 'value should be in form of "source:dest_dir", where source is the path to file (or directory) to be ' + "collected, dest_dir is the destination directory relative to the top-level application directory, and both " + "paths are separated by a colon (:). To put a file in the top-level application directory, use . as a " + "dest_dir. This option can be used multiple times." + ) + g.add_argument( + '--add-binary', + action=SourceDestAction, + dest="binaries", + help='Additional binary files to be added to the executable. See the ``--add-data`` option for the format. ' + 'This option can be used multiple times.', + ) + g.add_argument( + "-p", + "--paths", + dest="pathex", + metavar="DIR", + action="append", + default=[], + help="A path to search for imports (like using PYTHONPATH). Multiple paths are allowed, separated by ``%s``, " + "or use this option multiple times. Equivalent to supplying the ``pathex`` argument in the spec file." % + repr(os.pathsep), + ) + g.add_argument( + '--hidden-import', + '--hiddenimport', + action='append', + default=[], + metavar="MODULENAME", + dest='hiddenimports', + help='Name an import not visible in the code of the script(s). This option can be used multiple times.', + ) + g.add_argument( + '--collect-submodules', + action="append", + default=[], + metavar="MODULENAME", + dest='collect_submodules', + help='Collect all submodules from the specified package or module. This option can be used multiple times.', + ) + g.add_argument( + '--collect-data', + '--collect-datas', + action="append", + default=[], + metavar="MODULENAME", + dest='collect_data', + help='Collect all data from the specified package or module. This option can be used multiple times.', + ) + g.add_argument( + '--collect-binaries', + action="append", + default=[], + metavar="MODULENAME", + dest='collect_binaries', + help='Collect all binaries from the specified package or module. This option can be used multiple times.', + ) + g.add_argument( + '--collect-all', + action="append", + default=[], + metavar="MODULENAME", + dest='collect_all', + help='Collect all submodules, data files, and binaries from the specified package or module. This option can ' + 'be used multiple times.', + ) + g.add_argument( + '--copy-metadata', + action="append", + default=[], + metavar="PACKAGENAME", + dest='copy_metadata', + help='Copy metadata for the specified package. This option can be used multiple times.', + ) + g.add_argument( + '--recursive-copy-metadata', + action="append", + default=[], + metavar="PACKAGENAME", + dest='recursive_copy_metadata', + help='Copy metadata for the specified package and all its dependencies. This option can be used multiple ' + 'times.', + ) + g.add_argument( + "--additional-hooks-dir", + action="append", + dest="hookspath", + default=[], + help="An additional path to search for hooks. This option can be used multiple times.", + ) + g.add_argument( + '--runtime-hook', + action='append', + dest='runtime_hooks', + default=[], + help='Path to a custom runtime hook file. A runtime hook is code that is bundled with the executable and is ' + 'executed before any other code or module to set up special features of the runtime environment. This option ' + 'can be used multiple times.', + ) + g.add_argument( + '--exclude-module', + dest='excludes', + action='append', + default=[], + help='Optional module or package (the Python name, not the path name) that will be ignored (as though it was ' + 'not found). This option can be used multiple times.', + ) + g.add_argument( + '--key', + dest='key', + help=argparse.SUPPRESS, + type=removed_key_option, + ) + g.add_argument( + '--splash', + dest='splash', + metavar="IMAGE_FILE", + help="(EXPERIMENTAL) Add an splash screen with the image IMAGE_FILE to the application. The splash screen can " + "display progress updates while unpacking.", + ) + + g = parser.add_argument_group('How to generate') + g.add_argument( + "-d", + "--debug", + # If this option is not specified, then its default value is an empty list (no debug options selected). + default=[], + # Note that ``nargs`` is omitted. This produces a single item not stored in a list, as opposed to a list + # containing one item, as per `nargs `_. + nargs=None, + # The options specified must come from this list. + choices=DEBUG_ALL_CHOICE + DEBUG_ARGUMENT_CHOICES, + # Append choice, rather than storing them (which would overwrite any previous selections). + action='append', + # Allow newlines in the help text; see the ``_SmartFormatter`` in ``__main__.py``. + help=( + "R|Provide assistance with debugging a frozen\n" + "application. This argument may be provided multiple\n" + "times to select several of the following options.\n" + "\n" + "- all: All three of the following options.\n" + "\n" + "- imports: specify the -v option to the underlying\n" + " Python interpreter, causing it to print a message\n" + " each time a module is initialized, showing the\n" + " place (filename or built-in module) from which it\n" + " is loaded. See\n" + " https://docs.python.org/3/using/cmdline.html#id4.\n" + "\n" + "- bootloader: tell the bootloader to issue progress\n" + " messages while initializing and starting the\n" + " bundled app. Used to diagnose problems with\n" + " missing imports.\n" + "\n" + "- noarchive: instead of storing all frozen Python\n" + " source files as an archive inside the resulting\n" + " executable, store them as files in the resulting\n" + " output directory.\n" + "\n" + ), + ) + g.add_argument( + '--optimize', + dest='optimize', + metavar='LEVEL', + type=int, + choices={-1, 0, 1, 2}, + default=None, + help='Bytecode optimization level used for collected python modules and scripts. For details, see the section ' + '“Bytecode Optimization Level” in PyInstaller manual.', + ) + g.add_argument( + '--python-option', + dest='python_options', + metavar='PYTHON_OPTION', + action='append', + default=[], + help='Specify a command-line option to pass to the Python interpreter at runtime. Currently supports ' + '"v" (equivalent to "--debug imports"), "u", "W ", "X ", and "hash_seed=". ' + 'For details, see the section "Specifying Python Interpreter Options" in PyInstaller manual.', + ) + g.add_argument( + "-s", + "--strip", + action="store_true", + help="Apply a symbol-table strip to the executable and shared libs (not recommended for Windows)", + ) + g.add_argument( + "--noupx", + action="store_true", + default=False, + help="Do not use UPX even if it is available (works differently between Windows and *nix)", + ) + g.add_argument( + "--upx-exclude", + dest="upx_exclude", + metavar="FILE", + action="append", + help="Prevent a binary from being compressed when using upx. This is typically used if upx corrupts certain " + "binaries during compression. FILE is the filename of the binary without path. This option can be used " + "multiple times.", + ) + + g = parser.add_argument_group('Windows and macOS specific options') + g.add_argument( + "-c", + "--console", + "--nowindowed", + dest="console", + action="store_true", + default=None, + help="Open a console window for standard i/o (default). On Windows this option has no effect if the first " + "script is a '.pyw' file.", + ) + g.add_argument( + "-w", + "--windowed", + "--noconsole", + dest="console", + action="store_false", + default=None, + help="Windows and macOS: do not provide a console window for standard i/o. On macOS this also triggers " + "building a macOS .app bundle. On Windows this option is automatically set if the first script is a '.pyw' " + "file. This option is ignored on *NIX systems.", + ) + g.add_argument( + "--hide-console", + type=str, + choices={'hide-early', 'hide-late', 'minimize-early', 'minimize-late'}, + default=None, + help="Windows only: in console-enabled executable, have bootloader automatically hide or minimize the console " + "window if the program owns the console window (i.e., was not launched from an existing console window).", + ) + g.add_argument( + "-i", + "--icon", + action='append', + dest="icon_file", + metavar='', + help="FILE.ico: apply the icon to a Windows executable. FILE.exe,ID: extract the icon with ID from an exe. " + "FILE.icns: apply the icon to the .app bundle on macOS. If an image file is entered that isn't in the " + "platform format (ico on Windows, icns on Mac), PyInstaller tries to use Pillow to translate the icon into " + "the correct format (if Pillow is installed). Use \"NONE\" to not apply any icon, thereby making the OS show " + "some default (default: apply PyInstaller's icon). This option can be used multiple times.", + ) + g.add_argument( + "--disable-windowed-traceback", + dest="disable_windowed_traceback", + action="store_true", + default=False, + help="Disable traceback dump of unhandled exception in windowed (noconsole) mode (Windows and macOS only), " + "and instead display a message that this feature is disabled.", + ) + + g = parser.add_argument_group('Windows specific options') + g.add_argument( + "--version-file", + dest="version_file", + metavar="FILE", + help="Add a version resource from FILE to the exe.", + ) + g.add_argument( + "--manifest", + metavar="", + help="Add manifest FILE or XML to the exe.", + ) + g.add_argument( + "-m", + dest="shorthand_manifest", + metavar="", + help="Deprecated shorthand for --manifest.", + ) + g.add_argument( + "--no-embed-manifest", + action=_RemovedNoEmbedManifestAction, + ) + g.add_argument( + "-r", + "--resource", + dest="resources", + metavar="RESOURCE", + action="append", + default=[], + help="Add or update a resource to a Windows executable. The RESOURCE is one to four items, " + "FILE[,TYPE[,NAME[,LANGUAGE]]]. FILE can be a data file or an exe/dll. For data files, at least TYPE and NAME " + "must be specified. LANGUAGE defaults to 0 or may be specified as wildcard * to update all resources of the " + "given TYPE and NAME. For exe/dll files, all resources from FILE will be added/updated to the final executable " + "if TYPE, NAME and LANGUAGE are omitted or specified as wildcard *. This option can be used multiple times.", + ) + g.add_argument( + '--uac-admin', + dest='uac_admin', + action="store_true", + default=False, + help="Using this option creates a Manifest that will request elevation upon application start.", + ) + g.add_argument( + '--uac-uiaccess', + dest='uac_uiaccess', + action="store_true", + default=False, + help="Using this option allows an elevated application to work with Remote Desktop.", + ) + + g = parser.add_argument_group('Windows Side-by-side Assembly searching options (advanced)') + g.add_argument( + "--win-private-assemblies", + action=_RemovedWinPrivateAssembliesAction, + ) + g.add_argument( + "--win-no-prefer-redirects", + action=_RemovedWinNoPreferRedirectsAction, + ) + + g = parser.add_argument_group('macOS specific options') + g.add_argument( + "--argv-emulation", + dest="argv_emulation", + action="store_true", + default=False, + help="Enable argv emulation for macOS app bundles. If enabled, the initial open document/URL event is " + "processed by the bootloader and the passed file paths or URLs are appended to sys.argv.", + ) + + g.add_argument( + '--osx-bundle-identifier', + dest='bundle_identifier', + help="macOS .app bundle identifier is used as the default unique program name for code signing purposes. " + "The usual form is a hierarchical name in reverse DNS notation. For example: com.mycompany.department.appname " + "(default: first script's basename)", + ) + + g.add_argument( + '--target-architecture', + '--target-arch', + dest='target_arch', + metavar='ARCH', + default=None, + help="Target architecture (macOS only; valid values: x86_64, arm64, universal2). Enables switching between " + "universal2 and single-arch version of frozen application (provided python installation supports the target " + "architecture). If not target architecture is not specified, the current running architecture is targeted.", + ) + + g.add_argument( + '--codesign-identity', + dest='codesign_identity', + metavar='IDENTITY', + default=None, + help="Code signing identity (macOS only). Use the provided identity to sign collected binaries and generated " + "executable. If signing identity is not provided, ad-hoc signing is performed instead.", + ) + + g.add_argument( + '--osx-entitlements-file', + dest='entitlements_file', + metavar='FILENAME', + default=None, + help="Entitlements file to use when code-signing the collected binaries (macOS only).", + ) + + g = parser.add_argument_group('Rarely used special options') + g.add_argument( + "--runtime-tmpdir", + dest="runtime_tmpdir", + metavar="PATH", + help="Where to extract libraries and support files in `onefile` mode. If this option is given, the bootloader " + "will ignore any temp-folder location defined by the run-time OS. The ``_MEIxxxxxx``-folder will be created " + "here. Please use this option only if you know what you are doing. Note that on POSIX systems, PyInstaller's " + "bootloader does NOT perform shell-style environment variable expansion on the given path string. Therefore, " + "using environment variables (e.g., ``~`` or ``$HOME``) in path will NOT work.", + ) + g.add_argument( + "--bootloader-ignore-signals", + action="store_true", + default=False, + help="Tell the bootloader to ignore signals rather than forwarding them to the child process. Useful in " + "situations where for example a supervisor process signals both the bootloader and the child (e.g., via a " + "process group) to avoid signalling the child twice.", + ) + + +def main( + scripts, + name=None, + onefile=False, + console=True, + debug=[], + python_options=[], + strip=False, + noupx=False, + upx_exclude=None, + runtime_tmpdir=None, + contents_directory=None, + pathex=[], + version_file=None, + specpath=None, + bootloader_ignore_signals=False, + disable_windowed_traceback=False, + datas=[], + binaries=[], + icon_file=None, + manifest=None, + resources=[], + bundle_identifier=None, + hiddenimports=[], + hookspath=[], + runtime_hooks=[], + excludes=[], + uac_admin=False, + uac_uiaccess=False, + collect_submodules=[], + collect_binaries=[], + collect_data=[], + collect_all=[], + copy_metadata=[], + splash=None, + recursive_copy_metadata=[], + target_arch=None, + codesign_identity=None, + entitlements_file=None, + argv_emulation=False, + hide_console=None, + optimize=None, + **_kwargs +): + # Default values for onefile and console when not explicitly specified on command-line (indicated by None) + if onefile is None: + onefile = False + + if console is None: + console = True + + # If appname is not specified - use the basename of the main script as name. + if name is None: + name = os.path.splitext(os.path.basename(scripts[0]))[0] + + # If specpath not specified - use default value - current working directory. + if specpath is None: + specpath = DEFAULT_SPECPATH + else: + # Expand starting tilde into user's home directory, as a work-around for tilde not being expanded by shell when + # using `--specpath=~/path/abc` instead of `--specpath ~/path/abc` (or when the path argument is quoted). + specpath = os.path.expanduser(specpath) + # If cwd is the root directory of PyInstaller, generate the .spec file in ./appname/ subdirectory. + if specpath == HOMEPATH: + specpath = os.path.join(HOMEPATH, name) + # Create directory tree if missing. + if not os.path.exists(specpath): + os.makedirs(specpath) + + # Handle additional EXE options. + exe_options = '' + if version_file: + exe_options += "\n version='%s'," % escape_win_filepath(version_file) + if uac_admin: + exe_options += "\n uac_admin=True," + if uac_uiaccess: + exe_options += "\n uac_uiaccess=True," + if icon_file: + # Icon file for Windows. + # On Windows, the default icon is embedded in the bootloader executable. + if icon_file[0] == 'NONE': + exe_options += "\n icon='NONE'," + else: + exe_options += "\n icon=[%s]," % ','.join("'%s'" % escape_win_filepath(ic) for ic in icon_file) + # Icon file for macOS. + # We need to encapsulate it into apostrofes. + icon_file = "'%s'" % icon_file[0] + else: + # On macOS, the default icon has to be copied into the .app bundle. + # The the text value 'None' means - use default icon. + icon_file = 'None' + if contents_directory: + exe_options += "\n contents_directory='%s'," % (contents_directory or "_internal") + if hide_console: + exe_options += "\n hide_console='%s'," % hide_console + + if bundle_identifier: + # We need to encapsulate it into apostrofes. + bundle_identifier = "'%s'" % bundle_identifier + + if _kwargs["shorthand_manifest"]: + manifest = _kwargs["shorthand_manifest"] + logger.log( + logging.DEPRECATION, "PyInstaller v7 will remove the -m shorthand flag. Please use --manifest=%s instead", + manifest + ) + if manifest: + if "<" in manifest: + # Assume XML string + exe_options += "\n manifest='%s'," % manifest.replace("'", "\\'") + else: + # Assume filename + exe_options += "\n manifest='%s'," % escape_win_filepath(manifest) + if resources: + resources = list(map(escape_win_filepath, resources)) + exe_options += "\n resources=%s," % repr(resources) + + hiddenimports = hiddenimports or [] + upx_exclude = upx_exclude or [] + + if is_darwin and onefile and not console: + from PyInstaller.building.osx import WINDOWED_ONEFILE_DEPRCATION + logger.log(logging.DEPRECATION, WINDOWED_ONEFILE_DEPRCATION) + + # If file extension of the first script is '.pyw', force --windowed option. + if is_win and os.path.splitext(scripts[0])[-1] == '.pyw': + console = False + + # If script paths are relative, make them relative to the directory containing .spec file. + scripts = [make_path_spec_relative(x, specpath) for x in scripts] + # With absolute paths replace prefix with variable HOMEPATH. + scripts = list(map(Path, scripts)) + + # Translate the default of ``debug=None`` to an empty list. + if debug is None: + debug = [] + # Translate the ``all`` option. + if DEBUG_ALL_CHOICE[0] in debug: + debug = DEBUG_ARGUMENT_CHOICES + + # Create preamble (for collect_*() calls) + preamble = Preamble( + datas, binaries, hiddenimports, collect_data, collect_binaries, collect_submodules, collect_all, copy_metadata, + recursive_copy_metadata + ) + + if splash: + splash_init = splashtmpl % {'splash_image': splash} + splash_binaries = "\n splash.binaries," + splash_target = "\n splash," + else: + splash_init = splash_binaries = splash_target = "" + + # Infer byte-code optimization level. + opt_level = sum([opt == 'O' for opt in python_options]) + if opt_level > 2: + logger.warning( + "The switch '--python-option O' has been specified %d times - it should be specified at most twice!", + opt_level, + ) + opt_level = 2 + + if optimize is None: + if opt_level == 0: + # Infer from running python process + optimize = sys.flags.optimize + else: + # Infer from `--python-option O` switch(es). + optimize = opt_level + elif optimize != opt_level and opt_level != 0: + logger.warning( + "Mismatch between optimization level passed via --optimize switch (%d) and number of '--python-option O' " + "switches (%d)!", + optimize, + opt_level, + ) + + if optimize >= 0: + # Ensure OPTIONs passed to bootloader match the optimization settings. + python_options += max(0, optimize - opt_level) * ['O'] + + # Create OPTIONs array + if 'imports' in debug and 'v' not in python_options: + python_options.append('v') + python_options_array = [(opt, None, 'OPTION') for opt in python_options] + + d = { + 'scripts': scripts, + 'pathex': pathex or [], + 'binaries': preamble.binaries, + 'datas': preamble.datas, + 'hiddenimports': preamble.hiddenimports, + 'preamble': preamble.content, + 'name': name, + 'noarchive': 'noarchive' in debug, + 'optimize': optimize, + 'options': python_options_array, + 'debug_bootloader': 'bootloader' in debug, + 'bootloader_ignore_signals': bootloader_ignore_signals, + 'strip': strip, + 'upx': not noupx, + 'upx_exclude': upx_exclude, + 'runtime_tmpdir': runtime_tmpdir, + 'exe_options': exe_options, + # Directory with additional custom import hooks. + 'hookspath': hookspath, + # List with custom runtime hook files. + 'runtime_hooks': runtime_hooks or [], + # List of modules/packages to ignore. + 'excludes': excludes or [], + # only Windows and macOS distinguish windowed and console apps + 'console': console, + 'disable_windowed_traceback': disable_windowed_traceback, + # Icon filename. Only macOS uses this item. + 'icon': icon_file, + # .app bundle identifier. Only macOS uses this item. + 'bundle_identifier': bundle_identifier, + # argv emulation (macOS only) + 'argv_emulation': argv_emulation, + # Target architecture (macOS only) + 'target_arch': target_arch, + # Code signing identity (macOS only) + 'codesign_identity': codesign_identity, + # Entitlements file (macOS only) + 'entitlements_file': entitlements_file, + # splash screen + 'splash_init': splash_init, + 'splash_target': splash_target, + 'splash_binaries': splash_binaries, + } + + # Write down .spec file to filesystem. + specfnm = os.path.join(specpath, name + '.spec') + with open(specfnm, 'w', encoding='utf-8') as specfile: + if onefile: + specfile.write(onefiletmplt % d) + # For macOS create .app bundle. + if is_darwin and not console: + specfile.write(bundleexetmplt % d) + else: + specfile.write(onedirtmplt % d) + # For macOS create .app bundle. + if is_darwin and not console: + specfile.write(bundletmplt % d) + + return specfnm diff --git a/venv/lib/python3.12/site-packages/PyInstaller/building/osx.py b/venv/lib/python3.12/site-packages/PyInstaller/building/osx.py new file mode 100755 index 0000000..dca5649 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/building/osx.py @@ -0,0 +1,736 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import os +import pathlib +import plistlib +import shutil +import subprocess + +from PyInstaller import log as logging +from PyInstaller.building.api import COLLECT, EXE +from PyInstaller.building.datastruct import Target, logger, normalize_toc +from PyInstaller.building.utils import _check_path_overlap, _rmtree, process_collected_binary +from PyInstaller.compat import is_darwin, strict_collect_mode +from PyInstaller.building.icon import normalize_icon_type +import PyInstaller.utils.misc as miscutils + +if is_darwin: + import PyInstaller.utils.osx as osxutils + +# Character sequence used to replace dot (`.`) in names of directories that are created in `Contents/MacOS` or +# `Contents/Frameworks`, where only .framework bundle directories are allowed to have dot in name. +DOT_REPLACEMENT = '__dot__' + +WINDOWED_ONEFILE_DEPRCATION = ( + "Onefile mode in combination with macOS .app bundles (windowed mode) don't make sense (a .app bundle can not be a " + "single file) and clashes with macOS's security. Please migrate to onedir mode. This will become an error " + "in v7.0." +) + + +class BUNDLE(Target): + def __init__(self, *args, **kwargs): + from PyInstaller.config import CONF + + for item in args: + if isinstance(item, EXE) and not item.exclude_binaries: + logger.log(logging.DEPRECATION, WINDOWED_ONEFILE_DEPRCATION) + + # BUNDLE only has a sense under macOS, it is a noop on other platforms. + if not is_darwin: + return + + # Get a path to a .icns icon for the app bundle. + self.icon = kwargs.get('icon') + if not self.icon: + # --icon not specified; use the default in the pyinstaller folder + self.icon = os.path.join( + os.path.dirname(os.path.dirname(__file__)), 'bootloader', 'images', 'icon-windowed.icns' + ) + else: + # User gave an --icon=path. If it is relative, make it relative to the spec file location. + if not os.path.isabs(self.icon): + self.icon = os.path.join(CONF['specpath'], self.icon) + + super().__init__() + + # .app bundle is created in DISTPATH. + self.name = kwargs.get('name', None) + base_name = os.path.basename(self.name) + self.name = os.path.join(CONF['distpath'], base_name) + + self.appname = os.path.splitext(base_name)[0] + # Ensure version is a string, even if user accidentally passed an int or a float. + # Having a `CFBundleShortVersionString` entry of non-string type in `Info.plist` causes the .app bundle to + # crash at start (#4466). + self.version = str(kwargs.get("version", "0.0.0")) + self.toc = [] + self.strip = False + self.upx = False + self.console = True + self.target_arch = None + self.codesign_identity = None + self.entitlements_file = None + + # .app bundle identifier for Code Signing + self.bundle_identifier = kwargs.get('bundle_identifier') + if not self.bundle_identifier: + # Fallback to appname. + self.bundle_identifier = self.appname + + self.info_plist = kwargs.get('info_plist', None) + + for arg in args: + # Valid arguments: EXE object, COLLECT object, and TOC-like iterables + if isinstance(arg, EXE): + # Add EXE as an entry to the TOC, and merge its dependencies TOC + self.toc.append((os.path.basename(arg.name), arg.name, 'EXECUTABLE')) + self.toc.extend(arg.dependencies) + # Inherit settings + self.strip = arg.strip + self.upx = arg.upx + self.upx_exclude = arg.upx_exclude + self.console = arg.console + self.target_arch = arg.target_arch + self.codesign_identity = arg.codesign_identity + self.entitlements_file = arg.entitlements_file + elif isinstance(arg, COLLECT): + # Merge the TOC + self.toc.extend(arg.toc) + # Inherit settings + self.strip = arg.strip_binaries + self.upx = arg.upx_binaries + self.upx_exclude = arg.upx_exclude + self.console = arg.console + self.target_arch = arg.target_arch + self.codesign_identity = arg.codesign_identity + self.entitlements_file = arg.entitlements_file + elif miscutils.is_iterable(arg): + # TOC-like iterable + self.toc.extend(arg) + else: + raise TypeError(f"Invalid argument type for BUNDLE: {type(arg)!r}") + + # Infer the executable name from the first EXECUTABLE entry in the TOC; it might have come from the COLLECT + # (as opposed to the stand-alone EXE). + for dest_name, src_name, typecode in self.toc: + if typecode == "EXECUTABLE": + self.exename = src_name + break + else: + raise ValueError("No EXECUTABLE entry found in the TOC!") + + # Normalize TOC + self.toc = normalize_toc(self.toc) + + self.__postinit__() + + _GUTS = ( + # BUNDLE always builds, just want the toc to be written out + ('toc', None), + ) + + def _check_guts(self, data, last_build): + # BUNDLE always needs to be executed, in order to clean the output directory. + return True + + # Helper for determining whether the given file belongs to a .framework bundle or not. If it does, it returns + # the path to the top-level .framework bundle directory; otherwise, returns None. In case of nested .framework + # bundles, the path to the top-most .framework bundle directory is returned. + @staticmethod + def _is_framework_file(dest_path): + # NOTE: reverse the parents list because we are looking for the top-most .framework bundle directory! + for parent in reversed(dest_path.parents): + if parent.name.endswith('.framework'): + return parent + return None + + # Helper that computes relative cross-link path between link's location and target, assuming they are both + # rooted in the `Contents` directory of a macOS .app bundle. + @staticmethod + def _compute_relative_crosslink(crosslink_location, crosslink_target): + # We could take symlink_location and symlink_target as they are (relative to parent of the `Contents` + # directory), but that would introduce an unnecessary `../Contents` part. So instead, we take both paths + # relative to the `Contents` directory. + return os.path.join( + *['..' for level in pathlib.PurePath(crosslink_location).relative_to('Contents').parent.parts], + pathlib.PurePath(crosslink_target).relative_to('Contents'), + ) + + # This method takes the original (input) TOC and processes it into final TOC, based on which the `assemble` method + # performs its file collection. The TOC processing here represents the core of our efforts to generate an .app + # bundle that is compatible with Apple's code-signing requirements. + # + # For in-depth details on the code-signing, see Apple's `Technical Note TN2206: macOS Code Signing In Depth` at + # https://developer.apple.com/library/archive/technotes/tn2206/_index.html + # + # The requirements, framed from PyInstaller's perspective, can be summarized as follows: + # + # 1. The `Contents/MacOS` directory is expected to contain only the program executable and (binary) code (= dylibs + # and nested .framework bundles). Alternatively, the dylibs and .framework bundles can be also placed into + # `Contents/Frameworks` directory (where same rules apply as for `Contents/MacOS`, so the remainder of this + # text refers to the two inter-changeably, unless explicitly noted otherwise). The code in `Contents/MacOS` + # is expected to be signed, and the `codesign` utility will recursively sign all found code when using `--deep` + # option to sign the .app bundle. + # + # 2. All non-code files should be be placed in `Contents/Resources`, so they become sealed (data) resources; + # i.e., their signature data is recorded in `Contents/_CodeSignature/CodeResources`. (As a side note, + # it seems that signature information for data/resources in `Contents/Resources` is kept nder `file` key in + # the `CodeResources` file, while the information for contents in `Contents/MacOS` is kept under `file2` key). + # + # 3. The directories in `Contents/MacOS` may not contain dots (`.`) in their names, except for the nested + # .framework bundle directories. The directories in `Contents/Resources` have no such restrictions. + # + # 4. There may not be any content in the top level of a bundle. In other words, if a bundle has a `Contents` + # or a `Versions` directory at its top level, there may be no other files or directories alongside them. The + # sole exception is that alongside `Versions`, there may be symlinks to files and directories in + # `Versions/Current`. This rule is important for nested .framework bundles that we collect from python packages. + # + # Next, let us consider the consequences of violating each of the above requirements: + # + # 1. Code signing machinery can directly store signature only in Mach-O binaries and nested .framework bundles; if + # a data file is placed in `Contents/MacOS`, the signature is stored in the file's extended attributes. If the + # extended attributes are lost, the program's signature will be broken. Many file transfer techniques (e.g., a + # zip file) do not preserve extended attributes, nor are they preserved when uploading to the Mac App Store. + # + # 2. Putting code (a dylib or a .framework bundle) into `Contents/Resources` causes it to be treated as a resource; + # the outer signature (i.e., of the whole .app bundle) does not know that this nested content is actually a code. + # Consequently, signing the bundle with `codesign --deep` will NOT sign binaries placed in the + # `Contents/Resources`, which may result in missing signatures when .app bundle is verified for notarization. + # This might be worked around by signing each binary separately, and then signing the whole bundle (without the + # `--deep` option), but requires the user to keep track of the offending binaries. + # + # 3. If a directory in `Contents/MacOS` contains a dot in the name, code-signing the bundle fails with + # `bundle format unrecognized, invalid, or unsuitable` due to code signing machinery treating directory as a + # nested .framework bundle directory. + # + # 4. If nested .framework bundle is malformed, the signing of the .app bundle might succeed, but subsequent + # verification will fail, for example with `embedded framework contains modified or invalid version` (as observed + # with .framework bundles shipped by contemporary PyQt/PySide PyPI wheels). + # + # The above requirements are unfortunately often at odds with the structure of python packages: + # + # * In general, python packages are mixed-content directories, where binaries and data files may be expected to + # be found next to each other. + # + # For example, `opencv-python` provides a custom loader script that requires the package to be collected in the + # source-only form by PyInstaller (i.e., the python modules and scripts collected as source .py files). At the + # same time, it expects the .py loader script to be able to find the binary extension next to itself. + # + # Another example of mixed-mode directories are Qt QML components' sub-directories, which contain both the + # component's plugin (a binary) and associated meta files (data files). + # + # * In python world, the directories often contain dots in their names. + # + # Dots are often used for private directories containing binaries that are shipped with a package. For example, + # `numpy/.dylibs`, `scipy/.dylibs`, etc. + # + # Qt QML components may also contain a dot in their name; couple of examples from `PySide2` package: + # `PySide2/Qt/qml/QtQuick.2`, `PySide2/Qt/qml/QtQuick/Controls.2`, `PySide2/Qt/qml/QtQuick/Particles.2`, etc. + # + # The packages' metadata directories also invariably contain dots in the name due to version (for example, + # `numpy-1.24.3.dist-info`). + # + # In the light of all above, PyInstaller attempts to strictly place all files to their mandated location + # (`Contents/MacOS` or `Contents/Frameworks` vs `Contents/Resources`). To preserve the illusion of mixed-content + # directories, the content is cross-linked from one directory to the other. Specifically: + # + # * All entries with DATA typecode are assumed to be data files, and are always placed in corresponding directory + # structure rooted in `Contents/Resources`. + # + # * All entries with BINARY or EXTENSION typecode are always placed in corresponding directory structure rooted in + # `Contents/Frameworks`. + # + # * All entries with EXECUTABLE are placed in `Contents/MacOS` directory. + # + # * For the purposes of relocation, nested .framework bundles are treated as a single BINARY entity; i.e., the + # whole .bundle directory is placed in corresponding directory structure rooted in `Contents/Frameworks` (even + # though some of its contents, such as `Info.plist` file, are actually data files). + # + # * Top-level data files and binaries are always cross-linked to the other directory. For example, given a data file + # `data_file.txt` that was collected into `Contents/Resources`, we create a symbolic link called + # `Contents/MacOS/data_file.txt` that points to `../Resources/data_file.txt`. + # + # * The executable itself, while placed in `Contents/MacOS`, are cross-linked into both `Contents/Framworks` and + # `Contents/Resources`. + # + # * The stand-alone PKG entries (used with onefile builds that side-load the PKG archive) are treated as data files + # and collected into `Contents/Resources`, but cross-linked only into `Contents/MacOS` directory (because they + # must appear to be next to the program executable). This is the only entry type that is cross-linked into the + # `Contents/MacOS` directory and also the only data-like entry type that is not cross-linked into the + # `Contents/Frameworks` directory. + # + # * For files in sub-directories, the cross-linking behavior depends on the type of directory: + # + # * A data-only directory is created in directory structure rooted in `Contents/Resources`, and cross-linked + # into directory structure rooted in `Contents/Frameworks` at directory level (i.e., we link the whole + # directory instead of individual files). + # + # This largely saves us from having to deal with dots in the names of collected metadata directories, which + # are examples of data-only directories. + # + # * A binary-only directory is created in directory structure rooted in `Contents/Frameworks`, and cross-linked + # into `Contents/Resources` at directory level. + # + # * A mixed-content directory is created in both directory structures. Files are placed into corresponding + # directory structure based on their type, and cross-linked into other directory structure at file level. + # + # * This rule is applied recursively; for example, a data-only sub-directory in a mixed-content directory is + # cross-linked at directory level, while adjacent binary and data files are cross-linked at file level. + # + # * To work around the issue with dots in the names of directories in `Contents/Frameworks` (applicable to + # binary-only or mixed-content directories), such directories are created with modified name (the dot replaced + # with a pre-defined pattern). Next to the modified directory, a symbolic link with original name is created, + # pointing to the directory with modified name. With mixed-content directories, this modification is performed + # only on the `Contents/Frameworks` side; the corresponding directory in `Contents/Resources` can be created + # directly, without name modification and symbolic link. + # + # * If a symbolic link needs to be created in a mixed-content directory due to a SYMLINK entry from the original + # TOC (i.e., a "collected" symlink originating from analysis, as opposed to the cross-linking mechanism described + # above), the link is created in both directory structures, each pointing to the resource in its corresponding + # directory structure (with one such resource being an actual file, and the other being a cross-link to the file). + # + # Final remarks: + # + # NOTE: the relocation mechanism is codified by tests in `tests/functional/test_macos_bundle_structure.py`. + # + # NOTE: by placing binaries and nested .framework entries into `Contents/Frameworks` instead of `Contents/MacOS`, + # we have effectively relocated the `sys._MEIPASS` directory from the `Contents/MacOS` (= the parent directory of + # the program executable) into `Contents/Frameworks`. This requires the PyInstaller's bootloader to detect that it + # is running in the app-bundle mode (e.g., by checking if program executable's parent directory is `Contents/NacOS`) + # and adjust the path accordingly. + # + # NOTE: the implemented relocation mechanism depends on the input TOC containing properly classified entries + # w.r.t. BINARY vs DATA. So hooks and .spec files triggering collection of binaries as datas (and vice versa) will + # result in incorrect placement of those files in the generated .app bundle. However, this is *not* the proper place + # to address such issues; if necessary, automatic (re)classification should be added to analysis process, to ensure + # that BUNDLE (as well as other build targets) receive correctly classified TOC. + # + # NOTE: similar to the previous note, the relocation mechanism is also not the proper place to enforce compliant + # structure of the nested .framework bundles. Instead, this is handled by the analysis process, using the + # `PyInstaller.utils.osx.collect_files_from_framework_bundles` helper function. So the input TOC that BUNDLE + # receives should already contain entries that reconstruct compliant nested .framework bundles. + def _process_bundle_toc(self, toc): + bundle_toc = [] + + # Step 1: inspect the directory layout and classify the directories according to their contents. + directory_types = dict() + + _MIXED_DIR_TYPE = 'MIXED-DIR' + _DATA_DIR_TYPE = 'DATA-DIR' + _BINARY_DIR_TYPE = 'BINARY-DIR' + _FRAMEWORK_DIR_TYPE = 'FRAMEWORK-DIR' + + _TOP_LEVEL_DIR = pathlib.PurePath('.') + + for dest_name, src_name, typecode in toc: + dest_path = pathlib.PurePath(dest_name) + + framework_dir = self._is_framework_file(dest_path) + if framework_dir: + # Mark the framework directory as FRAMEWORK-DIR. + directory_types[framework_dir] = _FRAMEWORK_DIR_TYPE + # Treat the framework directory as BINARY file when classifying parent directories. + typecode = 'BINARY' + parent_dirs = framework_dir.parents + else: + parent_dirs = dest_path.parents + # Treat BINARY and EXTENSION as BINARY to simplify further processing. + if typecode == 'EXTENSION': + typecode = 'BINARY' + + # (Re)classify parent directories + for parent_dir in parent_dirs: + # Skip the top-level `.` dir. This is also the only directory that can contain EXECUTABLE and PKG + # entries, so we do not have to worry about. + if parent_dir == _TOP_LEVEL_DIR: + continue + + directory_type = _BINARY_DIR_TYPE if typecode == 'BINARY' else _DATA_DIR_TYPE # default + directory_type = directory_types.get(parent_dir, directory_type) + + if directory_type == _DATA_DIR_TYPE and typecode == 'BINARY': + directory_type = _MIXED_DIR_TYPE + if directory_type == _BINARY_DIR_TYPE and typecode == 'DATA': + directory_type = _MIXED_DIR_TYPE + + directory_types[parent_dir] = directory_type + + logger.debug("Directory classification: %r", directory_types) + + # Step 2: process the obtained directory structure and create symlink entries for directories that need to be + # cross-linked. Such directories are data-only and binary-only directories (and framework directories) that are + # located either in the top-level directory (have no parent) or in a mixed-content directory. + for directory_path, directory_type in directory_types.items(): + # Cross-linking at directory level applies only to data-only and binary-only directories (as well as + # framework directories). + if directory_type == _MIXED_DIR_TYPE: + continue + + # The parent needs to be either top-level directory or a mixed-content directory. Otherwise, the parent + # (or one of its ancestors) will get cross-linked, and we do not need the link here. + parent_dir = directory_path.parent + requires_crosslink = parent_dir == _TOP_LEVEL_DIR or directory_types.get(parent_dir) == _MIXED_DIR_TYPE + if not requires_crosslink: + continue + + logger.debug("Cross-linking directory %r of type %r", directory_path, directory_type) + + # Data-only directories are created in `Contents/Resources`, needs to be cross-linked into `Contents/MacOS`. + # Vice versa for binary-only or framework directories. The directory creation is handled implicitly, when we + # create parent directory structure for collected files. + if directory_type == _DATA_DIR_TYPE: + symlink_src = os.path.join('Contents/Resources', directory_path) + symlink_dest = os.path.join('Contents/Frameworks', directory_path) + else: + symlink_src = os.path.join('Contents/Frameworks', directory_path) + symlink_dest = os.path.join('Contents/Resources', directory_path) + symlink_ref = self._compute_relative_crosslink(symlink_dest, symlink_src) + + bundle_toc.append((symlink_dest, symlink_ref, 'SYMLINK')) + + # Step 3: first part of the work-around for directories that are located in `Contents/Frameworks` but contain a + # dot in their name. As per `codesign` rules, the only directories in `Contents/Frameworks` that are allowed to + # contain a dot in their name are .framework bundle directories. So we replace the dot with a custom character + # sequence (stored in global `DOT_REPLACEMENT` variable), and create a symbolic with original name pointing to + # the modified name. This is the best we can do with code-sign requirements vs. python community showing their + # packages' dylibs into `.dylib` subdirectories, or Qt storing their Qml components in directories named + # `QtQuick.2`, `QtQuick/Controls.2`, `QtQuick/Particles.2`, `QtQuick/Templates.2`, etc. + # + # In this step, we only prepare symlink entries that link the original directory name (with dot) to the modified + # one (with dot replaced). The parent paths for collected files are modified in later step(s). + for directory_path, directory_type in directory_types.items(): + # .framework bundle directories contain a dot in the name, but are allowed that. + if directory_type == _FRAMEWORK_DIR_TYPE: + continue + + # Data-only directories are fully located in `Contents/Resources` and cross-linked to `Contents/Frameworks` + # at directory level, so they are also allowed a dot in their name. + if directory_type == _DATA_DIR_TYPE: + continue + + # Apply the work-around, if necessary... + if '.' not in directory_path.name: + continue + + logger.debug( + "Creating symlink to work around the dot in the name of directory %r (%s)...", str(directory_path), + directory_type + ) + + # Create a SYMLINK entry, but only for this level. In case of nested directories with dots in names, the + # symlinks for ancestors will be created by corresponding loop iteration. + bundle_toc.append(( + os.path.join('Contents/Frameworks', directory_path), + directory_path.name.replace('.', DOT_REPLACEMENT), + 'SYMLINK', + )) + + # Step 4: process the entries for collected files, and decide whether they should be placed into + # `Contents/MacOS`, `Contents/Frameworks`, or `Contents/Resources`, and whether they should be cross-linked into + # other directories. + for orig_dest_name, src_name, typecode in toc: + orig_dest_path = pathlib.PurePath(orig_dest_name) + + # Special handling for EXECUTABLE and PKG entries + if typecode == 'EXECUTABLE': + # Place into `Contents/MacOS`, ... + file_dest = os.path.join('Contents/MacOS', orig_dest_name) + bundle_toc.append((file_dest, src_name, typecode)) + # ... and do nothing else. We explicitly avoid cross-linking the executable to `Contents/Frameworks` and + # `Contents/Resources`, because it should be not necessary (the executable's location should be + # discovered via `sys.executable`) and to prevent issues when executable name collides with name of a + # package from which we collect either binaries or data files (or both); see #7314. + continue + elif typecode == 'PKG': + # Place into `Contents/Resources` ... + file_dest = os.path.join('Contents/Resources', orig_dest_name) + bundle_toc.append((file_dest, src_name, typecode)) + # ... and cross-link only into `Contents/MacOS`. + # This is used only in `onefile` mode, where there is actually no other content to distribute among the + # `Contents/Resources` and `Contents/Frameworks` directories, so cross-linking into the latter makes + # little sense. + symlink_dest = os.path.join('Contents/MacOS', orig_dest_name) + symlink_ref = self._compute_relative_crosslink(symlink_dest, file_dest) + bundle_toc.append((symlink_dest, symlink_ref, 'SYMLINK')) + continue + + # Standard data vs binary processing... + + # Determine file location based on its type. + if self._is_framework_file(orig_dest_path): + # File from a framework bundle; put into `Contents/Frameworks`, but never cross-link the file itself. + # The whole .framework bundle directory will be linked as necessary by the directory cross-linking + # mechanism. + file_base_dir = 'Contents/Frameworks' + crosslink_base_dir = None + elif typecode == 'DATA': + # Data file; relocate to `Contents/Resources` and cross-link it back into `Contents/Frameworks`. + file_base_dir = 'Contents/Resources' + crosslink_base_dir = 'Contents/Frameworks' + else: + # Binary; put into `Contents/Frameworks` and cross-link it into `Contents/Resources`. + file_base_dir = 'Contents/Frameworks' + crosslink_base_dir = 'Contents/Resources' + + # Determine if we need to cross-link the file. We need to do this for top-level files (the ones without + # parent directories), and for files whose parent directories are mixed-content directories. + requires_crosslink = False + if crosslink_base_dir is not None: + parent_dir = orig_dest_path.parent + requires_crosslink = parent_dir == _TOP_LEVEL_DIR or directory_types.get(parent_dir) == _MIXED_DIR_TYPE + + # Special handling for SYMLINK entries in original TOC; if we need to cross-link a symlink entry, we create + # it in both locations, and have each point to the (relative) resource in the same directory (so one of the + # targets will likely be a file, and the other will be a symlink due to cross-linking). + if typecode == 'SYMLINK' and requires_crosslink: + bundle_toc.append((os.path.join(file_base_dir, orig_dest_name), src_name, typecode)) + bundle_toc.append((os.path.join(crosslink_base_dir, orig_dest_name), src_name, typecode)) + continue + + # The file itself. + file_dest = os.path.join(file_base_dir, orig_dest_name) + bundle_toc.append((file_dest, src_name, typecode)) + + # Symlink for cross-linking + if requires_crosslink: + symlink_dest = os.path.join(crosslink_base_dir, orig_dest_name) + symlink_ref = self._compute_relative_crosslink(symlink_dest, file_dest) + bundle_toc.append((symlink_dest, symlink_ref, 'SYMLINK')) + + # Step 5: sanitize all destination paths in the new TOC, to ensure that paths that are rooted in + # `Contents/Frameworks` do not contain directories with dots in their names. Doing this as a post-processing + # step keeps code simple and clean and ensures that this step is applied to files, symlinks that originate from + # cross-linking files, and symlinks that originate from cross-linking directories. This in turn ensures that + # all directory hierarchies created during the actual file collection have sanitized names, and that collection + # outcome does not depend on the order of entries in the TOC. + sanitized_toc = [] + for dest_name, src_name, typecode in bundle_toc: + dest_path = pathlib.PurePath(dest_name) + + # Paths rooted in Contents/Resources do not require sanitizing. + if dest_path.parts[0] == 'Contents' and dest_path.parts[1] == 'Resources': + sanitized_toc.append((dest_name, src_name, typecode)) + continue + + # Special handling for files from .framework bundle directories; sanitize only parent path of the .framework + # directory. + framework_path = self._is_framework_file(dest_path) + if framework_path: + parent_path = framework_path.parent + remaining_path = dest_path.relative_to(parent_path) + else: + parent_path = dest_path.parent + remaining_path = dest_path.name + + sanitized_dest_path = pathlib.PurePath( + *parent_path.parts[:2], # Contents/Frameworks + *[part.replace('.', DOT_REPLACEMENT) for part in parent_path.parts[2:]], + remaining_path, + ) + sanitized_dest_name = str(sanitized_dest_path) + + if sanitized_dest_path != dest_path: + logger.debug("Sanitizing dest path: %r -> %r", dest_name, sanitized_dest_name) + + sanitized_toc.append((sanitized_dest_name, src_name, typecode)) + + bundle_toc = sanitized_toc + + # Normalize and sort the TOC for easier inspection + bundle_toc = sorted(normalize_toc(bundle_toc)) + + return bundle_toc + + def assemble(self): + from PyInstaller.config import CONF + + if _check_path_overlap(self.name) and os.path.isdir(self.name): + _rmtree(self.name) + + logger.info("Building BUNDLE %s", self.tocbasename) + + # Create a minimal Mac bundle structure. + os.makedirs(os.path.join(self.name, "Contents", "MacOS")) + os.makedirs(os.path.join(self.name, "Contents", "Resources")) + os.makedirs(os.path.join(self.name, "Contents", "Frameworks")) + + # Makes sure the icon exists and attempts to convert to the proper format if applicable + self.icon = normalize_icon_type(self.icon, ("icns",), "icns", CONF["workpath"]) + + # Ensure icon path is absolute + self.icon = os.path.abspath(self.icon) + + # Copy icns icon to Resources directory. + shutil.copyfile(self.icon, os.path.join(self.name, 'Contents', 'Resources', os.path.basename(self.icon))) + + # Key/values for a minimal Info.plist file + info_plist_dict = { + "CFBundleDisplayName": self.appname, + "CFBundleName": self.appname, + + # Required by 'codesign' utility. + # The value for CFBundleIdentifier is used as the default unique name of your program for Code Signing + # purposes. It even identifies the APP for access to restricted macOS areas like Keychain. + # + # The identifier used for signing must be globally unique. The usual form for this identifier is a + # hierarchical name in reverse DNS notation, starting with the toplevel domain, followed by the company + # name, followed by the department within the company, and ending with the product name. Usually in the + # form: com.mycompany.department.appname + # CLI option --osx-bundle-identifier sets this value. + "CFBundleIdentifier": self.bundle_identifier, + "CFBundleExecutable": os.path.basename(self.exename), + "CFBundleIconFile": os.path.basename(self.icon), + "CFBundleInfoDictionaryVersion": "6.0", + "CFBundlePackageType": "APPL", + "CFBundleShortVersionString": self.version, + } + + # Set some default values. But they still can be overwritten by the user. + if self.console: + # Setting EXE console=True implies LSBackgroundOnly=True. + info_plist_dict['LSBackgroundOnly'] = True + else: + # Let's use high resolution by default. + info_plist_dict['NSHighResolutionCapable'] = True + + # Merge info_plist settings from spec file + if isinstance(self.info_plist, dict) and self.info_plist: + info_plist_dict.update(self.info_plist) + + plist_filename = os.path.join(self.name, "Contents", "Info.plist") + with open(plist_filename, "wb") as plist_fh: + plistlib.dump(info_plist_dict, plist_fh) + + # Pre-process the TOC into its final BUNDLE-compatible form. + bundle_toc = self._process_bundle_toc(self.toc) + + # Perform the actual collection. + CONTENTS_FRAMEWORKS_PATH = pathlib.PurePath('Contents/Frameworks') + for dest_name, src_name, typecode in bundle_toc: + # Create parent directory structure, if necessary + dest_path = os.path.join(self.name, dest_name) # Absolute destination path + dest_dir = os.path.dirname(dest_path) + try: + os.makedirs(dest_dir, exist_ok=True) + except FileExistsError: + raise SystemExit( + f"ERROR: Pyinstaller needs to create a directory at {dest_dir!r}, " + "but there already exists a file at that path!" + ) + # Copy extensions and binaries from cache. This ensures that these files undergo additional binary + # processing - have paths to linked libraries rewritten (relative to `@rpath`) and have rpath set to the + # top-level directory (relative to `@loader_path`, i.e., the file's location). The "top-level" directory + # in this case corresponds to `Contents/MacOS` (where `sys._MEIPASS` also points), so we need to pass + # the cache retrieval function the *original* destination path (which is without preceding + # `Contents/MacOS`). + if typecode in ('EXTENSION', 'BINARY'): + orig_dest_name = str(pathlib.PurePath(dest_name).relative_to(CONTENTS_FRAMEWORKS_PATH)) + src_name = process_collected_binary( + src_name, + orig_dest_name, + use_strip=self.strip, + use_upx=self.upx, + upx_exclude=self.upx_exclude, + target_arch=self.target_arch, + codesign_identity=self.codesign_identity, + entitlements_file=self.entitlements_file, + strict_arch_validation=(typecode == 'EXTENSION'), + ) + if typecode == 'SYMLINK': + os.symlink(src_name, dest_path) # Create link at dest_path, pointing at (relative) src_name + else: + # BUNDLE does not support MERGE-based multipackage + assert typecode != 'DEPENDENCY', "MERGE DEPENDENCY entries are not supported in BUNDLE!" + + # At this point, `src_name` should be a valid file. + if not os.path.isfile(src_name): + raise ValueError(f"Resource {src_name!r} is not a valid file!") + # If strict collection mode is enabled, the destination should not exist yet. + if strict_collect_mode and os.path.exists(dest_path): + raise ValueError( + f"Attempting to collect a duplicated file into BUNDLE: {dest_name} (type: {typecode})" + ) + # Use `shutil.copyfile` to copy file with default permissions. We do not attempt to preserve original + # permissions nor metadata, as they might be too restrictive and cause issues either during subsequent + # re-build attempts or when trying to move the application bundle. For binaries (and data files with + # executable bit set), we manually set the executable bits after copying the file. + shutil.copyfile(src_name, dest_path) + if ( + typecode in ('EXTENSION', 'BINARY', 'EXECUTABLE') + or (typecode == 'DATA' and os.access(src_name, os.X_OK)) + ): + os.chmod(dest_path, 0o755) + + # Sign the bundle + logger.info('Signing the BUNDLE...') + try: + osxutils.sign_binary(self.name, self.codesign_identity, self.entitlements_file, deep=True) + except Exception as e: + # Display a warning or re-raise the error, depending on the environment-variable setting. + if os.environ.get("PYINSTALLER_STRICT_BUNDLE_CODESIGN_ERROR", "0") == "0": + logger.warning("Error while signing the bundle: %s", e) + logger.warning("You will need to sign the bundle manually!") + else: + raise RuntimeError("Failed to codesign the bundle!") from e + + logger.info("Building BUNDLE %s completed successfully.", self.tocbasename) + + # Optionally verify bundle's signature. This is primarily intended for our CI. + if os.environ.get("PYINSTALLER_VERIFY_BUNDLE_SIGNATURE", "0") != "0": + logger.info("Verifying signature for BUNDLE %s...", self.name) + self.verify_bundle_signature(self.name) + logger.info("BUNDLE verification complete!") + + @staticmethod + def verify_bundle_signature(bundle_dir): + # First, verify the bundle signature using codesign. + cmd_args = ['/usr/bin/codesign', '--verify', '--all-architectures', '--deep', '--strict', bundle_dir] + p = subprocess.run(cmd_args, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, encoding='utf8') + if p.returncode: + raise SystemError( + f"codesign command ({cmd_args}) failed with error code {p.returncode}!\noutput: {p.stdout}" + ) + + # Ensure that code-signing information is *NOT* embedded in the files' extended attributes. + # + # This happens when files other than binaries are present in `Contents/MacOS` or `Contents/Frameworks` + # directory; as the signature cannot be embedded within the file itself (contrary to binaries with + # `LC_CODE_SIGNATURE` section in their header), it ends up stores in the file's extended attributes. However, + # if such bundle is transferred using a method that does not support extended attributes (for example, a zip + # file), the signatures on these files are lost, and the signature of the bundle as a whole becomes invalid. + # This is the primary reason why we need to relocate non-binaries into `Contents/Resources` - the signatures + # for files in that directory end up stored in `Contents/_CodeSignature/CodeResources` file. + # + # This check therefore aims to ensure that all files have been properly relocated to their corresponding + # locations w.r.t. the code-signing requirements. + + try: + import xattr + except ModuleNotFoundError: + logger.info("xattr package not available; skipping verification of extended attributes!") + return + + CODESIGN_ATTRS = ( + "com.apple.cs.CodeDirectory", + "com.apple.cs.CodeRequirements", + "com.apple.cs.CodeRequirements-1", + "com.apple.cs.CodeSignature", + ) + + for entry in pathlib.Path(bundle_dir).rglob("*"): + if not entry.is_file(): + continue + + file_attrs = xattr.listxattr(entry) + if any([codesign_attr in file_attrs for codesign_attr in CODESIGN_ATTRS]): + raise ValueError(f"Code-sign attributes found in extended attributes of {str(entry)!r}!") diff --git a/venv/lib/python3.12/site-packages/PyInstaller/building/splash.py b/venv/lib/python3.12/site-packages/PyInstaller/building/splash.py new file mode 100755 index 0000000..c22215c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/building/splash.py @@ -0,0 +1,476 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +# ----------------------------------------------------------------------------- +import io +import os +import re +import struct +import pathlib + +from PyInstaller import log as logging +from PyInstaller.archive.writers import SplashWriter +from PyInstaller.building import splash_templates +from PyInstaller.building.datastruct import Target +from PyInstaller.building.utils import _check_guts_eq, _check_guts_toc, misc +from PyInstaller.compat import is_aix, is_darwin +from PyInstaller.depend import bindepend +from PyInstaller.utils.hooks.tcl_tk import tcltk_info + +try: + from PIL import Image as PILImage +except ImportError: + PILImage = None + +logger = logging.getLogger(__name__) + +# These requirement files are checked against the current splash screen script. If you wish to modify the splash screen +# and run into tcl errors/bad behavior, this is a good place to start and add components your implementation of the +# splash screen might use. +# NOTE: these paths use the *destination* layout for Tcl/Tk scripts, which uses unversioned tcl and tk directories +# (see `PyInstaller.utils.hooks.tcl_tk.collect_tcl_tk_files`). +splash_requirements = [ + # prepended tcl/tk binaries + os.path.join(tcltk_info.TK_ROOTNAME, "license.terms"), + os.path.join(tcltk_info.TK_ROOTNAME, "text.tcl"), + os.path.join(tcltk_info.TK_ROOTNAME, "tk.tcl"), + # Used for customizable font + os.path.join(tcltk_info.TK_ROOTNAME, "ttk", "ttk.tcl"), + os.path.join(tcltk_info.TK_ROOTNAME, "ttk", "fonts.tcl"), + os.path.join(tcltk_info.TK_ROOTNAME, "ttk", "cursors.tcl"), + os.path.join(tcltk_info.TK_ROOTNAME, "ttk", "utils.tcl"), +] + + +class Splash(Target): + """ + Bundles the required resources for the splash screen into a file, which will be included in the CArchive. + + A Splash has two outputs, one is itself and one is stored in splash.binaries. Both need to be passed to other + build targets in order to enable the splash screen. + """ + def __init__(self, image_file, binaries, datas, **kwargs): + """ + :param str image_file: + A path-like object to the image to be used. Only the PNG file format is supported. + + .. note:: If a different file format is supplied and PIL (Pillow) is installed, the file will be converted + automatically. + + .. note:: *Windows*: The color ``'magenta'`` / ``'#ff00ff'`` must not be used in the image or text, as it is + used by splash screen to indicate transparent areas. Use a similar color (e.g., ``'#ff00fe'``) instead. + + .. note:: If PIL (Pillow) is installed and the image is bigger than max_img_size, the image will be resized + to fit into the specified area. + :param list binaries: + The TOC list of binaries the Analysis build target found. This TOC includes all extension modules and their + binary dependencies. This is required to determine whether the user's program uses `tkinter`. + :param list datas: + The TOC list of data the Analysis build target found. This TOC includes all data-file dependencies of the + modules. This is required to check if all splash screen requirements can be bundled. + + :keyword text_pos: + An optional two-integer tuple that represents the origin of the text on the splash screen image. The + origin of the text is its lower left corner. A unit in the respective coordinate system is a pixel of the + image, its origin lies in the top left corner of the image. This parameter also acts like a switch for + the text feature. If omitted, no text will be displayed on the splash screen. This text will be used to + show textual progress in onefile mode. + :type text_pos: Tuple[int, int] + :keyword text_size: + The desired size of the font. If the size argument is a positive number, it is interpreted as a size in + points. If size is a negative number, its absolute value is interpreted as a size in pixels. Default: ``12`` + :type text_size: int + :keyword text_font: + An optional name of a font for the text. This font must be installed on the user system, otherwise the + system default font is used. If this parameter is omitted, the default font is also used. + :keyword text_color: + An optional color for the text. HTML color codes (``'#40e0d0'``) and color names (``'turquoise'``) are + supported. Default: ``'black'`` + (Windows: the color ``'magenta'`` / ``'#ff00ff'`` is used to indicate transparency, and should not be used) + :type text_color: str + :keyword text_default: + The default text which will be displayed before the extraction starts. Default: ``"Initializing"`` + :type text_default: str + :keyword full_tk: + By default Splash bundles only the necessary files for the splash screen (some tk components). This + options enables adding full tk and making it a requirement, meaning all tk files will be unpacked before + the splash screen can be started. This is useful during development of the splash screen script. + Default: ``False`` + :type full_tk: bool + :keyword minify_script: + The splash screen is created by executing an Tcl/Tk script. This option enables minimizing the script, + meaning removing all non essential parts from the script. Default: ``True`` + :keyword name: + An optional alternative filename for the .res file. If not specified, a name is generated. + :type name: str + :keyword script_name: + An optional alternative filename for the Tcl script, that will be generated. If not specified, a name is + generated. + :type script_name: str + :keyword max_img_size: + Maximum size of the splash screen image as a tuple. If the supplied image exceeds this limit, it will be + resized to fit the maximum width (to keep the original aspect ratio). This option can be disabled by + setting it to None. Default: ``(760, 480)`` + :type max_img_size: Tuple[int, int] + :keyword always_on_top: + Force the splashscreen to be always on top of other windows. If disabled, other windows (e.g., from other + applications) can cover the splash screen by user bringing them to front. This might be useful for + frozen applications with long startup times. Default: ``True`` + :type always_on_top: bool + """ + from ..config import CONF + Target.__init__(self) + + # Splash screen is not supported on macOS. It operates in a secondary thread and macOS disallows UI operations + # in any thread other than main. + if is_darwin: + raise SystemExit("ERROR: Splash screen is not supported on macOS.") + + # Ensure tkinter (and thus Tcl/Tk) is available. + if not tcltk_info.available: + raise SystemExit( + "ERROR: Your platform does not support the splash screen feature, since tkinter is not installed. " + "Please install tkinter and try again." + ) + + # Check if the Tcl/Tk version is supported. + logger.info("Verifying Tcl/Tk compatibility with splash screen requirements") + self._check_tcl_tk_compatibility() + + # Make image path relative to .spec file + if not os.path.isabs(image_file): + image_file = os.path.join(CONF['specpath'], image_file) + image_file = os.path.normpath(image_file) + if not os.path.exists(image_file): + raise ValueError("Image file '%s' not found" % image_file) + + # Copy all arguments + self.image_file = image_file + self.full_tk = kwargs.get("full_tk", False) + self.name = kwargs.get("name", None) + self.script_name = kwargs.get("script_name", None) + self.minify_script = kwargs.get("minify_script", True) + self.max_img_size = kwargs.get("max_img_size", (760, 480)) + + # text options + self.text_pos = kwargs.get("text_pos", None) + self.text_size = kwargs.get("text_size", 12) + self.text_font = kwargs.get("text_font", "TkDefaultFont") + self.text_color = kwargs.get("text_color", "black") + self.text_default = kwargs.get("text_default", "Initializing") + + # always-on-top behavior + self.always_on_top = kwargs.get("always_on_top", True) + + # Save the generated file separately so that it is not necessary to generate the data again and again + root = os.path.splitext(self.tocfilename)[0] + if self.name is None: + self.name = root + '.res' + if self.script_name is None: + self.script_name = root + '_script.tcl' + + # Internal variables + # Store path to _tkinter extension module, so that guts check can detect if the path changed for some reason. + self._tkinter_file = tcltk_info.tkinter_extension_file + + # Calculated / analysed values + self.uses_tkinter = self._uses_tkinter(self._tkinter_file, binaries) + logger.debug("Program uses tkinter: %r", self.uses_tkinter) + self.script = self.generate_script() + self.tcl_lib = tcltk_info.tcl_shared_library # full path to shared library + self.tk_lib = tcltk_info.tk_shared_library + + assert self.tcl_lib is not None + assert self.tk_lib is not None + + logger.debug("Using Tcl shared library: %r", self.tcl_lib) + logger.debug("Using Tk shared library: %r", self.tk_lib) + + self.splash_requirements = set([ + # NOTE: the implicit assumption here is that Tcl and Tk shared library are collected into top-level + # application directory, which, at tme moment, is true in practically all cases. + os.path.basename(self.tcl_lib), + os.path.basename(self.tk_lib), + *splash_requirements, + ]) + + logger.info("Collect Tcl/Tk data files for the splash screen") + tcltk_tree = tcltk_info.data_files # 3-element tuple TOC + if self.full_tk: + # The user wants a full copy of Tk, so make all Tk files a requirement. + self.splash_requirements.update(entry[0] for entry in tcltk_tree) + + # Scan for binary dependencies of the Tcl/Tk shared libraries, and add them to `binaries` TOC list (which + # should really be called `dependencies` as it is not limited to binaries. But it is too late now, and + # existing spec files depend on this naming). We specify these binary dependencies (which include the + # Tcl and Tk shared libraries themselves) even if the user's program uses tkinter and they would be collected + # anyway; let the collection mechanism deal with potential duplicates. + tcltk_libs = [(os.path.basename(src_name), src_name, 'BINARY') for src_name in (self.tcl_lib, self.tk_lib)] + self.binaries = bindepend.binary_dependency_analysis(tcltk_libs) + + # Put all shared library dependencies in `splash_requirements`, so they are made available in onefile mode. + self.splash_requirements.update(entry[0] for entry in self.binaries) + + # If the user's program does not use tkinter, add resources from Tcl/Tk tree to the dependencies list. + # Do so only for the resources that are part of splash requirements. + if not self.uses_tkinter: + self.binaries.extend(entry for entry in tcltk_tree if entry[0] in self.splash_requirements) + + # Check if all requirements were found. + collected_files = set(entry[0] for entry in (binaries + datas + self.binaries)) + + def _filter_requirement(filename): + if filename not in collected_files: + # Item is not bundled, so warn the user about it. This actually may happen on some tkinter installations + # that are missing the license.terms file - as this file has no effect on operation of splash screen, + # suppress the warning for it. + if os.path.basename(filename) == 'license.terms': + return False + + logger.warning( + "The local Tcl/Tk installation is missing the file %s. The behavior of the splash screen is " + "therefore undefined and may be unsupported.", filename + ) + return False + return True + + # Remove all files which were not found. + self.splash_requirements = set(filter(_filter_requirement, self.splash_requirements)) + + logger.debug("Splash Requirements: %s", self.splash_requirements) + + # On AIX, the Tcl and Tk shared libraries might in fact be ar archives with shared object inside it, and need to + # be `dlopen`'ed with full name (for example, `libtcl.a(libtcl.so.8.6)` and `libtk.a(libtk.so.8.6)`. So if the + # library's suffix is .a, adjust the name accordingly, assuming fixed format for the shared object name. + # Adjust the names at the end of this method, because preceding steps use `self.tcl_lib` and `self.tk_lib` for + # filesystem-based operations and need the original filenames. + if is_aix: + _, ext = os.path.splitext(self.tcl_lib) + if ext == '.a': + tcl_major, tcl_minor = tcltk_info.tcl_version + self.tcl_lib += f"(libtcl.so.{tcl_major}.{tcl_minor})" + _, ext = os.path.splitext(self.tk_lib) + if ext == '.a': + tk_major, tk_minor = tcltk_info.tk_version + self.tk_lib += f"(libtk.so.{tk_major}.{tk_minor})" + + self.__postinit__() + + _GUTS = ( + # input parameters + ('image_file', _check_guts_eq), + ('name', _check_guts_eq), + ('script_name', _check_guts_eq), + ('text_pos', _check_guts_eq), + ('text_size', _check_guts_eq), + ('text_font', _check_guts_eq), + ('text_color', _check_guts_eq), + ('text_default', _check_guts_eq), + ('always_on_top', _check_guts_eq), + ('full_tk', _check_guts_eq), + ('minify_script', _check_guts_eq), + ('max_img_size', _check_guts_eq), + # calculated/analysed values + ('uses_tkinter', _check_guts_eq), + ('script', _check_guts_eq), + ('tcl_lib', _check_guts_eq), + ('tk_lib', _check_guts_eq), + ('splash_requirements', _check_guts_eq), + ('binaries', _check_guts_toc), + # internal value + # Check if the tkinter installation changed. This is theoretically possible if someone uses two different python + # installations of the same version. + ('_tkinter_file', _check_guts_eq), + ) + + def _check_guts(self, data, last_build): + if Target._check_guts(self, data, last_build): + return True + + # Check if the image has been modified. + if misc.mtime(self.image_file) > last_build: + logger.info("Building %s because file %s changed", self.tocbasename, self.image_file) + return True + + return False + + def assemble(self): + logger.info("Building Splash %s", self.name) + + # Function to resize a given image to fit into the area defined by max_img_size. + def _resize_image(_image, _orig_size): + if PILImage: + _w, _h = _orig_size + _ratio_w = self.max_img_size[0] / _w + if _ratio_w < 1: + # Image width exceeds limit + _h = int(_h * _ratio_w) + _w = self.max_img_size[0] + + _ratio_h = self.max_img_size[1] / _h + if _ratio_h < 1: + # Image height exceeds limit + _w = int(_w * _ratio_h) + _h = self.max_img_size[1] + + # If a file is given it will be open + if isinstance(_image, PILImage.Image): + _img = _image + else: + _img = PILImage.open(_image) + _img_resized = _img.resize((_w, _h)) + + # Save image into a stream + _image_stream = io.BytesIO() + _img_resized.save(_image_stream, format='PNG') + _img.close() + _img_resized.close() + _image_data = _image_stream.getvalue() + logger.info("Resized image %s from dimensions %r to (%d, %d)", self.image_file, _orig_size, _w, _h) + return _image_data + else: + raise ValueError( + "The splash image dimensions (w: %d, h: %d) exceed max_img_size (w: %d, h:%d), but the image " + "cannot be resized due to missing PIL.Image! Either install the Pillow package, adjust the " + "max_img_size, or use an image of compatible dimensions." % + (_orig_size[0], _orig_size[1], self.max_img_size[0], self.max_img_size[1]) + ) + + # Open image file + image_file = open(self.image_file, 'rb') + + # Check header of the file to identify it + if image_file.read(8) == b'\x89PNG\r\n\x1a\n': + # self.image_file is a PNG file + image_file.seek(16) + img_size = (struct.unpack("!I", image_file.read(4))[0], struct.unpack("!I", image_file.read(4))[0]) + + if img_size > self.max_img_size: + # The image exceeds the maximum image size, so resize it + image = _resize_image(self.image_file, img_size) + else: + image = os.path.abspath(self.image_file) + elif PILImage: + # Pillow is installed, meaning the image can be converted automatically + img = PILImage.open(self.image_file, mode='r') + + if img.size > self.max_img_size: + image = _resize_image(img, img.size) + else: + image_data = io.BytesIO() + img.save(image_data, format='PNG') + img.close() + image = image_data.getvalue() + logger.info("Converted image %s to PNG format", self.image_file) + else: + raise ValueError( + "The image %s needs to be converted to a PNG file, but PIL.Image is not available! Either install the " + "Pillow package, or use a PNG image for you splash screen." % (self.image_file,) + ) + + image_file.close() + + SplashWriter( + self.name, + self.splash_requirements, + os.path.basename(self.tcl_lib), # tcl86t.dll + os.path.basename(self.tk_lib), # tk86t.dll + tcltk_info.TK_ROOTNAME, + image, + self.script + ) + + @staticmethod + def _check_tcl_tk_compatibility(): + tcl_version = tcltk_info.tcl_version # (major, minor) tuple + tk_version = tcltk_info.tk_version + + if is_darwin and tcltk_info.is_macos_system_framework: + # Outdated Tcl/Tk 8.5 system framework is not supported. + raise SystemExit( + "ERROR: The splash screen feature does not support macOS system framework version of Tcl/Tk." + ) + + # Test if tcl/tk version is supported + if tcl_version < (8, 6) or tk_version < (8, 6): + logger.warning( + "The installed Tcl/Tk (%d.%d / %d.%d) version might not work with the splash screen feature of the " + "bootloader, which was tested against Tcl/Tk 8.6", *tcl_version, *tk_version + ) + + # This should be impossible, since tcl/tk is released together with the same version number, but just in case + if tcl_version != tk_version: + logger.warning( + "The installed version of Tcl (%d.%d) and Tk (%d.%d) do not match. PyInstaller is tested against " + "matching versions", *tcl_version, *tk_version + ) + + # Ensure that Tcl is built with multi-threading support. + if not tcltk_info.tcl_threaded: + # This is a feature breaking problem, so exit. + raise SystemExit( + "ERROR: The installed Tcl version is not threaded. PyInstaller only supports the splash screen " + "using threaded Tcl." + ) + + # Ensure that Tcl and Tk shared libraries are available + if tcltk_info.tcl_shared_library is None or tcltk_info.tk_shared_library is None: + message = \ + "ERROR: Could not determine the path to Tcl and/or Tk shared library, " \ + "which are required for splash screen." + if not tcltk_info.tkinter_extension_file: + message += ( + " The _tkinter module appears to be a built-in, which likely means that python was built with " + "statically-linked Tcl/Tk libraries and is incompatible with splash screen." + ) + raise SystemExit(message) + + def generate_script(self): + """ + Generate the script for the splash screen. + + If minify_script is True, all unnecessary parts will be removed. + """ + d = {} + if self.text_pos is not None: + logger.debug("Add text support to splash screen") + d.update({ + 'pad_x': self.text_pos[0], + 'pad_y': self.text_pos[1], + 'color': self.text_color, + 'font': self.text_font, + 'font_size': self.text_size, + 'default_text': self.text_default, + }) + script = splash_templates.build_script(text_options=d, always_on_top=self.always_on_top) + + if self.minify_script: + # Remove any documentation, empty lines and unnecessary spaces + script = '\n'.join( + line for line in map(lambda line: line.strip(), script.splitlines()) + if not line.startswith('#') # documentation + and line # empty lines + ) + # Remove unnecessary spaces + script = re.sub(' +', ' ', script) + + # Write script to disk, so that it is transparent to the user what script is executed. + with open(self.script_name, "w", encoding="utf-8") as script_file: + script_file.write(script) + return script + + @staticmethod + def _uses_tkinter(tkinter_file, binaries): + # Test for _tkinter extension instead of tkinter module, because user might use a different wrapping library for + # Tk. Use `pathlib.PurePath` in comparisons to account for case normalization and separator normalization. + tkinter_file = pathlib.PurePath(tkinter_file) + for dest_name, src_name, typecode in binaries: + if pathlib.PurePath(src_name) == tkinter_file: + return True + return False diff --git a/venv/lib/python3.12/site-packages/PyInstaller/building/splash_templates.py b/venv/lib/python3.12/site-packages/PyInstaller/building/splash_templates.py new file mode 100755 index 0000000..e93c696 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/building/splash_templates.py @@ -0,0 +1,229 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +# ----------------------------------------------------------------------------- +""" +Templates for the splash screen tcl script. +""" +from PyInstaller.compat import is_cygwin, is_darwin, is_win + +ipc_script = r""" +proc _ipc_server {channel clientaddr clientport} { + # This function is called if a new client connects to + # the server. This creates a channel, which calls + # _ipc_caller if data was send through the connection + set client_name [format <%s:%d> $clientaddr $clientport] + + chan configure $channel \ + -buffering none \ + -encoding utf-8 \ + -eofchar \x04 \ + -translation cr + chan event $channel readable [list _ipc_caller $channel $client_name] +} + +proc _ipc_caller {channel client_name} { + # This function is called if a command was sent through + # the tcp connection. The current implementation supports + # two commands: update_text and exit, although exit + # is implemented to be called if the connection gets + # closed (from python) or the character 0x04 was received + chan gets $channel cmd + + if {[chan eof $channel]} { + # This is entered if either the connection was closed + # or the char 0x04 was send + chan close $channel + exit + + } elseif {![chan blocked $channel]} { + # RPC methods + + # update_text command + if {[string match "update_text*" $cmd]} { + global status_text + set first [expr {[string first "(" $cmd] + 1}] + set last [expr {[string last ")" $cmd] - 1}] + + set status_text [string range $cmd $first $last] + } + # Implement other procedures here + } +} + +# By setting the port to 0 the os will assign a free port +set server_socket [socket -server _ipc_server -myaddr localhost 0] +set server_port [fconfigure $server_socket -sockname] + +# This environment variable is shared between the python and the tcl +# interpreter and publishes the port the tcp server socket is available +set env(_PYI_SPLASH_IPC) [lindex $server_port 2] +""" + +image_script = r""" +# The variable $_image_data, which holds the data for the splash +# image is created by the bootloader. +image create photo splash_image +splash_image put $_image_data +# delete the variable, because the image now holds the data +unset _image_data + +proc canvas_text_update {canvas tag _var - -} { + # This function is rigged to be called if the a variable + # status_text gets changed. This updates the text on + # the canvas + upvar $_var var + $canvas itemconfigure $tag -text $var +} +""" + +splash_canvas_setup = r""" +package require Tk + +set image_width [image width splash_image] +set image_height [image height splash_image] +set display_width [winfo screenwidth .] +set display_height [winfo screenheight .] + +set x_position [expr {int(0.5*($display_width - $image_width))}] +set y_position [expr {int(0.5*($display_height - $image_height))}] + +# Toplevel frame in which all widgets should be positioned +frame .root + +# Configure the canvas on which the splash +# screen will be drawn +canvas .root.canvas \ + -width $image_width \ + -height $image_height \ + -borderwidth 0 \ + -highlightthickness 0 + +# Draw the image into the canvas, filling it. +.root.canvas create image \ + [expr {$image_width / 2}] \ + [expr {$image_height / 2}] \ + -image splash_image +""" + +splash_canvas_text = r""" +# Create a text on the canvas, which tracks the local +# variable status_text. status_text is changed via C to +# update the progress on the splash screen. +# We cannot use the default label, because it has a +# default background, which cannot be turned transparent +.root.canvas create text \ + %(pad_x)d \ + %(pad_y)d \ + -fill %(color)s \ + -justify center \ + -font myFont \ + -tag vartext \ + -anchor sw +trace variable status_text w \ + [list canvas_text_update .root.canvas vartext] +set status_text "%(default_text)s" +""" + +splash_canvas_default_font = r""" +font create myFont {*}[font actual TkDefaultFont] +font configure myFont -size %(font_size)d +""" + +splash_canvas_custom_font = r""" +font create myFont -family %(font)s -size %(font_size)d +""" + +if is_win or is_cygwin: + transparent_setup = r""" +# If the image is transparent, the background will be filled +# with magenta. The magenta background is later replaced with transparency. +# Here is the limitation of this implementation, that only +# sharp transparent image corners are possible +wm attributes . -transparentcolor magenta +.root.canvas configure -background magenta +""" + +elif is_darwin: + # This is untested, but should work following: https://stackoverflow.com/a/44296157/5869139 + transparent_setup = r""" +wm attributes . -transparent 1 +. configure -background systemTransparent +.root.canvas configure -background systemTransparent +""" + +else: + # For Linux there is no common way to create a transparent window + transparent_setup = r"" + +pack_widgets = r""" +# Position all widgets in the window +pack .root +grid .root.canvas -column 0 -row 0 -columnspan 1 -rowspan 2 +""" + +# Enable always-on-top behavior, by setting overrideredirect and the topmost attribute. +position_window_on_top = r""" +# Set position and mode of the window - always-on-top behavior +wm overrideredirect . 1 +wm geometry . +${x_position}+${y_position} +wm attributes . -topmost 1 +""" + +# Disable always-on-top behavior +if is_win or is_cygwin or is_darwin: + # On Windows, we disable the always-on-top behavior while still setting overrideredirect + # (to disable window decorations), but set topmost attribute to 0. + position_window = r""" +# Set position and mode of the window +wm overrideredirect . 1 +wm geometry . +${x_position}+${y_position} +wm attributes . -topmost 0 +""" +else: + # On Linux, we must not use overrideredirect; instead, we set X11-specific type attribute to splash, + # which lets the window manager to properly handle the splash screen (without window decorations + # but allowing other windows to be brought to front). + position_window = r""" +# Set position and mode of the window +wm geometry . +${x_position}+${y_position} +wm attributes . -type splash +""" + +raise_window = r""" +raise . +""" + + +def build_script(text_options=None, always_on_top=False): + """ + This function builds the tcl script for the splash screen. + """ + # Order is important! + script = [ + ipc_script, + image_script, + splash_canvas_setup, + ] + + if text_options: + # If the default font is used we need a different syntax + if text_options['font'] == "TkDefaultFont": + script.append(splash_canvas_default_font % text_options) + else: + script.append(splash_canvas_custom_font % text_options) + script.append(splash_canvas_text % text_options) + + script.append(transparent_setup) + + script.append(pack_widgets) + script.append(position_window_on_top if always_on_top else position_window) + script.append(raise_window) + + return '\n'.join(script) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/building/templates.py b/venv/lib/python3.12/site-packages/PyInstaller/building/templates.py new file mode 100755 index 0000000..24e5080 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/building/templates.py @@ -0,0 +1,126 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Templates to generate .spec files. +""" + +onefiletmplt = """# -*- mode: python ; coding: utf-8 -*- +%(preamble)s + +a = Analysis( + %(scripts)s, + pathex=%(pathex)s, + binaries=%(binaries)s, + datas=%(datas)s, + hiddenimports=%(hiddenimports)s, + hookspath=%(hookspath)r, + hooksconfig={}, + runtime_hooks=%(runtime_hooks)r, + excludes=%(excludes)s, + noarchive=%(noarchive)s, + optimize=%(optimize)r, +) +pyz = PYZ(a.pure) +%(splash_init)s +exe = EXE( + pyz, + a.scripts, + a.binaries, + a.datas,%(splash_target)s%(splash_binaries)s + %(options)s, + name='%(name)s', + debug=%(debug_bootloader)s, + bootloader_ignore_signals=%(bootloader_ignore_signals)s, + strip=%(strip)s, + upx=%(upx)s, + upx_exclude=%(upx_exclude)s, + runtime_tmpdir=%(runtime_tmpdir)r, + console=%(console)s, + disable_windowed_traceback=%(disable_windowed_traceback)s, + argv_emulation=%(argv_emulation)r, + target_arch=%(target_arch)r, + codesign_identity=%(codesign_identity)r, + entitlements_file=%(entitlements_file)r,%(exe_options)s +) +""" + +onedirtmplt = """# -*- mode: python ; coding: utf-8 -*- +%(preamble)s + +a = Analysis( + %(scripts)s, + pathex=%(pathex)s, + binaries=%(binaries)s, + datas=%(datas)s, + hiddenimports=%(hiddenimports)s, + hookspath=%(hookspath)r, + hooksconfig={}, + runtime_hooks=%(runtime_hooks)r, + excludes=%(excludes)s, + noarchive=%(noarchive)s, + optimize=%(optimize)r, +) +pyz = PYZ(a.pure) +%(splash_init)s +exe = EXE( + pyz, + a.scripts,%(splash_target)s + %(options)s, + exclude_binaries=True, + name='%(name)s', + debug=%(debug_bootloader)s, + bootloader_ignore_signals=%(bootloader_ignore_signals)s, + strip=%(strip)s, + upx=%(upx)s, + console=%(console)s, + disable_windowed_traceback=%(disable_windowed_traceback)s, + argv_emulation=%(argv_emulation)r, + target_arch=%(target_arch)r, + codesign_identity=%(codesign_identity)r, + entitlements_file=%(entitlements_file)r,%(exe_options)s +) +coll = COLLECT( + exe, + a.binaries, + a.datas,%(splash_binaries)s + strip=%(strip)s, + upx=%(upx)s, + upx_exclude=%(upx_exclude)s, + name='%(name)s', +) +""" + +bundleexetmplt = """app = BUNDLE( + exe, + name='%(name)s.app', + icon=%(icon)s, + bundle_identifier=%(bundle_identifier)s, +) +""" + +bundletmplt = """app = BUNDLE( + coll, + name='%(name)s.app', + icon=%(icon)s, + bundle_identifier=%(bundle_identifier)s, +) +""" + +splashtmpl = """splash = Splash( + %(splash_image)r, + binaries=a.binaries, + datas=a.datas, + text_pos=None, + text_size=12, + minify_script=True, + always_on_top=True, +) +""" diff --git a/venv/lib/python3.12/site-packages/PyInstaller/building/utils.py b/venv/lib/python3.12/site-packages/PyInstaller/building/utils.py new file mode 100755 index 0000000..da195f2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/building/utils.py @@ -0,0 +1,846 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import fnmatch +import glob +import hashlib +import io +import marshal +import os +import pathlib +import platform +import shutil +import struct +import subprocess +import sys +import types +import zipfile + +from PyInstaller import compat +from PyInstaller import log as logging +from PyInstaller.compat import is_aix, is_darwin, is_win, is_linux +from PyInstaller.exceptions import InvalidSrcDestTupleError +from PyInstaller.utils import misc + +if is_win: + from PyInstaller.utils.win32 import versioninfo + +if is_darwin: + import PyInstaller.utils.osx as osxutils + +logger = logging.getLogger(__name__) + +# -- Helpers for checking guts. +# +# NOTE: by _GUTS it is meant intermediate files and data structures that PyInstaller creates for bundling files and +# creating final executable. + + +def _check_guts_eq(attr_name, old_value, new_value, last_build): + """ + Rebuild is required if values differ. + """ + if old_value != new_value: + logger.info("Building because %s changed", attr_name) + return True + return False + + +def _check_guts_toc_mtime(attr_name, old_toc, new_toc, last_build): + """ + Rebuild is required if mtimes of files listed in old TOC are newer than last_build. + + Use this for calculated/analysed values read from cache. + """ + for dest_name, src_name, typecode in old_toc: + if misc.mtime(src_name) > last_build: + logger.info("Building because %s changed", src_name) + return True + return False + + +def _check_guts_toc(attr_name, old_toc, new_toc, last_build): + """ + Rebuild is required if either TOC content changed or mtimes of files listed in old TOC are newer than last_build. + + Use this for input parameters. + """ + return _check_guts_eq(attr_name, old_toc, new_toc, last_build) or \ + _check_guts_toc_mtime(attr_name, old_toc, new_toc, last_build) + + +def destination_name_for_extension(module_name, src_name, typecode): + """ + Take a TOC entry (dest_name, src_name, typecode) and determine the full destination name for the extension. + """ + + assert typecode == 'EXTENSION' + + # The `module_name` should be the extension's importable module name, such as `psutil._psutil_linux` or + # `numpy._core._multiarray_umath`. Reconstruct the directory structure from parent package name(s), if any. + dest_elements = module_name.split('.') + + # We have the base name of the extension file (the last element in the module name), but we do not know the + # full extension suffix. We can take that from source name; for simplicity, replace the whole base name part. + src_path = pathlib.Path(src_name) + dest_elements[-1] = src_path.name + + # Extensions that originate from python's python3.x/lib-dynload directory should be diverted into + # python3.x/lib-dynload destination directory instead of being collected into top-level application directory. + # See #5604 for original motivation (using just lib-dynload), and #9204 for extension (using python3.x/lib-dynload). + if src_path.parent.name == 'lib-dynload': + python_dir = f'python{sys.version_info.major}.{sys.version_info.minor}' + if src_path.parent.parent.name == python_dir: + dest_elements = [python_dir, 'lib-dynload', *dest_elements] + + return os.path.join(*dest_elements) + + +def process_collected_binary( + src_name, + dest_name, + use_strip=False, + use_upx=False, + upx_exclude=None, + target_arch=None, + codesign_identity=None, + entitlements_file=None, + strict_arch_validation=False +): + """ + Process the collected binary using strip or UPX (or both), and apply any platform-specific processing. On macOS, + this rewrites the library paths in the headers, and (re-)signs the binary. On-disk cache is used to avoid processing + the same binary with same options over and over. + + In addition to given arguments, this function also uses CONF['cachedir'] and CONF['upx_dir']. + """ + from PyInstaller.config import CONF + + # We need to use cache in the following scenarios: + # * extra binary processing due to use of `strip` or `upx` + # * building on macOS, where we need to rewrite library paths in binaries' headers and (re-)sign the binaries. + if not use_strip and not use_upx and not is_darwin: + return src_name + + # Match against provided UPX exclude patterns. + upx_exclude = upx_exclude or [] + if use_upx: + src_path = pathlib.PurePath(src_name) + for upx_exclude_entry in upx_exclude: + # pathlib.PurePath.match() matches from right to left, and supports * wildcard, but does not support the + # "**" syntax for directory recursion. Case sensitivity follows the OS default. + if src_path.match(upx_exclude_entry): + logger.info("Disabling UPX for %s due to match in exclude pattern: %s", src_name, upx_exclude_entry) + use_upx = False + break + + # Additional automatic disablement rules for UPX and strip. + + # On Windows, avoid using UPX with binaries that have control flow guard (CFG) enabled. + if use_upx and is_win and versioninfo.pefile_check_control_flow_guard(src_name): + logger.info('Disabling UPX for %s due to CFG!', src_name) + use_upx = False + + # Avoid using UPX with Qt plugins, as it strips the data required by the Qt plugin loader. + if use_upx and misc.is_file_qt_plugin(src_name): + logger.info('Disabling UPX for %s due to it being a Qt plugin!', src_name) + use_upx = False + + # On linux, if a binary has an accompanying HMAC or CHK file, avoid modifying it in any way. + if (use_upx or use_strip) and is_linux: + src_path = pathlib.Path(src_name) + hmac_path = src_path.with_name(f".{src_path.name}.hmac") + chk_path = src_path.with_suffix(".chk") + if hmac_path.is_file(): + logger.info('Disabling UPX and/or strip for %s due to accompanying .hmac file!', src_name) + use_upx = use_strip = False + elif chk_path.is_file(): + logger.info('Disabling UPX and/or strip for %s due to accompanying .chk file!', src_name) + use_upx = use_strip = False + del src_path, hmac_path, chk_path + + # Exit early if no processing is required after above rules are applied. + if not use_strip and not use_upx and not is_darwin: + return src_name + + # Prepare cache directory path. Cache is tied to python major/minor version, but also to various processing options. + pyver = f'py{sys.version_info[0]}{sys.version_info[1]}' + arch = platform.architecture()[0] + cache_dir = os.path.join( + CONF['cachedir'], + f'bincache{use_strip:d}{use_upx:d}{pyver}{arch}', + ) + if target_arch: + cache_dir = os.path.join(cache_dir, target_arch) + if is_darwin: + # Separate by codesign identity + if codesign_identity: + # Compute hex digest of codesign identity string to prevent issues with invalid characters. + csi_hash = hashlib.sha256(codesign_identity.encode('utf-8')) + cache_dir = os.path.join(cache_dir, csi_hash.hexdigest()) + else: + cache_dir = os.path.join(cache_dir, 'adhoc') # ad-hoc signing + # Separate by entitlements + if entitlements_file: + # Compute hex digest of entitlements file contents + with open(entitlements_file, 'rb') as fp: + ef_hash = hashlib.sha256(fp.read()) + cache_dir = os.path.join(cache_dir, ef_hash.hexdigest()) + else: + cache_dir = os.path.join(cache_dir, 'no-entitlements') + os.makedirs(cache_dir, exist_ok=True) + + # Load cache index, if available + cache_index_file = os.path.join(cache_dir, "index.dat") + try: + cache_index = misc.load_py_data_struct(cache_index_file) + except FileNotFoundError: + cache_index = {} + except Exception: + # Tell the user they may want to fix their cache... However, do not delete it for them; if it keeps getting + # corrupted, we will never find out. + logger.warning("PyInstaller bincache may be corrupted; use pyinstaller --clean to fix it.") + raise + + # Look up the file in cache; use case-normalized destination name as identifier. + cached_id = os.path.normcase(dest_name) + cached_name = os.path.join(cache_dir, dest_name) + src_digest = _compute_file_digest(src_name) + + if cached_id in cache_index: + # If digest matches to the cached digest, return the cached file... + if src_digest == cache_index[cached_id]: + return cached_name + + # ... otherwise remove it. + os.remove(cached_name) + + # Ensure parent path exists + os.makedirs(os.path.dirname(cached_name), exist_ok=True) + + # Use `shutil.copyfile` to copy the file with default permissions bits, then manually set executable + # bits. This way, we avoid copying permission bits and metadata from the original file, which might be too + # restrictive for further processing (read-only permissions, immutable flag on FreeBSD, and so on). + shutil.copyfile(src_name, cached_name) + os.chmod(cached_name, 0o755) + + # Apply strip + if use_strip: + strip_options = [] + if is_darwin: + # The default strip behavior breaks some shared libraries under macOS. + strip_options = ["-S"] # -S = strip only debug symbols. + elif is_aix: + # Set -X32_64 flag to have strip transparently process both 32-bit and 64-bit binaries, without user having + # to set OBJECT_MODE environment variable prior to the build. Also accommodates potential mixed-case + # scenario, for example a 32-bit utility program being collected into a 64-bit application bundle. + strip_options = ["-X32_64"] + + cmd = ["strip", *strip_options, cached_name] + logger.info("Executing: %s", " ".join(cmd)) + try: + p = subprocess.run( + cmd, + stdin=subprocess.DEVNULL, + stdout=subprocess.PIPE, + stderr=subprocess.STDOUT, + check=True, + errors='ignore', + encoding='utf-8', + ) + logger.debug("Output from strip command:\n%s", p.stdout) + except subprocess.CalledProcessError as e: + show_warning = True + + # On AIX, strip utility raises an error when ran against already-stripped binary. Catch the corresponding + # message (`0654-419 The specified archive file was already stripped.`) and suppress the warning. + if is_aix and "0654-419" in e.stdout: + show_warning = False + + if show_warning: + logger.warning("Failed to run strip on %r!", cached_name, exc_info=True) + logger.warning("Output from strip command:\n%s", e.stdout) + except Exception: + logger.warning("Failed to run strip on %r!", cached_name, exc_info=True) + + # Apply UPX + if use_upx: + upx_exe = 'upx' + upx_dir = CONF['upx_dir'] + if upx_dir: + upx_exe = os.path.join(upx_dir, upx_exe) + + upx_options = [ + # Do not compress icons, so that they can still be accessed externally. + '--compress-icons=0', + # Use LZMA compression. + '--lzma', + # Quiet mode. + '-q', + ] + if is_win: + # Binaries built with Visual Studio 7.1 require --strip-loadconf or they will not compress. + upx_options.append('--strip-loadconf') + + cmd = [upx_exe, *upx_options, cached_name] + logger.info("Executing: %s", " ".join(cmd)) + try: + p = subprocess.run( + cmd, + stdin=subprocess.DEVNULL, + stdout=subprocess.PIPE, + stderr=subprocess.STDOUT, + check=True, + errors='ignore', + encoding='utf-8', + ) + logger.debug("Output from upx command:\n%s", p.stdout) + except subprocess.CalledProcessError as e: + logger.warning("Failed to upx strip on %r!", cached_name, exc_info=True) + logger.warning("Output from upx command:\n%s", e.stdout) + except Exception: + logger.warning("Failed to run upx on %r!", cached_name, exc_info=True) + + # On macOS, we need to modify the given binary's paths to the dependent libraries, in order to ensure they are + # relocatable and always refer to location within the frozen application. Specifically, we make all dependent + # library paths relative to @rpath, and set @rpath to point to the top-level application directory, relative to + # the binary's location (i.e., @loader_path). + # + # While modifying the headers invalidates existing signatures, we avoid removing them in order to speed things up + # (and to avoid potential bugs in the codesign utility, like the one reported on macOS 10.13 in #6167). + # The forced re-signing at the end should take care of the invalidated signatures. + if is_darwin: + try: + osxutils.binary_to_target_arch(cached_name, target_arch, display_name=src_name) + #osxutils.remove_signature_from_binary(cached_name) # Disabled as per comment above. + target_rpath = str( + pathlib.PurePath('@loader_path', *['..' for level in pathlib.PurePath(dest_name).parent.parts]) + ) + osxutils.set_dylib_dependency_paths(cached_name, target_rpath) + osxutils.sign_binary(cached_name, codesign_identity, entitlements_file) + except osxutils.InvalidBinaryError: + # Raised by osxutils.binary_to_target_arch when the given file is not a valid macOS binary (for example, + # a linux .so file; see issue #6327). The error prevents any further processing, so just ignore it. + pass + except osxutils.IncompatibleBinaryArchError: + # Raised by osxutils.binary_to_target_arch when the given file does not contain (all) required arch slices. + # Depending on the strict validation mode, re-raise or swallow the error. + # + # Strict validation should be enabled only for binaries where the architecture *must* match the target one, + # i.e., the extension modules. Everything else is pretty much a gray area, for example: + # * a universal2 extension may have its x86_64 and arm64 slices linked against distinct single-arch/thin + # shared libraries + # * a collected executable that is launched by python code via a subprocess can be x86_64-only, even though + # the actual python code is running on M1 in native arm64 mode. + if strict_arch_validation: + raise + logger.debug("File %s failed optional architecture validation - collecting as-is!", src_name) + except Exception as e: + raise SystemError(f"Failed to process binary {cached_name!r}!") from e + + # Update cache index + cache_index[cached_id] = src_digest + misc.save_py_data_struct(cache_index_file, cache_index) + + return cached_name + + +def _compute_file_digest(filename): + hasher = hashlib.sha1() + with open(filename, "rb") as fp: + for chunk in iter(lambda: fp.read(16 * 1024), b""): + hasher.update(chunk) + return bytearray(hasher.digest()) + + +def _check_path_overlap(path): + """ + Check that path does not overlap with WORKPATH or SPECPATH (i.e., WORKPATH and SPECPATH may not start with path, + which could be caused by a faulty hand-edited specfile). + + Raise SystemExit if there is overlap, return True otherwise + """ + from PyInstaller.config import CONF + specerr = 0 + if CONF['workpath'].startswith(path): + logger.error('Specfile error: The output path "%s" contains WORKPATH (%s)', path, CONF['workpath']) + specerr += 1 + if CONF['specpath'].startswith(path): + logger.error('Specfile error: The output path "%s" contains SPECPATH (%s)', path, CONF['specpath']) + specerr += 1 + if specerr: + raise SystemExit( + 'ERROR: Please edit/recreate the specfile (%s) and set a different output name (e.g. "dist").' % + CONF['spec'] + ) + return True + + +def _make_clean_directory(path): + """ + Create a clean directory from the given directory name. + """ + if _check_path_overlap(path): + if os.path.isdir(path) or os.path.isfile(path): + try: + os.remove(path) + except OSError: + _rmtree(path) + + os.makedirs(path, exist_ok=True) + + +def _rmtree(path): + """ + Remove directory and all its contents, but only after user confirmation, or if the -y option is set. + """ + from PyInstaller.config import CONF + if CONF['noconfirm']: + choice = 'y' + elif sys.stdout.isatty(): + choice = input( + 'WARNING: The output directory "%s" and ALL ITS CONTENTS will be REMOVED! Continue? (y/N)' % path + ) + else: + raise SystemExit( + 'ERROR: The output directory "%s" is not empty. Please remove all its contents or use the -y option (remove' + ' output directory without confirmation).' % path + ) + if choice.strip().lower() == 'y': + if not CONF['noconfirm']: + print("On your own risk, you can use the option `--noconfirm` to get rid of this question.") + logger.info('Removing dir %s', path) + shutil.rmtree(path) + else: + raise SystemExit('User aborted') + + +# TODO Refactor to prohibit empty target directories. As the docstring below documents, this function currently permits +# the second item of each 2-tuple in "hook.datas" to be the empty string, in which case the target directory defaults to +# the source directory's basename. However, this functionality is very fragile and hence bad. Instead: +# +# * An exception should be raised if such item is empty. +# * All hooks currently passing the empty string for such item (e.g., +# "hooks/hook-babel.py", "hooks/hook-matplotlib.py") should be refactored +# to instead pass such basename. +def format_binaries_and_datas(binaries_or_datas, workingdir=None): + """ + Convert the passed list of hook-style 2-tuples into a returned set of `TOC`-style 2-tuples. + + Elements of the passed list are 2-tuples `(source_dir_or_glob, target_dir)`. + Elements of the returned set are 2-tuples `(target_file, source_file)`. + For backwards compatibility, the order of elements in the former tuples are the reverse of the order of elements in + the latter tuples! + + Parameters + ---------- + binaries_or_datas : list + List of hook-style 2-tuples (e.g., the top-level `binaries` and `datas` attributes defined by hooks) whose: + * The first element is either: + * A glob matching only the absolute or relative paths of source non-Python data files. + * The absolute or relative path of a source directory containing only source non-Python data files. + * The second element is the relative path of the target directory into which these source files will be + recursively copied. + + If the optional `workingdir` parameter is passed, source paths may be either absolute or relative; else, source + paths _must_ be absolute. + workingdir : str + Optional absolute path of the directory to which all relative source paths in the `binaries_or_datas` + parameter will be prepended by (and hence converted into absolute paths) _or_ `None` if these paths are to be + preserved as relative. Defaults to `None`. + + Returns + ---------- + set + Set of `TOC`-style 2-tuples whose: + * First element is the absolute or relative path of a target file. + * Second element is the absolute or relative path of the corresponding source file to be copied to this target + file. + """ + toc_datas = set() + + for src_root_path_or_glob, trg_root_dir in binaries_or_datas: + # Disallow empty source path. Those are typically result of errors, and result in implicit collection of the + # whole current working directory, which is never a good idea. + if not src_root_path_or_glob: + raise InvalidSrcDestTupleError( + (src_root_path_or_glob, trg_root_dir), + "Empty SRC is not allowed when adding binary and data files, as it would result in collection of the " + "whole current working directory." + ) + if not trg_root_dir: + raise InvalidSrcDestTupleError( + (src_root_path_or_glob, trg_root_dir), + "Empty DEST_DIR is not allowed - to collect files into application's top-level directory, use " + f"{os.curdir!r}." + ) + # Disallow absolute target paths, as well as target paths that would end up pointing outside of the + # application's top-level directory. + if os.path.isabs(trg_root_dir): + raise InvalidSrcDestTupleError((src_root_path_or_glob, trg_root_dir), "DEST_DIR must be a relative path!") + if os.path.normpath(trg_root_dir).startswith('..'): + raise InvalidSrcDestTupleError( + (src_root_path_or_glob, trg_root_dir), + "DEST_DIR must not point outside of application's top-level directory!", + ) + + # Convert relative to absolute paths if required. + if workingdir and not os.path.isabs(src_root_path_or_glob): + src_root_path_or_glob = os.path.join(workingdir, src_root_path_or_glob) + + # Normalize paths. + src_root_path_or_glob = os.path.normpath(src_root_path_or_glob) + + # If given source path is a file or directory path, pass it on. + # If not, treat it as a glob and pass on all matching paths. However, we need to preserve the directories + # captured by the glob - as opposed to collecting their contents into top-level target directory. Therefore, + # we set a flag which is used in subsequent processing to distinguish between original directory paths and + # directory paths that were captured by the glob. + if os.path.isfile(src_root_path_or_glob) or os.path.isdir(src_root_path_or_glob): + src_root_paths = [src_root_path_or_glob] + was_glob = False + else: + src_root_paths = glob.glob(src_root_path_or_glob) + was_glob = True + + if not src_root_paths: + raise SystemExit(f'ERROR: Unable to find {src_root_path_or_glob!r} when adding binary and data files.') + + for src_root_path in src_root_paths: + if os.path.isfile(src_root_path): + # Normalizing the result to remove redundant relative paths (e.g., removing "./" from "trg/./file"). + toc_datas.add(( + os.path.normpath(os.path.join(trg_root_dir, os.path.basename(src_root_path))), + os.path.normpath(src_root_path), + )) + elif os.path.isdir(src_root_path): + for src_dir, src_subdir_basenames, src_file_basenames in os.walk(src_root_path): + # Ensure the current source directory is a subdirectory of the passed top-level source directory. + # Since os.walk() does *NOT* follow symlinks by default, this should be the case. (But let's make + # sure.) + assert src_dir.startswith(src_root_path) + + # Relative path of the current target directory, obtained by: + # + # * Stripping the top-level source directory from the current source directory (e.g., removing + # "/top" from "/top/dir"). + # * Normalizing the result to remove redundant relative paths (e.g., removing "./" from + # "trg/./file"). + if was_glob: + # Preserve directories captured by glob. + rel_dir = os.path.relpath(src_dir, os.path.dirname(src_root_path)) + else: + rel_dir = os.path.relpath(src_dir, src_root_path) + trg_dir = os.path.normpath(os.path.join(trg_root_dir, rel_dir)) + + for src_file_basename in src_file_basenames: + src_file = os.path.join(src_dir, src_file_basename) + if os.path.isfile(src_file): + # Normalize the result to remove redundant relative paths (e.g., removing "./" from + # "trg/./file"). + toc_datas.add(( + os.path.normpath(os.path.join(trg_dir, src_file_basename)), os.path.normpath(src_file) + )) + + return toc_datas + + +def get_code_object(modname, filename, optimize): + """ + Get the code-object for a module. + + This is a simplifed non-performant version which circumvents __pycache__. + """ + + # Once upon a time, we compiled dummy code objects for PEP-420 namespace packages. We do not do that anymore. + assert filename not in {'-', None}, "Called with PEP-420 namespace package!" + + _, ext = os.path.splitext(filename) + ext = ext.lower() + + if ext == '.pyc': + # The module is available in binary-only form. Read the contents of .pyc file using helper function, which + # supports reading from either stand-alone or archive-embedded .pyc files. + logger.debug('Reading code object from .pyc file %s', filename) + pyc_data = _read_pyc_data(filename) + code_object = marshal.loads(pyc_data[16:]) + else: + # Assume this is a source .py file, but allow an arbitrary extension (other than .pyc, which is taken in + # the above branch). This allows entry-point scripts to have an arbitrary (or no) extension, as tested by + # the `test_arbitrary_ext` in `test_basic.py`. + logger.debug('Compiling python script/module file %s', filename) + + with open(filename, 'rb') as f: + source = f.read() + + # If entry-point script has no suffix, append .py when compiling the source. In POSIX builds, the executable + # has no suffix either; this causes issues with `traceback` module, as it tries to read the executable file + # when trying to look up the code for the entry-point script (when current working directory contains the + # executable). + _, ext = os.path.splitext(filename) + if not ext: + logger.debug("Appending .py to compiled entry-point name...") + filename += '.py' + + try: + code_object = compile(source, filename, 'exec', optimize=optimize) + except SyntaxError: + logger.warning("Sytnax error while compiling %s", filename) + raise + + return code_object + + +def replace_filename_in_code_object(code_object, filename): + """ + Recursively replace the `co_filename` in the given code object and code objects stored in its `co_consts` entries. + Primarily used to anonymize collected code objects, i.e., by removing the build environment's paths from them. + """ + + consts = tuple( + replace_filename_in_code_object(const_co, filename) if isinstance(const_co, types.CodeType) else const_co + for const_co in code_object.co_consts + ) + + return code_object.replace(co_consts=consts, co_filename=filename) + + +def _should_include_system_binary(binary_tuple, exceptions): + """ + Return True if the given binary_tuple describes a system binary that should be included. + + Exclude all system library binaries other than those with "lib-dynload" in the destination or "python" in the + source, except for those matching the patterns in the exceptions list. Intended to be used from the Analysis + exclude_system_libraries method. + """ + dest = binary_tuple[0] + if dest.startswith(f'python{sys.version_info.major}.{sys.version_info.minor}/lib-dynload'): + return True + src = binary_tuple[1] + if fnmatch.fnmatch(src, '*python*'): + return True + if not src.startswith('/lib') and not src.startswith('/usr/lib'): + return True + for exception in exceptions: + if fnmatch.fnmatch(dest, exception): + return True + return False + + +def compile_pymodule(name, src_path, workpath, optimize, code_cache=None): + """ + Given the name and source file for a pure-python module, compile the module in the specified working directory, + and return the name of resulting .pyc file. The paths in the resulting .pyc module are anonymized by having their + absolute prefix removed. + + If a .pyc file with matching name already exists in the target working directory, it is re-used (provided it has + compatible bytecode magic in the header, and that its modification time is newer than that of the source file). + + If the specified module is available in binary-only form, the input .pyc file is copied to the target working + directory and post-processed. If the specified module is available in source form, it is compiled only if + corresponding code object is not available in the optional code-object cache; otherwise, it is copied from cache + and post-processed. When compiling the module, the specified byte-code optimization level is used. + + It is up to caller to ensure that the optional code-object cache contains only code-objects of target optimization + level, and that if the specified working directory already contains .pyc files, that they were created with target + optimization level. + """ + + # Construct the target .pyc filename in the workpath + split_name = name.split(".") + if "__init__" in src_path: + # __init__ module; use "__init__" as module name, and construct parent path using all components of the + # fully-qualified name + parent_dirs = split_name + mod_basename = "__init__" + else: + # Regular module; use last component of the fully-qualified name as module name, and the rest as the parent + # path. + parent_dirs = split_name[:-1] + mod_basename = split_name[-1] + pyc_path = os.path.join(workpath, *parent_dirs, mod_basename + '.pyc') + + # Check if optional cache contains module entry + code_object = code_cache.get(name, None) if code_cache else None + + if code_object is None: + _, ext = os.path.splitext(src_path) + ext = ext.lower() + + if ext == '.py': + # Source py file; read source and compile it. + with open(src_path, 'rb') as f: + src_data = f.read() + code_object = compile(src_data, src_path, 'exec', optimize=optimize) + elif ext == '.pyc': + # The module is available in binary-only form. Read the contents of .pyc file using helper function, which + # supports reading from either stand-alone or archive-embedded .pyc files. + pyc_data = _read_pyc_data(src_path) + # Unmarshal code object; this is necessary if we want to strip paths from it + code_object = marshal.loads(pyc_data[16:]) + else: + raise ValueError(f"Invalid python module file {src_path}; unhandled extension {ext}!") + + # Replace co_filename in code object with anonymized filename that does not contain full path. Construct the + # relative filename from module name, similar how we earlier constructed the `pyc_path`. + co_filename = os.path.join(*parent_dirs, mod_basename + '.py') + code_object = replace_filename_in_code_object(code_object, co_filename) + + # Write complete .pyc module to in-memory stream. Then, check if .pyc file already exists, compare contents, and + # (re)write it only if different. This avoids unnecessary (re)writing of the file, and in turn also avoids + # unnecessary cache invalidation for targets that make use of the .pyc file (e.g., PKG, COLLECT). + with io.BytesIO() as pyc_stream: + pyc_stream.write(compat.BYTECODE_MAGIC) + pyc_stream.write(struct.pack('= 3.10 stdlib, or equivalent importlib-metadata >= 4.6. +if _setup_py_mode: + importlib_metadata = None +else: + if sys.version_info >= (3, 10): + import importlib.metadata as importlib_metadata + else: + try: + import importlib_metadata + except ImportError as e: + from PyInstaller.exceptions import ImportlibMetadataError + raise ImportlibMetadataError() from e + + import packaging.version # For importlib_metadata version check + + # Validate the version + if packaging.version.parse(importlib_metadata.version("importlib-metadata")) < packaging.version.parse("4.6"): + from PyInstaller.exceptions import ImportlibMetadataError + raise ImportlibMetadataError() + +# Strict collect mode, which raises error when trying to collect duplicate files into PKG/CArchive or COLLECT. +strict_collect_mode = os.environ.get("PYINSTALLER_STRICT_COLLECT_MODE", "0") != "0" + +# Copied from https://docs.python.org/3/library/platform.html#cross-platform. +is_64bits: bool = sys.maxsize > 2**32 + +# Distinguish specific code for various Python versions. Variables 'is_pyXY' mean that Python X.Y and up is supported. +# Keep even unsupported versions here to keep 3rd-party hooks working. +is_py35 = sys.version_info >= (3, 5) +is_py36 = sys.version_info >= (3, 6) +is_py37 = sys.version_info >= (3, 7) +is_py38 = sys.version_info >= (3, 8) +is_py39 = sys.version_info >= (3, 9) +is_py310 = sys.version_info >= (3, 10) +is_py311 = sys.version_info >= (3, 11) +is_py312 = sys.version_info >= (3, 12) +is_py313 = sys.version_info >= (3, 13) +is_py314 = sys.version_info >= (3, 14) + +is_win = sys.platform.startswith('win') +is_win_10 = is_win and (platform.win32_ver()[0] == '10') +is_win_11 = is_win and (platform.win32_ver()[0] == '11') +is_win_wine = False # Running under Wine; determined later on. +is_cygwin = sys.platform == 'cygwin' +is_darwin = sys.platform == 'darwin' # macOS + +# Unix platforms +is_linux = sys.platform.startswith('linux') +is_solar = sys.platform.startswith('sun') # Solaris +is_aix = sys.platform.startswith('aix') +is_freebsd = sys.platform.startswith('freebsd') +is_openbsd = sys.platform.startswith('openbsd') +is_hpux = sys.platform.startswith('hp-ux') + +# Some code parts are similar to several unix platforms (e.g. Linux, Solaris, AIX). +# macOS is not considered as unix since there are many platform-specific details for Mac in PyInstaller. +is_unix = is_linux or is_solar or is_aix or is_freebsd or is_hpux or is_openbsd + +# Linux distributions such as Alpine or OpenWRT use musl as their libc implementation and resultantly need specially +# compiled bootloaders. On musl systems, ldd with no arguments prints 'musl' and its version. +is_musl = is_linux and "musl" in subprocess.run(["ldd"], capture_output=True, encoding="utf-8").stderr + +# Termux - terminal emulator and Linux environment app for Android. +is_termux = is_linux and hasattr(sys, 'getandroidapilevel') + +# macOS version +_macos_ver = tuple(int(x) for x in platform.mac_ver()[0].split('.')) if is_darwin else None + +# macOS 11 (Big Sur): if python is not compiled with Big Sur support, it ends up in compatibility mode by default, which +# is indicated by platform.mac_ver() returning '10.16'. The lack of proper Big Sur support breaks find_library() +# function from ctypes.util module, as starting with Big Sur, shared libraries are not visible on disk anymore. Support +# for the new library search mechanism was added in python 3.9 when compiled with Big Sur support. In such cases, +# platform.mac_ver() reports version as '11.x'. The behavior can be further modified via SYSTEM_VERSION_COMPAT +# environment variable; which allows explicitly enabling or disabling the compatibility mode. However, note that +# disabling the compatibility mode and using python that does not properly support Big Sur still leaves find_library() +# broken (which is a scenario that we ignore at the moment). +# The same logic applies to macOS 12 (Monterey). +is_macos_11_compat = bool(_macos_ver) and _macos_ver[0:2] == (10, 16) # Big Sur or newer in compat mode +is_macos_11_native = bool(_macos_ver) and _macos_ver[0:2] >= (11, 0) # Big Sur or newer in native mode +is_macos_11 = is_macos_11_compat or is_macos_11_native # Big Sur or newer + +# Check if python >= 3.13 was built with Py_GIL_DISABLED / free-threading (PEP703). +# +# This affects the shared library name, which has the "t" ABI suffix, as per: +# https://github.com/python/steering-council/issues/221#issuecomment-1841593283 +# +# It also affects the layout of PyConfig structure used by bootloader; consequently we need to inform bootloader what +# kind of build it is dealing with (only in python 3.13; with 3.14 and later, we use PEP741 configuration API in the +# bootloader, and do not need to know the layout of PyConfig structure anymore) +is_nogil = bool(sysconfig.get_config_var('Py_GIL_DISABLED')) + +# In a virtual environment created by virtualenv (github.com/pypa/virtualenv) there exists sys.real_prefix with the path +# to the base Python installation from which the virtual environment was created. This is true regardless of the version +# of Python used to execute the virtualenv command. +# +# In a virtual environment created by the venv module available in the Python standard lib, there exists sys.base_prefix +# with the path to the base implementation. This does not exist in a virtual environment created by virtualenv. +# +# The following code creates compat.is_venv and is.virtualenv that are True when running a virtual environment, and also +# compat.base_prefix with the path to the base Python installation. + +base_prefix: str = os.path.abspath(getattr(sys, 'real_prefix', getattr(sys, 'base_prefix', sys.prefix))) +# Ensure `base_prefix` is not containing any relative parts. +is_venv = is_virtualenv = base_prefix != os.path.abspath(sys.prefix) + +# Conda environments sometimes have different paths or apply patches to packages that can affect how a hook or package +# should access resources. Method for determining conda taken from https://stackoverflow.com/questions/47610844#47610844 +is_conda = os.path.isdir(os.path.join(base_prefix, 'conda-meta')) + +# Similar to ``is_conda`` but is ``False`` using another ``venv``-like manager on top. In this case, no packages +# encountered will be conda packages meaning that the default non-conda behaviour is generally desired from PyInstaller. +is_pure_conda = os.path.isdir(os.path.join(sys.prefix, 'conda-meta')) + +# Full path to python interpreter. +python_executable = getattr(sys, '_base_executable', sys.executable) + +# Is this Python from Microsoft App Store (Windows only)? Python from Microsoft App Store has executable pointing at +# empty shims. +is_ms_app_store = is_win and os.path.getsize(python_executable) == 0 + +if is_ms_app_store: + # Locate the actual executable inside base_prefix. + python_executable = os.path.join(base_prefix, os.path.basename(python_executable)) + if not os.path.exists(python_executable): + raise SystemExit( + 'ERROR: PyInstaller cannot locate real python executable belonging to Python from Microsoft App Store!' + ) + +# Bytecode magic value +BYTECODE_MAGIC = importlib.util.MAGIC_NUMBER + +# List of suffixes for Python C extension modules. +EXTENSION_SUFFIXES = importlib.machinery.EXTENSION_SUFFIXES +ALL_SUFFIXES = importlib.machinery.all_suffixes() + +# On Windows we require pywin32-ctypes. +# -> all pyinstaller modules should use win32api from PyInstaller.compat to +# ensure that it can work on MSYS2 (which requires pywin32-ctypes) +if is_win: + if _setup_py_mode: + pywintypes = None + win32api = None + else: + try: + # Hide the `cffi` package from win32-ctypes by temporarily blocking its import. This ensures that `ctypes` + # backend is always used, even if `cffi` is available. The `cffi` backend uses `pycparser`, which is + # incompatible with -OO mode (2nd optimization level) due to its removal of docstrings. + # See https://github.com/pyinstaller/pyinstaller/issues/6345 + # On the off chance that `cffi` has already been imported, store the `sys.modules` entry so we can restore + # it after importing `pywin32-ctypes` modules. + orig_cffi = sys.modules.get('cffi') + sys.modules['cffi'] = None + + from win32ctypes.pywin32 import pywintypes # noqa: F401, E402 + from win32ctypes.pywin32 import win32api # noqa: F401, E402 + except ImportError as e: + raise SystemExit( + 'ERROR: Could not import `pywintypes` or `win32api` from `win32ctypes.pywin32`.\n' + 'Please make sure that `pywin32-ctypes` is installed and importable, for example:\n\n' + 'pip install pywin32-ctypes\n' + ) from e + finally: + # Unblock `cffi`. + if orig_cffi is not None: + sys.modules['cffi'] = orig_cffi + else: + del sys.modules['cffi'] + del orig_cffi + +# macOS's platform.architecture() can be buggy, so we do this manually here. Based off the python documentation: +# https://docs.python.org/3/library/platform.html#platform.architecture +if is_darwin: + architecture = '64bit' if sys.maxsize > 2**32 else '32bit' +else: + architecture = platform.architecture()[0] + +# Cygwin needs special handling, because platform.system() contains identifiers such as MSYS_NT-10.0-19042 and +# CYGWIN_NT-10.0-19042 that do not fit PyInstaller's OS naming scheme. Explicitly set `system` to 'Cygwin'. +system = 'Cygwin' if is_cygwin else platform.system() + +# Machine suffix for bootloader. +if is_win: + # On Windows ARM64 using an x64 Python environment, platform.machine() returns ARM64 but + # we really want the bootloader that matches the Python environment instead of the OS. + machine = _pyi_machine(os.environ.get("PROCESSOR_ARCHITECTURE", platform.machine()), platform.system()) +else: + machine = _pyi_machine(platform.machine(), platform.system()) + + +# Wine detection and support +def is_wine_dll(filename: str | os.PathLike): + """ + Check if the given PE file is a Wine DLL (PE-converted built-in, or fake/placeholder one). + + Returns True if the given file is a Wine DLL, False if not (or if file cannot be analyzed or does not exist). + """ + _WINE_SIGNATURES = ( + b'Wine builtin DLL', # PE-converted Wine DLL + b'Wine placeholder DLL', # Fake/placeholder Wine DLL + ) + _MAX_LEN = max([len(sig) for sig in _WINE_SIGNATURES]) + + # Wine places their DLL signature in the padding area between the IMAGE_DOS_HEADER and IMAGE_NT_HEADERS. So we need + # to compare the bytes that come right after IMAGE_DOS_HEADER, i.e., after initial 64 bytes. We can read the file + # directly and avoid using the pefile library to avoid performance penalty associated with full header parsing. + try: + with open(filename, 'rb') as fp: + fp.seek(64) + signature = fp.read(_MAX_LEN) + return signature.startswith(_WINE_SIGNATURES) + except Exception: + pass + return False + + +if is_win: + try: + import ctypes.util # noqa: E402 + is_win_wine = is_wine_dll(ctypes.util.find_library('kernel32')) + except Exception: + pass + +# Set and get environment variables does not handle unicode strings correctly on Windows. + +# Acting on os.environ instead of using getenv()/setenv()/unsetenv(), as suggested in +# : "Calling putenv() directly does not change os.environ, so it is +# better to modify os.environ." (Same for unsetenv.) + + +def getenv(name: str, default: str | None = None): + """ + Returns unicode string containing value of environment variable 'name'. + """ + return os.environ.get(name, default) + + +def setenv(name: str, value: str): + """ + Accepts unicode string and set it as environment variable 'name' containing value 'value'. + """ + os.environ[name] = value + + +def unsetenv(name: str): + """ + Delete the environment variable 'name'. + """ + # Some platforms (e.g., AIX) do not support `os.unsetenv()` and thus `del os.environ[name]` has no effect on the + # real environment. For this case, we set the value to the empty string. + os.environ[name] = "" + del os.environ[name] + + +# Exec commands in subprocesses. + + +def exec_command( + *cmdargs: str, encoding: str | None = None, raise_enoent: bool | None = None, **kwargs: int | bool | list | None +): + """ + Run the command specified by the passed positional arguments, optionally configured by the passed keyword arguments. + + .. DANGER:: + **Ignore this function's return value** -- unless this command's standard output contains _only_ pathnames, in + which case this function returns the correct filesystem-encoded string expected by PyInstaller. In all other + cases, this function's return value is _not_ safely usable. + + For backward compatibility, this function's return value non-portably depends on the current Python version and + passed keyword arguments: + + * Under Python 3.x, this value is a **decoded `str` string**. However, even this value is _not_ necessarily + safely usable: + * If the `encoding` parameter is passed, this value is guaranteed to be safely usable. + * Else, this value _cannot_ be safely used for any purpose (e.g., string manipulation or parsing), except to be + passed directly to another non-Python command. Why? Because this value has been decoded with the encoding + specified by `sys.getfilesystemencoding()`, the encoding used by `os.fsencode()` and `os.fsdecode()` to + convert from platform-agnostic to platform-specific pathnames. This is _not_ necessarily the encoding with + which this command's standard output was encoded. Cue edge-case decoding exceptions. + + Parameters + ---------- + cmdargs : + Variadic list whose: + 1. Mandatory first element is the absolute path, relative path, or basename in the current `${PATH}` of the + command to run. + 2. Optional remaining elements are arguments to pass to this command. + encoding : str, optional + Optional keyword argument specifying the encoding with which to decode this command's standard output under + Python 3. As this function's return value should be ignored, this argument should _never_ be passed. + raise_enoent : boolean, optional + Optional keyword argument to simply raise the exception if the executing the command fails since to the command + is not found. This is useful to checking id a command exists. + + All remaining keyword arguments are passed as is to the `subprocess.Popen()` constructor. + + Returns + ---------- + str + Ignore this value. See discussion above. + """ + + proc = subprocess.Popen(cmdargs, stdout=subprocess.PIPE, **kwargs) + try: + out = proc.communicate(timeout=60)[0] + except OSError as e: + if raise_enoent and e.errno == errno.ENOENT: + raise + print('--' * 20, file=sys.stderr) + print("Error running '%s':" % " ".join(cmdargs), file=sys.stderr) + print(e, file=sys.stderr) + print('--' * 20, file=sys.stderr) + raise ExecCommandFailed("ERROR: Executing command failed!") from e + except subprocess.TimeoutExpired: + proc.kill() + raise + + # stdout/stderr are returned as a byte array NOT as string, so we need to convert that to proper encoding. + try: + if encoding: + out = out.decode(encoding) + else: + # If no encoding is given, assume we are reading filenames from stdout only because it is the common case. + out = os.fsdecode(out) + except UnicodeDecodeError as e: + # The sub-process used a different encoding; provide more information to ease debugging. + print('--' * 20, file=sys.stderr) + print(str(e), file=sys.stderr) + print('These are the bytes around the offending byte:', file=sys.stderr) + print('--' * 20, file=sys.stderr) + raise + return out + + +def exec_command_rc(*cmdargs: str, **kwargs: float | bool | list | None): + """ + Return the exit code of the command specified by the passed positional arguments, optionally configured by the + passed keyword arguments. + + Parameters + ---------- + cmdargs : list + Variadic list whose: + 1. Mandatory first element is the absolute path, relative path, or basename in the current `${PATH}` of the + command to run. + 2. Optional remaining elements are arguments to pass to this command. + + All keyword arguments are passed as is to the `subprocess.call()` function. + + Returns + ---------- + int + This command's exit code as an unsigned byte in the range `[0, 255]`, where 0 signifies success and all other + values signal a failure. + """ + + # 'encoding' keyword is not supported for 'subprocess.call'; remove it from kwargs. + if 'encoding' in kwargs: + kwargs.pop('encoding') + return subprocess.call(cmdargs, **kwargs) + + +def exec_command_all(*cmdargs: str, encoding: str | None = None, **kwargs: int | bool | list | None): + """ + Run the command specified by the passed positional arguments, optionally configured by the passed keyword arguments. + + .. DANGER:: + **Ignore this function's return value.** If this command's standard output consists solely of pathnames, consider + calling `exec_command()` + + Parameters + ---------- + cmdargs : str + Variadic list whose: + 1. Mandatory first element is the absolute path, relative path, or basename in the current `${PATH}` of the + command to run. + 2. Optional remaining elements are arguments to pass to this command. + encoding : str, optional + Optional keyword argument specifying the encoding with which to decode this command's standard output. As this + function's return value should be ignored, this argument should _never_ be passed. + + All remaining keyword arguments are passed as is to the `subprocess.Popen()` constructor. + + Returns + ---------- + (int, str, str) + Ignore this 3-element tuple `(exit_code, stdout, stderr)`. See the `exec_command()` function for discussion. + """ + proc = subprocess.Popen( + cmdargs, + bufsize=-1, # Default OS buffer size. + stdout=subprocess.PIPE, + stderr=subprocess.PIPE, + **kwargs + ) + # Waits for subprocess to complete. + try: + out, err = proc.communicate(timeout=60) + except subprocess.TimeoutExpired: + proc.kill() + raise + # stdout/stderr are returned as a byte array NOT as string. Thus we need to convert that to proper encoding. + try: + if encoding: + out = out.decode(encoding) + err = err.decode(encoding) + else: + # If no encoding is given, assume we're reading filenames from stdout only because it's the common case. + out = os.fsdecode(out) + err = os.fsdecode(err) + except UnicodeDecodeError as e: + # The sub-process used a different encoding, provide more information to ease debugging. + print('--' * 20, file=sys.stderr) + print(str(e), file=sys.stderr) + print('These are the bytes around the offending byte:', file=sys.stderr) + print('--' * 20, file=sys.stderr) + raise + + return proc.returncode, out, err + + +def __wrap_python(args, kwargs): + cmdargs = [sys.executable] + + # macOS supports universal binaries (binary for multiple architectures. We need to ensure that subprocess + # binaries are running for the same architecture as python executable. It is necessary to run binaries with 'arch' + # command. + if is_darwin: + if architecture == '64bit': + if platform.machine() == 'arm64': + py_prefix = ['arch', '-arm64'] # Apple M1 + else: + py_prefix = ['arch', '-x86_64'] # Intel + elif architecture == '32bit': + py_prefix = ['arch', '-i386'] + else: + py_prefix = [] + # Since macOS 10.11, the environment variable DYLD_LIBRARY_PATH is no more inherited by child processes, so we + # proactively propagate the current value using the `-e` option of the `arch` command. + if 'DYLD_LIBRARY_PATH' in os.environ: + path = os.environ['DYLD_LIBRARY_PATH'] + py_prefix += ['-e', 'DYLD_LIBRARY_PATH=%s' % path] + cmdargs = py_prefix + cmdargs + + if not __debug__: + cmdargs.append('-O') + + cmdargs.extend(args) + + env = kwargs.get('env') + if env is None: + env = dict(**os.environ) + + # Ensure python 3 subprocess writes 'str' as utf-8 + env['PYTHONIOENCODING'] = 'UTF-8' + # ... and ensure we read output as utf-8 + kwargs['encoding'] = 'UTF-8' + + return cmdargs, kwargs + + +def exec_python(*args: str, **kwargs: str | None): + """ + Wrap running python script in a subprocess. + + Return stdout of the invoked command. + """ + cmdargs, kwargs = __wrap_python(args, kwargs) + return exec_command(*cmdargs, **kwargs) + + +def exec_python_rc(*args: str, **kwargs: str | None): + """ + Wrap running python script in a subprocess. + + Return exit code of the invoked command. + """ + cmdargs, kwargs = __wrap_python(args, kwargs) + return exec_command_rc(*cmdargs, **kwargs) + + +# Path handling. + + +# Site-packages functions - use native function if available. +def getsitepackages(prefixes: list | None = None): + """ + Returns a list containing all global site-packages directories. + + For each directory present in ``prefixes`` (or the global ``PREFIXES``), this function finds its `site-packages` + subdirectory depending on the system environment, and returns a list of full paths. + """ + # This implementation was copied from the ``site`` module, python 3.7.3. + sitepackages = [] + seen = set() + + if prefixes is None: + prefixes = [sys.prefix, sys.exec_prefix] + + for prefix in prefixes: + if not prefix or prefix in seen: + continue + seen.add(prefix) + + if os.sep == '/': + sitepackages.append(os.path.join(prefix, "lib", "python%d.%d" % sys.version_info[:2], "site-packages")) + else: + sitepackages.append(prefix) + sitepackages.append(os.path.join(prefix, "lib", "site-packages")) + return sitepackages + + +# Backported for virtualenv. Module 'site' in virtualenv might not have this attribute. +getsitepackages = getattr(site, 'getsitepackages', getsitepackages) + + +# Wrapper to load a module from a Python source file. This function loads import hooks when processing them. +def importlib_load_source(name: str, pathname: str): + # Import module from a file. + mod_loader = importlib.machinery.SourceFileLoader(name, pathname) + mod = types.ModuleType(mod_loader.name) + mod.__file__ = mod_loader.get_filename() # Some hooks require __file__ attribute in their namespace + mod_loader.exec_module(mod) + return mod + + +# Patterns of module names that should be bundled into the base_library.zip to be available during bootstrap. +# These modules include direct or indirect dependencies of encodings.* modules. The encodings modules must be +# recursively included to set the I/O encoding during python startup. Similarly, this list should include +# modules used by PyInstaller's bootstrap scripts and modules (loader/pyi*.py) + +PY3_BASE_MODULES = { + '_collections_abc', + '_weakrefset', + 'abc', + 'codecs', + 'collections', + 'copyreg', + 'encodings', + 'enum', + 'functools', + 'genericpath', # dependency of os.path + 'io', + 'heapq', + 'keyword', + 'linecache', + 'locale', + 'ntpath', # dependency of os.path + 'operator', + 'os', + 'posixpath', # dependency of os.path + 're', + 'reprlib', + 'sre_compile', + 'sre_constants', + 'sre_parse', + 'stat', # dependency of os.path + 'traceback', # for startup errors + 'types', + 'weakref', + 'warnings', +} + +if not is_py310: + PY3_BASE_MODULES.add('_bootlocale') + +# Object types of Pure Python modules in modulegraph dependency graph. +# Pure Python modules have code object (attribute co_code). +PURE_PYTHON_MODULE_TYPES = { + 'SourceModule', + 'CompiledModule', + 'Package', + 'NamespacePackage', + # Deprecated. + # TODO Could these module types be removed? + 'FlatPackage', + 'ArchiveModule', +} +# Object types of special Python modules (built-in, run-time, namespace package) in modulegraph dependency graph that do +# not have code object. +SPECIAL_MODULE_TYPES = { + # Omit AliasNode from here (and consequently from VALID_MODULE_TYPES), in order to prevent PyiModuleGraph from + # running standard hooks for aliased modules. + #'AliasNode', + 'BuiltinModule', + 'RuntimeModule', + 'RuntimePackage', + + # PyInstaller handles scripts differently and not as standard Python modules. + 'Script', +} +# Object types of Binary Python modules (extensions, etc) in modulegraph dependency graph. +BINARY_MODULE_TYPES = { + 'Extension', + 'ExtensionPackage', +} +# Object types of valid Python modules in modulegraph dependency graph. +VALID_MODULE_TYPES = PURE_PYTHON_MODULE_TYPES | SPECIAL_MODULE_TYPES | BINARY_MODULE_TYPES +# Object types of bad/missing/invalid Python modules in modulegraph dependency graph. +# TODO: should be 'Invalid' module types also in the 'MISSING' set? +BAD_MODULE_TYPES = { + 'BadModule', + 'ExcludedModule', + 'InvalidSourceModule', + 'InvalidCompiledModule', + 'MissingModule', + + # Runtime modules and packages are technically valid rather than bad, but exist only in-memory rather than on-disk + # (typically due to pre_safe_import_module() hooks), and hence cannot be physically frozen. For simplicity, these + # nodes are categorized as bad rather than valid. + 'RuntimeModule', + 'RuntimePackage', +} +ALL_MODULE_TYPES = VALID_MODULE_TYPES | BAD_MODULE_TYPES +# TODO: review this mapping to TOC, remove useless entries. +# Dictionary to map ModuleGraph node types to TOC typecodes. +MODULE_TYPES_TO_TOC_DICT = { + # Pure modules. + 'AliasNode': 'PYMODULE', + 'Script': 'PYSOURCE', + 'SourceModule': 'PYMODULE', + 'CompiledModule': 'PYMODULE', + 'Package': 'PYMODULE', + 'FlatPackage': 'PYMODULE', + 'ArchiveModule': 'PYMODULE', + # Binary modules. + 'Extension': 'EXTENSION', + 'ExtensionPackage': 'EXTENSION', + # Special valid modules. + 'BuiltinModule': 'BUILTIN', + 'NamespacePackage': 'PYMODULE', + # Bad modules. + 'BadModule': 'bad', + 'ExcludedModule': 'excluded', + 'InvalidSourceModule': 'invalid', + 'InvalidCompiledModule': 'invalid', + 'MissingModule': 'missing', + 'RuntimeModule': 'runtime', + 'RuntimePackage': 'runtime', + # Other. + 'does not occur': 'BINARY', +} + + +def check_requirements(): + """ + Verify that all requirements to run PyInstaller are met. + + Fail hard if any requirement is not met. + """ + # Fail hard if Python does not have minimum required version + if sys.version_info < (3, 8): + raise EnvironmentError('PyInstaller requires Python 3.8 or newer.') + + if sys.implementation.name != "cpython": + raise SystemExit(f"ERROR: PyInstaller does not support {sys.implementation.name}. Only CPython is supported.") + + if getattr(sys, "frozen", False): + raise SystemExit("ERROR: PyInstaller can not be ran on itself") + + # There are some old packages which used to be backports of libraries which are now part of the standard library. + # These backports are now unmaintained and contain only an older subset of features leading to obscure errors like + # "enum has not attribute IntFlag" if installed. + from importlib.metadata import distribution, PackageNotFoundError + + for name in ["enum34", "typing", "pathlib"]: + try: + dist = distribution(name) + except PackageNotFoundError: + continue + remove = "conda remove" if is_conda else f'"{sys.executable}" -m pip uninstall {name}' + raise SystemExit( + f"ERROR: The '{name}' package is an obsolete backport of a standard library package and is incompatible " + f"with PyInstaller. Please remove this package (located in {dist.locate_file('')}) using\n {remove}\n" + "then try again." + ) + + # Bail out if binutils is not installed. + if is_linux and shutil.which("objdump") is None: + raise SystemExit( + "ERROR: On Linux, objdump is required. It is typically provided by the 'binutils' package " + "installable via your Linux distribution's package manager." + ) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/config.py b/venv/lib/python3.12/site-packages/PyInstaller/config.py new file mode 100755 index 0000000..e6cb695 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/config.py @@ -0,0 +1,56 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +This module holds run-time PyInstaller configuration. + +Variable CONF is a dict() with all configuration options that are necessary for the build phase. Build phase is done by +passing .spec file to exec() function. CONF variable is the only way how to pass arguments to exec() and how to avoid +using 'global' variables. + +NOTE: Having 'global' variables does not play well with the test suite because it does not provide isolated environments +for tests. Some tests might fail in this case. + +NOTE: The 'CONF' dict() is cleaned after building phase to not interfere with any other possible test. + +To pass any arguments to build phase, just do: + + from PyInstaller.config import CONF + CONF['my_var_name'] = my_value + +And to use this variable in the build phase: + + from PyInstaller.config import CONF + foo = CONF['my_var_name'] + + +This is the list of known variables. (Please update it if necessary.) + +cachedir +hiddenimports +noconfirm +pathex +ui_admin +ui_access +upx_available +upx_dir +workpath + +tests_modgraph - cached PyiModuleGraph object to speed up tests + +code_cache - dictionary associating `Analysis.pure` list instances with code cache dictionaries. Used by PYZ writer. +""" + +# NOTE: Do not import other PyInstaller modules here. Just define constants here. + +CONF = { + # Unit tests require this key to exist. + 'pathex': [], +} diff --git a/venv/lib/python3.12/site-packages/PyInstaller/configure.py b/venv/lib/python3.12/site-packages/PyInstaller/configure.py new file mode 100755 index 0000000..46234b8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/configure.py @@ -0,0 +1,107 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Configure PyInstaller for the current Python installation. +""" + +import os +import subprocess + +from PyInstaller import compat +from PyInstaller import log as logging + +logger = logging.getLogger(__name__) + + +def _check_upx_availability(upx_dir): + logger.debug('Testing UPX availability ...') + + upx_exe = "upx" + if upx_dir: + upx_exe = os.path.normpath(os.path.join(upx_dir, upx_exe)) + + # Check if we can call `upx -V`. + try: + output = subprocess.check_output( + [upx_exe, '-V'], + stdin=subprocess.DEVNULL, + stderr=subprocess.DEVNULL, + encoding='utf-8', + ) + except Exception: + logger.debug('UPX is not available.') + return False + + # Read the first line to display version string + try: + version_string = output.splitlines()[0] + except IndexError: + version_string = 'version string unavailable' + + logger.debug('UPX is available: %s', version_string) + return True + + +def _get_pyinstaller_cache_dir(): + old_cache_dir = None + if compat.getenv('PYINSTALLER_CONFIG_DIR'): + cache_dir = compat.getenv('PYINSTALLER_CONFIG_DIR') + elif compat.is_win: + cache_dir = compat.getenv('LOCALAPPDATA') + if not cache_dir: + cache_dir = os.path.expanduser('~\\Application Data') + elif compat.is_darwin: + cache_dir = os.path.expanduser('~/Library/Application Support') + else: + # According to XDG specification: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html + old_cache_dir = compat.getenv('XDG_DATA_HOME') + if not old_cache_dir: + old_cache_dir = os.path.expanduser('~/.local/share') + cache_dir = compat.getenv('XDG_CACHE_HOME') + if not cache_dir: + cache_dir = os.path.expanduser('~/.cache') + cache_dir = os.path.join(cache_dir, 'pyinstaller') + # Move old cache-dir, if any, to new location. + if old_cache_dir and not os.path.exists(cache_dir): + old_cache_dir = os.path.join(old_cache_dir, 'pyinstaller') + if os.path.exists(old_cache_dir): + parent_dir = os.path.dirname(cache_dir) + if not os.path.exists(parent_dir): + os.makedirs(parent_dir) + os.rename(old_cache_dir, cache_dir) + return cache_dir + + +def get_config(upx_dir=None): + config = {} + + config['cachedir'] = _get_pyinstaller_cache_dir() + config['upx_dir'] = upx_dir + + # Disable UPX on non-Windows. Using UPX (3.96) on modern Linux shared libraries (for example, the python3.x.so + # shared library) seems to result in segmentation fault when they are dlopen'd. This happens in recent versions + # of Fedora and Ubuntu linux, as well as in Alpine containers. On macOS, UPX (3.96) fails with + # UnknownExecutableFormatException on most .dylibs (and interferes with code signature on other occasions). And + # even when it would succeed, compressed libraries cannot be (re)signed due to failed strict validation. + upx_available = _check_upx_availability(upx_dir) + if upx_available: + if compat.is_win or compat.is_cygwin: + logger.info("UPX is available and will be used if enabled on build targets.") + elif os.environ.get("PYINSTALLER_FORCE_UPX", "0") != "0": + logger.warning( + "UPX is available and force-enabled on platform with known compatibility problems - use at own risk!" + ) + else: + upx_available = False + logger.info("UPX is available but is disabled on non-Windows due to known compatibility problems.") + config['upx_available'] = upx_available + + return config diff --git a/venv/lib/python3.12/site-packages/PyInstaller/depend/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/depend/__init__.py new file mode 100755 index 0000000..792d600 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/depend/__init__.py @@ -0,0 +1 @@ +# diff --git a/venv/lib/python3.12/site-packages/PyInstaller/depend/analysis.py b/venv/lib/python3.12/site-packages/PyInstaller/depend/analysis.py new file mode 100755 index 0000000..72ae4e4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/depend/analysis.py @@ -0,0 +1,1025 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Define a modified ModuleGraph that can return its contents as a TOC and in other ways act like the old ImpTracker. +TODO: This class, along with TOC and Tree, should be in a separate module. + +For reference, the ModuleGraph node types and their contents: + + nodetype identifier filename + + Script full path to .py full path to .py + SourceModule basename full path to .py + BuiltinModule basename None + CompiledModule basename full path to .pyc + Extension basename full path to .so + MissingModule basename None + Package basename full path to __init__.py + packagepath is ['path to package'] + globalnames is set of global names __init__.py defines + ExtensionPackage basename full path to __init__.{so,dll} + packagepath is ['path to package'] + +The main extension here over ModuleGraph is a method to extract nodes from the flattened graph and return them as a +TOC, or added to a TOC. Other added methods look up nodes by identifier and return facts about them, replacing what +the old ImpTracker list could do. +""" + +import ast +import os +import sys +import traceback +from collections import defaultdict +from copy import deepcopy + +from PyInstaller import HOMEPATH, PACKAGEPATH +from PyInstaller import log as logging +from PyInstaller.building.utils import destination_name_for_extension +from PyInstaller.compat import ( + BAD_MODULE_TYPES, BINARY_MODULE_TYPES, MODULE_TYPES_TO_TOC_DICT, PURE_PYTHON_MODULE_TYPES, PY3_BASE_MODULES, + VALID_MODULE_TYPES, importlib_load_source, is_win +) +from PyInstaller.depend import bytecode +from PyInstaller.depend.imphook import AdditionalFilesCache, ModuleHookCache +from PyInstaller.depend.imphookapi import (PreFindModulePathAPI, PreSafeImportModuleAPI) +from PyInstaller.lib.modulegraph.find_modules import get_implies +from PyInstaller.lib.modulegraph.modulegraph import ModuleGraph, DEFAULT_IMPORT_LEVEL, ABSOLUTE_IMPORT_LEVEL, Package +from PyInstaller.log import DEBUG, INFO, TRACE +from PyInstaller.utils.hooks import collect_submodules, is_package + +logger = logging.getLogger(__name__) + +# Location-based hook priority constants +HOOK_PRIORITY_BUILTIN_HOOKS = -2000 # Built-in hooks. Lowest priority. +HOOK_PRIORITY_CONTRIBUTED_HOOKS = -1000 # Hooks from pyinstaller-hooks-contrib package. +HOOK_PRIORITY_UPSTREAM_HOOKS = 0 # Hooks provided by packages themselves, via entry-points. +HOOK_PRIORITY_USER_HOOKS = 1000 # User-supplied hooks (command-line / spec file). Highest priority. + + +class PyiModuleGraph(ModuleGraph): + """ + Directed graph whose nodes represent modules and edges represent dependencies between these modules. + + This high-level subclass wraps the lower-level `ModuleGraph` class with support for graph and runtime hooks. + While each instance of `ModuleGraph` represents a set of disconnected trees, each instance of this class *only* + represents a single connected tree whose root node is the Python script originally passed by the user on the + command line. For that reason, while there may (and typically do) exist more than one `ModuleGraph` instance, + there typically exists only a singleton instance of this class. + + Attributes + ---------- + _hooks : ModuleHookCache + Dictionary mapping the fully-qualified names of all modules with normal (post-graph) hooks to the absolute paths + of such hooks. See the the `_find_module_path()` method for details. + _hooks_pre_find_module_path : ModuleHookCache + Dictionary mapping the fully-qualified names of all modules with pre-find module path hooks to the absolute + paths of such hooks. See the the `_find_module_path()` method for details. + _hooks_pre_safe_import_module : ModuleHookCache + Dictionary mapping the fully-qualified names of all modules with pre-safe import module hooks to the absolute + paths of such hooks. See the `_safe_import_module()` method for details. + _user_hook_dirs : list + List of the absolute paths of all directories containing user-defined hooks for the current application. + _excludes : list + List of module names to be excluded when searching for dependencies. + _additional_files_cache : AdditionalFilesCache + Cache of all external dependencies (e.g., binaries, datas) listed in hook scripts for imported modules. + _module_collection_mode : dict + A dictionary of module/package collection mode settings set by hook scripts for their modules. + _bindepend_symlink_suppression : set + A set of paths or path patterns corresponding to shared libraries for which binary dependency analysis should + not create symbolic links into top-level application directory. + _base_modules: list + Dependencies for `base_library.zip` (which remain the same for every executable). + """ + + # Note: these levels are completely arbitrary and may be adjusted if needed. + LOG_LEVEL_MAPPING = {0: INFO, 1: DEBUG, 2: TRACE, 3: TRACE, 4: TRACE} + + def __init__(self, pyi_homepath, user_hook_dirs=(), excludes=(), **kwargs): + super().__init__(excludes=excludes, **kwargs) + # Homepath to the place where is PyInstaller located. + self._homepath = pyi_homepath + # modulegraph Node for the main python script that is analyzed by PyInstaller. + self._top_script_node = None + + # Absolute paths of all user-defined hook directories. + self._excludes = excludes + self._reset(user_hook_dirs) + self._analyze_base_modules() + + def _reset(self, user_hook_dirs): + """ + Reset for another set of scripts. This is primary required for running the test-suite. + """ + self._top_script_node = None + self._additional_files_cache = AdditionalFilesCache() + self._module_collection_mode = dict() + self._bindepend_symlink_suppression = set() + # Hook sources: user-supplied (command-line / spec file), entry-point (upstream hooks, contributed hooks), and + # built-in hooks. The order does not really matter anymore, because each entry is now a (location, priority) + # tuple, and order is determined from assigned priority (which may also be overridden by hooks themselves). + self._user_hook_dirs = [ + *user_hook_dirs, + (os.path.join(PACKAGEPATH, 'hooks'), HOOK_PRIORITY_BUILTIN_HOOKS), + ] + # Hook-specific lookup tables. These need to reset when reusing cached PyiModuleGraph to avoid hooks to refer to + # files or data from another test-case. + logger.info('Initializing module graph hook caches...') + self._hooks = self._cache_hooks("") + self._hooks_pre_safe_import_module = self._cache_hooks('pre_safe_import_module') + self._hooks_pre_find_module_path = self._cache_hooks('pre_find_module_path') + + # Search for run-time hooks in all hook directories. + self._available_rthooks = defaultdict(list) + for uhd, _ in self._user_hook_dirs: + uhd_path = os.path.abspath(os.path.join(uhd, 'rthooks.dat')) + try: + with open(uhd_path, 'r', encoding='utf-8') as f: + rthooks = ast.literal_eval(f.read()) + except FileNotFoundError: + # Ignore if this hook path doesn't have run-time hooks. + continue + except Exception as e: + logger.error('Unable to read run-time hooks from %r: %s' % (uhd_path, e)) + continue + + self._merge_rthooks(rthooks, uhd, uhd_path) + + # Convert back to a standard dict. + self._available_rthooks = dict(self._available_rthooks) + + def _merge_rthooks(self, rthooks, uhd, uhd_path): + """ + The expected data structure for a run-time hook file is a Python dictionary of type ``Dict[str, List[str]]``, + where the dictionary keys are module names and the sequence strings are Python file names. + + Check then merge this data structure, updating the file names to be absolute. + """ + # Check that the root element is a dict. + assert isinstance(rthooks, dict), 'The root element in %s must be a dict.' % uhd_path + for module_name, python_file_name_list in rthooks.items(): + # Ensure the key is a string. + assert isinstance(module_name, str), \ + '%s must be a dict whose keys are strings; %s is not a string.' % (uhd_path, module_name) + # Ensure the value is a list. + assert isinstance(python_file_name_list, list), \ + 'The value of %s key %s must be a list.' % (uhd_path, module_name) + if module_name in self._available_rthooks: + logger.warning( + 'Runtime hooks for %s have already been defined. Skipping the runtime hooks for %s that are ' + 'defined in %s.', module_name, module_name, os.path.join(uhd, 'rthooks') + ) + # Skip this module + continue + # Merge this with existing run-time hooks. + for python_file_name in python_file_name_list: + # Ensure each item in the list is a string. + assert isinstance(python_file_name, str), \ + '%s key %s, item %r must be a string.' % (uhd_path, module_name, python_file_name) + # Transform it into an absolute path. + abs_path = os.path.join(uhd, 'rthooks', python_file_name) + # Make sure this file exists. + assert os.path.exists(abs_path), \ + 'In %s, key %s, the file %r expected to be located at %r does not exist.' % \ + (uhd_path, module_name, python_file_name, abs_path) + # Merge it. + self._available_rthooks[module_name].append(abs_path) + + @staticmethod + def _findCaller(*args, **kwargs): + # Used to add an additional stack-frame above logger.findCaller. findCaller expects the caller to be three + # stack-frames above itself. + return logger.findCaller(*args, **kwargs) + + def msg(self, level, s, *args): + """ + Print a debug message with the given level. + + 1. Map the msg log level to a logger log level. + 2. Generate the message format (the same format as ModuleGraph) + 3. Find the caller, which findCaller expects three stack-frames above itself: + [3] caller -> [2] msg (here) -> [1] _findCaller -> [0] logger.findCaller + 4. Create a logRecord with the caller's information. + 5. Handle the logRecord. + """ + try: + level = self.LOG_LEVEL_MAPPING[level] + except KeyError: + return + if not logger.isEnabledFor(level): + return + + msg = "%s %s" % (s, ' '.join(map(repr, args))) + + try: + fn, lno, func, sinfo = self._findCaller() + except ValueError: # pragma: no cover + fn, lno, func, sinfo = "(unknown file)", 0, "(unknown function)", None + record = logger.makeRecord(logger.name, level, fn, lno, msg, [], None, func, None, sinfo) + + logger.handle(record) + + # Set logging methods so that the stack is correctly detected. + msgin = msg + msgout = msg + + def _cache_hooks(self, hook_type): + """ + Create a cache of all hooks of the specified type. + + The cache will include all official hooks defined by the PyInstaller codebase _and_ all unofficial hooks + defined for the current application. + + Parameters + ---------- + hook_type : str + Type of hooks to be cached, equivalent to the basename of the subpackage of the `PyInstaller.hooks` + package containing such hooks (e.g., empty string for standard hooks, `pre_safe_import_module` for + pre-safe-import-module hooks, `pre_find_module_path` for pre-find-module-path hooks). + """ + # Cache of this type of hooks. + hook_dirs = [] + for user_hook_dir, priority in self._user_hook_dirs: + # Absolute path of the user-defined subdirectory of this hook type. If this directory exists, add it to the + # list to be cached. + user_hook_type_dir = os.path.join(user_hook_dir, hook_type) + if os.path.isdir(user_hook_type_dir): + hook_dirs.append((user_hook_type_dir, priority)) + + return ModuleHookCache(self, hook_dirs) + + def _analyze_base_modules(self): + """ + Analyze dependencies of the the modules in base_library.zip. + """ + logger.info('Analyzing modules for base_library.zip ...') + required_mods = [] + # Collect submodules from required modules in base_library.zip. + for m in PY3_BASE_MODULES: + if is_package(m): + required_mods += collect_submodules(m) + else: + required_mods.append(m) + # Initialize ModuleGraph. + self._base_modules = [mod for req in required_mods for mod in self.import_hook(req)] + + def add_script(self, pathname, caller=None): + """ + Wrap the parent's 'run_script' method and create graph from the first script in the analysis, and save its + node to use as the "caller" node for all others. This gives a connected graph rather than a collection of + unrelated trees. + """ + if self._top_script_node is None: + # Remember the node for the first script. + try: + self._top_script_node = super().add_script(pathname) + except SyntaxError: + print("\nSyntax error in", pathname, file=sys.stderr) + formatted_lines = traceback.format_exc().splitlines(True) + print(*formatted_lines[-4:], file=sys.stderr) + sys.exit(1) + # Create references from the top script to the base_modules in graph. + for node in self._base_modules: + self.add_edge(self._top_script_node, node) + # Return top-level script node. + return self._top_script_node + else: + if not caller: + # Defaults to as any additional script is called from the top-level script. + caller = self._top_script_node + return super().add_script(pathname, caller=caller) + + def process_post_graph_hooks(self, analysis): + """ + For each imported module, run this module's post-graph hooks if any. + + Parameters + ---------- + analysis: build_main.Analysis + The Analysis that calls the hooks + + """ + # For each iteration of the infinite "while" loop below: + # + # 1. All hook() functions defined in cached hooks for imported modules are called. This may result in new + # modules being imported (e.g., as hidden imports) that were ignored earlier in the current iteration: if + # this is the case, all hook() functions defined in cached hooks for these modules will be called by the next + # iteration. + # 2. All cached hooks whose hook() functions were called are removed from this cache. If this cache is empty, no + # hook() functions will be called by the next iteration and this loop will be terminated. + # 3. If no hook() functions were called, this loop is terminated. + logger.info('Processing module hooks (post-graph stage)...') + while True: + # Set of the names of all imported modules whose post-graph hooks are run by this iteration, preventing the + # next iteration from re- running these hooks. If still empty at the end of this iteration, no post-graph + # hooks were run; thus, this loop will be terminated. + hooked_module_names = set() + + # For each remaining hookable module and corresponding hooks... + for module_name, module_hook in self._hooks.items(): + # Graph node for this module if imported or "None" otherwise. + module_node = self.find_node(module_name, create_nspkg=False) + + # If this module has not been imported, temporarily ignore it. This module is retained in the cache, as + # a subsequently run post-graph hook could import this module as a hidden import. + if module_node is None: + continue + + # If this module is unimportable, permanently ignore it. + if type(module_node).__name__ not in VALID_MODULE_TYPES: + hooked_module_names.add(module_name) + continue + + # Run this script's post-graph hook. + module_hook.post_graph(analysis) + + # Cache all external dependencies listed by this script after running this hook, which could add + # dependencies. + self._additional_files_cache.add(module_name, module_hook.binaries, module_hook.datas) + + # Update package collection mode settings. + self._module_collection_mode.update(module_hook.module_collection_mode) + + # Update symbolic link suppression patterns for binary dependency analysis. + self._bindepend_symlink_suppression.update(module_hook.bindepend_symlink_suppression) + + # Prevent this module's hooks from being run again. + hooked_module_names.add(module_name) + + # Prevent all post-graph hooks run above from being run again by the next iteration. + self._hooks.remove_modules(*hooked_module_names) + + # If no post-graph hooks were run, terminate iteration. + if not hooked_module_names: + break + + def _find_all_excluded_imports(self, module_name): + """ + Collect excludedimports from the hooks of the specified module and all its parents. + """ + excluded_imports = set() + while module_name: + # Gather excluded imports from hook belonging to the module. + module_hook = self._hooks.get(module_name, None) + if module_hook: + excluded_imports.update(module_hook.excludedimports) + # Change module name to the module's parent name + module_name = module_name.rpartition('.')[0] + return excluded_imports + + def _safe_import_hook( + self, target_module_partname, source_module, target_attr_names, level=DEFAULT_IMPORT_LEVEL, edge_attr=None + ): + if source_module is not None: + # Gather all excluded imports for the referring modules, as well as its parents. + # For example, we want the excluded imports specified by hook for PIL to be also applied when the referring + # module is its submodule, PIL.Image. + excluded_imports = self._find_all_excluded_imports(source_module.identifier) + + # Apply extra processing only if we have any excluded-imports rules + if excluded_imports: + # Resolve the base module name. Level can be ABSOLUTE_IMPORT_LEVEL (= 0) for absolute imports, or an + # integer indicating the relative level. We do not use equality comparison just in case we ever happen + # to get ABSOLUTE_OR_RELATIVE_IMPORT_LEVEL (-1), which is a remnant of python2 days. + if level > ABSOLUTE_IMPORT_LEVEL: + if isinstance(source_module, Package): + # Package + base_module_name = source_module.identifier + else: + # Module in a package; base name must be the parent package name! + base_module_name = '.'.join(source_module.identifier.split('.')[:-1]) + + # Adjust the base module name based on level + if level > 1: + base_module_name = '.'.join(base_module_name.split('.')[:-(level - 1)]) + + if target_module_partname: + base_module_name += '.' + target_module_partname + else: + base_module_name = target_module_partname + + def _exclude_module(module_name, excluded_imports, referrer_name): + """ + Helper for checking whether given module should be excluded. + Returns the name of exclusion rule if module should be excluded, None otherwise. + """ + module_name_parts = module_name.split('.') + for excluded_import in excluded_imports: + excluded_import_parts = excluded_import.split('.') + match = module_name_parts[:len(excluded_import_parts)] == excluded_import_parts + if match: + # Check if the referrer is (was!) subject to the same rule. Because if it was and was + # analyzed anyway, some other import chain must have overrode the exclusion, and we should + # waive it here. A package hook might exclude a part (a subpackage) of the said package to + # prevent its collection when there are no external references; but when they are (for + # example, user explicitly imports the said subpackage in their program), we must let the + # subpackage import its submodules. + referrer_name_parts = referrer_name.split('.') + referrer_match = referrer_name_parts[:len(excluded_import_parts)] == excluded_import_parts + if referrer_match: + logger.debug( + "Deactivating suppression rule %r for module %r because it also applies to the " + "referrer (%r)...", excluded_import, module_name, referrer_name + ) + continue + + return excluded_import + return None + + # First, check if base module name is to be excluded. + # This covers both basic `import a` and `import a.b.c`, as well as `from d import e, f` where base + # module `d` is excluded. + excluded_import_rule = _exclude_module( + base_module_name, + excluded_imports, + source_module.identifier, + ) + if excluded_import_rule: + logger.debug( + "Suppressing import of %r from module %r due to excluded import %r specified in a hook for %r " + "(or its parent package(s)).", base_module_name, source_module.identifier, excluded_import_rule, + source_module.identifier + ) + return [] + + # If we have target attribute names, check each of them, and remove excluded ones from the + # `target_attr_names` list. + if target_attr_names: + filtered_target_attr_names = [] + for target_attr_name in target_attr_names: + submodule_name = base_module_name + '.' + target_attr_name + excluded_import_rule = _exclude_module( + submodule_name, + excluded_imports, + source_module.identifier, + ) + if excluded_import_rule: + logger.debug( + "Suppressing import of %r from module %r due to excluded import %r specified in a hook " + "for %r (or its parent package(s)).", submodule_name, source_module.identifier, + excluded_import_rule, source_module.identifier + ) + else: + filtered_target_attr_names.append(target_attr_name) + + # Swap with filtered target attribute names list; if no elements remain after the filtering, pass + # None... + target_attr_names = filtered_target_attr_names or None + + ret_modules = super()._safe_import_hook( + target_module_partname, source_module, target_attr_names, level, edge_attr + ) + + # Ensure that hooks are pre-loaded for returned module(s), in an attempt to ensure that hooks are called in the + # order of imports. The hooks are cached, so there should be no downsides to pre-loading hooks early (as opposed + # to loading them in post-graph analysis). When modules are imported from other modules, the hooks for those + # referring (source) modules and their parent package(s) are loaded by the exclusion mechanism that takes place + # before the above `super()._safe_import_hook` call. The code below attempts to complement that, but for the + # referred (target) modules and their parent package(s). + for ret_module in ret_modules: + if type(ret_module).__name__ not in VALID_MODULE_TYPES: + continue + # (Ab)use the `_find_all_excluded_imports` helper to load all hooks for the given module and its parent + # package(s). + self._find_all_excluded_imports(ret_module.identifier) + + return ret_modules + + def _safe_import_module(self, module_basename, module_name, parent_package): + """ + Create a new graph node for the module with the passed name under the parent package signified by the passed + graph node. + + This method wraps the superclass method with support for pre-import module hooks. If such a hook exists for + this module (e.g., a script `PyInstaller.hooks.hook-{module_name}` containing a function + `pre_safe_import_module()`), that hook will be run _before_ the superclass method is called. + + Pre-Safe-Import-Hooks are performed just *prior* to importing the module. When running the hook, the modules + parent package has already been imported and ti's `__path__` is set up. But the module is just about to be + imported. + + See the superclass method for description of parameters and return value. + """ + # If this module has a pre-safe import module hook, run it. Make sure to remove it first, to prevent subsequent + # calls from running it again. + hook = self._hooks_pre_safe_import_module.pop(module_name, None) + if hook is not None: + # Dynamically import this hook as a fabricated module. + hook_path, hook_basename = os.path.split(hook.hook_filename) + logger.info('Processing pre-safe-import-module hook %r from %r', hook_basename, hook_path) + hook_module_name = 'PyInstaller_hooks_pre_safe_import_module_' + module_name.replace('.', '_') + hook_module = importlib_load_source(hook_module_name, hook.hook_filename) + + # Object communicating changes made by this hook back to us. + hook_api = PreSafeImportModuleAPI( + module_graph=self, + module_basename=module_basename, + module_name=module_name, + parent_package=parent_package, + ) + + # Run this hook, passed this object. + if not hasattr(hook_module, 'pre_safe_import_module'): + raise NameError('pre_safe_import_module() function not defined by hook %r.' % hook_module) + hook_module.pre_safe_import_module(hook_api) + + # Respect method call changes requested by this hook. + module_basename = hook_api.module_basename + module_name = hook_api.module_name + + # Call the superclass method. + return super()._safe_import_module(module_basename, module_name, parent_package) + + def _find_module_path(self, fullname, module_name, search_dirs): + """ + Get a 3-tuple detailing the physical location of the module with the passed name if that module exists _or_ + raise `ImportError` otherwise. + + This method wraps the superclass method with support for pre-find module path hooks. If such a hook exists + for this module (e.g., a script `PyInstaller.hooks.hook-{module_name}` containing a function + `pre_find_module_path()`), that hook will be run _before_ the superclass method is called. + + See superclass method for parameter and return value descriptions. + """ + # If this module has a pre-find module path hook, run it. Make sure to remove it first, to prevent subsequent + # calls from running it again. + hook = self._hooks_pre_find_module_path.pop(fullname, None) + if hook is not None: + # Dynamically import this hook as a fabricated module. + hook_path, hook_basename = os.path.split(hook.hook_filename) + logger.info('Processing pre-find-module-path hook %r from %r', hook_basename, hook_path) + hook_fullname = 'PyInstaller_hooks_pre_find_module_path_' + fullname.replace('.', '_') + hook_module = importlib_load_source(hook_fullname, hook.hook_filename) + + # Object communicating changes made by this hook back to us. + hook_api = PreFindModulePathAPI( + module_graph=self, + module_name=fullname, + search_dirs=search_dirs, + ) + + # Run this hook, passed this object. + if not hasattr(hook_module, 'pre_find_module_path'): + raise NameError('pre_find_module_path() function not defined by hook %r.' % hook_module) + hook_module.pre_find_module_path(hook_api) + + # Respect search-directory changes requested by this hook. + search_dirs = hook_api.search_dirs + + # Call the superclass method. + return super()._find_module_path(fullname, module_name, search_dirs) + + def get_code_objects(self): + """ + Get code objects from ModuleGraph for pure Python modules. This allows to avoid writing .pyc/pyo files to hdd + at later stage. + + :return: Dict with module name and code object. + """ + code_dict = {} + mod_types = PURE_PYTHON_MODULE_TYPES + for node in self.iter_graph(start=self._top_script_node): + # TODO This is terrible. To allow subclassing, types should never be directly compared. Use isinstance() + # instead, which is safer, simpler, and accepts sets. Most other calls to type() in the codebase should also + # be refactored to call isinstance() instead. + + # get node type e.g. Script + mg_type = type(node).__name__ + if mg_type in mod_types: + if node.code: + code_dict[node.identifier] = node.code + return code_dict + + def _make_toc(self, typecode=None): + """ + Return the name, path and type of selected nodes as a TOC. The selection is determined by the given list + of PyInstaller TOC typecodes. If that list is empty we return the complete flattened graph as a TOC with the + ModuleGraph note types in place of typecodes -- meant for debugging only. Normally we return ModuleGraph + nodes whose types map to the requested PyInstaller typecode(s) as indicated in the MODULE_TYPES_TO_TOC_DICT. + + We use the ModuleGraph (really, ObjectGraph) flatten() method to scan all the nodes. This is patterned after + ModuleGraph.report(). + """ + toc = list() + for node in self.iter_graph(start=self._top_script_node): + entry = self._node_to_toc(node, typecode) + # Append the entry. We do not check for duplicates here; the TOC normalization is left to caller. + # However, as entries are obtained from modulegraph, there should not be any duplicates at this stage. + if entry is not None: + toc.append(entry) + return toc + + def make_pure_toc(self): + """ + Return all pure Python modules formatted as TOC. + """ + # PyInstaller should handle special module types without code object. + return self._make_toc(PURE_PYTHON_MODULE_TYPES) + + def make_binaries_toc(self): + """ + Return all binary Python modules formatted as TOC. + """ + return self._make_toc(BINARY_MODULE_TYPES) + + def make_missing_toc(self): + """ + Return all MISSING Python modules formatted as TOC. + """ + return self._make_toc(BAD_MODULE_TYPES) + + @staticmethod + def _node_to_toc(node, typecode=None): + # TODO This is terrible. Everything in Python has a type. It is nonsensical to even speak of "nodes [that] are + # not typed." How would that even occur? After all, even "None" has a type! (It is "NoneType", for the curious.) + # Remove this, please. + + # Get node type, e.g., Script + mg_type = type(node).__name__ + assert mg_type is not None + + if typecode and mg_type not in typecode: + # Type is not a to be selected one, skip this one + return None + # Extract the identifier and a path if any. + if mg_type == 'Script': + # for Script nodes only, identifier is a whole path + (name, ext) = os.path.splitext(node.filename) + name = os.path.basename(name) + elif mg_type == 'ExtensionPackage': + # Package with __init__ module being an extension module. This needs to end up as e.g. 'mypkg/__init__.so'. + # Convert the packages name ('mypkg') into the module name ('mypkg.__init__') *here* to keep special cases + # away elsewhere (where the module name is converted to a filename). + name = node.identifier + ".__init__" + else: + name = node.identifier + path = node.filename if node.filename is not None else '' + # Ensure name is really 'str'. Module graph might return object type 'modulegraph.Alias' which inherits fromm + # 'str'. But 'marshal.dumps()' function is able to marshal only 'str'. Otherwise on Windows PyInstaller might + # fail with message like: + # ValueError: unmarshallable object + name = str(name) + # Translate to the corresponding TOC typecode. + toc_type = MODULE_TYPES_TO_TOC_DICT[mg_type] + return name, path, toc_type + + def nodes_to_toc(self, nodes): + """ + Given a list of nodes, create a TOC representing those nodes. This is mainly used to initialize a TOC of + scripts with the ones that are runtime hooks. The process is almost the same as _make_toc(), but the caller + guarantees the nodes are valid, so minimal checking. + """ + return [self._node_to_toc(node) for node in nodes] + + # Return true if the named item is in the graph as a BuiltinModule node. The passed name is a basename. + def is_a_builtin(self, name): + node = self.find_node(name) + if node is None: + return False + return type(node).__name__ == 'BuiltinModule' + + def get_importers(self, name): + """ + List all modules importing the module with the passed name. + + Returns a list of (identifier, DependencyIinfo)-tuples. If the names module has not yet been imported, this + method returns an empty list. + + Parameters + ---------- + name : str + Fully-qualified name of the module to be examined. + + Returns + ---------- + list + List of (fully-qualified names, DependencyIinfo)-tuples of all modules importing the module with the passed + fully-qualified name. + + """ + def get_importer_edge_data(importer): + edge = self.graph.edge_by_node(importer, name) + # edge might be None in case an AliasModule was added. + if edge is not None: + return self.graph.edge_data(edge) + + node = self.find_node(name) + if node is None: + return [] + _, importers = self.get_edges(node) + importers = (importer.identifier for importer in importers if importer is not None) + return [(importer, get_importer_edge_data(importer)) for importer in importers] + + # TODO: create a class from this function. + def analyze_runtime_hooks(self, custom_runhooks): + """ + Analyze custom run-time hooks and run-time hooks implied by found modules. + + :return : list of Graph nodes. + """ + rthooks_nodes = [] + logger.info('Analyzing run-time hooks ...') + # Process custom runtime hooks (from --runtime-hook options). The runtime hooks are order dependent. First hooks + # in the list are executed first. Put their graph nodes at the head of the priority_scripts list Pyinstaller + # defined rthooks and thus they are executed first. + if custom_runhooks: + for hook_file in custom_runhooks: + logger.info("Including custom run-time hook %r", hook_file) + hook_file = os.path.abspath(hook_file) + # Not using "try" here because the path is supposed to exist, if it does not, the raised error will + # explain. + rthooks_nodes.append(self.add_script(hook_file)) + + # Find runtime hooks that are implied by packages already imported. Get a temporary TOC listing all the scripts + # and packages graphed so far. Assuming that runtime hooks apply only to modules and packages. + temp_toc = self._make_toc(VALID_MODULE_TYPES) + for (mod_name, path, typecode) in temp_toc: + # Look if there is any run-time hook for given module. + if mod_name in self._available_rthooks: + # There could be several run-time hooks for a module. + for abs_path in self._available_rthooks[mod_name]: + hook_path, hook_basename = os.path.split(abs_path) + logger.info("Including run-time hook %r from %r", hook_basename, hook_path) + rthooks_nodes.append(self.add_script(abs_path)) + + return rthooks_nodes + + def add_hiddenimports(self, module_list): + """ + Add hidden imports that are either supplied as CLI option --hidden-import=MODULENAME or as dependencies from + some PyInstaller features when enabled (e.g., crypto feature). + """ + assert self._top_script_node is not None + # Analyze the script's hidden imports (named on the command line). + for modnm in module_list: + node = self.find_node(modnm) + if node is not None: + logger.debug('Hidden import %r already found', modnm) + else: + logger.info("Analyzing hidden import %r", modnm) + # ModuleGraph throws ImportError if import not found. + try: + nodes = self.import_hook(modnm) + assert len(nodes) == 1 + node = nodes[0] + except ImportError: + logger.error("Hidden import %r not found", modnm) + continue + # Create references from the top script to the hidden import, even if found otherwise. Do not waste time + # checking whether it is actually added by this (test-) script. + self.add_edge(self._top_script_node, node) + + def get_code_using(self, module: str) -> dict: + """ + Find modules that import a given **module**. + """ + co_dict = {} + pure_python_module_types = PURE_PYTHON_MODULE_TYPES | { + 'Script', + } + node = self.find_node(module) + if node: + referrers = self.incoming(node) + for r in referrers: + # Under python 3.7 and earlier, if `module` is added to hidden imports, one of referrers ends up being + # None, causing #3825. Work around it. + if r is None: + continue + # Ensure that modulegraph objects have 'code' attribute. + if type(r).__name__ not in pure_python_module_types: + continue + identifier = r.identifier + if identifier == module or identifier.startswith(module + '.'): + # Skip self references or references from `modules`'s own submodules. + continue + # The code object may be None if referrer ends up shadowed by eponymous directory that ends up treated + # as a namespace package. See #6873 for an example. + if r.code is None: + continue + co_dict[r.identifier] = r.code + return co_dict + + def metadata_required(self) -> set: + """ + Collect metadata for all packages that appear to need it. + """ + + # List every function that we can think of which is known to require metadata. + out = set() + + out |= self._metadata_from( + "pkg_resources", + ["get_distribution"], # Requires metadata for one distribution. + ["require"], # Requires metadata for all dependencies. + ) + + # importlib.metadata is often `import ... as` aliased to importlib_metadata for compatibility with < py38. + # Assume both are valid. + for importlib_metadata in ["importlib.metadata", "importlib_metadata"]: + out |= self._metadata_from( + importlib_metadata, + ["metadata", "distribution", "version", "files", "requires"], + [], + ) + + return out + + def _metadata_from(self, package, methods=(), recursive_methods=()) -> set: + """ + Collect metadata whose requirements are implied by given function names. + + Args: + package: + The module name that must be imported in a source file to trigger the search. + methods: + Function names from **package** which take a distribution name as an argument and imply that metadata + is required for that distribution. + recursive_methods: + Like **methods** but also implies that a distribution's dependencies' metadata must be collected too. + Returns: + Required metadata in hook data ``(source, dest)`` format as returned by + :func:`PyInstaller.utils.hooks.copy_metadata()`. + + Scan all source code to be included for usage of particular *key* functions which imply that that code will + require metadata for some distribution (which may not be its own) at runtime. In the case of a match, + collect the required metadata. + """ + from PyInstaller.utils.hooks import copy_metadata + from PyInstaller.compat import importlib_metadata + + # Generate sets of possible function names to search for. + need_metadata = set() + need_recursive_metadata = set() + for method in methods: + need_metadata.update(bytecode.any_alias(package + "." + method)) + for method in recursive_methods: + need_recursive_metadata.update(bytecode.any_alias(package + "." + method)) + + out = set() + + for name, code in self.get_code_using(package).items(): + for calls in bytecode.recursive_function_calls(code).values(): + for function_name, args in calls: + # Only consider function calls taking one argument. + if len(args) != 1: + continue + package = args[0] + try: + if function_name in need_metadata: + out.update(copy_metadata(package)) + elif function_name in need_recursive_metadata: + out.update(copy_metadata(package, recursive=True)) + + except importlib_metadata.PackageNotFoundError: + # Currently, we opt to silently skip over missing metadata. + continue + + return out + + def get_collected_packages(self) -> list: + """ + Return the list of collected python packages. + """ + # `node.identifier` might be an instance of `modulegraph.Alias`, hence explicit conversion to `str`. + return [ + str(node.identifier) for node in self.iter_graph(start=self._top_script_node) + if type(node).__name__ == 'Package' + ] + + def make_hook_binaries_toc(self) -> list: + """ + Return the TOC list of binaries collected by hooks." + """ + toc = [] + for node in self.iter_graph(start=self._top_script_node): + module_name = str(node.identifier) + for dest_name, src_name in self._additional_files_cache.binaries(module_name): + toc.append((dest_name, src_name, 'BINARY')) + + return toc + + def make_hook_datas_toc(self) -> list: + """ + Return the TOC list of data files collected by hooks." + """ + toc = [] + for node in self.iter_graph(start=self._top_script_node): + module_name = str(node.identifier) + for dest_name, src_name in self._additional_files_cache.datas(module_name): + toc.append((dest_name, src_name, 'DATA')) + + return toc + + +_cached_module_graph_ = None + + +def initialize_modgraph(excludes=(), user_hook_dirs=()): + """ + Create the cached module graph. + + This function might appear weird but is necessary for speeding up test runtime because it allows caching basic + ModuleGraph object that gets created for 'base_library.zip'. + + Parameters + ---------- + excludes : list + List of the fully-qualified names of all modules to be "excluded" and hence _not_ frozen into the executable. + user_hook_dirs : list + List of the absolute paths of all directories containing user-defined hooks for the current application or + `None` if no such directories were specified. + + Returns + ---------- + PyiModuleGraph + Module graph with core dependencies. + """ + # Normalize parameters to ensure tuples and make comparison work. + user_hook_dirs = user_hook_dirs or () + excludes = excludes or () + + # Ensure that __main__ is always excluded from the modulegraph, to prevent accidentally pulling PyInstaller itself + # into the modulegraph. This seems to happen on Windows, because modulegraph is able to resolve `__main__` as + # `.../PyInstaller.exe/__main__.py` and analyze it. The `__main__` has a different meaning during analysis compared + # to the program run-time, when it refers to the program's entry-point (which would always be part of the + # modulegraph anyway, by virtue of being the starting point of the analysis). + if "__main__" not in excludes: + excludes += ("__main__",) + + # If there is a graph cached with the same excludes, reuse it. See ``PyiModulegraph._reset()`` for what is + # reset. This cache is used primarily to speed up the test-suite. Fixture `pyi_modgraph` calls this function with + # empty excludes, creating a graph suitable for the huge majority of tests. + global _cached_module_graph_ + if _cached_module_graph_ and _cached_module_graph_._excludes == excludes: + logger.info('Reusing cached module dependency graph...') + graph = deepcopy(_cached_module_graph_) + graph._reset(user_hook_dirs) + return graph + + logger.info('Initializing module dependency graph...') + + # Construct the initial module graph by analyzing all import statements. + graph = PyiModuleGraph( + HOMEPATH, + excludes=excludes, + # get_implies() are hidden imports known by modulgraph. + implies=get_implies(), + user_hook_dirs=user_hook_dirs, + ) + + if not _cached_module_graph_: + # Only cache the first graph, see above for explanation. + logger.info('Caching module dependency graph...') + # cache a deep copy of the graph + _cached_module_graph_ = deepcopy(graph) + # Clear data which does not need to be copied from the cached graph since it will be reset by + # ``PyiModulegraph._reset()`` anyway. + _cached_module_graph_._hooks = None + _cached_module_graph_._hooks_pre_safe_import_module = None + _cached_module_graph_._hooks_pre_find_module_path = None + + return graph + + +def get_bootstrap_modules(): + """ + Get TOC with the bootstrapping modules and their dependencies. + :return: TOC with modules + """ + # Import 'struct' modules to get real paths to module file names. + mod_struct = __import__('struct') + # Basic modules necessary for the bootstrap process. + loader_mods = list() + loaderpath = os.path.join(HOMEPATH, 'PyInstaller', 'loader') + # On some platforms (Windows, Debian/Ubuntu) '_struct' and zlib modules are built-in modules (linked statically) + # and thus does not have attribute __file__. 'struct' module is required for reading Python bytecode from + # executable. 'zlib' is required to decompress this bytecode. + for mod_name in ['_struct', 'zlib']: + mod = __import__(mod_name) # C extension. + if hasattr(mod, '__file__'): + mod_file = os.path.abspath(mod.__file__) + # Resolve full destination name for extension, diverting it into python3.x/lib-dynload directory if + # necessary (to match behavior for extension collection introduced in #5604). + mod_dest = destination_name_for_extension(mod_name, mod_file, 'EXTENSION') + loader_mods.append((mod_dest, mod_file, 'EXTENSION')) + loader_mods.append(('struct', os.path.abspath(mod_struct.__file__), 'PYMODULE')) + # Loader/bootstrap modules. + # NOTE: These modules should be kept simple without any complicated dependencies. + loader_mods += [ + ('pyimod01_archive', os.path.join(loaderpath, 'pyimod01_archive.py'), 'PYMODULE'), + ('pyimod02_importers', os.path.join(loaderpath, 'pyimod02_importers.py'), 'PYMODULE'), + ('pyimod03_ctypes', os.path.join(loaderpath, 'pyimod03_ctypes.py'), 'PYMODULE'), + ] + if is_win: + loader_mods.append(('pyimod04_pywin32', os.path.join(loaderpath, 'pyimod04_pywin32.py'), 'PYMODULE')) + # The bootstrap script + loader_mods.append(('pyiboot01_bootstrap', os.path.join(loaderpath, 'pyiboot01_bootstrap.py'), 'PYSOURCE')) + return loader_mods diff --git a/venv/lib/python3.12/site-packages/PyInstaller/depend/bindepend.py b/venv/lib/python3.12/site-packages/PyInstaller/depend/bindepend.py new file mode 100755 index 0000000..23b3769 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/depend/bindepend.py @@ -0,0 +1,1131 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Find external dependencies of binary libraries. +""" + +import ctypes.util +import functools +import os +import pathlib +import re +import sys +import sysconfig +import subprocess + +from PyInstaller import compat +from PyInstaller import log as logging +from PyInstaller.depend import dylib, utils +from PyInstaller.utils.win32 import winutils +from PyInstaller.exceptions import PythonLibraryNotFoundError + +if compat.is_darwin: + import PyInstaller.utils.osx as osxutils + +logger = logging.getLogger(__name__) + +_exe_machine_type = None +if compat.is_win: + _exe_machine_type = winutils.get_pe_file_machine_type(compat.python_executable) + +#- High-level binary dependency analysis + + +def _get_paths_for_parent_directory_preservation(): + """ + Return list of paths that serve as prefixes for parent-directory preservation of collected binaries and/or + shared libraries. If a binary is collected from a location that starts with a path from this list, the relative + directory structure is preserved within the frozen application bundle; otherwise, the binary is collected to the + frozen application's top-level directory. + """ + + # Use only site-packages paths. We have no control over contents of `sys.path`, so using all paths from that may + # lead to unintended behavior in corner cases. For example, if `sys.path` contained the drive root (see #7028), + # all paths that do not match some other sub-path rooted in that drive will end up recognized as relative to the + # drive root. In such case, any DLL collected from `c:\Windows\system32` will be collected into `Windows\system32` + # sub-directory; ucrt DLLs collected from MSVC or Windows SDK installed in `c:\Program Files\...` will end up + # collected into `Program Files\...` subdirectory; etc. + # + # On the other hand, the DLL parent directory preservation is primarily aimed at packages installed via PyPI + # wheels, which are typically installed into site-packages. Therefore, limiting the directory preservation for + # shared libraries collected from site-packages should do the trick, and should be reasonably safe. + import site + + orig_paths = site.getsitepackages() + orig_paths.append(site.getusersitepackages()) + + # Explicitly excluded paths. `site.getsitepackages` seems to include `sys.prefix`, which we need to exclude, to + # avoid issue swith DLLs in its sub-directories. We need both resolved and unresolved variant to handle cases + # where `base_prefix` itself is a symbolic link (e.g., `scoop`-installed python on Windows, see #8023). + excluded_paths = { + pathlib.Path(sys.base_prefix), + pathlib.Path(sys.base_prefix).resolve(), + pathlib.Path(sys.prefix), + pathlib.Path(sys.prefix).resolve(), + } + + # For each path in orig_paths, append a resolved variant. This helps with linux venv where we need to consider + # both `venv/lib/python3.11/site-packages` and `venv/lib/python3.11/site-packages` and `lib64` is a symlink + # to `lib`. + orig_paths += [pathlib.Path(path).resolve() for path in orig_paths] + + paths = set() + for path in orig_paths: + if not path: + continue + path = pathlib.Path(path) + # Filter out non-directories (e.g., /path/to/python3x.zip) or non-existent paths + if not path.is_dir(): + continue + # Filter out explicitly excluded paths + if path in excluded_paths: + continue + paths.add(path) + + # Sort by length (in term of path components) to ensure match against the longest common prefix (for example, match + # /path/to/venv/lib/site-packages instead of /path/to/venv when both paths are in site paths). + paths = sorted(paths, key=lambda x: len(x.parents), reverse=True) + + return paths + + +def _select_destination_directory(src_filename, parent_dir_preservation_paths): + # Check parent directory preservation paths + for parent_dir_preservation_path in parent_dir_preservation_paths: + if parent_dir_preservation_path in src_filename.parents: + # Collect into corresponding sub-directory. + return src_filename.relative_to(parent_dir_preservation_path) + + # Collect into top-level directory. + return src_filename.name + + +def binary_dependency_analysis(binaries, search_paths=None, symlink_suppression_patterns=None): + """ + Perform binary dependency analysis on the given TOC list of collected binaries, by recursively scanning each binary + for linked dependencies (shared library imports). Returns new TOC list that contains both original entries and their + binary dependencies. + + Additional search paths for dependencies' full path resolution may be supplied via optional argument. + """ + + # Get all path prefixes for binaries' parent-directory preservation. For binaries collected from packages in (for + # example) site-packages directory, we should try to preserve the parent directory structure. + parent_dir_preservation_paths = _get_paths_for_parent_directory_preservation() + + # Keep track of processed binaries and processed dependencies. + processed_binaries = set() + processed_dependencies = set() + + # Keep track of unresolved dependencies, in order to defer the missing-library warnings until after everything has + # been processed. This allows us to suppress warnings for dependencies that end up being collected anyway; for + # details, see the end of this function. + missing_dependencies = [] + + # Populate output TOC with input binaries - this also serves as TODO list, as we iterate over it while appending + # new entries at the end. + output_toc = binaries[:] + for dest_name, src_name, typecode in output_toc: + # Do not process symbolic links (already present in input TOC list, or added during analysis below). + if typecode == 'SYMLINK': + continue + + # Keep track of processed binaries, to avoid unnecessarily repeating analysis of the same file. Use pathlib.Path + # to avoid having to worry about case normalization. + src_path = pathlib.Path(src_name) + if src_path in processed_binaries: + continue + processed_binaries.add(src_path) + + logger.debug("Analyzing binary %r", src_name) + + # Analyze imports (linked dependencies) + for dep_name, dep_src_path in get_imports(src_name, search_paths): + logger.debug("Processing dependency, name: %r, resolved path: %r", dep_name, dep_src_path) + + # Skip unresolved dependencies. Defer the missing-library warnings until after binary dependency analysis + # is complete. + if not dep_src_path: + missing_dependencies.append((dep_name, src_name)) + continue + + # Compare resolved dependency against global inclusion/exclusion rules. + if not dylib.include_library(dep_src_path): + logger.debug("Skipping dependency %r due to global exclusion rules.", dep_src_path) + continue + + dep_src_path = pathlib.Path(dep_src_path) # Turn into pathlib.Path for subsequent processing + + # Avoid processing this dependency if we have already processed it. + if dep_src_path in processed_dependencies: + logger.debug("Skipping dependency %r due to prior processing.", str(dep_src_path)) + continue + processed_dependencies.add(dep_src_path) + + # Try to preserve parent directory structure, if applicable. + # NOTE: do not resolve the source path, because on macOS and linux, it may be a versioned .so (e.g., + # libsomething.so.1, pointing at libsomething.so.1.2.3), and we need to collect it under original name! + dep_dest_path = _select_destination_directory(dep_src_path, parent_dir_preservation_paths) + dep_dest_path = pathlib.PurePath(dep_dest_path) # Might be a str() if it is just a basename... + + # If we are collecting library into top-level directory on macOS, check whether it comes from a + # .framework bundle. If it does, re-create the .framework bundle in the top-level directory + # instead. + if compat.is_darwin and dep_dest_path.parent == pathlib.PurePath('.'): + if osxutils.is_framework_bundle_lib(dep_src_path): + # dst_src_path is parent_path/Name.framework/Versions/Current/Name + framework_parent_path = dep_src_path.parent.parent.parent.parent + dep_dest_path = pathlib.PurePath(dep_src_path.relative_to(framework_parent_path)) + + logger.debug("Collecting dependency %r as %r.", str(dep_src_path), str(dep_dest_path)) + output_toc.append((str(dep_dest_path), str(dep_src_path), 'BINARY')) + + # On non-Windows, if we are not collecting the binary into application's top-level directory ('.'), + # add a symbolic link from top-level directory to the actual location. This is to accommodate + # LD_LIBRARY_PATH being set to the top-level application directory on linux (although library search + # should be mostly done via rpaths, so this might be redundant) and to accommodate library path + # rewriting on macOS, which assumes that the library was collected into top-level directory. + if compat.is_win: + # We do not use symlinks on Windows. + pass + elif dep_dest_path.parent == pathlib.PurePath('.'): + # The shared library itself is being collected into top-level application directory. + pass + elif any(dep_src_path.match(pattern) for pattern in symlink_suppression_patterns): + # Honor symlink suppression patterns specified by hooks. + logger.debug( + "Skipping symbolic link from %r to top-level application directory due to source path matching one " + "of symlink suppression path patterns.", str(dep_dest_path) + ) + else: + logger.debug("Adding symbolic link from %r to top-level application directory.", str(dep_dest_path)) + output_toc.append((str(dep_dest_path.name), str(dep_dest_path), 'SYMLINK')) + + # Handle missing dependencies: display warnings, add missing symbolic links to top-level application directory, etc. + seen_binaries = { + os.path.normcase(os.path.basename(src_name)): (dest_name, src_name, typecode) + for dest_name, src_name, typecode in output_toc if typecode != 'SYMLINK' + } + existing_symlinks = set([dest_name for dest_name, src_name, typecode in output_toc if typecode == 'SYMLINK']) + + for dependency_name, referring_binary in missing_dependencies: + # Ignore libraries that we would not collect in the first place. + if not dylib.include_library(dependency_name): + continue + + # If the binary with a matching basename happens to be among the discovered binaries, suppress the message as + # well. This might happen either because the library was collected by some other mechanism (for example, via + # hook, or supplied by the user), or because it was discovered during the analysis of another binary (which, + # for example, had properly set run-paths on Linux/macOS or was located next to that other analyzed binary on + # Windows). + # + # On non-Windows, also check if symbolic link to the discovered binary already exists in the top-level + # application directory, and if not, create it. This is important especially on macOS, where our library path + # rewriting assumes that all dependent libraries are available in the top-level application directory, or + # linked into it. + dependency_basename = os.path.normcase(os.path.basename(dependency_name)) + dependency_toc_entry = seen_binaries.get(dependency_basename, None) + if dependency_toc_entry is None: + # Not found, emit a warning (subject to global warning suppression rules). + if not dylib.warn_missing_lib(dependency_name): + continue + logger.warning( + "Library not found: could not resolve %r, dependency of %r.", dependency_name, referring_binary + ) + elif not compat.is_win: + # Found; generate symbolic link if necessary. + dependency_dest_path = pathlib.PurePath(dependency_toc_entry[0]) + dependency_src_path = pathlib.Path(dependency_toc_entry[1]) + + if dependency_dest_path.parent == pathlib.PurePath('.'): + # The binary is collected into top-level application directory. + continue + elif dependency_basename in existing_symlinks: + # The symbolic link already exists. + continue + + # Keep honoring symlink suppression patterns specified by hooks (same as in main binary dependency analysis + # loop). + if any(dependency_src_path.match(pattern) for pattern in symlink_suppression_patterns): + logger.info( + "Missing dependency handling: skipping symbolic link from %r to top-level application directory " + "due to source path matching one of symlink suppression path patterns.", str(dependency_dest_path) + ) + continue + + # Create the symbolic link + logger.info( + "Missing dependency handling: adding symbolic link from %r to top-level application directory.", + str(dependency_dest_path) + ) + output_toc.append((dependency_basename, str(dependency_dest_path), 'SYMLINK')) + existing_symlinks.add(dependency_basename) + + return output_toc + + +#- Low-level import analysis + + +def get_imports(filename, search_paths=None): + """ + Analyze the given binary file (shared library or executable), and obtain the list of shared libraries it imports + (i.e., link-time dependencies). + + Returns set of tuples (name, fullpath). The name component is the referenced name, and on macOS, may not be just + a base name. If the library's full path cannot be resolved, fullpath element is None. + + Additional list of search paths may be specified via `search_paths`, to be used as a fall-back when the + platform-specific resolution mechanism fails to resolve a library fullpath. + """ + if compat.is_win: + if str(filename).lower().endswith(".manifest"): + return [] + return _get_imports_pefile(filename, search_paths) + elif compat.is_darwin: + return _get_imports_macholib(filename, search_paths) + else: + return _get_imports_ldd(filename, search_paths) + + +def _get_imports_pefile(filename, search_paths): + """ + Windows-specific helper for `get_imports`, which uses the `pefile` library to walk through PE header. + """ + import pefile + + output = set() + + # By default, pefile library parses all PE information. We are only interested in the list of dependent dlls. + # Performance is improved by reading only needed information. https://code.google.com/p/pefile/wiki/UsageExamples + pe = pefile.PE(filename, fast_load=True) + pe.parse_data_directories( + directories=[ + pefile.DIRECTORY_ENTRY['IMAGE_DIRECTORY_ENTRY_IMPORT'], + pefile.DIRECTORY_ENTRY['IMAGE_DIRECTORY_ENTRY_EXPORT'], + ], + forwarded_exports_only=True, + import_dllnames_only=True, + ) + + # If a library has no binary dependencies, pe.DIRECTORY_ENTRY_IMPORT does not exist. + for entry in getattr(pe, 'DIRECTORY_ENTRY_IMPORT', []): + dll_str = entry.dll.decode('utf-8') + output.add(dll_str) + + # We must also read the exports table to find forwarded symbols: + # http://blogs.msdn.com/b/oldnewthing/archive/2006/07/19/671238.aspx + exported_symbols = getattr(pe, 'DIRECTORY_ENTRY_EXPORT', None) + if exported_symbols: + for symbol in exported_symbols.symbols: + if symbol.forwarder is not None: + # symbol.forwarder is a bytes object. Convert it to a string. + forwarder = symbol.forwarder.decode('utf-8') + # symbol.forwarder is for example 'KERNEL32.EnterCriticalSection' + dll = forwarder.split('.')[0] + output.add(dll + ".dll") + + pe.close() + + # Attempt to resolve full paths to referenced DLLs. Always add the input binary's parent directory to the search + # paths. + search_paths = [os.path.dirname(filename)] + (search_paths or []) + output = {(lib, resolve_library_path(lib, search_paths)) for lib in output} + + return output + + +def _get_imports_ldd(filename, search_paths): + """ + Helper for `get_imports`, which uses `ldd` to analyze shared libraries. Used on Linux and other POSIX-like platforms + (with exception of macOS). + """ + + output = set() + + # Output of ldd varies between platforms... + if compat.is_aix: + # Match libs of the form + # 'archivelib.a(objectmember.so/.o)' + # or + # 'sharedlib.so' + # Will not match the fake lib '/unix' + LDD_PATTERN = re.compile(r"^\s*(((?P(.*\.a))(?P\(.*\)))|((?P(.*\.so))))$") + elif compat.is_hpux: + # Match libs of the form + # 'sharedlib.so => full-path-to-lib + # e.g. + # 'libpython2.7.so => /usr/local/lib/hpux32/libpython2.7.so' + LDD_PATTERN = re.compile(r"^\s+(.*)\s+=>\s+(.*)$") + elif compat.is_solar: + # Match libs of the form + # 'sharedlib.so => full-path-to-lib + # e.g. + # 'libpython2.7.so.1.0 => /usr/local/lib/libpython2.7.so.1.0' + # Will not match the platform specific libs starting with '/platform' + LDD_PATTERN = re.compile(r"^\s+(.*)\s+=>\s+(.*)$") + elif compat.is_linux: + # Match libs of the form + # libpython3.13.so.1.0 => /home/brenainn/.pyenv/versions/3.13.0/lib/libpython3.13.so.1.0 (0x00007a9e15800000) + # or + # /tmp/python/install/bin/../lib/libpython3.13.so.1.0 (0x00007b9489c82000) + LDD_PATTERN = re.compile(r"^\s*(?:(.*?)\s+=>\s+)?(.*?)\s+\(.*\)") + else: + LDD_PATTERN = re.compile(r"\s*(.*?)\s+=>\s+(.*?)\s+\(.*\)") + + # Resolve symlinks since GNU ldd contains a bug in processing a symlink to a binary + # using $ORIGIN: https://sourceware.org/bugzilla/show_bug.cgi?id=25263 + p = subprocess.run( + ['ldd', os.path.realpath(filename)], + stdin=subprocess.DEVNULL, + stderr=subprocess.PIPE, + stdout=subprocess.PIPE, + encoding='utf-8', + ) + + ldd_warnings = [] + for line in p.stderr.splitlines(): + if not line: + continue + # Python extensions (including stdlib ones) are not linked against python.so but rely on Python's symbols having + # already been loaded into symbol space at runtime. musl's ldd issues a series of harmless warnings to stderr + # telling us that those symbols are unfindable. These should be suppressed. + elif line.startswith("Error relocating ") and line.endswith(" symbol not found"): + continue + # Shared libraries should have the executable bits set; however, this is not the case for shared libraries + # shipped in PyPI wheels, which cause ldd to emit `ldd: warning: you do not have execution permission for ...` + # warnings. Suppress these. + elif line.startswith("ldd: warning: you do not have execution permission for "): + continue + # When `ldd` is ran against a file that is not a dynamic binary (i.e., is not a binary at all, or is a static + # binary), it emits a "not a dynamic executable" warning. Suppress it. + elif "not a dynamic executable" in line: + continue + # Propagate any other warnings it might have. + ldd_warnings.append(line) + if ldd_warnings: + logger.warning("ldd warnings for %r:\n%s", filename, "\n".join(ldd_warnings)) + + for line in p.stdout.splitlines(): + name = None # Referenced name + lib = None # Resolved library path + + m = LDD_PATTERN.search(line) + if m: + if compat.is_aix: + libarchive = m.group('libarchive') + if libarchive: + # We matched an archive lib with a request for a particular embedded shared object. + # 'archivelib.a(objectmember.so/.o)' + lib = libarchive + name = os.path.basename(lib) + m.group('objectmember') + else: + # We matched a stand-alone shared library. + # 'sharedlib.so' + lib = m.group('libshared') + name = os.path.basename(lib) + elif compat.is_hpux: + name, lib = m.group(1), m.group(2) + else: + name, lib = m.group(1), m.group(2) + name = name or os.path.basename(lib) + if compat.is_linux: + # Skip all ld variants listed https://sourceware.org/glibc/wiki/ABIList + # plus musl's ld-musl-*.so.*. + if re.fullmatch(r"ld(64)?(-linux|-musl)?(-.+)?\.so(\..+)?", os.path.basename(lib)): + continue + if name[:10] in ('linux-gate', 'linux-vdso'): + # linux-gate is a fake library which does not exist and should be ignored. See also: + # http://www.trilithium.com/johan/2005/08/linux-gate/ + continue + + if compat.is_cygwin: + # exclude Windows system library + if lib.lower().startswith('/cygdrive/c/windows/system'): + continue + + # Reset library path if it does not exist + if not os.path.exists(lib): + lib = None + elif line.endswith("not found"): + # On glibc-based linux distributions, missing libraries are marked with name.so => not found + tokens = line.split('=>') + if len(tokens) != 2: + continue + name = tokens[0].strip() + lib = None + else: + # TODO: should we warn about unprocessed lines? + continue + + # Fall back to searching the supplied search paths, if any. + if not lib: + lib = _resolve_library_path_in_search_paths( + os.path.basename(name), # Search for basename of the referenced name. + search_paths, + ) + + # Normalize the resolved path, to remove any extraneous "../" elements. + if lib: + lib = os.path.normpath(lib) + + # Return referenced name as-is instead of computing a basename, to provide additional context when library + # cannot be resolved. + output.add((name, lib)) + + return output + + +def _get_imports_macholib(filename, search_paths): + """ + macOS-specific helper for `get_imports`, which uses `macholib` to analyze library load commands in Mach-O headers. + """ + from macholib.dyld import dyld_find + from macholib.mach_o import LC_RPATH + from macholib.MachO import MachO + + try: + from macholib.dyld import _dyld_shared_cache_contains_path + except ImportError: + _dyld_shared_cache_contains_path = None + + output = set() + + # Parent directory of the input binary and parent directory of python executable, used to substitute @loader_path + # and @executable_path. The macOS dylib loader (dyld) fully resolves the symbolic links when using @loader_path + # and @executable_path references, so we need to do the same using `os.path.realpath`. + bin_path = os.path.dirname(os.path.realpath(filename)) + python_bin = os.path.realpath(sys.executable) + python_bin_path = os.path.dirname(python_bin) + + def _get_referenced_libs(m): + # Collect referenced libraries from MachO object. + referenced_libs = set() + for header in m.headers: + for idx, name, lib in header.walkRelocatables(): + referenced_libs.add(lib) + return referenced_libs + + def _get_run_paths(m): + # Find LC_RPATH commands to collect rpaths from MachO object. + # macholib does not handle @rpath, so we need to handle run paths ourselves. + run_paths = [] + for header in m.headers: + for command in header.commands: + # A command is a tuple like: + # (, + # , + # '../lib\x00\x00') + cmd_type = command[0].cmd + if cmd_type == LC_RPATH: + rpath = command[2].decode('utf-8') + # Remove trailing '\x00' characters. E.g., '../lib\x00\x00' + rpath = rpath.rstrip('\x00') + # If run path starts with @, ensure it starts with either @loader_path or @executable_path. + # We cannot process anything else. + if rpath.startswith("@") and not rpath.startswith(("@executable_path", "@loader_path")): + logger.warning("Unsupported rpath format %r found in binary %r - ignoring...", rpath, filename) + continue + run_paths.append(rpath) + return run_paths + + @functools.lru_cache + def get_run_paths_and_referenced_libs(filename): + # Walk through Mach-O headers, and collect all referenced libraries and run paths. + m = MachO(filename) + return _get_referenced_libs(m), _get_run_paths(m) + + @functools.lru_cache + def get_run_paths(filename): + # Walk through Mach-O headers, and collect only run paths. + return _get_run_paths(MachO(filename)) + + # Collect referenced libraries and run paths from the input binary. + referenced_libs, run_paths = get_run_paths_and_referenced_libs(filename) + + # On macOS, run paths (rpaths) are inherited from the executable that loads the given shared library (or from the + # shared library that loads the given shared library). This means that shared libraries and python binary extensions + # can reference other shared libraries using @rpath without having set any run paths themselves. + # + # In order to simulate the run path inheritance that happens in unfrozen python programs, we need to augment the + # run paths from the given binary with those set by the python interpreter executable (`sys.executable`). Anaconda + # python, for example, sets the run path on the python executable to `@loader_path/../lib`, which allows python + # extensions to reference shared libraries in the Anaconda environment's `lib` directory via only `@rpath` + # (for example, the `_ssl` extension can reference the OpenSSL library as `@rpath/libssl.3.dylib`). In another + # example, python executable has its run path set to the top-level directory of its .framework bundle; in this + # case the `ssl` extension references the OpenSSL library as `@rpath/Versions/3.10/lib/libssl.1.1.dylib`. + run_paths += get_run_paths(python_bin) + + # This fallback should be fully superseded by the above recovery of run paths from python executable; but for now, + # keep it around in case of unforeseen corner cases. + run_paths.append(os.path.join(compat.base_prefix, 'lib')) + + # De-duplicate run_paths while preserving their order. + run_paths = list(dict.fromkeys(run_paths)) + + def _resolve_using_path(lib): + # Absolute paths should not be resolved; we should just check whether the library exists or not. This used to + # be done using macholib's dyld_find() as well (as it properly handles system libraries that are hidden on + # Big Sur and later), but it turns out that even if given an absolute path, it gives precedence to search paths + # from DYLD_LIBRARY_PATH. This leads to confusing errors when directory in DYLD_LIBRARY_PATH contains a file + # (shared library or data file) that happens to have the same name as a library from a system framework. + if os.path.isabs(lib): + if _dyld_shared_cache_contains_path is not None and _dyld_shared_cache_contains_path(lib): + return lib + if os.path.isfile(lib): + return lib + return None + + try: + return dyld_find(lib) + except ValueError: + return None + + def _resolve_using_loader_path(lib, bin_path, python_bin_path): + # Strictly speaking, @loader_path should be anchored to parent directory of analyzed binary (`bin_path`), while + # @executable_path should be anchored to the parent directory of the process' executable. Typically, this would + # be python executable (`python_bin_path`). Unless we are analyzing a collected 3rd party executable; in that + # case, `bin_path` is correct option. So we first try resolving using `bin_path`, and then fall back to + # `python_bin_path`. This does not account for transitive run paths of higher-order dependencies, but there is + # only so much we can do here... + # + # NOTE: do not use macholib's `dyld_find`, because its fallback search locations might end up resolving wrong + # instance of the library! For example, if our `bin_path` and `python_bin_path` are anchored in an Anaconda + # python environment and the candidate library path does not exit (because we are calling this function when + # trying to resolve @rpath with multiple candidate run paths), we do not want to fall back to eponymous library + # that happens to be present in the Homebrew python environment... + if lib.startswith('@loader_path/'): + lib = lib[len('@loader_path/'):] + elif lib.startswith('@executable_path/'): + lib = lib[len('@executable_path/'):] + + # Try resolving with binary's path first... + resolved_lib = _resolve_using_path(os.path.join(bin_path, lib)) + if resolved_lib is not None: + return resolved_lib + + # ... and fall-back to resolving with python executable's path + return _resolve_using_path(os.path.join(python_bin_path, lib)) + + # Try to resolve full path of the referenced libraries. + for referenced_lib in referenced_libs: + resolved_lib = None + + # If path starts with @rpath, we have to handle it ourselves. + if referenced_lib.startswith('@rpath'): + lib = os.path.join(*referenced_lib.split(os.sep)[1:]) # Remove the @rpath/ prefix + + # Try all run paths. + for run_path in run_paths: + # Join the path. + lib_path = os.path.join(run_path, lib) + + if lib_path.startswith(("@executable_path", "@loader_path")): + # Run path starts with @executable_path or @loader_path. + lib_path = _resolve_using_loader_path(lib_path, bin_path, python_bin_path) + else: + # If run path was relative, anchor it to binary's location. + if not os.path.isabs(lib_path): + os.path.join(bin_path, lib_path) + lib_path = _resolve_using_path(lib_path) + + if lib_path and os.path.exists(lib_path): + resolved_lib = lib_path + break + else: + if referenced_lib.startswith(("@executable_path", "@loader_path")): + resolved_lib = _resolve_using_loader_path(referenced_lib, bin_path, python_bin_path) + else: + resolved_lib = _resolve_using_path(referenced_lib) + + # Fall back to searching the supplied search paths, if any. + if not resolved_lib: + resolved_lib = _resolve_library_path_in_search_paths( + os.path.basename(referenced_lib), # Search for basename of the referenced name. + search_paths, + ) + + # Normalize the resolved path, to remove any extraneous "../" elements. + if resolved_lib: + resolved_lib = os.path.normpath(resolved_lib) + + # Return referenced library name as-is instead of computing a basename. Full referenced name carries additional + # information that might be useful for the caller to determine how to deal with unresolved library (e.g., ignore + # unresolved libraries that are supposed to be located in system-wide directories). + output.add((referenced_lib, resolved_lib)) + + return output + + +#- Library full path resolution + + +def resolve_library_path(name, search_paths=None): + """ + Given a library name, attempt to resolve full path to that library. The search for library is done via + platform-specific mechanism and fall back to optionally-provided list of search paths. Returns None if library + cannot be resolved. If give library name is already an absolute path, the given path is returned without any + processing. + """ + # No-op if path is already absolute. + if os.path.isabs(name): + return name + + if compat.is_unix: + # Use platform-specific helper. + fullpath = _resolve_library_path_unix(name) + if fullpath: + return fullpath + # Fall back to searching the supplied search paths, if any + return _resolve_library_path_in_search_paths(name, search_paths) + elif compat.is_win: + # Try the caller-supplied search paths, if any. + fullpath = _resolve_library_path_in_search_paths(name, search_paths) + if fullpath: + return fullpath + + # Fall back to default Windows search paths, using the PATH environment variable (which should also include + # the system paths, such as c:\windows and c:\windows\system32) + win_search_paths = [path for path in compat.getenv('PATH', '').split(os.pathsep) if path] + return _resolve_library_path_in_search_paths(name, win_search_paths) + else: + return ctypes.util.find_library(name) + + return None + + +# Compatibility aliases for hooks from contributed hooks repository. All of these now point to the high-level +# `resolve_library_path`. +findLibrary = resolve_library_path +findSystemLibrary = resolve_library_path + + +def _resolve_library_path_in_search_paths(name, search_paths=None): + """ + Low-level helper for resolving given library name to full path in given list of search paths. + """ + for search_path in search_paths or []: + fullpath = os.path.join(search_path, name) + if not os.path.isfile(fullpath): + continue + + # On Windows, ensure that architecture matches that of running python interpreter. + if compat.is_win: + try: + dll_machine_type = winutils.get_pe_file_machine_type(fullpath) + except Exception: + # A search path might contain a DLL that we cannot analyze; for example, a stub file. Skip over. + continue + if dll_machine_type != _exe_machine_type: + continue + + return os.path.normpath(fullpath) + + return None + + +def _resolve_library_path_unix(name): + """ + UNIX-specific helper for resolving library path. + + Emulates the algorithm used by dlopen. `name` must include the prefix, e.g., ``libpython2.4.so``. + """ + assert compat.is_unix, "Current implementation for Unix only (Linux, Solaris, AIX, FreeBSD)" + + if name.endswith('.so') or '.so.' in name: + # We have been given full library name that includes suffix. Use `_resolve_library_path_in_search_paths` to find + # the exact match. + lib_search_func = _resolve_library_path_in_search_paths + else: + # We have been given a library name without suffix. Use `_which_library` as search function, which will try to + # find library with matching basename. + lib_search_func = _which_library + + # Look in the LD_LIBRARY_PATH according to platform. + if compat.is_aix: + lp = compat.getenv('LIBPATH', '') + elif compat.is_darwin: + lp = compat.getenv('DYLD_LIBRARY_PATH', '') + else: + lp = compat.getenv('LD_LIBRARY_PATH', '') + lib = lib_search_func(name, filter(None, lp.split(os.pathsep))) + + # Look in /etc/ld.so.cache + # Solaris does not have /sbin/ldconfig. Just check if this file exists. + if lib is None: + utils.load_ldconfig_cache() + lib = utils.LDCONFIG_CACHE.get(name) + if lib: + assert os.path.isfile(lib) + + # Look in the known safe paths. + if lib is None: + # Architecture independent locations. + paths = ['/lib', '/usr/lib'] + # Architecture dependent locations. + if compat.architecture == '32bit': + paths.extend(['/lib32', '/usr/lib32']) + else: + paths.extend(['/lib64', '/usr/lib64']) + # Machine dependent locations. + if compat.machine == 'intel': + if compat.architecture == '32bit': + paths.extend(['/usr/lib/i386-linux-gnu']) + else: + paths.extend(['/usr/lib/x86_64-linux-gnu']) + + # On Debian/Ubuntu /usr/bin/python is linked statically with libpython. Newer Debian/Ubuntu with multiarch + # support puts the libpythonX.Y.so in paths like /usr/lib/i386-linux-gnu/. Try to query the arch-specific + # sub-directory, if available. + arch_subdir = sysconfig.get_config_var('multiarchsubdir') + if arch_subdir: + arch_subdir = os.path.basename(arch_subdir) + paths.append(os.path.join('/usr/lib', arch_subdir)) + else: + logger.debug('Multiarch directory not detected.') + + # Termux (a Ubuntu like subsystem for Android) has an additional libraries directory. + if os.path.isdir('/data/data/com.termux/files/usr/lib'): + paths.append('/data/data/com.termux/files/usr/lib') + + if compat.is_aix: + paths.append('/opt/freeware/lib') + elif compat.is_hpux: + if compat.architecture == '32bit': + paths.append('/usr/local/lib/hpux32') + else: + paths.append('/usr/local/lib/hpux64') + elif compat.is_freebsd or compat.is_openbsd: + paths.append('/usr/local/lib') + lib = lib_search_func(name, paths) + + return lib + + +def _which_library(name, dirs): + """ + Search for a shared library in a list of directories. + + Args: + name: + The library name including the `lib` prefix but excluding any `.so` suffix. + dirs: + An iterable of folders to search in. + Returns: + The path to the library if found or None otherwise. + + """ + matcher = _library_matcher(name) + for path in filter(os.path.exists, dirs): + for _path in os.listdir(path): + if matcher(_path): + return os.path.join(path, _path) + + +def _library_matcher(name): + """ + Create a callable that matches libraries if **name** is a valid library prefix for input library full names. + """ + return re.compile(name + r"[0-9]*\.").match + + +#- Python shared library search + + +def get_python_library_path(): + """ + Find Python shared library that belongs to the current interpreter. + + Return full path to Python dynamic library or None when not found. + + PyInstaller needs to collect the Python shared library, so that bootloader can load it, import Python C API + symbols, and use them to set up the embedded Python interpreter. + + The name of the shared library is typically fixed (`python3.X.dll` on Windows, libpython3.X.so on Unix systems, + and `libpython3.X.dylib` on macOS for shared library builds and `Python.framework/Python` for framework build). + Its location can usually be inferred from the Python interpreter executable, when the latter is dynamically + linked against the shared library. + + However, some situations require extra handling due to various quirks; for example, Debian-based linux + distributions statically link the Python interpreter executable against the Python library, while also providing + a shared library variant for external users. + """ + + # With Windows Python builds, this is pretty straight-forward: `sys.dllhandle` provides a handle to the loaded + # Python DLL, and we can resolve its path using `GetModuleFileName()` from win32 API. + # This is applicable to python.org Windows builds, Anaconda on Windows, and MSYS2 Python. + if compat.is_win: + if hasattr(sys, 'dllhandle'): + import _winapi + return _winapi.GetModuleFileName(sys.dllhandle) + else: + raise PythonLibraryNotFoundError( + "Python was built without a shared library, which is required by PyInstaller." + ) + + # On other (POSIX) platforms, the name of the Python shared library is available in the `INSTSONAME` variable + # exposed by the `sysconfig` module. There is also the `LDLIBRARY` variable, which points to the unversioned .so + # symbolic link for linking purposes; however, we are interested in the actual, fully-versioned soname. + # This should cover all variations in the naming schemes across different platforms as well as different build + # options (debug build, free-threaded build, etc.). + # + # However, `INSTSONAME` points to the shared library only if shared library is enabled; in static-library builds, + # it points to the static library, which is of no use to us. We can check if Python was built with shared library + # (i.e., the `--enable-shared` option) by checking `Py_ENABLE_SHARED` variable, which should be set to 1 in this + # case (and 0 in the case of a static-library build). On macOS, builds made with `--enable-framework` have + # `Py_ENABLE_SHARED` set to 0, but have `PYTHONFRAMEWORK`set to a non-empty string. + # + # The above description is further complicated by the fact that in some Python builds, the `python` executable is + # built against static Python library, and the shared library is built separately and provided for development and + # for embedders (such as PyInstaller). Presumably, this is done for performance reasons. Also, it is enabled by the + # fact that on POSIX, Python extensions do not need to have the referenced Python symbols resolved at link-time; + # rather, these symbols can be resolved at run-time from the running Python process (and are effectively provided + # by the `python` executable). Such builds come in two variants. In the first variant, `Py_ENABLE_SHARED` is 0 and + # `INSTSONAME` points to the static library; an example of such build is Anaconda Python. In the second variant, + # `Py_ENABLE_SHARED` is 1 and `INSTSONAME` points to the shared library, but `python` executable is not linked + # against it; examples of such build are Debian-packaged Python and `astral-sh/python-build-standalone` Python. + # + # Therefore, our strategy is as follows: if we determine that shared library was enabled (via `Py_ENABLE_SHARED` + # on all platforms and/or via `PYTHONFRAMEWORK` on macOS), we use the name given by `INSTSONAME`. First, we try + # to locate it by analyzing binary dependencies of `python` executable (regular shared-library-enabled build), + # then fall back to standard search locations (second variant of static-executable-with-separate-shared-library). + # If `Py_ENABLE_SHARED` is set to 0, we try to guess the library name based on version and feature flags, but we + # search only `sys.base_prefix` and `lib` directory under `sys.base_prefix`; if the shared library is not found + # there, we assume it is unavailable and raise an error. This attempts to accommodate Anaconda python (and corner + # cases when we cannot reliably identify Anaconda python - see #9273) and prevent accidental bundling of + # system-wide Python shared library in cases when user tries to use custom Python build without shared library. + + def _find_lib_in_libdirs(name, *libdirs): + for libdir in libdirs: + full_path = os.path.join(libdir, name) + if not os.path.exists(full_path): + continue + # Resolve potential symbolic links to achieve consistent results with linker-based search; e.g., on + # POSIX systems, linker resolves unversioned library names (python3.X.so) to versioned ones + # (libpython3.X.so.1.0) due to former being symbolic links to the latter. See #6831. + full_path = os.path.realpath(full_path) + if not os.path.exists(full_path): + continue + return full_path + return None + + is_shared = ( + # Builds made with `--enable-shared` have `Py_ENABLE_SHARED` set to 1. This is true even for Debian-packaged + # Python, which has the `python` executable statically linked against the Python library. + sysconfig.get_config_var("Py_ENABLE_SHARED") or + # On macOS, builds made with `--enable-framework` have `Py_ENABLE_SHARED` set to 0, but have `PYTHONFRAMEWORK` + # set to a non-empty string. + (compat.is_darwin and sysconfig.get_config_var("PYTHONFRAMEWORK")) + ) + + if not is_shared: + # Anaconda Python; this codepath used to be under `compat.is_conda` switch, but we may also be dealing with + # Anaconda Python without `conda-meta` directory (see #9273). Or some other Python build where shared library + # is provided but `Py_ENABLE_SHARED` is set to 0. + py_major, py_minor = sys.version_info[:2] + py_suffix = "t" if compat.is_nogil else "" # TODO: does Anaconda provide debug builds with "d" suffix? + if compat.is_darwin: + # macOS + expected_name = f"libpython{py_major}.{py_minor}{py_suffix}.dylib" + else: + # Linux; assume any other potential POSIX builds use the same naming scheme. + expected_name = f"libpython{py_major}.{py_minor}{py_suffix}.so.1.0" + + # Allow the library to be only in `sys.base_prefix` or the `lib` directory under it. This should prevent us from + # picking up an unrelated copy of shared library that might happen to be available in standard search path, when + # we should instead be raising an error due to Python having been built without a shared library. (In true + # static-library builds, Python's own extension modules are usually turned into built-ins. So picking up an + # unrelated Python shared library that happens to be of the same version results in run-time errors due to + # missing extensions - because in the build that produced the shared library, those extensions are expected to + # be external extension modules!) + python_libname = _find_lib_in_libdirs( + expected_name, # Full name + compat.base_prefix, + os.path.join(compat.base_prefix, 'lib'), + ) + if python_libname: + return python_libname + + # Raise PythonLibraryNotFoundError + option_str = ( + "either the `--enable-shared` or the `--enable-framework` option" + if compat.is_darwin else "the `--enable-shared` option" + ) + raise PythonLibraryNotFoundError( + "Python was built without a shared library, which is required by PyInstaller. " + f"If you built Python from source, rebuild it with {option_str}." + ) + + # Use the library name from `INSTSONAME`. + expected_name = sysconfig.get_config_var('INSTSONAME') + + # In Cygwin builds (and also MSYS2 python, although that should be handled by Windows-specific codepath...), + # INSTSONAME is available, but the name has a ".dll.a" suffix; remove that trailing ".a". + if (compat.is_win or compat.is_cygwin) and os.path.normcase(expected_name).endswith('.dll.a'): + expected_name = expected_name[:-2] + + # NOTE: on macOS with .framework bundle build, INSTSONAME contains full name of the .framework library, for example + # `Python.framework/Versions/3.13/Python`. Pre-compute a basename for comparisons that are using only basename. + expected_basename = os.path.normcase(os.path.basename(expected_name)) + + # First, try to find the expected name among the libraries against which the Python executable is linked. This + # assumes that the Python executable was not statically linked against the library (as is the case with + # Debian-packaged Python or `astral-sh/python-build-standalone` Python). + imported_libraries = get_imports(compat.python_executable) # (name, fullpath) tuples + for _, lib_path in imported_libraries: + if lib_path is None: + continue # Skip unresolved imports + if os.path.normcase(os.path.basename(lib_path)) == expected_basename: # Basename comparison + # Python library found. Return absolute path to it. + return lib_path + + # As a fallback, try to find the library in several "standard" search locations... + + # First, search the `sys.base_prefix` and `lib` directory in `sys.base_prefix`, as these locations have the closest + # ties to our current Python process. This caters to builds such as `astral-sh/python-build-standalone` Python. + python_libname = _find_lib_in_libdirs( + expected_name, # Full name + compat.base_prefix, + os.path.join(compat.base_prefix, 'lib'), + ) + if python_libname: + return python_libname + + # Perform search in the configured library search locations. This should be done after exhausting all other options; + # it primarily caters to Debian-packaged Python, but we need to make sure that we do not collect shared library from + # system-installed Python when the current interpreter is in fact some other Python build (such as, for example, + # `astral-sh/python-build-standalone` Python that is handled in the preceding code block). + python_libname = resolve_library_path(expected_basename) # Basename + if python_libname: + return python_libname + + # Not found. Raise a PythonLibraryNotFoundError with corresponding message. + message = f"ERROR: Python shared library ({expected_name!r}) was not found!" + if compat.is_linux and os.path.isfile('/etc/debian_version'): + # The shared library is provided by `libpython3.x` package (i.e., no need to install full `python3-dev`). + pkg_name = f"libpython3.{sys.version_info.minor}" + message += ( + " If you are using system python on Debian/Ubuntu, you might need to install a separate package by running " + f"`apt install {pkg_name}`." + ) + + raise PythonLibraryNotFoundError(message) + + +#- Binary vs data (re)classification + + +def classify_binary_vs_data(filename): + """ + Classify the given file as either BINARY or a DATA, using appropriate platform-specific method. Returns 'BINARY' + or 'DATA' string depending on the determined file type, or None if classification cannot be performed (non-existing + file, missing tool, and other errors during classification). + """ + + # We cannot classify non-existent files. + if not os.path.isfile(filename): + return None + + # Use platform-specific implementation. + return _classify_binary_vs_data(filename) + + +if compat.is_linux: + + def _classify_binary_vs_data(filename): + # First check for ELF signature, in order to avoid calling `objdump` on every data file, which can be costly. + try: + with open(filename, 'rb') as fp: + sig = fp.read(4) + except Exception: + return None + + if sig != b"\x7FELF": + return "DATA" + + # Verify the binary by checking if `objdump` recognizes the file. The preceding ELF signature check should + # ensure that this is an ELF file, while this check should ensure that it is a valid ELF file. In the future, + # we could try checking that the architecture matches the running platform. + cmd_args = ['objdump', '-a', filename] + try: + p = subprocess.run( + cmd_args, + stdout=subprocess.PIPE, + stderr=subprocess.PIPE, + stdin=subprocess.DEVNULL, + encoding='utf8', + ) + except Exception: + return None # Failed to run `objdump` or `objdump` unavailable. + + return 'BINARY' if p.returncode == 0 else 'DATA' + +elif compat.is_win: + + @functools.lru_cache() + def _no_op_pefile_gc(): + # Disable pefile's reduntant and very slow call to gc.collect(). See #8762. + import types + import gc + import pefile + + fake_gc = types.ModuleType("gc") + fake_gc.__dict__.update(gc.__dict__) + fake_gc.collect = lambda *_, **__: None + pefile.gc = fake_gc + + def _classify_binary_vs_data(filename): + import pefile + + _no_op_pefile_gc() + + # First check for MZ signature, which should allow us to quickly classify the majority of data files. + try: + with open(filename, 'rb') as fp: + sig = fp.read(2) + except Exception: + return None + + if sig != b"MZ": + return "DATA" + + # Check if the file can be opened using `pefile`. + try: + with pefile.PE(filename, fast_load=True) as pe: # noqa: F841 + pass + return 'BINARY' + except pefile.PEFormatError: + return 'DATA' + except Exception: + pass + + return None + +elif compat.is_darwin: + + def _classify_binary_vs_data(filename): + # See if the file can be opened using `macholib`. + import macholib.MachO + + try: + macho = macholib.MachO.MachO(filename) # noqa: F841 + return 'BINARY' + except Exception: + # TODO: catch only `ValueError`? + pass + + return 'DATA' + +else: + + def _classify_binary_vs_data(filename): + # Classification not implemented for the platform. + return None diff --git a/venv/lib/python3.12/site-packages/PyInstaller/depend/bytecode.py b/venv/lib/python3.12/site-packages/PyInstaller/depend/bytecode.py new file mode 100755 index 0000000..d51ea34 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/depend/bytecode.py @@ -0,0 +1,366 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Tools for searching bytecode for key statements that indicate the need for additional resources, such as data files +and package metadata. + +By *bytecode* I mean the ``code`` object given by ``compile()``, accessible from the ``__code__`` attribute of any +non-builtin function or, in PyInstallerLand, the ``PyiModuleGraph.node("some.module").code`` attribute. The best +guide for bytecode format I have found is the disassembler reference: https://docs.python.org/3/library/dis.html + +This parser implementation aims to combine the flexibility and speed of regex with the clarity of the output of +``dis.dis(code)``. It has not achieved the 2nd, but C'est la vie... + +The biggest clarity killer here is the ``EXTENDED_ARG`` opcode which can appear almost anywhere and therefore needs +to be tiptoed around at every step. If this code needs to expand significantly, I would recommend an upgrade to a +regex-based grammar parsing library such as Reparse. This way, little steps like unpacking ``EXTENDED_ARGS`` can be +defined once then simply referenced forming a nice hierarchy rather than copied everywhere its needed. +""" + +import dis +import re +from types import CodeType +from typing import Pattern + +from PyInstaller import compat + +# opcode name -> opcode map +# Python 3.11 introduced specialized opcodes that are not covered by opcode.opmap (and equivalent dis.opmap), but dis +# has a private map of all opcodes called _all_opmap. So use the latter, if available. +opmap = getattr(dis, '_all_opmap', dis.opmap) + + +def _instruction_to_regex(x: str): + """ + Get a regex-escaped opcode byte from its human readable name. + """ + return re.escape(bytes([opmap[x]])) + + +def bytecode_regex(pattern: bytes, flags=re.VERBOSE | re.DOTALL): + """ + A regex-powered Python bytecode matcher. + + ``bytecode_regex`` provides a very thin wrapper around :func:`re.compile`. + + * Any opcode names wrapped in backticks are substituted for their corresponding opcode bytes. + * Patterns are compiled in VERBOSE mode by default so that whitespace and comments may be used. + + This aims to mirror the output of :func:`dis.dis`, which is far more readable than looking at raw byte strings. + """ + assert isinstance(pattern, bytes) + + # Replace anything wrapped in backticks with regex-escaped opcodes. + pattern = re.sub( + rb"`(\w+)`", + lambda m: _instruction_to_regex(m[1].decode()), + pattern, + ) + return re.compile(pattern, flags=flags) + + +def finditer(pattern: Pattern, string: bytes): + """ + Call ``pattern.finditer(string)``, but remove any matches beginning on an odd byte (i.e., matches where + match.start() is not a multiple of 2). + + This should be used to avoid false positive matches where a bytecode pair's argument is mistaken for an opcode. + """ + assert isinstance(string, bytes) + string = _cleanup_bytecode_string(string) + matches = pattern.finditer(string) + while True: + for match in matches: + if match.start() % 2 == 0: + # All is good. This match starts on an OPCODE. + yield match + else: + # This match has started on an odd byte, meaning that it is a false positive and should be skipped. + # There is a very slim chance that a genuine match overlaps this one and, because re.finditer() does not + # allow overlapping matches, it would be lost. To avoid that, restart the regex scan, starting at the + # next even byte. + matches = pattern.finditer(string, match.start() + 1) + break + else: + break + + +# Opcodes involved in function calls with constant arguments. The differences between python versions are handled by +# variables below, which are then used to construct the _call_function_bytecode regex. +# NOTE1: the _OPCODES_* entries are typically used in (non-capturing) groups that match the opcode plus an arbitrary +# argument. But because the entries themselves may contain more than on opcode (with OR operator between them), they +# themselves need to be enclosed in another (non-capturing) group. E.g., "(?:(?:_OPCODES_FUNCTION_GLOBAL).)". +# NOTE2: _OPCODES_EXTENDED_ARG2 is an exception, as it is used as a list of opcodes to exclude, i.e., +# "[^_OPCODES_EXTENDED_ARG2]". Therefore, multiple opcodes are not separated by the OR operator. +if not compat.is_py311: + # Python 3.7 introduced two new function-related opcodes, LOAD_METHOD and CALL_METHOD + _OPCODES_EXTENDED_ARG = rb"`EXTENDED_ARG`" + _OPCODES_EXTENDED_ARG2 = _OPCODES_EXTENDED_ARG + _OPCODES_FUNCTION_GLOBAL = rb"`LOAD_NAME`|`LOAD_GLOBAL`|`LOAD_FAST`" + _OPCODES_FUNCTION_LOAD = rb"`LOAD_ATTR`|`LOAD_METHOD`" + _OPCODES_FUNCTION_ARGS = rb"`LOAD_CONST`" + _OPCODES_FUNCTION_CALL = rb"`CALL_FUNCTION`|`CALL_METHOD`|`CALL_FUNCTION_EX`" + + def _cleanup_bytecode_string(bytecode): + return bytecode # Nothing to do here +elif not compat.is_py312: + # Python 3.11 removed CALL_FUNCTION and CALL_METHOD, and replaced them with PRECALL + CALL instruction sequence. + # As both PRECALL and CALL have the same parameter (the argument count), we need to match only up to the PRECALL. + # The CALL_FUNCTION_EX is still present. + # From Python 3.11b1 on, there is an EXTENDED_ARG_QUICK specialization opcode present. + _OPCODES_EXTENDED_ARG = rb"`EXTENDED_ARG`|`EXTENDED_ARG_QUICK`" + _OPCODES_EXTENDED_ARG2 = rb"`EXTENDED_ARG``EXTENDED_ARG_QUICK`" # Special case; see note above the if/else block! + _OPCODES_FUNCTION_GLOBAL = rb"`LOAD_NAME`|`LOAD_GLOBAL`|`LOAD_FAST`" + _OPCODES_FUNCTION_LOAD = rb"`LOAD_ATTR`|`LOAD_METHOD`" + _OPCODES_FUNCTION_ARGS = rb"`LOAD_CONST`" + _OPCODES_FUNCTION_CALL = rb"`PRECALL`|`CALL_FUNCTION_EX`" + + # Starting with python 3.11, the bytecode is peppered with CACHE instructions (which dis module conveniently hides + # unless show_caches=True is used). Dealing with these CACHE instructions in regex rules is going to render them + # unreadable, so instead we pre-process the bytecode and filter the offending opcodes out. + _cache_instruction_filter = bytecode_regex(rb"(`CACHE`.)|(..)") + + def _cleanup_bytecode_string(bytecode): + return _cache_instruction_filter.sub(rb"\2", bytecode) +else: + # Python 3.12 merged EXTENDED_ARG_QUICK back in to EXTENDED_ARG, and LOAD_METHOD in to LOAD_ATTR + # PRECALL is no longer a valid key + _OPCODES_EXTENDED_ARG = rb"`EXTENDED_ARG`" + _OPCODES_EXTENDED_ARG2 = _OPCODES_EXTENDED_ARG + if compat.is_py314: + # Python 3.14.0a7 added LOAD_FAST_BORROW. + _OPCODES_FUNCTION_GLOBAL = rb"`LOAD_NAME`|`LOAD_GLOBAL`|`LOAD_FAST`|`LOAD_FAST_BORROW`" + else: + _OPCODES_FUNCTION_GLOBAL = rb"`LOAD_NAME`|`LOAD_GLOBAL`|`LOAD_FAST`" + _OPCODES_FUNCTION_LOAD = rb"`LOAD_ATTR`" + if compat.is_py314: + # Python 3.14.0a2 split LOAD_CONST into LOAD_CONST, LOAD_IMMORTAL_CONST, and LOAD_SMALL_INT. + # https://github.com/python/cpython/commit/faa3272fb8d63d481a136cc0467a0cba6ed7b264 + _OPCODES_FUNCTION_ARGS = rb"`LOAD_CONST`|`LOAD_SMALL_INT`|`LOAD_CONST_IMMORTAL`" + else: + _OPCODES_FUNCTION_ARGS = rb"`LOAD_CONST`" + _OPCODES_FUNCTION_CALL = rb"`CALL`|`CALL_FUNCTION_EX`" + + # In Python 3.13, PUSH_NULL opcode is emitted after the LOAD_NAME (and after LOAD_ATTR opcode(s), if applicable). + # In python 3.11 and 3.12, it was emitted before the LOAD_NAME, and thus fell outside of our regex matching; now, + # we have to deal with it. But, instead of trying to add it to matching rules and adjusting the post-processing + # to deal with it, we opt to filter them out (at the same time as we filter out CACHE opcodes), and leave the rest + # of processing untouched. + if compat.is_py313: + _cache_instruction_filter = bytecode_regex(rb"(`CACHE`.)|(`PUSH_NULL`.)|(..)") + + def _cleanup_bytecode_string(bytecode): + return _cache_instruction_filter.sub(rb"\3", bytecode) + else: + _cache_instruction_filter = bytecode_regex(rb"(`CACHE`.)|(..)") + + def _cleanup_bytecode_string(bytecode): + return _cache_instruction_filter.sub(rb"\2", bytecode) + + +# language=PythonVerboseRegExp +_call_function_bytecode = bytecode_regex( + rb""" + # Matches `global_function('some', 'constant', 'arguments')`. + + # Load the global function. In code with >256 of names, this may require extended name references. + ( + (?:(?:""" + _OPCODES_EXTENDED_ARG + rb""").)* + (?:(?:""" + _OPCODES_FUNCTION_GLOBAL + rb""").) + ) + + # For foo.bar.whizz(), the above is the 'foo', below is the 'bar.whizz' (one opcode per name component, each + # possibly preceded by name reference extension). + ( + (?: + (?:(?:""" + _OPCODES_EXTENDED_ARG + rb""").)* + (?:""" + _OPCODES_FUNCTION_LOAD + rb"""). + )* + ) + + # Load however many arguments it takes. These (for now) must all be constants. + # Again, code with >256 constants may need extended enumeration. + ( + (?: + (?:(?:""" + _OPCODES_EXTENDED_ARG + rb""").)* + (?:""" + _OPCODES_FUNCTION_ARGS + rb"""). + )* + ) + + # Call the function. If opcode is CALL_FUNCTION_EX, the parameter are flags. For other opcodes, the parameter + # is the argument count (which may be > 256). + ( + (?:(?:""" + _OPCODES_EXTENDED_ARG + rb""").)* + (?:""" + _OPCODES_FUNCTION_CALL + rb"""). + ) +""" +) + +# language=PythonVerboseRegExp +_extended_arg_bytecode = bytecode_regex( + rb"""( + # Arbitrary number of EXTENDED_ARG pairs. + (?:(?:""" + _OPCODES_EXTENDED_ARG + rb""").)* + + # Followed by some other instruction (usually a LOAD). + [^""" + _OPCODES_EXTENDED_ARG2 + rb"""]. +)""" +) + + +def extended_arguments(extended_args: bytes): + """ + Unpack the (extended) integer used to reference names or constants. + + The input should be a bytecode snippet of the following form:: + + EXTENDED_ARG ? # Repeated 0-4 times. + LOAD_xxx ? # Any of LOAD_NAME/LOAD_CONST/LOAD_METHOD/... + + Each ? byte combined together gives the number we want. + """ + return int.from_bytes(extended_args[1::2], "big") + + +def load(raw: bytes, code: CodeType) -> str: + """ + Parse an (extended) LOAD_xxx instruction. + """ + # Get the enumeration. + index = extended_arguments(raw) + + # Work out what that enumeration was for (constant/local var/global var). + + # If the last instruction byte is a LOAD_FAST: + if raw[-2] == opmap["LOAD_FAST"]: + # Then this is a local variable. + return code.co_varnames[index] + # Or if it is a LOAD_CONST: + if raw[-2] == opmap["LOAD_CONST"]: + # Then this is a literal. + return code.co_consts[index] + # Otherwise, it is a global name. + if compat.is_py311 and raw[-2] == opmap["LOAD_GLOBAL"]: + # In python 3.11, namei>>1 is pushed on stack... + return code.co_names[index >> 1] + if compat.is_py312 and raw[-2] == opmap["LOAD_ATTR"]: + # In python 3.12, namei>>1 is pushed on stack... + return code.co_names[index >> 1] + if compat.is_py314 and raw[-2] == opmap["LOAD_SMALL_INT"]: + # python 3.14 introduced LOAD_SMALL_INT, which pushes its argument (int value < 256) on the stack + return index + if compat.is_py314 and raw[-2] == opmap["LOAD_CONST_IMMORTAL"]: + # python 3.14 introduced LOAD_CONST_IMMORTAL, which pushes co_consts[consti] on the stack. This is intended to + # be a variant of LOAD_CONST for constants that are known to be immortal. + return code.co_consts[index] + if compat.is_py314 and raw[-2] == opmap["LOAD_FAST_BORROW"]: + # python 3.14 introduced LOAD_FAST_BORROW, which pushes a borrowed reference to the local co_varnames[var_num] + # onto the stack. + return code.co_varnames[index] + + return code.co_names[index] + + +def loads(raw: bytes, code: CodeType) -> list: + """ + Parse multiple consecutive LOAD_xxx instructions. Or load() in a for loop. + + May be used to unpack a function's parameters or nested attributes ``(foo.bar.pop.whack)``. + """ + return [load(i, code) for i in _extended_arg_bytecode.findall(raw)] + + +def function_calls(code: CodeType) -> list: + """ + Scan a code object for all function calls on constant arguments. + """ + match: re.Match + out = [] + + for match in finditer(_call_function_bytecode, code.co_code): + function_root, methods, args, function_call = match.groups() + + # For foo(): + # `function_root` contains 'foo' and `methods` is empty. + # For foo.bar.whizz(): + # `function_root` contains 'foo' and `methods` contains the rest. + function_root = load(function_root, code) + methods = loads(methods, code) + function = ".".join([function_root] + methods) + + args = loads(args, code) + if function_call[0] == opmap['CALL_FUNCTION_EX']: + flags = extended_arguments(function_call) + if flags != 0: + # Keyword arguments present. Unhandled at the moment. + continue + # In calls with const arguments, args contains a single + # tuple with all values. + if len(args) != 1 or not isinstance(args[0], tuple): + continue + args = list(args[0]) + else: + arg_count = extended_arguments(function_call) + + if arg_count != len(args): + # This happens if there are variable or keyword arguments. Bail out in either case. + continue + + out.append((function, args)) + + return out + + +def search_recursively(search: callable, code: CodeType, _memo=None) -> dict: + """ + Apply a search function to a code object, recursing into child code objects (function definitions). + """ + if _memo is None: + _memo = {} + if code not in _memo: + _memo[code] = search(code) + for const in code.co_consts: + if isinstance(const, CodeType): + search_recursively(search, const, _memo) + return _memo + + +def recursive_function_calls(code: CodeType) -> dict: + """ + Scan a code object for function calls on constant arguments, recursing into function definitions and bodies of + comprehension loops. + """ + return search_recursively(function_calls, code) + + +def any_alias(full_name: str): + """List possible aliases of a fully qualified Python name. + + >>> list(any_alias("foo.bar.wizz")) + ['foo.bar.wizz', 'bar.wizz', 'wizz'] + + This crudely allows us to capture uses of wizz() under any of + :: + import foo + foo.bar.wizz() + :: + from foo import bar + bar.wizz() + :: + from foo.bar import wizz + wizz() + + However, it will fail for any form of aliases and quite likely find false matches. + """ + parts = full_name.split('.') + while parts: + yield ".".join(parts) + parts = parts[1:] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/depend/dylib.py b/venv/lib/python3.12/site-packages/PyInstaller/depend/dylib.py new file mode 100755 index 0000000..3b92c34 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/depend/dylib.py @@ -0,0 +1,378 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Manipulating with dynamic libraries. +""" + +import os +import pathlib +import re + +from PyInstaller import compat +import PyInstaller.log as logging + +logger = logging.getLogger(__name__) + +# Ignoring some system libraries speeds up packaging process +_excludes = { + # Ignore annoying warnings with Windows system DLLs. + # + # 'W: library kernel32.dll required via ctypes not found' + # 'W: library coredll.dll required via ctypes not found' + # + # These these dlls has to be ignored for all operating systems because they might be resolved when scanning code for + # ctypes dependencies. + r'advapi32\.dll', + r'ws2_32\.dll', + r'gdi32\.dll', + r'oleaut32\.dll', + r'shell32\.dll', + r'ole32\.dll', + r'coredll\.dll', + r'crypt32\.dll', + r'kernel32', + r'kernel32\.dll', + r'msvcrt\.dll', + r'rpcrt4\.dll', + r'user32\.dll', + # Some modules tries to import the Python library. e.g. pyreadline.console.console + r'python\%s\%s', +} + +# Regex includes - overrides excludes. Include list is used only to override specific libraries from exclude list. +_includes = set() + +_win_includes = { + # We need to allow collection of Visual Studio C++ (VC) runtime DLLs from system directories in order to avoid + # missing DLL errors when the frozen application is run on a system that does not have the corresponding VC + # runtime installed. The VC runtime DLLs may be dependencies of python shared library itself or of extension + # modules provided by 3rd party packages. + + # Visual Studio 2010 (VC10) runtime + # http://msdn.microsoft.com/en-us/library/8kche8ah(v=vs.100).aspx + r'atl100\.dll', + r'msvcr100\.dll', + r'msvcp100\.dll', + r'mfc100\.dll', + r'mfc100u\.dll', + r'mfcmifc80\.dll', + r'mfcm100\.dll', + r'mfcm100u\.dll', + + # Visual Studio 2012 (VC11) runtime + # https://docs.microsoft.com/en-us/visualstudio/releases/2013/2012-redistribution-vs + # + # VC110.ATL + r'atl110\.dll', + # VC110.CRT + r'msvcp110\.dll', + r'msvcr110\.dll', + r'vccorlib110\.dll', + # VC110.CXXAMP + r'vcamp110\.dll', + # VC110.MFC + r'mfc110\.dll', + r'mfc110u\.dll', + r'mfcm110\.dll', + r'mfcm110u\.dll', + # VC110.MFCLOC + r'mfc110chs\.dll', + r'mfc110cht\.dll', + r'mfc110enu\.dll', + r'mfc110esn\.dll', + r'mfc110deu\.dll', + r'mfc110fra\.dll', + r'mfc110ita\.dll', + r'mfc110jpn\.dll', + r'mfc110kor\.dll', + r'mfc110rus\.dll', + # VC110.OpenMP + r'vcomp110\.dll', + # DIA SDK + r'msdia110\.dll', + + # Visual Studio 2013 (VC12) runtime + # https://docs.microsoft.com/en-us/visualstudio/releases/2013/2013-redistribution-vs + # + # VC120.CRT + r'msvcp120\.dll', + r'msvcr120\.dll', + r'vccorlib120\.dll', + # VC120.CXXAMP + r'vcamp120\.dll', + # VC120.MFC + r'mfc120\.dll', + r'mfc120u\.dll', + r'mfcm120\.dll', + r'mfcm120u\.dll', + # VC120.MFCLOC + r'mfc120chs\.dll', + r'mfc120cht\.dll', + r'mfc120deu\.dll', + r'mfc120enu\.dll', + r'mfc120esn\.dll', + r'mfc120fra\.dll', + r'mfc120ita\.dll', + r'mfc120jpn\.dll', + r'mfc120kor\.dll', + r'mfc120rus\.dll', + # VC120.OPENMP + r'vcomp120\.dll', + # DIA SDK + r'msdia120\.dll', + # Cpp REST Windows SDK + r'casablanca120.winrt\.dll', + # Mobile Services Cpp Client + r'zumosdk120.winrt\.dll', + # Cpp REST SDK + r'casablanca120\.dll', + + # Universal C Runtime Library (since Visual Studio 2015) + # + # NOTE: these should be put under a switch, as they need not to be bundled if deployment target is Windows 10 + # and later, as "UCRT is now a system component in Windows 10 and later, managed by Windows Update". + # (https://docs.microsoft.com/en-us/cpp/windows/determining-which-dlls-to-redistribute?view=msvc-170) + # And as discovered in #6326, Windows prefers system-installed version over the bundled one, anyway + # (see https://docs.microsoft.com/en-us/cpp/windows/universal-crt-deployment?view=msvc-170#local-deployment). + r'api-ms-win-core.*', + r'api-ms-win-crt.*', + r'ucrtbase\.dll', + + # Visual Studio 2015/2017/2019/2022 (VC14) runtime + # https://docs.microsoft.com/en-us/visualstudio/releases/2022/redistribution + # + # VC141.CRT/VC142.CRT/VC143.CRT + r'concrt140\.dll', + r'msvcp140\.dll', + r'msvcp140_1\.dll', + r'msvcp140_2\.dll', + r'msvcp140_atomic_wait\.dll', + r'msvcp140_codecvt_ids\.dll', + r'vccorlib140\.dll', + r'vcruntime140\.dll', + r'vcruntime140_1\.dll', + # VC141.CXXAMP/VC142.CXXAMP/VC143.CXXAMP + r'vcamp140\.dll', + # VC141.OpenMP/VC142.OpenMP/VC143.OpenMP + r'vcomp140\.dll', + # DIA SDK + r'msdia140\.dll', + + # Allow pythonNN.dll, pythoncomNN.dll, pywintypesNN.dll + r'py(?:thon(?:com(?:loader)?)?|wintypes)\d+\.dll', +} + +_win_excludes = { + # On Windows, only .dll files can be loaded. + r'.*\.so', + r'.*\.dylib', + + # MS assembly excludes + r'Microsoft\.Windows\.Common-Controls', +} + +_unix_excludes = { + r'libc\.so(\..*)?', + r'libdl\.so(\..*)?', + r'libm\.so(\..*)?', + r'libpthread\.so(\..*)?', + r'librt\.so(\..*)?', + r'libthread_db\.so(\..*)?', + # glibc regex excludes. + r'ld-linux\.so(\..*)?', + r'libBrokenLocale\.so(\..*)?', + r'libanl\.so(\..*)?', + r'libcidn\.so(\..*)?', + r'libcrypt\.so(\..*)?', + r'libnsl\.so(\..*)?', + r'libnss_compat.*\.so(\..*)?', + r'libnss_dns.*\.so(\..*)?', + r'libnss_files.*\.so(\..*)?', + r'libnss_hesiod.*\.so(\..*)?', + r'libnss_nis.*\.so(\..*)?', + r'libnss_nisplus.*\.so(\..*)?', + r'libresolv\.so(\..*)?', + r'libutil\.so(\..*)?', + # graphical interface libraries come with graphical stack (see libglvnd) + r'libE?(Open)?GLX?(ESv1_CM|ESv2)?(dispatch)?\.so(\..*)?', + r'libdrm\.so(\..*)?', + # a subset of libraries included as part of the Nvidia Linux Graphics Driver as of 520.56.06: + # https://download.nvidia.com/XFree86/Linux-x86_64/520.56.06/README/installedcomponents.html + r'nvidia_drv\.so', + r'libglxserver_nvidia\.so(\..*)?', + r'libnvidia-egl-(gbm|wayland)\.so(\..*)?', + r'libnvidia-(cfg|compiler|e?glcore|glsi|glvkspirv|rtcore|allocator|tls|ml)\.so(\..*)?', + r'lib(EGL|GLX)_nvidia\.so(\..*)?', + # libcuda.so, libcuda.so.1, and libcuda.so.{version} are run-time part of NVIDIA driver, and should not be + # collected, as they need to match the rest of driver components on the target system. + r'libcuda\.so(\..*)?', + r'libcudadebugger\.so(\..*)?', + # libxcb-dri changes ABI frequently (e.g.: between Ubuntu LTS releases) and is usually installed as dependency of + # the graphics stack anyway. No need to bundle it. + r'libxcb\.so(\..*)?', + r'libxcb-dri.*\.so(\..*)?', + # system running a Wayland compositor should already have these libraries + # in versions that should not conflict with system drivers, unlike bundled + r'libwayland.*\.so(\..*)?', +} + +_aix_excludes = { + r'libbz2\.a', + r'libc\.a', + r'libC\.a', + r'libcrypt\.a', + r'libdl\.a', + r'libintl\.a', + r'libpthreads\.a', + r'librt\\.a', + r'librtl\.a', + r'libz\.a', +} + +_solaris_excludes = { + r'libsocket\.so(\..*)?', +} + +_cygwin_excludes = { + r'cygwin1\.dll', +} + +if compat.is_win: + _includes |= _win_includes + _excludes |= _win_excludes +elif compat.is_cygwin: + _excludes |= _cygwin_excludes +elif compat.is_aix: + # The exclude list for AIX differs from other *nix platforms. + _excludes |= _aix_excludes +elif compat.is_solar: + # The exclude list for Solaris differs from other *nix platforms. + _excludes |= _solaris_excludes + _excludes |= _unix_excludes +elif compat.is_unix: + # Common excludes for *nix platforms -- except AIX. + _excludes |= _unix_excludes + + +class MatchList: + def __init__(self, entries): + self._regex = re.compile('|'.join(entries), re.I) if entries else None + + def check_library(self, libname): + if self._regex: + return self._regex.match(os.path.basename(libname)) + return False + + +if compat.is_darwin: + import macholib.util + + class MacExcludeList(MatchList): + def __init__(self, entries): + super().__init__(entries) + + def check_library(self, libname): + # Try the global exclude list. + result = super().check_library(libname) + if result: + return result + + # Exclude libraries in standard system locations. + return macholib.util.in_system_path(libname) + + exclude_list = MacExcludeList(_excludes) + include_list = MatchList(_includes) + +elif compat.is_win: + from PyInstaller.utils.win32 import winutils + + class WinExcludeList(MatchList): + def __init__(self, entries): + super().__init__(entries) + + self._windows_dir = pathlib.Path(winutils.get_windows_dir()).resolve() + + # When running as SYSTEM user, the home directory is `%WINDIR%\system32\config\systemprofile`. + self._home_dir = pathlib.Path.home().resolve() + self._system_home = self._windows_dir in self._home_dir.parents + + def check_library(self, libname): + # Try the global exclude list. The global exclude list contains lower-cased names, so lower-case the input + # for case-normalized comparison. + result = super().check_library(libname.lower()) + if result: + return result + + # Exclude everything from the Windows directory by default; but allow contents of user's gome directory if + # that happens to be rooted under Windows directory (e.g., when running PyInstaller as SYSTEM user). + lib_fullpath = pathlib.Path(libname).resolve() + exclude = self._windows_dir in lib_fullpath.parents + if exclude and self._system_home and self._home_dir in lib_fullpath.parents: + exclude = False + return exclude + + exclude_list = WinExcludeList(_excludes) + include_list = MatchList(_includes) +else: + exclude_list = MatchList(_excludes) + include_list = MatchList(_includes) + +_seen_wine_dlls = set() # Used for warning tracking in include_library() + + +def include_library(libname): + """ + Check if the dynamic library should be included with application or not. + """ + if exclude_list.check_library(libname) and not include_list.check_library(libname): + # Library is excluded and is not overridden by include list. It should be excluded. + return False + + # If we are running under Wine and the library is a Wine built-in DLL, ensure that it is always excluded. Typically, + # excluding a DLL leads to an incomplete bundle and run-time errors when the said DLL is not installed on the target + # system. However, having Wine built-in DLLs collected is even more detrimental, as they usually provide Wine's + # implementation of low-level functionality, and therefore cannot be used on actual Windows (i.e., system libraries + # from the C:\Windows\system32 directory that might end up collected due to ``_win_includes`` list; a prominent + # example are VC runtime DLLs, for which Wine provides their own implementation, unless user explicitly installs + # Microsoft's VC redistributable package in their Wine environment). Therefore, excluding the Wine built-in DLLs + # actually improves the chances of the bundle running on Windows, or at least makes the issue easier to debug by + # turning it into the "standard" missing DLL problem. Exclusion should not affect the bundle's ability to run under + # Wine itself, as the excluded DLLs are available there. + if compat.is_win_wine and compat.is_wine_dll(libname): + # Display warning message only once per DLL. Note that it is also displayed only if the DLL were to be included + # in the first place. + if libname not in _seen_wine_dlls: + logger.warning("Excluding Wine built-in DLL: %s", libname) + _seen_wine_dlls.add(libname) + return False + + return True + + +# Patterns for suppressing warnings about missing dynamically linked libraries +_warning_suppressions = [] + +# On some systems (e.g., openwrt), libc.so might point to ldd. Suppress warnings about it. +if compat.is_linux: + _warning_suppressions.append(r'ldd') + +# Suppress warnings about unresolvable UCRT DLLs (see issue #1566) on Windows 10 and 11. +if compat.is_win_10 or compat.is_win_11: + _warning_suppressions.append(r'api-ms-win-.*\.dll') + +missing_lib_warning_suppression_list = MatchList(_warning_suppressions) + + +def warn_missing_lib(libname): + """ + Check if a missing-library warning should be displayed for the given library name (or full path). + """ + return not missing_lib_warning_suppression_list.check_library(libname) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/depend/imphook.py b/venv/lib/python3.12/site-packages/PyInstaller/depend/imphook.py new file mode 100755 index 0000000..b4f184a --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/depend/imphook.py @@ -0,0 +1,582 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Code related to processing of import hooks. +""" + +import glob +import os.path +import sys +import weakref +import re + +from PyInstaller import log as logging +from PyInstaller.building.utils import format_binaries_and_datas +from PyInstaller.compat import importlib_load_source +from PyInstaller.depend.imphookapi import PostGraphAPI +from PyInstaller.exceptions import ImportErrorWhenRunningHook + +logger = logging.getLogger(__name__) + + +class ModuleHookCache(dict): + """ + Cache of lazily loadable hook script objects. + + This cache is implemented as a `dict` subclass mapping from the fully-qualified names of all modules with at + least one hook script to lists of `ModuleHook` instances encapsulating these scripts. As a `dict` subclass, + all cached module names and hook scripts are accessible via standard dictionary operations. + + Attributes + ---------- + module_graph : ModuleGraph + Current module graph. + _hook_module_name_prefix : str + String prefixing the names of all in-memory modules lazily loaded from cached hook scripts. See also the + `hook_module_name_prefix` parameter passed to the `ModuleHook.__init__()` method. + """ + + _cache_id_next = 0 + """ + 0-based identifier unique to the next `ModuleHookCache` to be instantiated. + + This identifier is incremented on each instantiation of a new `ModuleHookCache` to isolate in-memory modules of + lazily loaded hook scripts in that cache to the same cache-specific namespace, preventing edge-case collisions + with existing in-memory modules in other caches. + + """ + def __init__(self, module_graph, hook_dirs): + """ + Cache all hook scripts in the passed directories. + + **Order of caching is significant** with respect to hooks for the same module, as the values of this + dictionary are lists. Hooks for the same module will be run in the order in which they are cached. Previously + cached hooks are always preserved rather than overridden. + + By default, official hooks are cached _before_ user-defined hooks. For modules with both official and + user-defined hooks, this implies that the former take priority over and hence will be loaded _before_ the + latter. + + Parameters + ---------- + module_graph : ModuleGraph + Current module graph. + hook_dirs : list + List of the absolute or relative paths of all directories containing **hook scripts** (i.e., + Python scripts with filenames matching `hook-{module_name}.py`, where `{module_name}` is the module + hooked by that script) to be cached. + """ + super().__init__() + + # To avoid circular references and hence increased memory consumption, a weak rather than strong reference is + # stored to the passed graph. Since this graph is guaranteed to live longer than this cache, + # this is guaranteed to be safe. + self.module_graph = weakref.proxy(module_graph) + + # String unique to this cache prefixing the names of all in-memory modules lazily loaded from cached hook + # scripts, privatized for safety. + self._hook_module_name_prefix = '__PyInstaller_hooks_{}_'.format(ModuleHookCache._cache_id_next) + ModuleHookCache._cache_id_next += 1 + + # Cache all hook scripts in the passed directories. + self._cache_hook_dirs(hook_dirs) + + def _cache_hook_dirs(self, hook_dirs): + """ + Cache all hook scripts in the passed directories. + + Parameters + ---------- + hook_dirs : list + List of the absolute or relative paths of all directories containing hook scripts to be cached. + """ + + for hook_dir, default_priority in hook_dirs: + # Canonicalize this directory's path and validate its existence. + hook_dir = os.path.abspath(hook_dir) + if not os.path.isdir(hook_dir): + raise FileNotFoundError('Hook directory "{}" not found.'.format(hook_dir)) + + # For each hook script in this directory... + hook_filenames = glob.glob(os.path.join(hook_dir, 'hook-*.py')) + for hook_filename in hook_filenames: + # Fully-qualified name of this hook's corresponding module, constructed by removing the "hook-" prefix + # and ".py" suffix. + module_name = os.path.basename(hook_filename)[5:-3] + + # Lazily loadable hook object. + module_hook = ModuleHook( + module_graph=self.module_graph, + module_name=module_name, + hook_filename=hook_filename, + hook_module_name_prefix=self._hook_module_name_prefix, + default_priority=default_priority, + ) + + # Add this hook to this module's list of hooks. + module_hooks = self.setdefault(module_name, []) + module_hooks.append(module_hook) + + # Post-processing: we allow only one instance of hook per module. Currently, the priority order is defined + # implicitly, via order of hook directories, so the first hook in the list has the highest priority. + for module_name in self.keys(): + hooks = self[module_name] + if len(hooks) == 1: + self[module_name] = hooks[0] + else: + # Order by priority value, in descending order. + sorted_hooks = sorted(hooks, key=lambda hook: hook.priority, reverse=True) + self[module_name] = sorted_hooks[0] + + def remove_modules(self, *module_names): + """ + Remove the passed modules and all hook scripts cached for these modules from this cache. + + Parameters + ---------- + module_names : list + List of all fully-qualified module names to be removed. + """ + + for module_name in module_names: + # Unload this module's hook script modules from memory. Since these are top-level pure-Python modules cached + # only in the "sys.modules" dictionary, popping these modules from this dictionary suffices to garbage + # collect them. + module_hook = self.pop(module_name, None) # Remove our reference, if available. + if module_hook is not None: + sys.modules.pop(module_hook.hook_module_name, None) + + +def _module_collection_mode_sanitizer(value): + if isinstance(value, dict): + # Hook set a dictionary; use it as-is + return value + elif isinstance(value, str): + # Hook set a mode string; convert to a dictionary and assign the string to `None` (= the hooked module). + return {None: value} + + raise ValueError(f"Invalid module collection mode setting value: {value!r}") + + +def _bindepend_symlink_suppression_sanitizer(value): + if isinstance(value, (list, set)): + # Hook set a list or a set; use it as-is + return set(value) + elif isinstance(value, str): + # Hook set a string; create a set with single element. + return set([value]) + + raise ValueError(f"Invalid value for bindepend_symlink_suppression: {value!r}") + + +# Dictionary mapping the names of magic attributes required by the "ModuleHook" class to 2-tuples "(default_type, +# sanitizer_func)", where: +# +# * "default_type" is the type to which that attribute will be initialized when that hook is lazily loaded. +# * "sanitizer_func" is the callable sanitizing the original value of that attribute defined by that hook into a +# safer value consumable by "ModuleHook" callers if any or "None" if the original value requires no sanitization. +# +# To avoid subtleties in the ModuleHook.__getattr__() method, this dictionary is declared as a module rather than a +# class attribute. If declared as a class attribute and then undefined (...for whatever reason), attempting to access +# this attribute from that method would produce infinite recursion. +_MAGIC_MODULE_HOOK_ATTRS = { + # Collections in which order is insignificant. This includes: + # + # * "datas", sanitized from hook-style 2-tuple lists defined by hooks into TOC-style 2-tuple sets consumable by + # "ModuleHook" callers. + # * "binaries", sanitized in the same way. + 'datas': (set, format_binaries_and_datas), + 'binaries': (set, format_binaries_and_datas), + 'excludedimports': (set, None), + + # Collections in which order is significant. This includes: + # + # * "hiddenimports", as order of importation is significant. On module importation, hook scripts are loaded and hook + # functions declared by these scripts are called. As these scripts and functions can have side effects dependent + # on module importation order, module importation itself can have side effects dependent on this order! + 'hiddenimports': (list, None), + + # Flags + 'warn_on_missing_hiddenimports': (lambda: True, bool), + + # Package/module collection mode dictionary. + 'module_collection_mode': (dict, _module_collection_mode_sanitizer), + + # Path patterns for suppression of symbolic links created by binary dependency analysis. + 'bindepend_symlink_suppression': (set, _bindepend_symlink_suppression_sanitizer), +} + + +class ModuleHook: + """ + Cached object encapsulating a lazy loadable hook script. + + This object exposes public attributes (e.g., `datas`) of the underlying hook script as attributes of the same + name of this object. On the first access of any such attribute, this hook script is lazily loaded into an + in-memory private module reused on subsequent accesses. These dynamic attributes are referred to as "magic." All + other static attributes of this object (e.g., `hook_module_name`) are referred to as "non-magic." + + Attributes (Magic) + ---------- + datas : set + Set of `TOC`-style 2-tuples `(target_file, source_file)` for all external non-executable files required by + the module being hooked, converted from the `datas` list of hook-style 2-tuples `(source_dir_or_glob, + target_dir)` defined by this hook script. + binaries : set + Set of `TOC`-style 2-tuples `(target_file, source_file)` for all external executable files required by the + module being hooked, converted from the `binaries` list of hook-style 2-tuples `(source_dir_or_glob, + target_dir)` defined by this hook script. + excludedimports : set + Set of the fully-qualified names of all modules imported by the module being hooked to be ignored rather than + imported from that module, converted from the `excludedimports` list defined by this hook script. These + modules will only be "locally" rather than "globally" ignored. These modules will remain importable from all + modules other than the module being hooked. + hiddenimports : set + Set of the fully-qualified names of all modules imported by the module being hooked that are _not_ + automatically detectable by PyInstaller (usually due to being dynamically imported in that module), + converted from the `hiddenimports` list defined by this hook script. + warn_on_missing_hiddenimports : bool + Boolean flag indicating whether missing hidden imports from the hook should generate warnings or not. This + behavior is enabled by default, but individual hooks can opt out of it. + module_collection_mode : dict + A dictionary of package/module names and their corresponding collection mode strings ('pyz', 'pyc', 'py', + 'pyz+py', 'py+pyz'). + bindepend_symlink_suppression : set + A set of paths or path patterns corresponding to shared libraries for which binary dependency analysis should + not create symbolic links into top-level application directory. + + Attributes (Non-magic) + ---------- + module_graph : ModuleGraph + Current module graph. + module_name : str + Name of the module hooked by this hook script. + hook_filename : str + Absolute or relative path of this hook script. + hook_module_name : str + Name of the in-memory module of this hook script's interpreted contents. + _hook_module : module + In-memory module of this hook script's interpreted contents, lazily loaded on the first call to the + `_load_hook_module()` method _or_ `None` if this method has yet to be accessed. + _default_priority : int + Default (location-based) priority for this hook. + priority : int + Actual priority for this hook. Might be different from `_default_priority` if hook file specifies the hook + priority override. + """ + + #-- Magic -- + + def __init__(self, module_graph, module_name, hook_filename, hook_module_name_prefix, default_priority): + """ + Initialize this metadata. + + Parameters + ---------- + module_graph : ModuleGraph + Current module graph. + module_name : str + Name of the module hooked by this hook script. + hook_filename : str + Absolute or relative path of this hook script. + hook_module_name_prefix : str + String prefixing the name of the in-memory module for this hook script. To avoid namespace clashes with + similar modules created by other `ModuleHook` objects in other `ModuleHookCache` containers, this string + _must_ be unique to the `ModuleHookCache` container containing this `ModuleHook` object. If this string + is non-unique, an existing in-memory module will be erroneously reused when lazily loading this hook + script, thus erroneously resanitizing previously sanitized hook script attributes (e.g., `datas`) with + the `format_binaries_and_datas()` helper. + default_priority : int + Default, location-based priority for this hook. Used to select active hook when multiple hooks are defined + for the same module. + """ + # Note that the passed module graph is already a weak reference, avoiding circular reference issues. See + # ModuleHookCache.__init__(). TODO: Add a failure message + assert isinstance(module_graph, weakref.ProxyTypes) + self.module_graph = module_graph + self.module_name = module_name + self.hook_filename = hook_filename + + # Default priority; used as fall-back for dynamic `hook_priority` attribute. + self._default_priority = default_priority + + # Name of the in-memory module fabricated to refer to this hook script. + self.hook_module_name = hook_module_name_prefix + self.module_name.replace('.', '_') + + # Attributes subsequently defined by the _load_hook_module() method. + self._loaded = False + self._has_hook_function = False + self._hook_module = None + + def __getattr__(self, attr_name): + """ + Get the magic attribute with the passed name (e.g., `datas`) from this lazily loaded hook script if any _or_ + raise `AttributeError` otherwise. + + This special method is called only for attributes _not_ already defined by this object. This includes + undefined attributes and the first attempt to access magic attributes. + + This special method is _not_ called for subsequent attempts to access magic attributes. The first attempt to + access magic attributes defines corresponding instance variables accessible via the `self.__dict__` instance + dictionary (e.g., as `self.datas`) without calling this method. This approach also allows magic attributes to + be deleted from this object _without_ defining the `__delattr__()` special method. + + See Also + ---------- + Class docstring for supported magic attributes. + """ + + if attr_name == 'priority': + # If attribute is part of hook metadata, read metadata from hook script and return the attribute value. + self._load_hook_metadata() + return getattr(self, attr_name) + if attr_name in _MAGIC_MODULE_HOOK_ATTRS and not self._loaded: + # If attribute is hook's magic attribute, load and run the hook script, and return the attribute value. + self._load_hook_module() + return getattr(self, attr_name) + else: + # This is an undefined attribute. Raise an exception. + raise AttributeError(attr_name) + + def __setattr__(self, attr_name, attr_value): + """ + Set the attribute with the passed name to the passed value. + + If this is a magic attribute, this hook script will be lazily loaded before setting this attribute. Unlike + `__getattr__()`, this special method is called to set _any_ attribute -- including magic, non-magic, + and undefined attributes. + + See Also + ---------- + Class docstring for supported magic attributes. + """ + + # If this is a magic attribute, initialize this attribute by lazy loading this hook script before overwriting + # this attribute. + if attr_name in _MAGIC_MODULE_HOOK_ATTRS: + self._load_hook_module() + + # Set this attribute to the passed value. To avoid recursion, the superclass method rather than setattr() is + # called. + return super().__setattr__(attr_name, attr_value) + + #-- Loading -- + + def _load_hook_metadata(self): + """ + Load hook metadata from its source file. + """ + self.priority = self._default_priority + + # Priority override pattern: `# $PyInstaller-Hook-Priority: ` + priority_pattern = re.compile(r"^\s*#\s*\$PyInstaller-Hook-Priority:\s*(?P[\S]+)") + + with open(self.hook_filename, "r", encoding="utf-8") as f: + for line in f: + # Attempt to match and parse hook priority directive + m = priority_pattern.match(line) + if m is not None: + try: + self.priority = int(m.group('value')) + except Exception: + logger.warning( + "Failed to parse hook priority value string: %r!", m.group('value'), exc_info=True + ) + # Currently, this is our only line of interest, so we can stop the search here. + return + + def _load_hook_module(self, keep_module_ref=False): + """ + Lazily load this hook script into an in-memory private module. + + This method (and, indeed, this class) preserves all attributes and functions defined by this hook script as + is, ensuring sane behaviour in hook functions _not_ expecting unplanned external modification. Instead, + this method copies public attributes defined by this hook script (e.g., `binaries`) into private attributes + of this object, which the special `__getattr__()` and `__setattr__()` methods safely expose to external + callers. For public attributes _not_ defined by this hook script, the corresponding private attributes will + be assigned sane defaults. For some public attributes defined by this hook script, the corresponding private + attributes will be transformed into objects more readily and safely consumed elsewhere by external callers. + + See Also + ---------- + Class docstring for supported attributes. + """ + + # If this hook script module has already been loaded, noop. + if self._loaded and (self._hook_module is not None or not keep_module_ref): + return + + # Load and execute the hook script. Even if mechanisms from the import machinery are used, this does not import + # the hook as the module. + hook_path, hook_basename = os.path.split(self.hook_filename) + logger.info('Processing standard module hook %r from %r', hook_basename, hook_path) + try: + self._hook_module = importlib_load_source(self.hook_module_name, self.hook_filename) + except ImportError: + logger.debug("Hook failed with:", exc_info=True) + raise ImportErrorWhenRunningHook(self.hook_module_name, self.hook_filename) + + # Mark as loaded + self._loaded = True + + # Check if module has hook() function. + self._has_hook_function = hasattr(self._hook_module, 'hook') + + # Copy hook script attributes into magic attributes exposed as instance variables of the current "ModuleHook" + # instance. + for attr_name, (default_type, sanitizer_func) in _MAGIC_MODULE_HOOK_ATTRS.items(): + # Unsanitized value of this attribute. + attr_value = getattr(self._hook_module, attr_name, None) + + # If this attribute is undefined, expose a sane default instead. + if attr_value is None: + attr_value = default_type() + # Else if this attribute requires sanitization, do so. + elif sanitizer_func is not None: + attr_value = sanitizer_func(attr_value) + # Else, expose the unsanitized value of this attribute. + + # Expose this attribute as an instance variable of the same name. + setattr(self, attr_name, attr_value) + + # If module_collection_mode has an entry with None key, reassign it to the hooked module's name. + setattr( + self, 'module_collection_mode', { + key if key is not None else self.module_name: value + for key, value in getattr(self, 'module_collection_mode').items() + } + ) + + # Release the module if we do not need the reference. This is the case when hook is loaded during the analysis + # rather as part of the post-graph operations. + if not keep_module_ref: + self._hook_module = None + + #-- Hooks -- + + def post_graph(self, analysis): + """ + Call the **post-graph hook** (i.e., `hook()` function) defined by this hook script, if any. + + Parameters + ---------- + analysis: build_main.Analysis + Analysis that calls the hook + + This method is intended to be called _after_ the module graph for this application is constructed. + """ + + # Lazily load this hook script into an in-memory module. + # The script might have been loaded before during modulegraph analysis; in that case, it needs to be reloaded + # only if it provides a hook() function. + if not self._loaded or self._has_hook_function: + # Keep module reference when loading the hook, so we can call its hook function! + self._load_hook_module(keep_module_ref=True) + + # Call this hook script's hook() function, which modifies attributes accessed by subsequent methods and + # hence must be called first. + self._process_hook_func(analysis) + + # Order is insignificant here. + self._process_hidden_imports() + + def _process_hook_func(self, analysis): + """ + Call this hook's `hook()` function if defined. + + Parameters + ---------- + analysis: build_main.Analysis + Analysis that calls the hook + """ + + # If this hook script defines no hook() function, noop. + if not hasattr(self._hook_module, 'hook'): + return + + # Call this hook() function. + hook_api = PostGraphAPI(module_name=self.module_name, module_graph=self.module_graph, analysis=analysis) + try: + self._hook_module.hook(hook_api) + except ImportError: + logger.debug("Hook failed with:", exc_info=True) + raise ImportErrorWhenRunningHook(self.hook_module_name, self.hook_filename) + + # Update all magic attributes modified by the prior call. + self.datas.update(set(hook_api._added_datas)) + self.binaries.update(set(hook_api._added_binaries)) + self.hiddenimports.extend(hook_api._added_imports) + self.module_collection_mode.update(hook_api._module_collection_mode) + self.bindepend_symlink_suppression.update(hook_api._bindepend_symlink_suppression) + + # FIXME: `hook_api._deleted_imports` should be appended to `self.excludedimports` and used to suppress module + # import during the modulegraph construction rather than handled here. However, for that to work, the `hook()` + # function needs to be ran during modulegraph construction instead of in post-processing (and this in turn + # requires additional code refactoring in order to be able to pass `analysis` to `PostGraphAPI` object at + # that point). So once the modulegraph rewrite is complete, remove the code block below. + for deleted_module_name in hook_api._deleted_imports: + # Remove the graph link between the hooked module and item. This removes the 'item' node from the graph if + # no other links go to it (no other modules import it) + self.module_graph.removeReference(hook_api.node, deleted_module_name) + + def _process_hidden_imports(self): + """ + Add all imports listed in this hook script's `hiddenimports` attribute to the module graph as if directly + imported by this hooked module. + + These imports are typically _not_ implicitly detectable by PyInstaller and hence must be explicitly defined + by hook scripts. + """ + + # For each hidden import required by the module being hooked... + for import_module_name in self.hiddenimports: + try: + # Graph node for this module. Do not implicitly create namespace packages for non-existent packages. + caller = self.module_graph.find_node(self.module_name, create_nspkg=False) + + # Manually import this hidden import from this module. + self.module_graph.import_hook(import_module_name, caller) + # If this hidden import is unimportable, print a non-fatal warning. Hidden imports often become + # desynchronized from upstream packages and hence are only "soft" recommendations. + except ImportError: + if self.warn_on_missing_hiddenimports: + logger.warning('Hidden import "%s" not found!', import_module_name) + + +class AdditionalFilesCache: + """ + Cache for storing what binaries and datas were pushed by what modules when import hooks were processed. + """ + def __init__(self): + self._binaries = {} + self._datas = {} + + def add(self, modname, binaries, datas): + + self._binaries.setdefault(modname, []) + self._binaries[modname].extend(binaries or []) + self._datas.setdefault(modname, []) + self._datas[modname].extend(datas or []) + + def __contains__(self, name): + return name in self._binaries or name in self._datas + + def binaries(self, modname): + """ + Return list of binaries for given module name. + """ + return self._binaries.get(modname, []) + + def datas(self, modname): + """ + Return list of datas for given module name. + """ + return self._datas.get(modname, []) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/depend/imphookapi.py b/venv/lib/python3.12/site-packages/PyInstaller/depend/imphookapi.py new file mode 100755 index 0000000..16ce0c1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/depend/imphookapi.py @@ -0,0 +1,486 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Classes facilitating communication between PyInstaller and import hooks. + +PyInstaller passes instances of classes defined by this module to corresponding functions defined by external import +hooks, which commonly modify the contents of these instances before returning. PyInstaller then detects and converts +these modifications into appropriate operations on the current `PyiModuleGraph` instance, thus modifying which +modules will be frozen into the executable. +""" + +from PyInstaller.building.utils import format_binaries_and_datas +from PyInstaller.lib.modulegraph.modulegraph import (RuntimeModule, RuntimePackage) + + +class PreSafeImportModuleAPI: + """ + Metadata communicating changes made by the current **pre-safe import module hook** (i.e., hook run immediately + _before_ a call to `ModuleGraph._safe_import_module()` recursively adding the hooked module, package, + or C extension and all transitive imports thereof to the module graph) back to PyInstaller. + + Pre-safe import module hooks _must_ define a `pre_safe_import_module()` function accepting an instance of this + class, whose attributes describe the subsequent `ModuleGraph._safe_import_module()` call creating the hooked + module's graph node. + + Each pre-safe import module hook is run _only_ on the first attempt to create the hooked module's graph node and + then subsequently ignored. If this hook successfully creates that graph node, the subsequent + `ModuleGraph._safe_import_module()` call will observe this fact and silently return without attempting to + recreate that graph node. + + Pre-safe import module hooks are typically used to create graph nodes for **runtime modules** (i.e., + modules dynamically defined at runtime). Most modules are physically defined in external `.py`-suffixed scripts. + Some modules, however, are dynamically defined at runtime (e.g., `six.moves`, dynamically defined by the + physically defined `six.py` module). However, `ModuleGraph` only parses `import` statements residing in external + scripts. `ModuleGraph` is _not_ a full-fledged, Turing-complete Python interpreter and hence has no means of + parsing `import` statements performed by runtime modules existing only in-memory. + + 'With great power comes great responsibility.' + + + Attributes (Immutable) + ---------------------------- + The following attributes are **immutable** (i.e., read-only). For safety, any attempts to change these attributes + _will_ result in a raised exception: + + module_graph : PyiModuleGraph + Current module graph. + parent_package : Package + Graph node for the package providing this module _or_ `None` if this module is a top-level module. + + Attributes (Mutable) + ----------------------------- + The following attributes are editable. + + module_basename : str + Unqualified name of the module to be imported (e.g., `text`). + module_name : str + Fully-qualified name of this module (e.g., `email.mime.text`). + """ + def __init__(self, module_graph, module_basename, module_name, parent_package): + self._module_graph = module_graph + self.module_basename = module_basename + self.module_name = module_name + self._parent_package = parent_package + + # Immutable properties. No corresponding setters are defined. + @property + def module_graph(self): + """ + Current module graph. + """ + return self._module_graph + + @property + def parent_package(self): + """ + Parent Package of this node. + """ + return self._parent_package + + def add_runtime_module(self, module_name): + """ + Add a graph node representing a non-package Python module with the passed name dynamically defined at runtime. + + Most modules are statically defined on-disk as standard Python files. Some modules, however, are dynamically + defined in-memory at runtime (e.g., `gi.repository.Gst`, dynamically defined by the statically defined + `gi.repository.__init__` module). + + This method adds a graph node representing such a runtime module. Since this module is _not_ a package, + all attempts to import submodules from this module in `from`-style import statements (e.g., the `queue` + submodule in `from six.moves import queue`) will be silently ignored. To circumvent this, simply call + `add_runtime_package()` instead. + + Parameters + ---------- + module_name : str + Fully-qualified name of this module (e.g., `gi.repository.Gst`). + + Examples + ---------- + This method is typically called by `pre_safe_import_module()` hooks, e.g.: + + def pre_safe_import_module(api): + api.add_runtime_module(api.module_name) + """ + + self._module_graph.add_module(RuntimeModule(module_name)) + + def add_runtime_package(self, package_name): + """ + Add a graph node representing a non-namespace Python package with the passed name dynamically defined at + runtime. + + Most packages are statically defined on-disk as standard subdirectories containing `__init__.py` files. Some + packages, however, are dynamically defined in-memory at runtime (e.g., `six.moves`, dynamically defined by + the statically defined `six` module). + + This method adds a graph node representing such a runtime package. All attributes imported from this package + in `from`-style import statements that are submodules of this package (e.g., the `queue` submodule in `from + six.moves import queue`) will be imported rather than ignored. + + Parameters + ---------- + package_name : str + Fully-qualified name of this package (e.g., `six.moves`). + + Examples + ---------- + This method is typically called by `pre_safe_import_module()` hooks, e.g.: + + def pre_safe_import_module(api): + api.add_runtime_package(api.module_name) + """ + + self._module_graph.add_module(RuntimePackage(package_name)) + + def add_alias_module(self, real_module_name, alias_module_name): + """ + Alias the source module to the target module with the passed names. + + This method ensures that the next call to findNode() given the target module name will resolve this alias. + This includes importing and adding a graph node for the source module if needed as well as adding a reference + from the target to the source module. + + Parameters + ---------- + real_module_name : str + Fully-qualified name of the **existing module** (i.e., the module being aliased). + alias_module_name : str + Fully-qualified name of the **non-existent module** (i.e., the alias to be created). + """ + + self._module_graph.alias_module(real_module_name, alias_module_name) + + def append_package_path(self, directory): + """ + Modulegraph does a good job at simulating Python's, but it cannot handle packagepath `__path__` modifications + packages make at runtime. + + Therefore there is a mechanism whereby you can register extra paths in this map for a package, and it will be + honored. + + Parameters + ---------- + directory : str + Absolute or relative path of the directory to be appended to this package's `__path__` attribute. + """ + + self._module_graph.append_package_path(self.module_name, directory) + + +class PreFindModulePathAPI: + """ + Metadata communicating changes made by the current **pre-find module path hook** (i.e., hook run immediately + _before_ a call to `ModuleGraph._find_module_path()` finding the hooked module's absolute path) back to PyInstaller. + + Pre-find module path hooks _must_ define a `pre_find_module_path()` function accepting an instance of this class, + whose attributes describe the subsequent `ModuleGraph._find_module_path()` call to be performed. + + Pre-find module path hooks are typically used to change the absolute path from which a module will be + subsequently imported and thus frozen into the executable. To do so, hooks may overwrite the default + `search_dirs` list of the absolute paths of all directories to be searched for that module: e.g., + + def pre_find_module_path(api): + api.search_dirs = ['/the/one/true/package/providing/this/module'] + + Each pre-find module path hook is run _only_ on the first call to `ModuleGraph._find_module_path()` for the + corresponding module. + + Attributes + ---------- + The following attributes are **mutable** (i.e., modifiable). All changes to these attributes will be immediately + respected by PyInstaller: + + search_dirs : list + List of the absolute paths of all directories to be searched for this module (in order). Searching will halt + at the first directory containing this module. + + Attributes (Immutable) + ---------- + The following attributes are **immutable** (i.e., read-only). For safety, any attempts to change these attributes + _will_ result in a raised exception: + + module_name : str + Fully-qualified name of this module. + module_graph : PyiModuleGraph + Current module graph. For efficiency, this attribute is technically mutable. To preserve graph integrity, + this attribute should nonetheless _never_ be modified. While read-only `PyiModuleGraph` methods (e.g., + `findNode()`) are safely callable from within pre-find module path hooks, methods modifying the graph are + _not_. If graph modifications are required, consider an alternative type of hook (e.g., pre-import module + hooks). + """ + def __init__( + self, + module_graph, + module_name, + search_dirs, + ): + # Mutable attributes. + self.search_dirs = search_dirs + + # Immutable attributes. + self._module_graph = module_graph + self._module_name = module_name + + # Immutable properties. No corresponding setters are defined. + @property + def module_graph(self): + """ + Current module graph. + """ + return self._module_graph + + @property + def module_name(self): + """ + Fully-qualified name of this module. + """ + return self._module_name + + +class PostGraphAPI: + """ + Metadata communicating changes made by the current **post-graph hook** (i.e., hook run for a specific module + transitively imported by the current application _after_ the module graph of all `import` statements performed by + this application has been constructed) back to PyInstaller. + + Post-graph hooks may optionally define a `post_graph()` function accepting an instance of this class, + whose attributes describe the current state of the module graph and the hooked module's graph node. + + Attributes (Mutable) + ---------- + The following attributes are **mutable** (i.e., modifiable). All changes to these attributes will be immediately + respected by PyInstaller: + + module_graph : PyiModuleGraph + Current module graph. + module : Node + Graph node for the currently hooked module. + + 'With great power comes great responsibility.' + + Attributes (Immutable) + ---------- + The following attributes are **immutable** (i.e., read-only). For safety, any attempts to change these attributes + _will_ result in a raised exception: + + __name__ : str + Fully-qualified name of this module (e.g., `six.moves.tkinter`). + __file__ : str + Absolute path of this module. If this module is: + * A standard (rather than namespace) package, this is the absolute path of this package's directory. + * A namespace (rather than standard) package, this is the abstract placeholder `-`. (Don't ask. Don't tell.) + * A non-package module or C extension, this is the absolute path of the corresponding file. + __path__ : list + List of the absolute paths of all directories comprising this package if this module is a package _or_ `None` + otherwise. If this module is a standard (rather than namespace) package, this list contains only the absolute + path of this package's directory. + co : code + Code object compiled from the contents of `__file__` (e.g., via the `compile()` builtin). + analysis: build_main.Analysis + The Analysis that load the hook. + + Attributes (Private) + ---------- + The following attributes are technically mutable but private, and hence should _never_ be externally accessed or + modified by hooks. Call the corresponding public methods instead: + + _added_datas : list + List of the `(name, path)` 2-tuples or TOC objects of all external data files required by the current hook, + defaulting to the empty list. This is equivalent to the global `datas` hook attribute. + _added_imports : list + List of the fully-qualified names of all modules imported by the current hook, defaulting to the empty list. + This is equivalent to the global `hiddenimports` hook attribute. + _added_binaries : list + List of the `(name, path)` 2-tuples or TOC objects of all external C extensions imported by the current hook, + defaulting to the empty list. This is equivalent to the global `binaries` hook attribute. + _module_collection_mode : dict + Dictionary of package/module names and their corresponding collection mode strings. This is equivalent to the + global `module_collection_mode` hook attribute. + _bindepend_symlink_suppression : set + A set of paths or path patterns corresponding to shared libraries for which binary dependency analysis should + not generate symbolic links into top-level application directory. + """ + def __init__(self, module_name, module_graph, analysis): + # Mutable attributes. + self.module_graph = module_graph + self.module = module_graph.find_node(module_name) + assert self.module is not None # should not occur + + # Immutable attributes. + self.___name__ = module_name + self.___file__ = self.module.filename + self._co = self.module.code + self._analysis = analysis + + # To enforce immutability, convert this module's package path if any into an immutable tuple. + self.___path__ = tuple(self.module.packagepath) \ + if self.module.packagepath is not None else None + + #FIXME: Refactor "_added_datas", "_added_binaries", and "_deleted_imports" into sets. Since order of + #import is important, "_added_imports" must remain a list. + + # Private attributes. + self._added_binaries = [] + self._added_datas = [] + self._added_imports = [] + self._deleted_imports = [] + self._module_collection_mode = {} + self._bindepend_symlink_suppression = set() + + # Immutable properties. No corresponding setters are defined. + @property + def __file__(self): + """ + Absolute path of this module's file. + """ + return self.___file__ + + @property + def __path__(self): + """ + List of the absolute paths of all directories comprising this package if this module is a package _or_ `None` + otherwise. If this module is a standard (rather than namespace) package, this list contains only the absolute + path of this package's directory. + """ + return self.___path__ + + @property + def __name__(self): + """ + Fully-qualified name of this module (e.g., `six.moves.tkinter`). + """ + return self.___name__ + + @property + def co(self): + """ + Code object compiled from the contents of `__file__` (e.g., via the `compile()` builtin). + """ + return self._co + + @property + def analysis(self): + """ + build_main.Analysis that calls the hook. + """ + return self._analysis + + # Obsolete immutable properties provided to preserve backward compatibility. + @property + def name(self): + """ + Fully-qualified name of this module (e.g., `six.moves.tkinter`). + + **This property has been deprecated by the `__name__` property.** + """ + return self.___name__ + + @property + def graph(self): + """ + Current module graph. + + **This property has been deprecated by the `module_graph` property.** + """ + return self.module_graph + + @property + def node(self): + """ + Graph node for the currently hooked module. + + **This property has been deprecated by the `module` property.** + """ + return self.module + + # TODO: This incorrectly returns the list of the graph nodes of all modules *TRANSITIVELY* (rather than directly) + # imported by this module. Unfortunately, this implies that most uses of this property are currently broken + # (e.g., "hook-PIL.SpiderImagePlugin.py"). We only require this for the aforementioned hook, so contemplate + # alternative approaches. + @property + def imports(self): + """ + List of the graph nodes of all modules directly imported by this module. + """ + return self.module_graph.iter_graph(start=self.module) + + def add_imports(self, *module_names): + """ + Add all Python modules whose fully-qualified names are in the passed list as "hidden imports" upon which the + current module depends. + + This is equivalent to appending such names to the hook-specific `hiddenimports` attribute. + """ + # Append such names to the current list of all such names. + self._added_imports.extend(module_names) + + def del_imports(self, *module_names): + """ + Remove the named fully-qualified modules from the set of imports (either hidden or visible) upon which the + current module depends. + + This is equivalent to appending such names to the hook-specific `excludedimports` attribute. + """ + self._deleted_imports.extend(module_names) + + def add_binaries(self, binaries): + """ + Add all external dynamic libraries in the passed list of `(src_name, dest_name)` 2-tuples as dependencies of the + current module. This is equivalent to adding to the global `binaries` hook attribute. + + For convenience, the `binaries` may also be a list of TOC-style 3-tuples `(dest_name, src_name, typecode)`. + """ + + # Detect TOC 3-tuple list by checking the length of the first entry + if binaries and len(binaries[0]) == 3: + self._added_binaries.extend(entry[:2] for entry in binaries) + else: + # NOTE: `format_binaries_and_datas` changes tuples from input format `(src_name, dest_name)` to output + # format `(dest_name, src_name)`. + self._added_binaries.extend(format_binaries_and_datas(binaries)) + + def add_datas(self, datas): + """ + Add all external data files in the passed list of `(src_name, dest_name)` 2-tuples as dependencies of the + current module. This is equivalent to adding to the global `datas` hook attribute. + + For convenience, the `datas` may also be a list of TOC-style 3-tuples `(dest_name, src_name, typecode)`. + """ + + # Detect TOC 3-tuple list by checking the length of the first entry + if datas and len(datas[0]) == 3: + self._added_datas.extend(entry[:2] for entry in datas) + else: + # NOTE: `format_binaries_and_datas` changes tuples from input format `(src_name, dest_name)` to output + # format `(dest_name, src_name)`. + self._added_datas.extend(format_binaries_and_datas(datas)) + + def set_module_collection_mode(self, name, mode): + """" + Set the package/module collection mode for the specified module name. If `name` is `None`, the hooked + module/package name is used. `mode` can be one of valid mode strings (`'pyz'`, `'pyc'`, `'py'`, `'pyz+py'`, + `'py+pyz'`) or `None`, which clears the setting for the module/package - but only within this hook's context! + """ + if name is None: + name = self.__name__ + if mode is None: + self._module_collection_mode.pop(name) + else: + self._module_collection_mode[name] = mode + + def add_bindepend_symlink_suppression_pattern(self, pattern): + """ + Add the given path or path pattern to the set of patterns that prevent binary dependency analysis from creating + a symbolic link to the top-level application directory. + """ + self._bindepend_symlink_suppression.add(pattern) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/depend/utils.py b/venv/lib/python3.12/site-packages/PyInstaller/depend/utils.py new file mode 100755 index 0000000..ebbbbff --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/depend/utils.py @@ -0,0 +1,344 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Utility functions related to analyzing/bundling dependencies. +""" + +import ctypes.util +import os +import re +import shutil +from types import CodeType + +from PyInstaller import compat +from PyInstaller import log as logging +from PyInstaller.depend import bytecode +from PyInstaller.depend.dylib import include_library +from PyInstaller.exceptions import ExecCommandFailed + +logger = logging.getLogger(__name__) + + +def scan_code_for_ctypes(co): + binaries = __recursively_scan_code_objects_for_ctypes(co) + + # If any of the libraries has been requested with anything else than the basename, drop that entry and warn the + # user - PyInstaller would need to patch the compiled pyc file to make it work correctly! + binaries = set(binaries) + for binary in list(binaries): + # 'binary' might be in some cases None. Some Python modules (e.g., PyObjC.objc._bridgesupport) might contain + # code like this: + # dll = ctypes.CDLL(None) + if not binary: + # None values have to be removed too. + binaries.remove(binary) + elif binary != os.path.basename(binary): + # TODO make these warnings show up somewhere. + try: + filename = co.co_filename + except Exception: + filename = 'UNKNOWN' + logger.warning( + "Ignoring %s imported from %s - only basenames are supported with ctypes imports!", binary, filename + ) + binaries.remove(binary) + + binaries = _resolveCtypesImports(binaries) + return binaries + + +def __recursively_scan_code_objects_for_ctypes(code: CodeType): + """ + Detects ctypes dependencies, using reasonable heuristics that should cover most common ctypes usages; returns a + list containing names of binaries detected as dependencies. + """ + from PyInstaller.depend.bytecode import any_alias, search_recursively + + binaries = [] + ctypes_dll_names = { + *any_alias("ctypes.CDLL"), + *any_alias("ctypes.cdll.LoadLibrary"), + *any_alias("ctypes.WinDLL"), + *any_alias("ctypes.windll.LoadLibrary"), + *any_alias("ctypes.OleDLL"), + *any_alias("ctypes.oledll.LoadLibrary"), + *any_alias("ctypes.PyDLL"), + *any_alias("ctypes.pydll.LoadLibrary"), + } + find_library_names = { + *any_alias("ctypes.util.find_library"), + } + + for calls in bytecode.recursive_function_calls(code).values(): + for (name, args) in calls: + if not len(args) == 1 or not isinstance(args[0], str): + continue + if name in ctypes_dll_names: + # ctypes.*DLL() or ctypes.*dll.LoadLibrary() + binaries.append(*args) + elif name in find_library_names: + # ctypes.util.find_library() needs to be handled separately, because we need to resolve the library base + # name given as the argument (without prefix and suffix, e.g. 'gs') into corresponding full name (e.g., + # 'libgs.so.9'). + libname = args[0] + if libname: + try: # this try was inserted due to the ctypes bug https://github.com/python/cpython/issues/93094 + libname = ctypes.util.find_library(libname) + except FileNotFoundError: + libname = None + logger.warning( + 'ctypes.util.find_library raised a FileNotFoundError. ' + 'Supressing and assuming no lib with the name "%s" was found.', args[0] + ) + if libname: + # On Windows, `find_library` may return a full pathname. See issue #1934. + libname = os.path.basename(libname) + binaries.append(libname) + + # The above handles any flavour of function/class call. We still need to capture the (albeit rarely used) case of + # loading libraries with ctypes.cdll's getattr. + for i in search_recursively(_scan_code_for_ctypes_getattr, code).values(): + binaries.extend(i) + + return binaries + + +_ctypes_getattr_regex = bytecode.bytecode_regex( + rb""" + # Matches 'foo.bar' or 'foo.bar.whizz'. + + # Load the 'foo'. + ( + (?:(?:""" + bytecode._OPCODES_EXTENDED_ARG + rb""").)* + (?:""" + bytecode._OPCODES_FUNCTION_GLOBAL + rb"""). + ) + + # Load the 'bar.whizz' (one opcode per name component, each possibly preceded by name reference extension). + ( + (?: + (?:(?:""" + bytecode._OPCODES_EXTENDED_ARG + rb""").)* + (?:""" + bytecode._OPCODES_FUNCTION_LOAD + rb"""). + )+ + ) +""" +) + + +def _scan_code_for_ctypes_getattr(code: CodeType): + """ + Detect uses of ``ctypes.cdll.library_name``, which implies that ``library_name.dll`` should be collected. + """ + + key_names = ("cdll", "oledll", "pydll", "windll") + + for match in bytecode.finditer(_ctypes_getattr_regex, code.co_code): + name, attrs = match.groups() + name = bytecode.load(name, code) + attrs = bytecode.loads(attrs, code) + + if attrs and attrs[-1] == "LoadLibrary": + continue + + # Capture `from ctypes import ole; ole.dll_name`. + if len(attrs) == 1: + if name in key_names: + yield attrs[0] + ".dll" + # Capture `import ctypes; ctypes.ole.dll_name`. + if len(attrs) == 2: + if name == "ctypes" and attrs[0] in key_names: + yield attrs[1] + ".dll" + + +# TODO: reuse this code with modulegraph implementation. +def _resolveCtypesImports(cbinaries): + """ + Completes ctypes BINARY entries for modules with their full path. + + Input is a list of c-binary-names (as found by `scan_code_instruction_for_ctypes`). Output is a list of tuples + ready to be appended to the ``binaries`` of a modules. + + This function temporarily extents PATH, LD_LIBRARY_PATH or DYLD_LIBRARY_PATH (depending on the platform) by + CONF['pathex'] so shared libs will be search there, too. + + Example: + >>> _resolveCtypesImports(['libgs.so']) + [(libgs.so', ''/usr/lib/libgs.so', 'BINARY')] + """ + from ctypes.util import find_library + + from PyInstaller.config import CONF + + if compat.is_unix: + envvar = "LD_LIBRARY_PATH" + elif compat.is_darwin: + envvar = "DYLD_LIBRARY_PATH" + else: + envvar = "PATH" + + def _setPaths(): + path = os.pathsep.join(CONF['pathex']) + old = compat.getenv(envvar) + if old is not None: + path = os.pathsep.join((path, old)) + compat.setenv(envvar, path) + return old + + def _restorePaths(old): + if old is None: + compat.unsetenv(envvar) + else: + compat.setenv(envvar, old) + + ret = [] + + # Try to locate the shared library on the disk. This is done by calling ctypes.util.find_library with + # ImportTracker's local paths temporarily prepended to the library search paths (and restored after the call). + old = _setPaths() + for cbin in cbinaries: + try: + # There is an issue with find_library() where it can run into errors trying to locate the library. See + # #5734. + cpath = find_library(os.path.splitext(cbin)[0]) + except FileNotFoundError: + # In these cases, find_library() should return None. + cpath = None + if compat.is_unix or compat.is_cygwin: + # CAVEAT: find_library() is not the correct function. ctype's documentation says that it is meant to resolve + # only the filename (as a *compiler* does) not the full path. Anyway, it works well enough on Windows and + # macOS. On Linux, we need to implement more code to find out the full path. + if cpath is None: + cpath = cbin + # "man ld.so" says that we should first search LD_LIBRARY_PATH and then the ldcache. + for d in compat.getenv(envvar, '').split(os.pathsep): + if os.path.isfile(os.path.join(d, cpath)): + cpath = os.path.join(d, cpath) + break + else: + if LDCONFIG_CACHE is None: + load_ldconfig_cache() + if cpath in LDCONFIG_CACHE: + cpath = LDCONFIG_CACHE[cpath] + assert os.path.isfile(cpath) + else: + cpath = None + if cpath is None: + # Skip warning message if cbin (basename of library) is ignored. This prevents messages like: + # 'W: library kernel32.dll required via ctypes not found' + if not include_library(cbin): + continue + # On non-Windows, automatically ignore all ctypes-based referenes to DLL files. This complements the above + # check, which might not match potential case variations (e.g., `KERNEL32.dll`, instead of `kernel32.dll`) + # due to case-sensitivity of the matching that is in effect on non-Windows platforms. + if (not compat.is_win and not compat.is_cygwin) and cbin.lower().endswith('.dll'): + continue + logger.warning("Library %s required via ctypes not found", cbin) + else: + if not include_library(cpath): + continue + ret.append((cbin, cpath, "BINARY")) + _restorePaths(old) + return ret + + +LDCONFIG_CACHE = None # cache the output of `/sbin/ldconfig -p` + + +def load_ldconfig_cache(): + """ + Create a cache of the `ldconfig`-output to call it only once. + It contains thousands of libraries and running it on every dylib is expensive. + """ + global LDCONFIG_CACHE + + if LDCONFIG_CACHE is not None: + return + + if compat.is_cygwin: + # Not available under Cygwin; but we might be re-using general POSIX codepaths, and end up here. So exit early. + LDCONFIG_CACHE = {} + return + + if compat.is_musl: + # Musl deliberately doesn't use ldconfig. The ldconfig executable either doesn't exist or it's a functionless + # executable which, on calling with any arguments, simply tells you that those arguments are invalid. + LDCONFIG_CACHE = {} + return + + ldconfig = shutil.which('ldconfig') + if ldconfig is None: + # If `ldconfig` is not found in $PATH, search for it in some fixed directories. Simply use a second call instead + # of fiddling around with checks for empty env-vars and string-concat. + ldconfig = shutil.which('ldconfig', path='/usr/sbin:/sbin:/usr/bin:/bin') + + # If we still could not find the 'ldconfig' command... + if ldconfig is None: + LDCONFIG_CACHE = {} + return + + if compat.is_freebsd or compat.is_openbsd: + # This has a quite different format than other Unixes: + # [vagrant@freebsd-10 ~]$ ldconfig -r + # /var/run/ld-elf.so.hints: + # search directories: /lib:/usr/lib:/usr/lib/compat:... + # 0:-lgeom.5 => /lib/libgeom.so.5 + # 184:-lpython2.7.1 => /usr/local/lib/libpython2.7.so.1 + ldconfig_arg = '-r' + splitlines_count = 2 + pattern = re.compile(r'^\s+\d+:-l(\S+)(\s.*)? => (\S+)') + else: + # Skip first line of the library list because it is just an informative line and might contain localized + # characters. Example of first line with locale set to cs_CZ.UTF-8: + #$ /sbin/ldconfig -p + #V keši „/etc/ld.so.cache“ nalezeno knihoven: 2799 + # libzvbi.so.0 (libc6,x86-64) => /lib64/libzvbi.so.0 + # libzvbi-chains.so.0 (libc6,x86-64) => /lib64/libzvbi-chains.so.0 + ldconfig_arg = '-p' + splitlines_count = 1 + pattern = re.compile(r'^\s+(\S+)(\s.*)? => (\S+)') + + try: + text = compat.exec_command(ldconfig, ldconfig_arg) + except ExecCommandFailed: + logger.warning("Failed to execute ldconfig. Disabling LD cache.") + LDCONFIG_CACHE = {} + return + + text = text.strip().splitlines()[splitlines_count:] + + LDCONFIG_CACHE = {} + for line in text: + # :fixme: this assumes library names do not contain whitespace + m = pattern.match(line) + + # Sanitize away any abnormal lines of output. + if m is None: + # Warn about it then skip the rest of this iteration. + if re.search("Cache generated by:", line): + # See #5540. This particular line is harmless. + pass + else: + logger.warning("Unrecognised line of output %r from ldconfig", line) + continue + + path = m.groups()[-1] + if compat.is_freebsd or compat.is_openbsd: + # Insert `.so` at the end of the lib's basename. soname and filename may have (different) trailing versions. + # We assume the `.so` in the filename to mark the end of the lib's basename. + bname = os.path.basename(path).split('.so', 1)[0] + name = 'lib' + m.group(1) + assert name.startswith(bname) + name = bname + '.so' + name[len(bname):] + else: + name = m.group(1) + # ldconfig may know about several versions of the same lib, e.g., different arch, different libc, etc. + # Use the first entry. + if name not in LDCONFIG_CACHE: + LDCONFIG_CACHE[name] = path diff --git a/venv/lib/python3.12/site-packages/PyInstaller/exceptions.py b/venv/lib/python3.12/site-packages/PyInstaller/exceptions.py new file mode 100755 index 0000000..020e878 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/exceptions.py @@ -0,0 +1,70 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +class ExecCommandFailed(SystemExit): + pass + + +class HookError(Exception): + """ + Base class for hook related errors. + """ + pass + + +class ImportErrorWhenRunningHook(HookError): + def __str__(self): + return ( + "ERROR: Failed to import module {0} required by hook for module {1}. Please check whether module {0} " + "actually exists and whether the hook is compatible with your version of {1}: You might want to read more " + "about hooks in the manual and provide a pull-request to improve PyInstaller.".format( + self.args[0], self.args[1] + ) + ) + + +class RemovedCipherFeatureError(SystemExit): + def __init__(self, message): + super().__init__( + f"ERROR: Bytecode encryption was removed in PyInstaller v6.0. {message}" + " For the rationale and alternatives see https://github.com/pyinstaller/pyinstaller/pull/6999" + ) + + +class RemovedExternalManifestError(SystemExit): + def __init__(self, message): + super().__init__(f"ERROR: Support for external executable manifest was removed in PyInstaller v6.0. {message}") + + +class RemovedWinSideBySideSupportError(SystemExit): + def __init__(self, message): + super().__init__( + f"ERROR: Support for collecting and processing WinSxS assemblies was removed in PyInstaller v6.0. {message}" + ) + + +class PythonLibraryNotFoundError(SystemExit): + def __init__(self, message): + super().__init__(f"ERROR: {message}") + + +class InvalidSrcDestTupleError(SystemExit): + def __init__(self, src_dest, message): + super().__init__(f"ERROR: Invalid (SRC, DEST_DIR) tuple: {src_dest!r}. {message}") + + +class ImportlibMetadataError(SystemExit): + def __init__(self): + super().__init__( + "ERROR: PyInstaller requires importlib.metadata from python >= 3.10 stdlib or importlib_metadata from " + "importlib-metadata >= 4.6" + ) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/_pyi_rth_utils/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/_pyi_rth_utils/__init__.py new file mode 100755 index 0000000..e006337 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/_pyi_rth_utils/__init__.py @@ -0,0 +1,36 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +# ----------------------------------------------------------------------------- + +import sys +import os + +# A boolean indicating whether the frozen application is a macOS .app bundle. +is_macos_app_bundle = sys.platform == 'darwin' and sys._MEIPASS.endswith("Contents/Frameworks") + + +def prepend_path_to_environment_variable(path, variable_name): + """ + Prepend the given path to the list of paths stored in the given environment variable (separated by `os.pathsep`). + If the given path is already specified in the environment variable, no changes are made. If the environment variable + is not set or is empty, it is set/overwritten with the given path. + """ + stored_paths = os.environ.get(variable_name) + if stored_paths: + # If path is already included, make this a no-op. NOTE: we need to split the string and search in the list of + # substrings to find an exact match; searching in the original string might erroneously match a prefix of a + # longer (i.e., sub-directory) path when such entry already happens to be in PATH (see #8857). + if path in stored_paths.split(os.pathsep): + return + # Otherwise, prepend the path + stored_paths = path + os.pathsep + stored_paths + else: + stored_paths = path + os.environ[variable_name] = stored_paths diff --git a/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/_pyi_rth_utils/_win32.py b/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/_pyi_rth_utils/_win32.py new file mode 100755 index 0000000..80e30ec --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/_pyi_rth_utils/_win32.py @@ -0,0 +1,333 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +# ----------------------------------------------------------------------------- + +import ctypes +import ctypes.wintypes + +# Constants from win32 headers +TOKEN_QUERY = 0x0008 + +TokenUser = 1 # from TOKEN_INFORMATION_CLASS enum +TokenAppContainerSid = 31 # from TOKEN_INFORMATION_CLASS enum + +ERROR_INSUFFICIENT_BUFFER = 122 + +INVALID_HANDLE = -1 + +FORMAT_MESSAGE_ALLOCATE_BUFFER = 0x00000100 +FORMAT_MESSAGE_FROM_SYSTEM = 0x00001000 + +SDDL_REVISION1 = 1 + +# Structures for ConvertSidToStringSidW +PSID = ctypes.wintypes.LPVOID + + +class SID_AND_ATTRIBUTES(ctypes.Structure): + _fields_ = [ + ("Sid", PSID), + ("Attributes", ctypes.wintypes.DWORD), + ] + + +class TOKEN_USER(ctypes.Structure): + _fields_ = [ + ("User", SID_AND_ATTRIBUTES), + ] + + +PTOKEN_USER = ctypes.POINTER(TOKEN_USER) + + +class TOKEN_APPCONTAINER_INFORMATION(ctypes.Structure): + _fields_ = [ + ("TokenAppContainer", PSID), + ] + + +PTOKEN_APPCONTAINER_INFORMATION = ctypes.POINTER(TOKEN_APPCONTAINER_INFORMATION) + +# SECURITY_ATTRIBUTES structure for CreateDirectoryW +PSECURITY_DESCRIPTOR = ctypes.wintypes.LPVOID + + +class SECURITY_ATTRIBUTES(ctypes.Structure): + _fields_ = [ + ("nLength", ctypes.wintypes.DWORD), + ("lpSecurityDescriptor", PSECURITY_DESCRIPTOR), + ("bInheritHandle", ctypes.wintypes.BOOL), + ] + + +# win32 API functions, bound via ctypes. +# NOTE: we do not use ctypes.windll. to avoid modifying its (global) function prototypes, which might affect +# user's code. +advapi32 = ctypes.WinDLL("advapi32") +kernel32 = ctypes.WinDLL("kernel32") + +advapi32.ConvertSidToStringSidW.restype = ctypes.wintypes.BOOL +advapi32.ConvertSidToStringSidW.argtypes = ( + PSID, # [in] PSID Sid + ctypes.POINTER(ctypes.wintypes.LPWSTR), # [out] LPWSTR *StringSid +) + +advapi32.ConvertStringSecurityDescriptorToSecurityDescriptorW.restype = ctypes.wintypes.BOOL +advapi32.ConvertStringSecurityDescriptorToSecurityDescriptorW.argtypes = ( + ctypes.wintypes.LPCWSTR, # [in] LPCWSTR StringSecurityDescriptor + ctypes.wintypes.DWORD, # [in] DWORD StringSDRevision + ctypes.POINTER(PSECURITY_DESCRIPTOR), # [out] PSECURITY_DESCRIPTOR *SecurityDescriptor + ctypes.wintypes.PULONG, # [out] PULONG SecurityDescriptorSize +) + +advapi32.GetTokenInformation.restype = ctypes.wintypes.BOOL +advapi32.GetTokenInformation.argtypes = ( + ctypes.wintypes.HANDLE, # [in] HANDLE TokenHandle + ctypes.c_int, # [in] TOKEN_INFORMATION_CLASS TokenInformationClass + ctypes.wintypes.LPVOID, # [out, optional] LPVOID TokenInformation + ctypes.wintypes.DWORD, # [in] DWORD TokenInformationLength + ctypes.wintypes.PDWORD, # [out] PDWORD ReturnLength +) + +kernel32.CloseHandle.restype = ctypes.wintypes.BOOL +kernel32.CloseHandle.argtypes = ( + ctypes.wintypes.HANDLE, # [in] HANDLE hObject +) + +kernel32.CreateDirectoryW.restype = ctypes.wintypes.BOOL +kernel32.CreateDirectoryW.argtypes = ( + ctypes.wintypes.LPCWSTR, # [in] LPCWSTR lpPathName + ctypes.POINTER(SECURITY_ATTRIBUTES), # [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes +) + +kernel32.FormatMessageW.restype = ctypes.wintypes.DWORD +kernel32.FormatMessageW.argtypes = ( + ctypes.wintypes.DWORD, # [in] DWORD dwFlags + ctypes.wintypes.LPCVOID, # [in, optional] LPCVOID lpSource + ctypes.wintypes.DWORD, # [in] DWORD dwMessageId + ctypes.wintypes.DWORD, # [in] DWORD dwLanguageId + ctypes.wintypes.LPWSTR, # [out] LPWSTR lpBuffer + ctypes.wintypes.DWORD, # [in] DWORD nSize + ctypes.wintypes.LPVOID, # [in, optional] va_list *Arguments +) + +kernel32.GetCurrentProcess.restype = ctypes.wintypes.HANDLE +# kernel32.GetCurrentProcess has no arguments + +kernel32.GetLastError.restype = ctypes.wintypes.DWORD +# kernel32.GetLastError has no arguments + +kernel32.LocalFree.restype = ctypes.wintypes.BOOL +kernel32.LocalFree.argtypes = ( + ctypes.wintypes.HLOCAL, # [in] _Frees_ptr_opt_ HLOCAL hMem +) + +kernel32.OpenProcessToken.restype = ctypes.wintypes.BOOL +kernel32.OpenProcessToken.argtypes = ( + ctypes.wintypes.HANDLE, # [in] HANDLE ProcessHandle + ctypes.wintypes.DWORD, # [in] DWORD DesiredAccess + ctypes.wintypes.PHANDLE, # [out] PHANDLE TokenHandle +) + + +def _win_error_to_message(error_code): + """ + Convert win32 error code to message. + """ + message_wstr = ctypes.wintypes.LPWSTR(None) + ret = kernel32.FormatMessageW( + FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM, + None, # lpSource + error_code, # dwMessageId + 0x400, # dwLanguageId = MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT) + ctypes.cast( + ctypes.byref(message_wstr), + ctypes.wintypes.LPWSTR, + ), # pointer to LPWSTR due to FORMAT_MESSAGE_ALLOCATE_BUFFER; needs to be cast to LPWSTR + 64, # due to FORMAT_MESSAGE_ALLOCATE_BUFFER, this is minimum number of characters to allocate + None, + ) + if ret == 0: + return None + + message = message_wstr.value + kernel32.LocalFree(message_wstr) + + # Strip trailing CR/LF. + if message: + message = message.strip() + return message + + +def _get_process_sid(token_information_class): + """ + Obtain the SID from the current process by the given token information class. + + Args: + token_information_class: Token information class identifying the SID that we're + interested in. Only TokenUser and TokenAppContainerSid are supported. + + Returns: SID (if it could be fetched) or None if not available or on error. + """ + process_token = ctypes.wintypes.HANDLE(INVALID_HANDLE) + + try: + # Get access token for the current process + ret = kernel32.OpenProcessToken( + kernel32.GetCurrentProcess(), + TOKEN_QUERY, + ctypes.pointer(process_token), + ) + if ret == 0: + error_code = kernel32.GetLastError() + raise RuntimeError(f"Failed to open process token! Error code: 0x{error_code:X}") + + # Query buffer size for sid + token_info_size = ctypes.wintypes.DWORD(0) + + ret = advapi32.GetTokenInformation( + process_token, + token_information_class, + None, + 0, + ctypes.byref(token_info_size), + ) + + # We expect this call to fail with ERROR_INSUFFICIENT_BUFFER + if ret == 0: + error_code = kernel32.GetLastError() + if error_code != ERROR_INSUFFICIENT_BUFFER: + raise RuntimeError(f"Failed to query token information buffer size! Error code: 0x{error_code:X}") + else: + raise RuntimeError("Unexpected return value from GetTokenInformation!") + + # Allocate buffer + token_info = ctypes.create_string_buffer(token_info_size.value) + ret = advapi32.GetTokenInformation( + process_token, + token_information_class, + token_info, + token_info_size, + ctypes.byref(token_info_size), + ) + if ret == 0: + error_code = kernel32.GetLastError() + raise RuntimeError(f"Failed to query token information! Error code: 0x{error_code:X}") + + # Convert SID to string + # Technically, when UserToken is used, we need to pass user_info->User.Sid, + # but as they are at the beginning of the buffer, just pass the buffer instead... + sid_wstr = ctypes.wintypes.LPWSTR(None) + + if token_information_class == TokenUser: + sid = ctypes.cast(token_info, PTOKEN_USER).contents.User.Sid + elif token_information_class == TokenAppContainerSid: + sid = ctypes.cast(token_info, PTOKEN_APPCONTAINER_INFORMATION).contents.TokenAppContainer + else: + raise ValueError(f"Unexpected token information class: {token_information_class}") + + ret = advapi32.ConvertSidToStringSidW(sid, ctypes.pointer(sid_wstr)) + if ret == 0: + error_code = kernel32.GetLastError() + raise RuntimeError(f"Failed to convert SID to string! Error code: 0x{error_code:X}") + sid = sid_wstr.value + kernel32.LocalFree(sid_wstr) + except Exception: + sid = None + finally: + # Close the process token + if process_token.value != INVALID_HANDLE: + kernel32.CloseHandle(process_token) + + return sid + + +# Get and cache current user's SID +_user_sid = _get_process_sid(TokenUser) + +# Get and cache current app container's SID (if any) +_app_container_sid = _get_process_sid(TokenAppContainerSid) + + +def secure_mkdir(dir_name): + """ + Replacement for mkdir that limits the access to created directory to current user. + """ + + # Create security descriptor + # Prefer actual user SID over SID S-1-3-4 (current owner), because at the time of writing, Wine does not properly + # support the latter. + user_sid = _user_sid or "S-1-3-4" + + # DACL descriptor (D): + # ace_type;ace_flags;rights;object_guid;inherit_object_guid;account_sid;(resource_attribute) + # - ace_type = SDDL_ACCESS_ALLOWED (A) + # - rights = SDDL_FILE_ALL (FA) + # - account_sid = current user (queried SID) + security_desc_str = f"D:(A;;FA;;;{user_sid})" + + # If the app is running within an AppContainer, the app container SID has to be added to the DACL. + # Otherwise our process will not have access to the temp dir. + # + # Quoting https://learn.microsoft.com/en-us/windows/win32/secauthz/implementing-an-appcontainer: + # "The AppContainer SID is a persistent unique identifier for the appcontainer. ... + # To allow a single AppContainer to access a resource, add its AppContainerSID to the ACL for that resource." + if _app_container_sid: + security_desc_str += f"(A;;FA;;;{_app_container_sid})" + security_desc = ctypes.wintypes.LPVOID(None) + + ret = advapi32.ConvertStringSecurityDescriptorToSecurityDescriptorW( + security_desc_str, + SDDL_REVISION1, + ctypes.byref(security_desc), + None, + ) + if ret == 0: + error_code = kernel32.GetLastError() + raise RuntimeError( + f"Failed to create security descriptor! Error code: 0x{error_code:X}, " + f"message: {_win_error_to_message(error_code)}" + ) + + security_attr = SECURITY_ATTRIBUTES() + security_attr.nLength = ctypes.sizeof(SECURITY_ATTRIBUTES) + security_attr.lpSecurityDescriptor = security_desc + security_attr.bInheritHandle = False + + # Create directory + ret = kernel32.CreateDirectoryW( + dir_name, + security_attr, + ) + if ret == 0: + # Call failed; store error code immediately, to avoid it being overwritten in cleanup below. + error_code = kernel32.GetLastError() + + # Free security descriptor + kernel32.LocalFree(security_desc) + + # Exit on succeess + if ret != 0: + return + + # Construct OSError from win error code + error_message = _win_error_to_message(error_code) + + # Strip trailing dot to match error message from os.mkdir(). + if error_message and error_message[-1] == '.': + error_message = error_message[:-1] + + raise OSError( + None, # errno + error_message, # strerror + dir_name, # filename + error_code, # winerror + None, # filename2 + ) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/_pyi_rth_utils/qt.py b/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/_pyi_rth_utils/qt.py new file mode 100755 index 0000000..b406677 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/_pyi_rth_utils/qt.py @@ -0,0 +1,118 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +# ----------------------------------------------------------------------------- + +import os +import importlib +import atexit + +# Helper for ensuring that only one Qt bindings package is registered at run-time via run-time hooks. +_registered_qt_bindings = None + + +def ensure_single_qt_bindings_package(qt_bindings): + global _registered_qt_bindings + if _registered_qt_bindings is not None: + raise RuntimeError( + f"Cannot execute run-time hook for {qt_bindings!r} because run-time hook for {_registered_qt_bindings!r} " + "has been run before, and PyInstaller-frozen applications do not support multiple Qt bindings in the same " + "application!" + ) + _registered_qt_bindings = qt_bindings + + +# Helper for relocating Qt prefix via embedded qt.conf file. +_QT_CONF_FILENAME = ":/qt/etc/qt.conf" + +_QT_CONF_RESOURCE_NAME = ( + # qt + b"\x00\x02" + b"\x00\x00\x07\x84" + b"\x00\x71" + b"\x00\x74" + # etc + b"\x00\x03" + b"\x00\x00\x6c\xa3" + b"\x00\x65" + b"\x00\x74\x00\x63" + # qt.conf + b"\x00\x07" + b"\x08\x74\xa6\xa6" + b"\x00\x71" + b"\x00\x74\x00\x2e\x00\x63\x00\x6f\x00\x6e\x00\x66" +) + +_QT_CONF_RESOURCE_STRUCT = ( + # : + b"\x00\x00\x00\x00\x00\x02\x00\x00\x00\x01\x00\x00\x00\x01" + # :/qt + b"\x00\x00\x00\x00\x00\x02\x00\x00\x00\x01\x00\x00\x00\x02" + # :/qt/etc + b"\x00\x00\x00\x0a\x00\x02\x00\x00\x00\x01\x00\x00\x00\x03" + # :/qt/etc/qt.conf + b"\x00\x00\x00\x16\x00\x00\x00\x00\x00\x01\x00\x00\x00\x00" +) + + +def create_embedded_qt_conf(qt_bindings, prefix_path): + # The QtCore module might be unavailable if we collected just the top-level binding package (e.g., PyQt5) without + # any of its submodules. Since this helper is called from run-time hook for the binding package, we need to handle + # that scenario here. + try: + QtCore = importlib.import_module(qt_bindings + ".QtCore") + except ImportError: + return + + # No-op if embedded qt.conf already exists + if QtCore.QFile.exists(_QT_CONF_FILENAME): + return + + # Create qt.conf file that relocates Qt prefix. + # NOTE: paths should use POSIX-style forward slashes as separator, even on Windows. + if os.sep == '\\': + prefix_path = prefix_path.replace(os.sep, '/') + + qt_conf = f"[Paths]\nPrefix = {prefix_path}\n" + if os.name == 'nt' and qt_bindings in {"PySide2", "PySide6"}: + # PySide PyPI wheels on Windows set LibraryExecutablesPath to PrefixPath + qt_conf += f"LibraryExecutables = {prefix_path}" + + # Encode the contents; in Qt5, QSettings uses Latin1 encoding, in Qt6, it uses UTF8. + if qt_bindings in {"PySide2", "PyQt5"}: + qt_conf = qt_conf.encode("latin1") + else: + qt_conf = qt_conf.encode("utf-8") + + # Prepend data size (32-bit integer, big endian) + qt_conf_size = len(qt_conf) + qt_resource_data = qt_conf_size.to_bytes(4, 'big') + qt_conf + + # Register + succeeded = QtCore.qRegisterResourceData( + 0x01, + _QT_CONF_RESOURCE_STRUCT, + _QT_CONF_RESOURCE_NAME, + qt_resource_data, + ) + if not succeeded: + return # Tough luck + + # Unregister the resource at exit, to ensure that the registered resource on Qt/C++ side does not outlive the + # `_qt_resource_data` python variable and its data buffer. This also adds a reference to the `_qt_resource_data`, + # which conveniently ensures that the data is not garbage collected before we perform the cleanup (otherwise garbage + # collector might kick in at any time after we exit this helper function, and `qRegisterResourceData` does not seem + # to make a copy of the data!). + atexit.register( + QtCore.qUnregisterResourceData, + 0x01, + _QT_CONF_RESOURCE_STRUCT, + _QT_CONF_RESOURCE_NAME, + qt_resource_data, + ) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/_pyi_rth_utils/tempfile.py b/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/_pyi_rth_utils/tempfile.py new file mode 100755 index 0000000..da2307b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/_pyi_rth_utils/tempfile.py @@ -0,0 +1,56 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +# ----------------------------------------------------------------------------- + +import os +import sys +import errno +import tempfile + +# Helper for creating temporary directories with access restricted to the user running the process. +# On POSIX systems, this is already achieved by `tempfile.mkdtemp`, which uses 0o700 permissions mask. +# On Windows, however, the POSIX permissions semantics have no effect, and we need to provide our own implementation +# that restricts the access by passing appropriate security attributes to the `CreateDirectory` function. + +if os.name == 'nt': + from . import _win32 + + def secure_mkdtemp(suffix=None, prefix=None, dir=None): + """ + Windows-specific replacement for `tempfile.mkdtemp` that restricts access to the user running the process. + Based on `mkdtemp` implementation from python 3.11 stdlib. + """ + + prefix, suffix, dir, output_type = tempfile._sanitize_params(prefix, suffix, dir) + + names = tempfile._get_candidate_names() + if output_type is bytes: + names = map(os.fsencode, names) + + for seq in range(tempfile.TMP_MAX): + name = next(names) + file = os.path.join(dir, prefix + name + suffix) + sys.audit("tempfile.mkdtemp", file) + try: + _win32.secure_mkdir(file) + except FileExistsError: + continue # try again + except PermissionError: + # This exception is thrown when a directory with the chosen name already exists on windows. + if (os.name == 'nt' and os.path.isdir(dir) and os.access(dir, os.W_OK)): + continue + else: + raise + return file + + raise FileExistsError(errno.EEXIST, "No usable temporary directory name found") + +else: + secure_mkdtemp = tempfile.mkdtemp diff --git a/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/pyi_splash.py b/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/pyi_splash.py new file mode 100755 index 0000000..3eb5719 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/fake-modules/pyi_splash.py @@ -0,0 +1,211 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +# ----------------------------------------------------------------------------- + +# This module is not a "fake module" in the classical sense, but a real module that can be imported. It acts as an RPC +# interface for the functions of the bootloader. +""" +This module connects to the bootloader to send messages to the splash screen. + +It is intended to act as a RPC interface for the functions provided by the bootloader, such as displaying text or +closing. This makes the users python program independent of how the communication with the bootloader is implemented, +since a consistent API is provided. + +To connect to the bootloader, it connects to a local tcp socket whose port is passed through the environment variable +'_PYI_SPLASH_IPC'. The bootloader creates a server socket and accepts every connection request. Since the os-module, +which is needed to request the environment variable, is not available at boot time, the module does not establish the +connection until initialization. + +The protocol by which the Python interpreter communicates with the bootloader is implemented in this module. + +This module does not support reloads while the splash screen is displayed, i.e. it cannot be reloaded (such as by +importlib.reload), because the splash screen closes automatically when the connection to this instance of the module +is lost. +""" + +import atexit +import os + +# Import the _socket module instead of the socket module. All used functions to connect to the ipc system are +# provided by the C module and the users program does not necessarily need to include the socket module and all +# required modules it uses. +import _socket + +__all__ = ["CLOSE_CONNECTION", "FLUSH_CHARACTER", "is_alive", "close", "update_text"] + +try: + # The user might have excluded logging from imports. + import logging as _logging +except ImportError: + _logging = None + +try: + # The user might have excluded functools from imports. + from functools import update_wrapper +except ImportError: + update_wrapper = None + + +# Utility +def _log(level, msg, *args, **kwargs): + """ + Conditional wrapper around logging module. If the user excluded logging from the imports or it was not imported, + this function should handle it and avoid using the logger. + """ + if _logging: + logger = _logging.getLogger(__name__) + logger.log(level, msg, *args, **kwargs) + + +# These constants define single characters which are needed to send commands to the bootloader. Those constants are +# also set in the tcl script. +CLOSE_CONNECTION = b'\x04' # ASCII End-of-Transmission character +FLUSH_CHARACTER = b'\x0D' # ASCII Carriage Return character + +# Module internal variables +_initialized = False +# Keep these variables always synchronized +_ipc_socket_closed = True +_ipc_socket = _socket.socket(_socket.AF_INET, _socket.SOCK_STREAM) + + +def _initialize(): + """ + Initialize this module + + :return: + """ + global _initialized, _ipc_socket_closed + + # If _ipc_port is zero, the splash screen is intentionally suppressed (for example, we are in sub-process spawned + # via sys.executable). Mark the splash screen as initialized, but do not attempt to connect. + if _ipc_port == 0: + _initialized = True + return + + # Attempt to connect to the splash screen process. + try: + _ipc_socket.connect(("127.0.0.1", _ipc_port)) + _ipc_socket_closed = False + + _initialized = True + _log(10, "IPC connection to the splash screen was successfully established.") # log-level: debug + except OSError as err: + raise ConnectionError(f"Could not connect to TCP port {_ipc_port}.") from err + + +# We expect a splash screen from the bootloader, but if _PYI_SPLASH_IPC is not set, the module cannot connect to it. +# _PYI_SPLASH_IPC being set to zero indicates that splash screen should be (gracefully) suppressed; i.e., the calls +# in this module should become no-op without generating warning messages. +try: + _ipc_port = int(os.environ['_PYI_SPLASH_IPC']) + del os.environ['_PYI_SPLASH_IPC'] + # Initialize the connection upon importing this module. This will establish a connection to the bootloader's TCP + # server socket. + _initialize() +except (KeyError, ValueError): + # log-level: warning + _log( + 30, + "The environment does not allow connecting to the splash screen. Did bootloader fail to initialize it?", + exc_info=True, + ) +except ConnectionError: + # log-level: error + _log(40, "Failed to connect to the bootloader's IPC server!", exc_info=True) + + +def _check_connection(func): + """ + Utility decorator for checking whether the function should be executed. + + The wrapped function may raise a ConnectionError if the module was not initialized correctly. + """ + def wrapper(*args, **kwargs): + """ + Executes the wrapped function if the environment allows it. + + That is, if the connection to to bootloader has not been closed and the module is initialized. + + :raises RuntimeError: if the module was not initialized correctly. + """ + if _initialized and _ipc_socket_closed: + if _ipc_port != 0: + _log(10, "Connection to splash screen has already been closed.") # log-level: debug + return + elif not _initialized: + raise RuntimeError("This module is not initialized; did it fail to load?") + + return func(*args, **kwargs) + + if update_wrapper: + # For runtime introspection + update_wrapper(wrapper, func) + + return wrapper + + +@_check_connection +def _send_command(cmd, args=None): + """ + Send the command followed by args to the splash screen. + + :param str cmd: The command to send. All command have to be defined as procedures in the tcl splash screen script. + :param list[str] args: All arguments to send to the receiving function + """ + if args is None: + args = [] + + full_cmd = "%s(%s)" % (cmd, " ".join(args)) + try: + _ipc_socket.sendall(full_cmd.encode("utf-8") + FLUSH_CHARACTER) + except OSError as err: + raise ConnectionError(f"Unable to send command {full_cmd!r} to the bootloader") from err + + +def is_alive(): + """ + Indicates whether the module can be used. + + Returns False if the module is either not initialized or was disabled by closing the splash screen. Otherwise, + the module should be usable. + """ + return _initialized and not _ipc_socket_closed + + +@_check_connection +def update_text(msg: str): + """ + Updates the text on the splash screen window. + + :param str msg: the text to be displayed + :raises ConnectionError: If the OS fails to write to the socket. + :raises RuntimeError: If the module is not initialized. + """ + _send_command("update_text", [msg]) + + +def close(): + """ + Close the connection to the ipc tcp server socket. + + This will close the splash screen and renders this module unusable. After this function is called, no connection + can be opened to the splash screen again and all functions in this module become unusable. + """ + global _ipc_socket_closed + if _initialized and not _ipc_socket_closed: + _ipc_socket.sendall(CLOSE_CONNECTION) + _ipc_socket.close() + _ipc_socket_closed = True + + +@atexit.register +def _exit(): + close() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/__init__.py new file mode 100755 index 0000000..792d600 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/__init__.py @@ -0,0 +1 @@ +# diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PIL.Image.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PIL.Image.py new file mode 100755 index 0000000..1d9e029 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PIL.Image.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This hook was tested with Pillow 2.9.0 (Maintained fork of PIL): https://pypi.python.org/pypi/Pillow + +from PyInstaller.utils.hooks import collect_submodules + +# Include all PIL image plugins - module names containing 'ImagePlugin'. e.g. PIL.JpegImagePlugin +hiddenimports = collect_submodules('PIL', lambda name: 'ImagePlugin' in name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PIL.ImageFilter.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PIL.ImageFilter.py new file mode 100755 index 0000000..528694b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PIL.ImageFilter.py @@ -0,0 +1,13 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# Only used if installed, not mean to pull in numpy. +excludedimports = ["numpy"] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PIL.SpiderImagePlugin.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PIL.SpiderImagePlugin.py new file mode 100755 index 0000000..1b6466f --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PIL.SpiderImagePlugin.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# PIL's SpiderImagePlugin features a tkPhotoImage() method, which imports ImageTk (and thus brings in the whole Tcl/Tk +# library). Assume that if people are really using tkinter in their application, they will also import it directly. +excludedimports = ['tkinter'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PIL.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PIL.py new file mode 100755 index 0000000..b7a6849 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PIL.py @@ -0,0 +1,21 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This hook was tested with Pillow 2.9.0 (Maintained fork of PIL): +# https://pypi.python.org/pypi/Pillow + +# Ignore tkinter to prevent inclusion of Tcl/Tk library and other GUI libraries. Assume that if people are really using +# tkinter in their application, they will also import it directly and thus PyInstaller bundles the right GUI library. +excludedimports = ['tkinter', 'PyQt5', 'PySide2', 'PyQt6', 'PySide6'] + +# Similarly, prevent inclusion of IPython, which in turn ends up pulling in whole matplotlib, along with its optional +# GUI library dependencies. +excludedimports += ['IPython'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QAxContainer.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QAxContainer.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QAxContainer.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qsci.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qsci.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qsci.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt.py new file mode 100755 index 0000000..668d423 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt.py @@ -0,0 +1,29 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# When PyQt5.Qt is imported it implies the import of all PyQt5 modules. See +# http://pyqt.sourceforge.net/Docs/PyQt5/Qt.html. +import os + +from PyInstaller.utils.hooks import get_module_file_attribute + +# Only do this if PyQt5 is found. +mfi = get_module_file_attribute('PyQt5') +if mfi: + # Determine the name of all these modules by looking in the PyQt5 directory. + hiddenimports = [] + for f in os.listdir(os.path.dirname(mfi)): + root, ext = os.path.splitext(os.path.basename(f)) + if root.startswith('Qt') and root != 'Qt': + # On Linux and macOS, PyQt 5.14.1 has a ``.abi3`` suffix on all library names. Remove it. + if root.endswith('.abi3'): + root = root[:-5] + hiddenimports.append('PyQt5.' + root) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DAnimation.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DAnimation.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DAnimation.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DCore.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DCore.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DCore.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DExtras.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DExtras.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DExtras.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DInput.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DInput.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DInput.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DLogic.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DLogic.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DLogic.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DRender.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DRender.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.Qt3DRender.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtBluetooth.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtBluetooth.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtBluetooth.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtChart.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtChart.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtChart.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtCore.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtCore.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtCore.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtDBus.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtDBus.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtDBus.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtDataVisualization.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtDataVisualization.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtDataVisualization.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtDesigner.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtDesigner.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtDesigner.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtGui.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtGui.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtGui.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtHelp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtHelp.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtHelp.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtLocation.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtLocation.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtLocation.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtMacExtras.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtMacExtras.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtMacExtras.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtMultimedia.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtMultimedia.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtMultimedia.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtMultimediaWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtMultimediaWidgets.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtMultimediaWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtNetwork.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtNetwork.py new file mode 100755 index 0000000..1c8cc67 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtNetwork.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies, pyqt5_library_info + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) +binaries += pyqt5_library_info.collect_qtnetwork_files() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtNetworkAuth.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtNetworkAuth.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtNetworkAuth.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtNfc.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtNfc.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtNfc.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtOpenGL.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtOpenGL.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtOpenGL.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtPositioning.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtPositioning.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtPositioning.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtPrintSupport.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtPrintSupport.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtPrintSupport.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtPurchasing.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtPurchasing.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtPurchasing.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtQml.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtQml.py new file mode 100755 index 0000000..718d323 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtQml.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies, pyqt5_library_info + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) +qml_binaries, qml_datas = pyqt5_library_info.collect_qtqml_files() +binaries += qml_binaries +datas += qml_datas diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtQuick.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtQuick.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtQuick.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtQuick3D.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtQuick3D.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtQuick3D.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtQuickWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtQuickWidgets.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtQuickWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtRemoteObjects.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtRemoteObjects.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtRemoteObjects.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtScript.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtScript.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtScript.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtSensors.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtSensors.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtSensors.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtSerialPort.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtSerialPort.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtSerialPort.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtSql.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtSql.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtSql.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtSvg.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtSvg.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtSvg.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtTest.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtTest.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtTest.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtTextToSpeech.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtTextToSpeech.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtTextToSpeech.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebChannel.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebChannel.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebChannel.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebEngine.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebEngine.py new file mode 100755 index 0000000..7b67e1b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebEngine.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebEngineCore.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebEngineCore.py new file mode 100755 index 0000000..f575e0d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebEngineCore.py @@ -0,0 +1,22 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import \ + add_qt5_dependencies, pyqt5_library_info + +# Ensure PyQt5 is importable before adding info depending on it. +if pyqt5_library_info.version is not None: + hiddenimports, binaries, datas = add_qt5_dependencies(__file__) + + # Include helper process executable, translations, and resources. + webengine_binaries, webengine_datas = pyqt5_library_info.collect_qtwebengine_files() + binaries += webengine_binaries + datas += webengine_datas diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebEngineWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebEngineWidgets.py new file mode 100755 index 0000000..7b67e1b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebEngineWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebKit.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebKit.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebKit.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebKitWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebKitWidgets.py new file mode 100755 index 0000000..7b67e1b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebKitWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebSockets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebSockets.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWebSockets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWidgets.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWinExtras.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWinExtras.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtWinExtras.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtX11Extras.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtX11Extras.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtX11Extras.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtXml.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtXml.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtXml.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtXmlPatterns.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtXmlPatterns.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.QtXmlPatterns.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.py new file mode 100755 index 0000000..2325577 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.py @@ -0,0 +1,29 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import pyqt5_library_info, ensure_single_qt_bindings_package + +# Allow only one Qt bindings package to be collected in frozen application. +ensure_single_qt_bindings_package("PyQt5") + +# Only proceed if PyQt5 can be imported. +if pyqt5_library_info.version is not None: + hiddenimports = [ + # PyQt5.10 and earlier uses sip in an separate package; + 'sip', + # PyQt5.11 and later provides SIP in a private package. Support both. + 'PyQt5.sip', + # Imported via __import__ in PyQt5/__init__.py + 'pkgutil', + ] + + # Collect required Qt binaries. + binaries = pyqt5_library_info.collect_extra_binaries() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.uic.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.uic.py new file mode 100755 index 0000000..e4474dd --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt5.uic.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files + +# We need to include modules in PyQt5.uic.widget-plugins, so they can be dynamically loaded by uic. They should be +# included as separate (data-like) files, so they can be found by os.listdir and friends. However, as this directory +# is not a package, refer to it using the package (PyQt5.uic) followed by the subdirectory name (``widget-plugins/``). +datas = collect_data_files('PyQt5.uic', True, 'widget-plugins') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QAxContainer.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QAxContainer.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QAxContainer.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qsci.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qsci.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qsci.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DAnimation.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DAnimation.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DAnimation.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DCore.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DCore.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DCore.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DExtras.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DExtras.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DExtras.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DInput.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DInput.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DInput.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DLogic.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DLogic.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DLogic.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DRender.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DRender.py new file mode 100755 index 0000000..58ac06d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.Qt3DRender.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) + +hiddenimports += ["PyQt6.QtOpenGL"] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtBluetooth.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtBluetooth.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtBluetooth.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtCharts.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtCharts.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtCharts.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtCore.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtCore.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtCore.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtDBus.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtDBus.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtDBus.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtDataVisualization.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtDataVisualization.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtDataVisualization.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtDesigner.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtDesigner.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtDesigner.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtGraphs.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtGraphs.py new file mode 100755 index 0000000..17c60d1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtGraphs.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) + +# These dependencies cannot seem to be inferred from linked libraries. +hiddenimports += ['PyQt6.QtNetwork', 'PyQt6.QtQml'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtGraphsWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtGraphsWidgets.py new file mode 100755 index 0000000..c4cba93 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtGraphsWidgets.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) + +# These dependencies cannot seem to be inferred from linked libraries. +hiddenimports += ['PyQt6.QtGraphs', 'PyQt6.QtQuickWidgets'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtGui.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtGui.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtGui.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtHelp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtHelp.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtHelp.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtMultimedia.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtMultimedia.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtMultimedia.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtMultimediaWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtMultimediaWidgets.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtMultimediaWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtNetwork.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtNetwork.py new file mode 100755 index 0000000..c780c7c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtNetwork.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies, pyqt6_library_info + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) +binaries += pyqt6_library_info.collect_qtnetwork_files() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtNetworkAuth.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtNetworkAuth.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtNetworkAuth.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtNfc.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtNfc.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtNfc.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtOpenGL.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtOpenGL.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtOpenGL.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtOpenGLWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtOpenGLWidgets.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtOpenGLWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtPdf.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtPdf.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtPdf.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtPdfWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtPdfWidgets.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtPdfWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtPositioning.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtPositioning.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtPositioning.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtPrintSupport.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtPrintSupport.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtPrintSupport.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtQml.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtQml.py new file mode 100755 index 0000000..024696a --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtQml.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies, pyqt6_library_info + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) +qml_binaries, qml_datas = pyqt6_library_info.collect_qtqml_files() +binaries += qml_binaries +datas += qml_datas diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtQuick.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtQuick.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtQuick.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtQuick3D.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtQuick3D.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtQuick3D.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtQuickWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtQuickWidgets.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtQuickWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtRemoteObjects.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtRemoteObjects.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtRemoteObjects.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSensors.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSensors.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSensors.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSerialPort.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSerialPort.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSerialPort.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSpatialAudio.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSpatialAudio.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSpatialAudio.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSql.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSql.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSql.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtStateMachine.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtStateMachine.py new file mode 100755 index 0000000..b1b97aa --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtStateMachine.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2025, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) + +# This dependency cannot seem to be inferred from linked libraries (at least on Windows). +hiddenimports += ['PyQt6.QtGui'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSvg.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSvg.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSvg.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSvgWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSvgWidgets.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtSvgWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtTest.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtTest.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtTest.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtTextToSpeech.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtTextToSpeech.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtTextToSpeech.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebChannel.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebChannel.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebChannel.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebEngineCore.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebEngineCore.py new file mode 100755 index 0000000..7eb593c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebEngineCore.py @@ -0,0 +1,27 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import \ + add_qt6_dependencies, pyqt6_library_info + +# Ensure PyQt6 is importable before adding info depending on it. +if pyqt6_library_info.version is not None: + # Qt6 prior to 6.2.2 contains a bug that makes it incompatible with the way PyInstaller collects + # QtWebEngine shared libraries and resources. So exit here and now instead of producing a defunct build. + if pyqt6_library_info.version < [6, 2, 2]: + raise SystemExit("ERROR: PyInstaller's QtWebEngine support requires Qt6 6.2.2 or later!") + + hiddenimports, binaries, datas = add_qt6_dependencies(__file__) + + # Include helper process executable, translations, and resources. + webengine_binaries, webengine_datas = pyqt6_library_info.collect_qtwebengine_files() + binaries += webengine_binaries + datas += webengine_datas diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebEngineQuick.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebEngineQuick.py new file mode 100755 index 0000000..19083de --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebEngineQuick.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebEngineWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebEngineWidgets.py new file mode 100755 index 0000000..19083de --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebEngineWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebSockets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebSockets.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWebSockets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWidgets.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtXml.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtXml.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.QtXml.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.py new file mode 100755 index 0000000..b9e2f51 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.py @@ -0,0 +1,26 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import pyqt6_library_info, ensure_single_qt_bindings_package + +# Allow only one Qt bindings package to be collected in frozen application. +ensure_single_qt_bindings_package("PyQt6") + +# Only proceed if PyQt6 can be imported. +if pyqt6_library_info.version is not None: + hiddenimports = [ + 'PyQt6.sip', + # Imported via __import__ in PyQt6/__init__.py + 'pkgutil', + ] + + # Collect required Qt binaries. + binaries = pyqt6_library_info.collect_extra_binaries() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.uic.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.uic.py new file mode 100755 index 0000000..7744cbc --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PyQt6.uic.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files + +# We need to include modules in PyQt6.uic.widget-plugins, so they can be dynamically loaded by uic. They should be +# included as separate (data-like) files, so they can be found by os.listdir and friends. However, as this directory +# is not a package, refer to it using the package (PyQt6.uic) followed by the subdirectory name (``widget-plugins/``). +datas = collect_data_files('PyQt6.uic', True, 'widget-plugins') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DAnimation.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DAnimation.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DAnimation.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DCore.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DCore.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DCore.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DExtras.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DExtras.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DExtras.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DInput.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DInput.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DInput.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DLogic.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DLogic.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DLogic.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DRender.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DRender.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qt3DRender.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtAxContainer.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtAxContainer.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtAxContainer.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtCharts.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtCharts.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtCharts.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtConcurrent.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtConcurrent.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtConcurrent.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtCore.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtCore.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtCore.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtDataVisualization.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtDataVisualization.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtDataVisualization.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtGui.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtGui.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtGui.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtHelp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtHelp.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtHelp.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtLocation.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtLocation.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtLocation.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtMacExtras.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtMacExtras.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtMacExtras.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtMultimedia.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtMultimedia.py new file mode 100755 index 0000000..1f3f908 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtMultimedia.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) + +# Using PySide2 true_properties ("from __feature__ import true_properties") causes a hidden dependency on +# QtMultimediaWidgets python module: +# https://github.com/qtproject/pyside-pyside-setup/blob/5.15.2/sources/shiboken2/shibokenmodule/files.dir/shibokensupport/signature/mapping.py#L577-L586 +hiddenimports += ['PySide2.QtMultimediaWidgets'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtMultimediaWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtMultimediaWidgets.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtMultimediaWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtNetwork.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtNetwork.py new file mode 100755 index 0000000..4e62091 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtNetwork.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies, pyside2_library_info + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) +binaries += pyside2_library_info.collect_qtnetwork_files() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtOpenGL.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtOpenGL.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtOpenGL.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtOpenGLFunctions.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtOpenGLFunctions.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtOpenGLFunctions.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtPositioning.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtPositioning.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtPositioning.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtPrintSupport.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtPrintSupport.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtPrintSupport.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtQml.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtQml.py new file mode 100755 index 0000000..a9f7162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtQml.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies, pyside2_library_info + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) +qml_binaries, qml_datas = pyside2_library_info.collect_qtqml_files() +binaries += qml_binaries +datas += qml_datas + +hiddenimports += ["PySide2.QtGui"] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtQuick.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtQuick.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtQuick.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtQuickControls2.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtQuickControls2.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtQuickControls2.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtQuickWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtQuickWidgets.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtQuickWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtRemoteObjects.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtRemoteObjects.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtRemoteObjects.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtScript.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtScript.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtScript.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtScriptTools.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtScriptTools.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtScriptTools.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtScxml.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtScxml.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtScxml.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtSensors.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtSensors.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtSensors.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtSerialPort.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtSerialPort.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtSerialPort.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtSql.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtSql.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtSql.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtSvg.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtSvg.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtSvg.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtTest.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtTest.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtTest.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtTextToSpeech.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtTextToSpeech.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtTextToSpeech.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtUiTools.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtUiTools.py new file mode 100755 index 0000000..9f47776 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtUiTools.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) +hiddenimports += ['PySide2.QtXml'] # Not inferred from dynamic lib analysis diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebChannel.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebChannel.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebChannel.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebEngine.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebEngine.py new file mode 100755 index 0000000..7b67e1b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebEngine.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebEngineCore.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebEngineCore.py new file mode 100755 index 0000000..afb578e --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebEngineCore.py @@ -0,0 +1,22 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import \ + add_qt5_dependencies, pyside2_library_info + +# Ensure PySide2 is importable before adding info depending on it. +if pyside2_library_info.version is not None: + hiddenimports, binaries, datas = add_qt5_dependencies(__file__) + + # Include helper process executable, translations, and resources. + webengine_binaries, webengine_datas = pyside2_library_info.collect_qtwebengine_files() + binaries += webengine_binaries + datas += webengine_datas diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebEngineWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebEngineWidgets.py new file mode 100755 index 0000000..7b67e1b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebEngineWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebKit.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebKit.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebKit.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebKitWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebKitWidgets.py new file mode 100755 index 0000000..7b67e1b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebKitWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebSockets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebSockets.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWebSockets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWidgets.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWinExtras.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWinExtras.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtWinExtras.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtX11Extras.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtX11Extras.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtX11Extras.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtXml.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtXml.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtXml.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtXmlPatterns.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtXmlPatterns.py new file mode 100755 index 0000000..51258b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.QtXmlPatterns.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt5_dependencies + +hiddenimports, binaries, datas = add_qt5_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qwt5.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qwt5.py new file mode 100755 index 0000000..57f3c22 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.Qwt5.py @@ -0,0 +1,31 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import isolated + +hiddenimports = ['PySide2.QtCore', 'PySide2.QtWidgets', 'PySide2.QtGui', 'PySide2.QtSvg'] + + +@isolated.decorate +def conditional_imports(): + from PySide2 import Qwt5 + + out = [] + if hasattr(Qwt5, "toNumpy"): + out.append("numpy") + if hasattr(Qwt5, "toNumeric"): + out.append("numeric") + if hasattr(Qwt5, "toNumarray"): + out.append("numarray") + return out + + +hiddenimports += conditional_imports() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.py new file mode 100755 index 0000000..aa7a714 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide2.py @@ -0,0 +1,25 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import pyside2_library_info, ensure_single_qt_bindings_package + +# Allow only one Qt bindings package to be collected in frozen application. +ensure_single_qt_bindings_package("PySide2") + +# Only proceed if PySide2 can be imported. +if pyside2_library_info.version is not None: + hiddenimports = ['shiboken2', 'inspect'] + if pyside2_library_info.version < [5, 15]: + # The shiboken2 bootstrap in earlier releases requires __future__ in addition to inspect + hiddenimports += ['__future__'] + + # Collect required Qt binaries. + binaries = pyside2_library_info.collect_extra_binaries() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DAnimation.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DAnimation.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DAnimation.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DCore.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DCore.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DCore.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DExtras.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DExtras.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DExtras.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DInput.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DInput.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DInput.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DLogic.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DLogic.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DLogic.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DRender.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DRender.py new file mode 100755 index 0000000..2bb9b83 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.Qt3DRender.py @@ -0,0 +1,20 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies, pyside6_library_info + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) + +# In PySide 6.7.0, Qt3DRender module added a reference to QtOpenGL type system. The hidden import is required on +# Windows, while on macOS and Linux we seem to pick it up automatically due to the corresponding Qt shared library +# appearing among binary dependencies. Keep it around on all OSes, though - just in case this ever changes. +if pyside6_library_info.version is not None and pyside6_library_info.version >= [6, 7]: + hiddenimports += ['PySide6.QtOpenGL'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtAxContainer.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtAxContainer.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtAxContainer.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtBluetooth.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtBluetooth.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtBluetooth.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtCharts.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtCharts.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtCharts.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtConcurrent.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtConcurrent.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtConcurrent.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtCore.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtCore.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtCore.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtDBus.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtDBus.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtDBus.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtDataVisualization.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtDataVisualization.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtDataVisualization.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtDesigner.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtDesigner.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtDesigner.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtGraphs.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtGraphs.py new file mode 100755 index 0000000..00941c0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtGraphs.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtGraphsWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtGraphsWidgets.py new file mode 100755 index 0000000..91ae027 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtGraphsWidgets.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) + +# These dependencies cannot seem to be inferred from linked libraries. +hiddenimports += ['PySide6.QtQuickWidgets', 'PySide6.QtGraphs'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtGui.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtGui.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtGui.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtHelp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtHelp.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtHelp.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtHttpServer.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtHttpServer.py new file mode 100755 index 0000000..790cb11 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtHttpServer.py @@ -0,0 +1,18 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) + +# This seems to be necessary on Windows; on other OSes, it is inferred automatically because the extension is linked +# against the Qt6Concurrent shared library. +hiddenimports += ['PySide6.QtConcurrent'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtLocation.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtLocation.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtLocation.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtMultimedia.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtMultimedia.py new file mode 100755 index 0000000..0c2d31b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtMultimedia.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) + +# Using PySide6 true_properties ("from __feature__ import true_properties") causes a hidden dependency on +# QtMultimediaWidgets python module: +# https://github.com/qtproject/pyside-pyside-setup/blob/v6.2.2.1/sources/shiboken6/shibokenmodule/files.dir/shibokensupport/signature/mapping.py#L614-L627 +hiddenimports += ['PySide6.QtMultimediaWidgets'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtMultimediaWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtMultimediaWidgets.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtMultimediaWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtNetwork.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtNetwork.py new file mode 100755 index 0000000..a216ecd --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtNetwork.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies, pyside6_library_info + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) +binaries += pyside6_library_info.collect_qtnetwork_files() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtNetworkAuth.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtNetworkAuth.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtNetworkAuth.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtNfc.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtNfc.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtNfc.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtOpenGL.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtOpenGL.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtOpenGL.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtOpenGLWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtOpenGLWidgets.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtOpenGLWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtPdf.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtPdf.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtPdf.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtPdfWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtPdfWidgets.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtPdfWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtPositioning.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtPositioning.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtPositioning.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtPrintSupport.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtPrintSupport.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtPrintSupport.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQml.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQml.py new file mode 100755 index 0000000..8b6837d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQml.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies, pyside6_library_info + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) +qml_binaries, qml_datas = pyside6_library_info.collect_qtqml_files() +binaries += qml_binaries +datas += qml_datas diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQuick.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQuick.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQuick.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQuick3D.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQuick3D.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQuick3D.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQuickControls2.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQuickControls2.py new file mode 100755 index 0000000..b405fc6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQuickControls2.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) + +hiddenimports += ['PySide6.QtQuick'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQuickWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQuickWidgets.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtQuickWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtRemoteObjects.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtRemoteObjects.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtRemoteObjects.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtScxml.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtScxml.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtScxml.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSensors.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSensors.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSensors.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSerialBus.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSerialBus.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSerialBus.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSerialPort.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSerialPort.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSerialPort.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSpatialAudio.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSpatialAudio.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSpatialAudio.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSql.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSql.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSql.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtStateMachine.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtStateMachine.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtStateMachine.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSvg.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSvg.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSvg.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSvgWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSvgWidgets.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtSvgWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtTest.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtTest.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtTest.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtTextToSpeech.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtTextToSpeech.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtTextToSpeech.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtUiTools.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtUiTools.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtUiTools.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebChannel.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebChannel.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebChannel.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebEngineCore.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebEngineCore.py new file mode 100755 index 0000000..06e05f8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebEngineCore.py @@ -0,0 +1,29 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import \ + add_qt6_dependencies, pyside6_library_info + +# Ensure PySide6 is importable before adding info depending on it. +if pyside6_library_info.version is not None: + # Qt6 prior to 6.2.2 contains a bug that makes it incompatible with the way PyInstaller collects + # QtWebEngine shared libraries and resources. So exit here and now instead of producing a defunct build. + if pyside6_library_info.version < [6, 2, 2]: + raise SystemExit("ERROR: PyInstaller's QtWebEngine support requires Qt6 6.2.2 or later!") + + hiddenimports, binaries, datas = add_qt6_dependencies(__file__) + + # Include helper process executable, translations, and resources. + webengine_binaries, webengine_datas = pyside6_library_info.collect_qtwebengine_files() + binaries += webengine_binaries + datas += webengine_datas + + hiddenimports += ['PySide6.QtPrintSupport'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebEngineQuick.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebEngineQuick.py new file mode 100755 index 0000000..19083de --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebEngineQuick.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebEngineWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebEngineWidgets.py new file mode 100755 index 0000000..19083de --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebEngineWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebSockets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebSockets.py new file mode 100755 index 0000000..49d27d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWebSockets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWidgets.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWidgets.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtWidgets.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtXml.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtXml.py new file mode 100755 index 0000000..edd5cd1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.QtXml.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.qt import add_qt6_dependencies + +hiddenimports, binaries, datas = add_qt6_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.py new file mode 100755 index 0000000..30e2ee6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-PySide6.py @@ -0,0 +1,28 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import check_requirement +from PyInstaller.utils.hooks.qt import pyside6_library_info, ensure_single_qt_bindings_package + +# Allow only one Qt bindings package to be collected in frozen application. +ensure_single_qt_bindings_package("PySide6") + +# Only proceed if PySide6 can be imported. +if pyside6_library_info.version is not None: + hiddenimports = ['shiboken6', 'inspect'] + + # Starting with PySide6 6.4.0, we need to collect PySide6.support.deprecated for | and & operators to work with + # Qt key and key modifiers enums. See #7249. + if check_requirement("PySide6 >= 6.4.0"): + hiddenimports += ['PySide6.support.deprecated'] + + # Collect required Qt binaries. + binaries = pyside6_library_info.collect_extra_binaries() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-_ctypes.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-_ctypes.py new file mode 100755 index 0000000..d9ccf8c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-_ctypes.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import compat + +# During python 3.14 development cycle, ctypes struct/union layout logic has been moved from `_ctypes` extension into +# Python, i.e., `ctypes._layout` module: https://github.com/python/cpython/pull/123352 +# Since this module is referenced only from the `_ctypes` extension, it needs to be added to hidden imports, at least on +# Windows and macOS. +if compat.is_py314: + hiddenimports = ['ctypes._layout'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-_osx_support.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-_osx_support.py new file mode 100755 index 0000000..a3a69d5 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-_osx_support.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2025, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# Prevent conditional import of `distutils` in `_osx_support.compiler_fixup()` in python < 3.10 from pulling in +# `distutils`; this function is called only from `distutils` itself, which ensures that the module is available as +# needed. Blocking this import prevents `distutils` (and nowadays `setuptools`) from being pulled into even very +# basic applications when built with python < 3.10. +# +# See: https://github.com/python/cpython/blob/f3994ade31a563d49806cf6a681d1b1115fccaa3/Lib/_osx_support.py#L430-L434 + +excludedimports = ['distutils'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-_pyi_rth_utils.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-_pyi_rth_utils.py new file mode 100755 index 0000000..cbd93aa --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-_pyi_rth_utils.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import compat + +# Exclude submodules specific to non-applicable OSes +excludedimports = [] +if not compat.is_win: + excludedimports += ['_pyi_rth_utils._win32'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-_tkinter.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-_tkinter.py new file mode 100755 index 0000000..7f21b49 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-_tkinter.py @@ -0,0 +1,22 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.tcl_tk import tcltk_info + + +def hook(hook_api): + # Add all Tcl/Tk data files, based on the `TclTkInfo.data_files`. If Tcl/Tk is unavailable, the list is empty. + # + # NOTE: the list contains 3-element TOC tuples with full destination filenames (because other parts of code, + # specifically splash-screen writer, currently require this format). Therefore, we need to use + # `PostGraphAPI.add_datas` (which supports 3-element TOC tuples); if this was 2-element "hook-style" TOC list, + # we could just assign `datas` global hook variable, without implementing the post-graph `hook()` function. + hook_api.add_datas(tcltk_info.data_files) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-babel.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-babel.py new file mode 100755 index 0000000..5f03a97 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-babel.py @@ -0,0 +1,24 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files + +# Ensure that .dat files from locale-data sub-directory are collected. +datas = collect_data_files('babel') + +# Unpickling of locale-data/root.dat currently (babel v2.16.0) requires classes from following modules, so ensure that +# they are always collected: +hiddenimports = [ + "babel.dates", + "babel.localedata", + "babel.plural", + "babel.numbers", +] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-difflib.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-difflib.py new file mode 100755 index 0000000..2416758 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-difflib.py @@ -0,0 +1,13 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# only required when run as `__main__` +excludedimports = ["doctest"] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-distutils.command.check.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-distutils.command.check.py new file mode 100755 index 0000000..50a17d4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-distutils.command.check.py @@ -0,0 +1,13 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# Conditionally imported in this module; should not trigger collection. +excludedimports = ['docutils'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-distutils.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-distutils.py new file mode 100755 index 0000000..c9cd63b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-distutils.py @@ -0,0 +1,33 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.setuptools import setuptools_info + +hiddenimports = [] + +# From Python 3.6 and later ``distutils.sysconfig`` takes on the same behaviour as regular ``sysconfig`` of moving the +# config vars to a module (see hook-sysconfig.py). It doesn't use a nice `get module name` function like ``sysconfig`` +# does to help us locate it but the module is the same file that ``sysconfig`` uses so we can use the +# ``_get_sysconfigdata_name()`` from regular ``sysconfig``. +try: + import sysconfig + hiddenimports += [sysconfig._get_sysconfigdata_name()] +except AttributeError: + # Either sysconfig has no attribute _get_sysconfigdata_name (i.e., the function does not exist), or this is Windows + # and the _get_sysconfigdata_name() call failed due to missing sys.abiflags attribute. + pass + +# Starting with setuptools 60.0, the vendored distutils overrides the stdlib one (which will be removed in python 3.12 +# anyway), so check if we are using that version. While the distutils override behavior can be controleld via the +# ``SETUPTOOLS_USE_DISTUTILS`` environment variable, the latter may have a different value during the build and at the +# runtime, and so we need to ensure that both stdlib and setuptools variant of distutils are collected. +if setuptools_info.available and setuptools_info.version >= (60, 0): + hiddenimports += ['setuptools._distutils'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-distutils.util.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-distutils.util.py new file mode 100755 index 0000000..021d459 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-distutils.util.py @@ -0,0 +1,13 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# distutils.util.run_2to3() imports lib2to3. Exclude it as chances are low that it is used by the frozen package. +excludedimports = ['lib2to3.refactor'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.contrib.sessions.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.contrib.sessions.py new file mode 100755 index 0000000..5d86e6c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.contrib.sessions.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('django.contrib.sessions.backends') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.core.cache.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.core.cache.py new file mode 100755 index 0000000..eb319c7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.core.cache.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('django.core.cache.backends') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.core.mail.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.core.mail.py new file mode 100755 index 0000000..1cee61c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.core.mail.py @@ -0,0 +1,25 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +django.core.mail uses part of the email package. +The problem is: when using runserver with autoreload mode, the thread that checks for changed files triggers further +imports within the email package, because of the LazyImporter in email (used in 2.5 for backward compatibility). +We then need to name those modules as hidden imports, otherwise at runtime the autoreload thread will complain +with a traceback. +""" + +hiddenimports = [ + 'email.mime.message', + 'email.mime.image', + 'email.mime.text', + 'email.mime.multipart', + 'email.mime.audio', +] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.core.management.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.core.management.py new file mode 100755 index 0000000..a8566e0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.core.management.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_submodules + +# Module django.core.management.commands.shell imports IPython, but it introduces many other dependencies that are not +# necessary for a simple django project; ignore the IPython module. +excludedimports = ['IPython', 'matplotlib', 'tkinter'] + +# Django requires management modules for the script 'manage.py'. +hiddenimports = collect_submodules('django.core.management.commands') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.db.backends.mysql.base.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.db.backends.mysql.base.py new file mode 100755 index 0000000..951899e --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.db.backends.mysql.base.py @@ -0,0 +1,13 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# Compiler module (see class DatabaseOperations) +hiddenimports = ["django.db.backends.mysql.compiler"] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.db.backends.oracle.base.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.db.backends.oracle.base.py new file mode 100755 index 0000000..d50eb97 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.db.backends.oracle.base.py @@ -0,0 +1,12 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +hiddenimports = ["django.db.backends.oracle.compiler"] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.db.backends.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.db.backends.py new file mode 100755 index 0000000..e829fe7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.db.backends.py @@ -0,0 +1,25 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import glob +import os + +from PyInstaller.utils.hooks import get_module_file_attribute + +# Compiler (see class BaseDatabaseOperations) +hiddenimports = ['django.db.models.sql.compiler'] + +# Include all available Django backends. +modpath = os.path.dirname(get_module_file_attribute('django.db.backends')) +for fn in glob.glob(os.path.join(modpath, '*')): + if os.path.isdir(fn): + fn = os.path.basename(fn) + hiddenimports.append('django.db.backends.' + fn + '.base') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.py new file mode 100755 index 0000000..4a8ee04 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.py @@ -0,0 +1,92 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# Tested with django 2.2 + +import glob +import os + +from PyInstaller import log as logging +from PyInstaller.utils import hooks +from PyInstaller.utils.hooks import django + +logger = logging.getLogger(__name__) + +# Collect everything. Some submodules of django are not importable without considerable external setup. Ignore the +# errors they raise. +datas, binaries, hiddenimports = hooks.collect_all('django', on_error="ignore") + +root_dir = django.django_find_root_dir() +if root_dir: + logger.info('Django root directory %s', root_dir) + # Include imports from the mysite.settings.py module. + settings_py_imports = django.django_dottedstring_imports(root_dir) + # Include all submodules of all imports detected in mysite.settings.py. + for submod in settings_py_imports: + hiddenimports.append(submod) + hiddenimports += hooks.collect_submodules(submod) + # Include main django modules - settings.py, urls.py, wsgi.py. Without them the django server won't run. + package_name = os.path.basename(root_dir) + default_settings_module = f'{package_name}.settings' + settings_module = os.environ.get('DJANGO_SETTINGS_MODULE', default_settings_module) + hiddenimports += [ + # TODO: consider including 'mysite.settings.py' in source code as a data files, + # since users might need to edit this file. + settings_module, + package_name + '.urls', + package_name + '.wsgi', + ] + # Django hiddenimports from the standard Python library. + hiddenimports += [ + 'http.cookies', + 'html.parser', + ] + + # Bundle django DB schema migration scripts as data files. They are necessary for some commands. + logger.info('Collecting Django migration scripts.') + migration_modules = [ + 'django.conf.app_template.migrations', + 'django.contrib.admin.migrations', + 'django.contrib.auth.migrations', + 'django.contrib.contenttypes.migrations', + 'django.contrib.flatpages.migrations', + 'django.contrib.redirects.migrations', + 'django.contrib.sessions.migrations', + 'django.contrib.sites.migrations', + ] + # Include migration scripts of Django-based apps too. + installed_apps = hooks.get_module_attribute(settings_module, 'INSTALLED_APPS') + migration_modules.extend(set(app + '.migrations' for app in installed_apps)) + # Copy migration files. + for mod in migration_modules: + mod_name, bundle_name = mod.split('.', 1) + mod_dir = os.path.dirname(hooks.get_module_file_attribute(mod_name)) + bundle_dir = bundle_name.replace('.', os.sep) + pattern = os.path.join(mod_dir, bundle_dir, '*.py') + files = glob.glob(pattern) + for f in files: + datas.append((f, os.path.join(mod_name, bundle_dir))) + + # Include data files from your Django project found in your django root package. + datas += hooks.collect_data_files(package_name) + + # Include database file if using sqlite. The sqlite database is usually next to the manage.py script. + root_dir_parent = os.path.dirname(root_dir) + # TODO Add more patterns if necessary. + _patterns = ['*.db', 'db.*'] + for p in _patterns: + files = glob.glob(os.path.join(root_dir_parent, p)) + for f in files: + # Place those files next to the executable. + datas.append((f, '.')) + +else: + logger.warning('No django root directory could be found!') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.template.loaders.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.template.loaders.py new file mode 100755 index 0000000..18b1374 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-django.template.loaders.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('django.template.loaders') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-encodings.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-encodings.py new file mode 100755 index 0000000..a4082e1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-encodings.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('encodings') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gevent.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gevent.py new file mode 100755 index 0000000..40ad953 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gevent.py @@ -0,0 +1,24 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_all, copy_metadata + +excludedimports = ["gevent.testing", "gevent.tests"] + +datas, binaries, hiddenimports = collect_all( + 'gevent', + filter_submodules=lambda name: ("gevent.testing" not in name or "gevent.tests" not in name), + include_py_files=False, + exclude_datas=["**/tests"] +) + +# Gevent uses ``pkg_resources.require("...")``, which means that all its dependencies must also have their metadata. +datas += copy_metadata('gevent', recursive=True) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.py new file mode 100755 index 0000000..78e3538 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.py @@ -0,0 +1,26 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import compat +from packaging.version import Version + +pygobject_version = Version(compat.importlib_metadata.version("pygobject")).release + +hiddenimports = ['gi._error', 'gi._option'] + +# PyGObject 3.50.0 added support for `asyncio`, and attempts to import inside the `_gi` extension. +if pygobject_version >= (3, 50, 0): + hiddenimports += ['asyncio'] + +# PyGobject 3.52.0 added `gi._enum`, which needs to be added to hiddenimports due to being imported from the +# `_gi` extension. +if pygobject_version >= (3, 52, 0): + hiddenimports += ['gi._enum'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Adw.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Adw.py new file mode 100755 index 0000000..3327e21 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Adw.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('Adw', '1') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.AppIndicator3.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.AppIndicator3.py new file mode 100755 index 0000000..4b9c894 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.AppIndicator3.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('AppIndicator3', '0.1') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Atk.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Atk.py new file mode 100755 index 0000000..b57ee3f --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Atk.py @@ -0,0 +1,29 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import get_hook_config +from PyInstaller.utils.hooks.gi import GiModuleInfo, collect_glib_translations + + +def hook(hook_api): + module_info = GiModuleInfo('Atk', '1.0') + if not module_info.available: + return + + binaries, datas, hiddenimports = module_info.collect_typelib_data() + + # Collect translations + lang_list = get_hook_config(hook_api, "gi", "languages") + datas += collect_glib_translations('atk10', lang_list) + + hook_api.add_datas(datas) + hook_api.add_binaries(binaries) + hook_api.add_imports(*hiddenimports) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.AyatanaAppIndicator3.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.AyatanaAppIndicator3.py new file mode 100755 index 0000000..36b178a --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.AyatanaAppIndicator3.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('AyatanaAppIndicator3', '0.1') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Champlain.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Champlain.py new file mode 100755 index 0000000..d48def3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Champlain.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('Champlain', '0.12') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Clutter.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Clutter.py new file mode 100755 index 0000000..9ad56a6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Clutter.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('Clutter', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.DBus.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.DBus.py new file mode 100755 index 0000000..0580fcb --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.DBus.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('DBus', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GIRepository.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GIRepository.py new file mode 100755 index 0000000..5c6961a --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GIRepository.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GIRepository', '2.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GLib.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GLib.py new file mode 100755 index 0000000..6aa236c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GLib.py @@ -0,0 +1,42 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import glob +import os + +from PyInstaller.compat import is_win +from PyInstaller.utils.hooks import get_hook_config +from PyInstaller.utils.hooks.gi import GiModuleInfo, collect_glib_share_files, collect_glib_translations + + +def hook(hook_api): + module_info = GiModuleInfo('GLib', '2.0') + if not module_info.available: + return + + binaries, datas, hiddenimports = module_info.collect_typelib_data() + + # Collect translations + lang_list = get_hook_config(hook_api, "gi", "languages") + datas += collect_glib_translations('glib20', lang_list) + + # Collect schemas + datas += collect_glib_share_files('glib-2.0', 'schemas') + + # On Windows, glib needs a spawn helper for g_spawn* API + if is_win: + pattern = os.path.join(module_info.get_libdir(), 'gspawn-*-helper*.exe') + for f in glob.glob(pattern): + binaries.append((f, '.')) + + hook_api.add_datas(datas) + hook_api.add_binaries(binaries) + hook_api.add_imports(*hiddenimports) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GModule.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GModule.py new file mode 100755 index 0000000..0ccaaaf --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GModule.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GModule', '2.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GObject.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GObject.py new file mode 100755 index 0000000..2171165 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GObject.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +from PyInstaller.utils.hooks import check_requirement +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GObject', '2.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() + # gi._gobject removed from PyGObject in version 3.25.1 + if check_requirement('PyGObject < 3.25.1'): + hiddenimports += ['gi._gobject'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gdk.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gdk.py new file mode 100755 index 0000000..99fbd08 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gdk.py @@ -0,0 +1,36 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo +from PyInstaller.utils.hooks import get_hook_config + + +def hook(hook_api): + # Use the Gdk version from hook config, if available. If not, try using Gtk version from hook config, so that we + # collect Gdk and Gtk of the same version. + module_versions = get_hook_config(hook_api, 'gi', 'module-versions') + if module_versions: + version = module_versions.get('Gdk') + if not version: + version = module_versions.get('Gtk', '3.0') + else: + version = '3.0' + + module_info = GiModuleInfo('Gdk', version) + if not module_info.available: + return + + binaries, datas, hiddenimports = module_info.collect_typelib_data() + hiddenimports += ['gi._gi_cairo', 'gi.repository.cairo'] + + hook_api.add_datas(datas) + hook_api.add_binaries(binaries) + hook_api.add_imports(*hiddenimports) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GdkPixbuf.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GdkPixbuf.py new file mode 100755 index 0000000..8126328 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GdkPixbuf.py @@ -0,0 +1,150 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import glob +import os +import shutil +import subprocess + +from PyInstaller import compat +from PyInstaller.config import CONF # workpath +from PyInstaller.utils.hooks import get_hook_config, logger +from PyInstaller.utils.hooks.gi import GiModuleInfo, collect_glib_translations + +LOADERS_PATH = os.path.join('gdk-pixbuf-2.0', '2.10.0', 'loaders') +LOADER_MODULE_DEST_PATH = "lib/gdk-pixbuf/loaders" +LOADER_CACHE_DEST_PATH = "lib/gdk-pixbuf" # NOTE: some search & replace code depends on / being used on all platforms. + + +def _find_gdk_pixbuf_query_loaders_executable(libdir): + # Distributions either package gdk-pixbuf-query-loaders in the GI libs directory (not on the path), or on the path + # with or without a -x64 suffix, depending on the architecture. + cmds = [ + os.path.join(libdir, 'gdk-pixbuf-2.0', 'gdk-pixbuf-query-loaders'), + 'gdk-pixbuf-query-loaders-64', + 'gdk-pixbuf-query-loaders', + ] + + for cmd in cmds: + cmd_fullpath = shutil.which(cmd) + if cmd_fullpath is not None: + return cmd_fullpath + + return None + + +def _collect_loaders(libdir): + # Assume loader plugins have .so library suffix on all non-Windows platforms + lib_ext = "*.dll" if compat.is_win else "*.so" + + # Find all loaders + loader_libs = [] + pattern = os.path.join(libdir, LOADERS_PATH, lib_ext) + for f in glob.glob(pattern): + loader_libs.append(f) + + # Sometimes the loaders are stored in a different directory from the library (msys2) + if not loader_libs: + pattern = os.path.abspath(os.path.join(libdir, '..', 'lib', LOADERS_PATH, lib_ext)) + for f in glob.glob(pattern): + loader_libs.append(f) + + return loader_libs + + +def _generate_loader_cache(gdk_pixbuf_query_loaders, libdir, loader_libs): + # Run the "gdk-pixbuf-query-loaders" command and capture its standard output providing an updated loader + # cache; then write this output to the loader cache bundled with this frozen application. On all platforms, + # we also move the package structure to point to lib/gdk-pixbuf instead of lib/gdk-pixbuf-2.0/2.10.0 in + # order to make compatible with macOS .app bundle signing. + # + # On macOS we use @executable_path to specify a path relative to the generated bundle. However, on + # non-Windows, we need to rewrite the loader cache because it is not relocatable by default. See + # https://bugzilla.gnome.org/show_bug.cgi?id=737523 + # + # To make it easier to rewrite, we just always write @executable_path, since its significantly easier to + # find/replace at runtime. :) + # + # To permit string munging, decode the encoded bytes output by this command (i.e., enable the + # "universal_newlines" option). + # + # On Fedora, the default loaders cache is /usr/lib64, but the libdir is actually /lib64. To get around this, + # we pass the path to the loader command, and it will create a cache with the right path. + # + # On Windows, the loaders lib directory is relative, starts with 'lib', and uses \\ as path separators + # (escaped \). + cachedata = subprocess.run([gdk_pixbuf_query_loaders, *loader_libs], + check=True, + stdout=subprocess.PIPE, + encoding='utf-8').stdout + + output_lines = [] + prefix = '"' + os.path.join(libdir, 'gdk-pixbuf-2.0', '2.10.0') + plen = len(prefix) + + win_prefix = '"' + '\\\\'.join(['lib', 'gdk-pixbuf-2.0', '2.10.0']) + win_plen = len(win_prefix) + + msys2_prefix = '"' + os.path.abspath(os.path.join(libdir, '..', 'lib', 'gdk-pixbuf-2.0', '2.10.0')) + msys2_plen = len(msys2_prefix) + + # For each line in the updated loader cache... + for line in cachedata.splitlines(): + if line.startswith('#'): + continue + if line.startswith(prefix): + line = '"@executable_path/' + LOADER_CACHE_DEST_PATH + line[plen:] + elif line.startswith(win_prefix): + line = '"' + LOADER_CACHE_DEST_PATH.replace('/', '\\\\') + line[win_plen:] + elif line.startswith(msys2_prefix): + line = ('"' + LOADER_CACHE_DEST_PATH + line[msys2_plen:]).replace('/', '\\\\') + output_lines.append(line) + + return '\n'.join(output_lines) + + +def hook(hook_api): + module_info = GiModuleInfo('GdkPixbuf', '2.0') + if not module_info.available: + return + + binaries, datas, hiddenimports = module_info.collect_typelib_data() + + libdir = module_info.get_libdir() + + # Collect GdkPixbuf loaders and generate loader cache file + gdk_pixbuf_query_loaders = _find_gdk_pixbuf_query_loaders_executable(libdir) + logger.debug("gdk-pixbuf-query-loaders executable: %s", gdk_pixbuf_query_loaders) + if not gdk_pixbuf_query_loaders: + logger.warning("gdk-pixbuf-query-loaders executable not found in GI library directory or in PATH!") + else: + # Find all GdkPixbuf loader modules + loader_libs = _collect_loaders(libdir) + + # Collect discovered loaders + for lib in loader_libs: + binaries.append((lib, LOADER_MODULE_DEST_PATH)) + + # Generate loader cache; we need to store it to CONF['workpath'] so we can collect it as a data file. + cachedata = _generate_loader_cache(gdk_pixbuf_query_loaders, libdir, loader_libs) + cachefile = os.path.join(CONF['workpath'], 'loaders.cache') + with open(cachefile, 'w', encoding='utf-8') as fp: + fp.write(cachedata) + datas.append((cachefile, LOADER_CACHE_DEST_PATH)) + + # Collect translations + lang_list = get_hook_config(hook_api, "gi", "languages") + if gdk_pixbuf_query_loaders: + datas += collect_glib_translations('gdk-pixbuf', lang_list) + + hook_api.add_datas(datas) + hook_api.add_binaries(binaries) + hook_api.add_imports(*hiddenimports) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gio.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gio.py new file mode 100755 index 0000000..fe34446 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gio.py @@ -0,0 +1,68 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2025, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import glob +import os + +from PyInstaller import compat +import PyInstaller.log as logging +from PyInstaller.utils.hooks.gi import GiModuleInfo + +logger = logging.getLogger(__name__) + +module_info = GiModuleInfo('Gio', '2.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() + + # Find Gio modules + libdir = module_info.get_libdir() + modules_pattern = None + gio_libdir = os.path.join(libdir, 'gio', 'modules') + runtime_path = 'gio_modules' + + lib_ext = '*.so' + if compat.is_win: + lib_ext = '*.dll' + + if not os.path.exists(gio_libdir): + # homebrew/MSYS2 may install the files elsewhere... + gio_libdir = os.path.join(os.path.commonprefix([compat.base_prefix, gio_libdir]), 'lib', 'gio', 'modules') + + if os.path.exists(gio_libdir): + modules_pattern = os.path.join(gio_libdir, lib_ext) + else: + logger.warning('Could not determine Gio modules path!') + + if modules_pattern: + for f in glob.glob(modules_pattern): + binaries.append((f, runtime_path)) + cache_file = os.path.join(gio_libdir, 'giomodule.cache') + if os.path.isfile(cache_file): + datas.append((cache_file, runtime_path)) + else: + # To add a new platform add a new elif above with the proper is_ and proper pattern for finding the + # Gio modules on your platform. + logger.warning('Bundling Gio modules is not supported on your platform.') + + # Bundle the mime cache -- might not be needed on Windows + # -> this is used for content type detection (also used by GdkPixbuf) + # -> gio/xdgmime/xdgmime.c looks for mime/mime.cache in the users home directory, followed by XDG_DATA_DIRS if + # specified in the environment, otherwise it searches /usr/local/share/ and /usr/share/ + if not compat.is_win: + _mime_searchdirs = ['/usr/local/share', '/usr/share'] + if 'XDG_DATA_DIRS' in os.environ: + _mime_searchdirs.insert(0, os.environ['XDG_DATA_DIRS']) + + for sd in _mime_searchdirs: + spath = os.path.join(sd, 'mime', 'mime.cache') + if os.path.exists(spath): + datas.append((spath, 'share/mime')) + break diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Graphene.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Graphene.py new file mode 100755 index 0000000..bfa4d30 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Graphene.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('Graphene', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gsk.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gsk.py new file mode 100755 index 0000000..9229252 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gsk.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('Gsk', '4.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gst.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gst.py new file mode 100755 index 0000000..939a37b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gst.py @@ -0,0 +1,93 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# GStreamer contains a lot of plugins. We need to collect them and bundle them with the exe file. We also need to +# resolve binary dependencies of these GStreamer plugins. + +import pathlib + +from PyInstaller.utils.hooks import get_hook_config, include_or_exclude_file +import PyInstaller.log as logging +from PyInstaller import isolated +from PyInstaller.utils.hooks.gi import GiModuleInfo, collect_glib_share_files, collect_glib_translations + +logger = logging.getLogger(__name__) + + +@isolated.decorate +def _get_gst_plugin_path(): + import os + import gi + gi.require_version('Gst', '1.0') + from gi.repository import Gst + Gst.init(None) + reg = Gst.Registry.get() + plug = reg.find_plugin('coreelements') + path = plug.get_filename() + return os.path.dirname(path) + + +def _format_plugin_pattern(plugin_name): + return f"**/*gst{plugin_name}.*" + + +def hook(hook_api): + module_info = GiModuleInfo('Gst', '1.0') + if not module_info.available: + return + + binaries, datas, hiddenimports = module_info.collect_typelib_data() + hiddenimports += ["gi.repository.Gio"] + + # Collect data files + datas += collect_glib_share_files('gstreamer-1.0') + + # Translations + lang_list = get_hook_config(hook_api, "gi", "languages") + for prog in [ + 'gst-plugins-bad-1.0', + 'gst-plugins-base-1.0', + 'gst-plugins-good-1.0', + 'gst-plugins-ugly-1.0', + 'gstreamer-1.0', + ]: + datas += collect_glib_translations(prog, lang_list) + + # Plugins + try: + plugin_path = _get_gst_plugin_path() + except Exception as e: + logger.warning("Failed to determine gstreamer plugin path: %s", e) + plugin_path = None + + if plugin_path: + plugin_path = pathlib.Path(plugin_path) + + # Obtain optional include/exclude list from hook config + include_list = get_hook_config(hook_api, "gstreamer", "include_plugins") + exclude_list = get_hook_config(hook_api, "gstreamer", "exclude_plugins") + + # Format plugin basenames into filename patterns for matching + if include_list is not None: + include_list = [_format_plugin_pattern(name) for name in include_list] + if exclude_list is not None: + exclude_list = [_format_plugin_pattern(name) for name in exclude_list] + + # The names of GStreamer plugins typically start with libgst (or just gst, depending on the toolchain). We also + # need to account for different extensions that might be used on a particular OS (for example, on macOS, the + # extension may be either .so or .dylib). + for lib_pattern in ['*gst*.dll', '*gst*.dylib', '*gst*.so']: + binaries += [(str(filename), 'gst_plugins') for filename in plugin_path.glob(lib_pattern) + if include_or_exclude_file(filename, include_list, exclude_list)] + + hook_api.add_datas(datas) + hook_api.add_binaries(binaries) + hook_api.add_imports(*hiddenimports) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstAllocators.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstAllocators.py new file mode 100755 index 0000000..119401a --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstAllocators.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstAllocators', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstApp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstApp.py new file mode 100755 index 0000000..7c25a44 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstApp.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstApp', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstAudio.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstAudio.py new file mode 100755 index 0000000..cf18078 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstAudio.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstAudio', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstBadAudio.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstBadAudio.py new file mode 100755 index 0000000..0f345b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstBadAudio.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstBadAudio', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstBase.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstBase.py new file mode 100755 index 0000000..ea6187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstBase.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstBase', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstCheck.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstCheck.py new file mode 100755 index 0000000..e631995 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstCheck.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstCheck', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstCodecs.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstCodecs.py new file mode 100755 index 0000000..ffa643e --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstCodecs.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstCodecs', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstController.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstController.py new file mode 100755 index 0000000..c928843 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstController.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstController', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstGL.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstGL.py new file mode 100755 index 0000000..0075eb0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstGL.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstGL', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstGLEGL.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstGLEGL.py new file mode 100755 index 0000000..a3f557d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstGLEGL.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstGLEGL', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstGLWayland.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstGLWayland.py new file mode 100755 index 0000000..6ef146d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstGLWayland.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstGLWayland', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstGLX11.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstGLX11.py new file mode 100755 index 0000000..dd68570 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstGLX11.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstGLX11', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstInsertBin.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstInsertBin.py new file mode 100755 index 0000000..c7980bc --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstInsertBin.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstInsertBin', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstMpegts.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstMpegts.py new file mode 100755 index 0000000..b690192 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstMpegts.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstMpegts', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstNet.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstNet.py new file mode 100755 index 0000000..0c268af --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstNet.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstNet', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstPbutils.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstPbutils.py new file mode 100755 index 0000000..173b695 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstPbutils.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstPbutils', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstPlay.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstPlay.py new file mode 100755 index 0000000..edb6020 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstPlay.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstPlay', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstPlayer.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstPlayer.py new file mode 100755 index 0000000..80cb93f --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstPlayer.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstPlayer', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstRtp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstRtp.py new file mode 100755 index 0000000..d18e58d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstRtp.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstRtp', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstRtsp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstRtsp.py new file mode 100755 index 0000000..09382dd --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstRtsp.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstRtsp', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstRtspServer.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstRtspServer.py new file mode 100755 index 0000000..d023c3f --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstRtspServer.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstRtspServer', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstSdp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstSdp.py new file mode 100755 index 0000000..2a78e2b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstSdp.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstSdp', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstTag.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstTag.py new file mode 100755 index 0000000..dbac756 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstTag.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstTag', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstTranscoder.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstTranscoder.py new file mode 100755 index 0000000..3cc1dcf --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstTranscoder.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstTranscoder', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstVideo.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstVideo.py new file mode 100755 index 0000000..398b503 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstVideo.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstVideo', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstVulkan.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstVulkan.py new file mode 100755 index 0000000..588c073 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstVulkan.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstVulkan', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstVulkanWayland.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstVulkanWayland.py new file mode 100755 index 0000000..aaef939 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstVulkanWayland.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstVulkanWayland', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstVulkanXCB.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstVulkanXCB.py new file mode 100755 index 0000000..2351a13 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstVulkanXCB.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstVulkanXCB', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstWebRTC.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstWebRTC.py new file mode 100755 index 0000000..9fcac06 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GstWebRTC.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GstWebRTC', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gtk.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gtk.py new file mode 100755 index 0000000..2495b1d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Gtk.py @@ -0,0 +1,59 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import os +import os.path + +from PyInstaller.compat import is_win +from PyInstaller.utils.hooks import get_hook_config +from PyInstaller.utils.hooks.gi import GiModuleInfo, collect_glib_etc_files, collect_glib_share_files, \ + collect_glib_translations + + +def hook(hook_api): + module_info = GiModuleInfo('Gtk', '3.0', hook_api=hook_api) # Pass hook_api to read version from hook config + if not module_info.available: + return + + binaries, datas, hiddenimports = module_info.collect_typelib_data() + + # Collect fontconfig data + datas += collect_glib_share_files('fontconfig') + + # Icons, themes, translations + icon_list = get_hook_config(hook_api, "gi", "icons") + if icon_list is not None: + for icon in icon_list: + datas += collect_glib_share_files(os.path.join('icons', icon)) + else: + datas += collect_glib_share_files('icons') + + # Themes + theme_list = get_hook_config(hook_api, "gi", "themes") + if theme_list is not None: + for theme in theme_list: + datas += collect_glib_share_files(os.path.join('themes', theme)) + else: + datas += collect_glib_share_files('themes') + + # Translations + lang_list = get_hook_config(hook_api, "gi", "languages") + datas += collect_glib_translations(f'gtk{module_info.version[0]}0', lang_list) + + # These only seem to be required on Windows + if is_win: + datas += collect_glib_etc_files('fonts') + datas += collect_glib_etc_files('pango') + datas += collect_glib_share_files('fonts') + + hook_api.add_datas(datas) + hook_api.add_binaries(binaries) + hook_api.add_imports(*hiddenimports) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GtkChamplain.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GtkChamplain.py new file mode 100755 index 0000000..777b620 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GtkChamplain.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GtkChamplain', '0.12') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GtkClutter.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GtkClutter.py new file mode 100755 index 0000000..cc4fcd7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GtkClutter.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('GtkClutter', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GtkSource.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GtkSource.py new file mode 100755 index 0000000..5e7efa7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GtkSource.py @@ -0,0 +1,31 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo, collect_glib_share_files + + +def hook(hook_api): + module_info = GiModuleInfo('GtkSource', '3.0', hook_api=hook_api) # Pass hook_api to read version from hook config + if not module_info.available: + return + + binaries, datas, hiddenimports = module_info.collect_typelib_data() + + # Collect data files + # The data directory name contains verbatim version, e.g.: + # * GtkSourceView-3.0 -> /usr/share/gtksourceview-3.0 + # * GtkSourceView-4 -> /usr/share/gtksourceview-4 + # * GtkSourceView-5 -> /usr/share/gtksourceview-5 + datas += collect_glib_share_files(f'gtksourceview-{module_info.version}') + + hook_api.add_datas(datas) + hook_api.add_binaries(binaries) + hook_api.add_imports(*hiddenimports) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GtkosxApplication.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GtkosxApplication.py new file mode 100755 index 0000000..3437edf --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.GtkosxApplication.py @@ -0,0 +1,18 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.compat import is_darwin +from PyInstaller.utils.hooks.gi import GiModuleInfo + +if is_darwin: + module_info = GiModuleInfo('GtkosxApplication', '1.0') + if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.HarfBuzz.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.HarfBuzz.py new file mode 100755 index 0000000..41cef14 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.HarfBuzz.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('HarfBuzz', '0.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.OsmGpsMap.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.OsmGpsMap.py new file mode 100755 index 0000000..477f0c0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.OsmGpsMap.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2025, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo("OsmGpsMap", "1.0") +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Pango.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Pango.py new file mode 100755 index 0000000..3d8b865 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Pango.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('Pango', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.PangoCairo.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.PangoCairo.py new file mode 100755 index 0000000..7c058fd --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.PangoCairo.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('PangoCairo', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Rsvg.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Rsvg.py new file mode 100755 index 0000000..e3ad6d2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.Rsvg.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('Rsvg', '2.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.cairo.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.cairo.py new file mode 100755 index 0000000..71fed30 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.cairo.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('cairo', '1.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.freetype2.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.freetype2.py new file mode 100755 index 0000000..ffea7a1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.freetype2.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('freetype2', '2.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.xlib.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.xlib.py new file mode 100755 index 0000000..1c2bde3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-gi.repository.xlib.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks.gi import GiModuleInfo + +module_info = GiModuleInfo('xlib', '2.0') +if module_info.available: + binaries, datas, hiddenimports = module_info.collect_typelib_data() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-heapq.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-heapq.py new file mode 100755 index 0000000..373025f --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-heapq.py @@ -0,0 +1,13 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# Only required when run as `__main__`. +excludedimports = ["doctest"] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-idlelib.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-idlelib.py new file mode 100755 index 0000000..505378d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-idlelib.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('idlelib') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-importlib_metadata.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-importlib_metadata.py new file mode 100755 index 0000000..7abf511 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-importlib_metadata.py @@ -0,0 +1,24 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2019-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +importlib_metadata is a library to access the metadata for a Python package. This functionality intends to replace most +uses of pkg_resources entry point API and metadata API. +""" + +from PyInstaller.utils.hooks import copy_metadata + +# Normally, we should never need to use copy_metadata() in a hook since metadata requirements detection is now +# automatic. However, that detection first uses `PyiModuleGraph.get_code_using("importlib_metadata")` to find +# files which `import importlib_metadata` and `get_code_using()` intentionally excludes internal imports. This +# means that importlib_metadata is not scanned for usages of importlib_metadata and therefore when +# importlib_metadata uses its own API to get its version, this goes undetected. Therefore, we must collect its +# metadata manually. +datas = copy_metadata('importlib_metadata') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-importlib_resources.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-importlib_resources.py new file mode 100755 index 0000000..b43b19b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-importlib_resources.py @@ -0,0 +1,22 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2019-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +`importlib_resources` is a backport of the 3.9+ module `importlib.resources` +""" + +from PyInstaller.utils.hooks import check_requirement, collect_data_files + +# Prior to v1.2.0, a `version.txt` file is used to set __version__. Later versions use `importlib.metadata`. +if check_requirement("importlib_resources < 1.2.0"): + datas = collect_data_files("importlib_resources", includes=["version.txt"]) + +if check_requirement("importlib_resources >= 1.3.1"): + hiddenimports = ['importlib_resources.trees'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-keyring.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-keyring.py new file mode 100755 index 0000000..acbd5ff --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-keyring.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_submodules, copy_metadata + +# Collect backends +hiddenimports = collect_submodules('keyring.backends') + +# Keyring performs backend plugin discovery using setuptools entry points, which are listed in the metadata. Therefore, +# we need to copy the metadata, otherwise no backends will be found at run-time. +datas = copy_metadata('keyring') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-kivy.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-kivy.py new file mode 100755 index 0000000..fd01f06 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-kivy.py @@ -0,0 +1,25 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import log as logging +from PyInstaller.utils.hooks import check_requirement + +if check_requirement('kivy >= 1.9.1'): + from kivy.tools.packaging.pyinstaller_hooks import (add_dep_paths, get_deps_all, get_factory_modules, kivy_modules) + from kivy.tools.packaging.pyinstaller_hooks import excludedimports, datas # noqa: F401 + + add_dep_paths() + + hiddenimports = get_deps_all()['hiddenimports'] + hiddenimports = list(set(get_factory_modules() + kivy_modules + hiddenimports)) +else: + logger = logging.getLogger(__name__) + logger.warning('Hook disabled because of Kivy version < 1.9.1') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-lib2to3.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-lib2to3.py new file mode 100755 index 0000000..83b0f08 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-lib2to3.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This is needed to bundle lib2to3 Grammars files + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('lib2to3') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backend_bases.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backend_bases.py new file mode 100755 index 0000000..f65344c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backend_bases.py @@ -0,0 +1,12 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +excludedimports = ['IPython'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backends.backend_qtagg.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backends.backend_qtagg.py new file mode 100755 index 0000000..b3067db --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backends.backend_qtagg.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This module conditionally imports PyQt6: +# https://github.com/matplotlib/matplotlib/blob/9e18a343fb58a2978a8e27df03190ed21c61c343/lib/matplotlib/backends/backend_qtagg.py#L52-L53 +# Suppress this import to prevent PyQt6 from being accidentally pulled in; the actually relevant Qt bindings are +# determined by our hook for `matplotlib.backends.qt_compat` module. +excludedimports = ['PyQt6'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backends.backend_qtcairo.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backends.backend_qtcairo.py new file mode 100755 index 0000000..0b9174b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backends.backend_qtcairo.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This module conditionally imports PyQt6: +# https://github.com/matplotlib/matplotlib/blob/9e18a343fb58a2978a8e27df03190ed21c61c343/lib/matplotlib/backends/backend_qtcairo.py#L24-L25 +# Suppress this import to prevent PyQt6 from being accidentally pulled in; the actually relevant Qt bindings are +# determined by our hook for `matplotlib.backends.qt_compat` module. +excludedimports = ['PyQt6'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backends.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backends.py new file mode 100755 index 0000000..935ca80 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backends.py @@ -0,0 +1,226 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.compat import is_darwin +from PyInstaller.utils.hooks import logger, get_hook_config +from PyInstaller import isolated + + +@isolated.decorate +def _get_configured_default_backend(): + """ + Return the configured default matplotlib backend name, if available as matplotlib.rcParams['backend'] (or overridden + by MPLBACKEND environment variable. If the value of matplotlib.rcParams['backend'] corresponds to the auto-sentinel + object, returns None + """ + import matplotlib + # matplotlib.rcParams overrides the __getitem__ implementation and attempts to determine and load the default + # backend using pyplot.switch_backend(). Therefore, use dict.__getitem__(). + val = dict.__getitem__(matplotlib.rcParams, 'backend') + if isinstance(val, str): + return val + return None + + +@isolated.decorate +def _list_available_mpl_backends(): + """ + Returns the names of all available matplotlib backends. + """ + import matplotlib + return matplotlib.rcsetup.all_backends + + +@isolated.decorate +def _check_mpl_backend_importable(module_name): + """ + Attempts to import the given module name (matplotlib backend module). + + Exceptions are propagated to caller. + """ + __import__(module_name) + + +# Bytecode scanning +def _recursive_scan_code_objects_for_mpl_use(co): + """ + Recursively scan the bytecode for occurrences of matplotlib.use() or mpl.use() calls with const arguments, and + collect those arguments into list of used matplotlib backend names. + """ + + from PyInstaller.depend.bytecode import any_alias, recursive_function_calls + + mpl_use_names = { + *any_alias("matplotlib.use"), + *any_alias("mpl.use"), # matplotlib is commonly aliased as mpl + } + + backends = [] + for calls in recursive_function_calls(co).values(): + for name, args in calls: + # matplotlib.use(backend) or matplotlib.use(backend, force) + # We support only literal arguments. Similarly, kwargs are + # not supported. + if len(args) not in {1, 2} or not isinstance(args[0], str): + continue + if name in mpl_use_names: + backends.append(args[0]) + + return backends + + +def _backend_module_name(name): + """ + Converts matplotlib backend name to its corresponding module name. + + Equivalent to matplotlib.cbook._backend_module_name(). + """ + if name.startswith("module://"): + return name[9:] + return f"matplotlib.backends.backend_{name.lower()}" + + +def _autodetect_used_backends(hook_api): + """ + Returns a list of automatically-discovered matplotlib backends in use, or the name of the default matplotlib + backend. Implements the 'auto' backend selection method. + """ + # Scan the code for matplotlib.use() + modulegraph = hook_api.analysis.graph + mpl_code_objs = modulegraph.get_code_using("matplotlib") + used_backends = [] + for name, co in mpl_code_objs.items(): + co_backends = _recursive_scan_code_objects_for_mpl_use(co) + if co_backends: + logger.info( + "Discovered Matplotlib backend(s) via `matplotlib.use()` call in module %r: %r", name, co_backends + ) + used_backends += co_backends + + # Deduplicate and sort the list of used backends before displaying it. + used_backends = sorted(set(used_backends)) + + if used_backends: + HOOK_CONFIG_DOCS = 'https://pyinstaller.org/en/stable/hooks-config.html#matplotlib-hooks' + logger.info( + "The following Matplotlib backends were discovered by scanning for `matplotlib.use()` calls: %r. If your " + "backend of choice is not in this list, either add a `matplotlib.use()` call to your code, or configure " + "the backend collection via hook options (see: %s).", used_backends, HOOK_CONFIG_DOCS + ) + return used_backends + + # Determine the default matplotlib backend. + # + # Ideally, this would be done by calling ``matplotlib.get_backend()``. However, that function tries to switch to the + # default backend (calling ``matplotlib.pyplot.switch_backend()``), which seems to occasionally fail on our linux CI + # with an error and, on other occasions, returns the headless Agg backend instead of the GUI one (even with display + # server running). Furthermore, using ``matplotlib.get_backend()`` returns headless 'Agg' when display server is + # unavailable, which is not ideal for automated builds. + # + # Therefore, we try to emulate ``matplotlib.get_backend()`` ourselves. First, we try to obtain the configured + # default backend from settings (rcparams and/or MPLBACKEND environment variable). If that is unavailable, we try to + # find the first importable GUI-based backend, using the same list as matplotlib.pyplot.switch_backend() uses for + # automatic backend selection. The difference is that we only test whether the backend module is importable, without + # trying to switch to it. + default_backend = _get_configured_default_backend() # isolated sub-process + if default_backend: + logger.info("Found configured default matplotlib backend: %s", default_backend) + return [default_backend] + + # `QtAgg` supersedes `Qt5Agg`; however, we keep `Qt5Agg` in the candidate list to support older versions of + # matplotlib that do not have `QtAgg`. + candidates = ["QtAgg", "Qt5Agg", "Gtk4Agg", "Gtk3Agg", "TkAgg", "WxAgg"] + if is_darwin: + candidates = ["MacOSX"] + candidates + logger.info("Trying determine the default backend as first importable candidate from the list: %r", candidates) + + for candidate in candidates: + try: + module_name = _backend_module_name(candidate) + _check_mpl_backend_importable(module_name) # NOTE: uses an isolated sub-process. + except Exception: + continue + return [candidate] + + # Fall back to headless Agg backend + logger.info("None of the backend candidates could be imported; falling back to headless Agg!") + return ['Agg'] + + +def _collect_all_importable_backends(hook_api): + """ + Returns a list of all importable matplotlib backends. Implements the 'all' backend selection method. + """ + # List of the human-readable names of all available backends. + backend_names = _list_available_mpl_backends() # NOTE: retrieved in an isolated sub-process. + logger.info("All available matplotlib backends: %r", backend_names) + + # Try to import the module(s). + importable_backends = [] + + # List of backends to exclude; Qt4 is not supported by PyInstaller anymore. + exclude_backends = {'Qt4Agg', 'Qt4Cairo'} + + # Ignore "CocoaAgg" on OSes other than macOS; attempting to import it on other OSes halts the current + # (sub)process without printing output or raising exceptions, preventing reliable detection. Apply the + # same logic for the (newer) "MacOSX" backend. + if not is_darwin: + exclude_backends |= {'CocoaAgg', 'MacOSX'} + + # For safety, attempt to import each backend in an isolated sub-process. + for backend_name in backend_names: + if backend_name in exclude_backends: + logger.info(' Matplotlib backend %r: excluded', backend_name) + continue + + try: + module_name = _backend_module_name(backend_name) + _check_mpl_backend_importable(module_name) # NOTE: uses an isolated sub-process. + except Exception: + # Backend is not importable, for whatever reason. + logger.info(' Matplotlib backend %r: ignored due to import error', backend_name) + continue + + logger.info(' Matplotlib backend %r: added', backend_name) + importable_backends.append(backend_name) + + return importable_backends + + +def hook(hook_api): + # Backend collection setting + backends_method = get_hook_config(hook_api, 'matplotlib', 'backends') + if backends_method is None: + backends_method = 'auto' # default method + + # Select backend(s) + if backends_method == 'auto': + logger.info("Matplotlib backend selection method: automatic discovery of used backends") + backend_names = _autodetect_used_backends(hook_api) + elif backends_method == 'all': + logger.info("Matplotlib backend selection method: collection of all importable backends") + backend_names = _collect_all_importable_backends(hook_api) + else: + logger.info("Matplotlib backend selection method: user-provided name(s)") + if isinstance(backends_method, str): + backend_names = [backends_method] + else: + assert isinstance(backends_method, list), "User-provided backend name(s) must be either a string or a list!" + backend_names = backends_method + + # Deduplicate and sort the list of selected backends before displaying it. + backend_names = sorted(set(backend_names)) + + logger.info("Selected matplotlib backends: %r", backend_names) + + # Set module names as hiddenimports + module_names = [_backend_module_name(backend) for backend in backend_names] # backend name -> module name + hook_api.add_imports(*module_names) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backends.qt_compat.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backends.qt_compat.py new file mode 100755 index 0000000..4e12fff --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.backends.qt_compat.py @@ -0,0 +1,26 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import qt as qtutils + +# This module conditionally imports all Qt bindings. Prevent all available bindings from being pulled in by trying to +# select the most applicable one. +# +# The preference order for this module appears to be: PyQt6, PySide6, PyQt5, PySide2 (or just PyQt5, PySide2 if Qt5 +# bindings are forced). See: +# https://github.com/matplotlib/matplotlib/blob/9e18a343fb58a2978a8e27df03190ed21c61c343/lib/matplotlib/backends/qt_compat.py#L113-L125 +# +# We, however, use the default preference order of the helper function, in order to keep it consistent across multiple +# hooks that use the same helper. +excludedimports = qtutils.exclude_extraneous_qt_bindings( + hook_name="hook-matplotlib.backends.qt_compat", + qt_bindings_order=None, +) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.numerix.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.numerix.py new file mode 100755 index 0000000..924b400 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.numerix.py @@ -0,0 +1,21 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +The matplotlib.numerix package sneaks these imports in under the radar. +""" + +hiddenimports = [ + 'fft', + 'linear_algebra', + 'random_array', + 'ma', + 'mlab', +] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.py new file mode 100755 index 0000000..e628e9b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.py @@ -0,0 +1,38 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import isolated +from PyInstaller import compat +from PyInstaller.utils import hooks as hookutils + + +@isolated.decorate +def mpl_data_dir(): + import matplotlib + return matplotlib.get_data_path() + + +datas = [ + (mpl_data_dir(), "matplotlib/mpl-data"), +] + +binaries = [] + +# Windows PyPI wheels for `matplotlib` >= 3.7.0 use `delvewheel`. +# In addition to DLLs from `matplotlib.libs` directory, which should be picked up automatically by dependency analysis +# in contemporary PyInstaller versions, we also need to collect the load-order file. This used to be required for +# python <= 3.7 (that lacked `os.add_dll_directory`), but is also needed for Anaconda python 3.8 and 3.9, where +# `delvewheel` falls back to load-order file codepath due to Anaconda breaking `os.add_dll_directory` implementation. +if compat.is_win and hookutils.check_requirement('matplotlib >= 3.7.0'): + delvewheel_datas, delvewheel_binaries = hookutils.collect_delvewheel_libs_directory('matplotlib') + + datas += delvewheel_datas + binaries += delvewheel_binaries diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.pyplot.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.pyplot.py new file mode 100755 index 0000000..2f78597 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-matplotlib.pyplot.py @@ -0,0 +1,12 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +excludedimports = ['IPython', "IPython.core.pylabtools"] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-multiprocessing.util.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-multiprocessing.util.py new file mode 100755 index 0000000..b9363ba --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-multiprocessing.util.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# In Python 3.8 mutliprocess.utils has _cleanup_tests() to cleanup multiprocessing resources when multiprocessing tests +# completed. This function import `tests` which is the complete Python test-suite, pulling in many more dependencies, +# e.g., tkinter. + +excludedimports = ['test'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-numpy.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-numpy.py new file mode 100755 index 0000000..b83132e --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-numpy.py @@ -0,0 +1,122 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. Additional +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# --- Copyright Disclaimer --- +# +# An earlier copy of this hook has been submitted to the NumPy project, where it was integrated in v1.23.0rc1 +# (https://github.com/numpy/numpy/pull/20745), under terms and conditions outlined in their repository [1]. +# +# A special provision is hereby granted to the NumPy project that allows the NumPy copy of the hook to incorporate the +# changes made to this (PyInstaller's) copy of the hook, subject to their licensing terms as opposed to PyInstaller's +# (stricter) licensing terms. +# +# .. refs: +# +# [1] NumPy's license: https://github.com/numpy/numpy/blob/master/LICENSE.txt + +# NOTE: when comparing the contents of this hook and the NumPy version of the hook (for example, to port changes), keep +# in mind that this copy is PyInstaller-centric - it caters to the version of PyInstaller it is bundled with, but needs +# to account for different behavior of different NumPy versions. In contrast, the NumPy copy of the hook caters to the +# version of NumPy it is bundled with, but should account for behavior differences in different PyInstaller versions. + +# Override the default hook priority so that our copy of hook is used instead of NumPy's one (which has priority 0, +# the default for upstream hooks). +# $PyInstaller-Hook-Priority: 1 + +from PyInstaller import compat +from PyInstaller.utils.hooks import ( + get_installer, + collect_dynamic_libs, +) + +from packaging.version import Version + +numpy_version = Version(compat.importlib_metadata.version("numpy")).release +numpy_installer = get_installer('numpy') + +hiddenimports = [] +datas = [] +binaries = [] + +# Collect shared libraries that are bundled inside the numpy's package directory. With PyInstaller 6.x, the directory +# layout of collected shared libraries should be preserved (to match behavior of the binary dependency analysis). In +# earlier versions of PyInstaller, it was necessary to collect the shared libraries into application's top-level +# directory (because that was also what binary dependency analysis in PyInstaller < 6.0 did). +binaries += collect_dynamic_libs("numpy") + +# Check if we are using Anaconda-packaged numpy +if numpy_installer == 'conda': + # Collect DLLs for NumPy and its dependencies (MKL, OpenBlas, OpenMP, etc.) from the communal Conda bin directory. + from PyInstaller.utils.hooks import conda_support + datas += conda_support.collect_dynamic_libs("numpy", dependencies=True) + +# NumPy 1.26 started using `delvewheel` for its Windows PyPI wheels. While contemporary PyInstaller versions +# automatically pick up DLLs from external `numpy.libs` directory, this does not work on Anaconda python 3.8 and 3.9 +# due to defunct `os.add_dll_directory`, which forces `delvewheel` to use the old load-order file approach. So we need +# to explicitly ensure that load-order file as well as DLLs are collected. +if compat.is_win and numpy_version >= (1, 26) and numpy_installer == 'pip': + from PyInstaller.utils.hooks import collect_delvewheel_libs_directory + datas, binaries = collect_delvewheel_libs_directory("numpy", datas=datas, binaries=binaries) + +# Submodules PyInstaller cannot detect (probably because they are only imported by extension modules, which PyInstaller +# cannot read). +if numpy_version >= (2, 0): + # In v2.0.0, `numpy.core` was renamed to `numpy._core`. + # See https://github.com/numpy/numpy/commit/47b70cbffd672849a5d3b9b6fa6e515700460fd0 + hiddenimports += ['numpy._core._dtype_ctypes', 'numpy._core._multiarray_tests'] +else: + hiddenimports += ['numpy.core._dtype_ctypes'] + + # See https://github.com/numpy/numpy/commit/99104bd2d0557078d7ea9a590129c87dd63df623 + if numpy_version >= (1, 25): + hiddenimports += ['numpy.core._multiarray_tests'] + +# Starting with v2.3.0, we need to add `numpy._core._exceptions` to hiddenimports; in previous versions, this module +# was picked up due to explicit import in `numpy._core._methods`, which was removed as part of cleanup in +# https://github.com/numpy/numpy/commit/a51a4f5c10aa9b7962ff1e7e9b5f9b7d91c51489 +if numpy_version >= (2, 3, 0): + hiddenimports += ['numpy._core._exceptions'] + +# This hidden import was removed from NumPy hook in v1.25.0 (https://github.com/numpy/numpy/pull/22666). According to +# comment in the linked PR, it should have been unnecessary since v1.19. +if compat.is_conda and numpy_version < (1, 19): + hiddenimports += ["six"] + +# Remove testing and building code and packages that are referenced throughout NumPy but are not really dependencies. +excludedimports = [ + "scipy", + "pytest", + "nose", + "f2py", + "setuptools", +] + +# As of v1.22.0, numpy.testing (imported for example by some scipy modules) requires numpy.distutils and distutils. +# This was due to numpy.testing adding import of numpy.testing._private.extbuild, which in turn imported numpy.distutils +# and distutils. These imports were moved into functions that require them in v1.22.2 and v.1.23.0. +# See: https://github.com/numpy/numpy/pull/20831 and https://github.com/numpy/numpy/pull/20906 +# So we can exclude them for all numpy versions except for v1.22.0 and v1.22.1 - the main motivation is to avoid pulling +# in `setuptools` (which nowadays provides its vendored version of `distutils`). +if numpy_version < (1, 22, 0) or numpy_version > (1, 22, 1): + excludedimports += [ + "distutils", + "numpy.distutils", + ] + +# In numpy v2.0.0, numpy.f2py submodule has been added to numpy's `__all__` attribute. Therefore, using +# `from numpy import *` leads to an error if `numpy.f2py` is excluded (seen in scipy 1.14). The exclusion in earlier +# releases was not reported to cause any issues, so keep it around. Although it should be noted that it does break an +# explicit import (i.e., `import numpy.f2py`) from user's code as well, because it prevents collection of other +# submodules from `numpy.f2py`. +if numpy_version < (2, 0): + excludedimports += [ + "numpy.f2py", + ] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pandas.io.clipboard.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pandas.io.clipboard.py new file mode 100755 index 0000000..2395920 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pandas.io.clipboard.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This module conditionally imports PyQt5: +# https://github.com/pandas-dev/pandas/blob/95308514e1221200e4526dfaf248283f3d7ade06/pandas/io/clipboard/__init__.py#L578-L597 +# Suppress this import to prevent PyQt5 from being accidentally pulled in; the actually relevant Qt bindings are +# determined by our hook for `qtpy` module, which contemporary versions of pandas mandate as part of `clipboard` and +# `all` extras: +# https://github.com/pandas-dev/pandas/blob/95308514e1221200e4526dfaf248283f3d7ade06/pyproject.toml#L86 +# https://github.com/pandas-dev/pandas/blob/95308514e1221200e4526dfaf248283f3d7ade06/pyproject.toml#L115 +excludedimports = ['PyQt5'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pandas.io.formats.style.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pandas.io.formats.style.py new file mode 100755 index 0000000..2a56828 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pandas.io.formats.style.py @@ -0,0 +1,18 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files + +# This module indirectly imports jinja2 +hiddenimports = ['jinja2'] + +# It also requires template file stored in pandas/io/formats/templates +datas = collect_data_files('pandas.io.formats') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pandas.plotting.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pandas.plotting.py new file mode 100755 index 0000000..948dd88 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pandas.plotting.py @@ -0,0 +1,18 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import check_requirement + +# Starting with pandas 1.3.0, pandas.plotting._matplotlib is imported via importlib.import_module() and needs to be +# added to hidden imports. But do this only if matplotlib is available in the first place (as it is soft dependency +# of pandas). +if check_requirement('pandas >= 1.3.0') and check_requirement('matplotlib'): + hiddenimports = ['pandas.plotting._matplotlib'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pandas.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pandas.py new file mode 100755 index 0000000..7b3acad --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pandas.py @@ -0,0 +1,20 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2017-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_submodules, check_requirement + +# Pandas keeps Python extensions loaded with dynamic imports here. +hiddenimports = collect_submodules('pandas._libs') + +# Pandas 1.2.0 and later require cmath hidden import on linux and macOS. On Windows, this is not strictly required, but +# we add it anyway to keep things simple (and future-proof). +if check_requirement('pandas >= 1.2.0'): + hiddenimports += ['cmath'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pickle.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pickle.py new file mode 100755 index 0000000..8d023bb --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pickle.py @@ -0,0 +1,13 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# Only required when run as `__main__` +excludedimports = ["argparse", "doctest"] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pkg_resources.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pkg_resources.py new file mode 100755 index 0000000..286671f --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pkg_resources.py @@ -0,0 +1,68 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_submodules, can_import_module +from PyInstaller.utils.hooks.setuptools import setuptools_info + +hiddenimports = [] +excludedimports = ['__main__'] + +# pkg_resources keeps vendored modules in its _vendor subpackage, and does sys.meta_path based import magic to expose +# them as pkg_resources.extern.* +# +# With setuptools >= 71.0, pkg_resources ceased to vendor packages, because vendoring is now done at the setuptools +# level. +if setuptools_info.available and setuptools_info.version < (71, 0, 0): + # The `railroad` package is an optional requirement for `pyparsing`. `pyparsing.diagrams` depends on `railroad`, so + # filter it out when `railroad` is not available. + if can_import_module('railroad'): + hiddenimports += collect_submodules('pkg_resources._vendor') + else: + hiddenimports += collect_submodules( + 'pkg_resources._vendor', filter=lambda name: 'pkg_resources._vendor.pyparsing.diagram' not in name + ) + + # pkg_resources v45.0 dropped support for Python 2 and added this module printing a warning. We could save some + # bytes if we would replace this by a fake module. + if setuptools_info.version >= (45, 0, 0) and setuptools_info.version < (49, 1, 1): + hiddenimports += ['pkg_resources.py2_warn'] + + # As of v60.7, setuptools vendored jaraco and has pkg_resources use it. Currently, the pkg_resources._vendor.jaraco + # namespace package cannot be automatically scanned due to limited support for pure namespace packages in our hook + # utilities. + # + # In setuptools 60.7.0, the vendored jaraco.text package included "Lorem Ipsum.txt" data file, which also has to be + # collected. However, the presence of the data file (and the resulting directory hierarchy) confuses the importer's + # redirection logic; instead of trying to work-around that, tell user to upgrade or downgrade their setuptools. + if setuptools_info.version == (60, 7, 0): + raise SystemExit( + "ERROR: Setuptools 60.7.0 is incompatible with PyInstaller. " + "Downgrade to an earlier version or upgrade to a later version." + ) + # In setuptools 60.7.1, the "Lorem Ipsum.txt" data file was dropped from the vendored jaraco.text package, so we can + # accommodate it with couple of hidden imports. + elif setuptools_info.version >= (60, 7, 1): + hiddenimports += [ + 'pkg_resources._vendor.jaraco.functools', + 'pkg_resources._vendor.jaraco.context', + 'pkg_resources._vendor.jaraco.text', + ] + + # As of setuptools 70.0.0, we need pkg_resources.extern added to hidden imports. + if setuptools_info.version >= (70, 0, 0): + hiddenimports += [ + 'pkg_resources.extern', + ] + +# Some more hidden imports. See: +# https://github.com/pyinstaller/pyinstaller-hooks-contrib/issues/15#issuecomment-663699288 `packaging` can either be +# its own package, or embedded in `pkg_resources._vendor.packaging`, or both. +hiddenimports += collect_submodules('packaging') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-platform.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-platform.py new file mode 100755 index 0000000..d1d8e1d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-platform.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +import sys + +# see https://github.com/python/cpython/blob/3.9/Lib/platform.py#L411 +# This will exclude `plistlib` for sys.platform != 'darwin' +if sys.platform != 'darwin': + excludedimports = ["plistlib"] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pygments.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pygments.py new file mode 100755 index 0000000..529d82b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pygments.py @@ -0,0 +1,29 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +PyInstaller hook file for Pygments. Tested with version 2.0.2. +""" + +from PyInstaller.utils.hooks import collect_submodules + +# The following applies to pygments version 2.0.2, as reported by ``pip show pygments``. +# +# From pygments.formatters, line 37:: +# +# def _load_formatters(module_name): +# """Load a formatter (and all others in the module too).""" +# mod = __import__(module_name, None, None, ['__all__']) +# +# Therefore, we need all the modules in ``pygments.formatters``. + +hiddenimports = collect_submodules('pygments.formatters') +hiddenimports.extend(collect_submodules('pygments.lexers')) +hiddenimports.extend(collect_submodules('pygments.styles')) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pytz.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pytz.py new file mode 100755 index 0000000..a44d29a --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pytz.py @@ -0,0 +1,20 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files + +# On Linux pytz installed from distribution repository uses zoneinfo from /usr/share/zoneinfo/ and no data files might +# be collected. +datas = collect_data_files('pytz') + +# pytz references pkg_resources in a fall-back codepath that should normally not be reached; add an exclude to prevent +# (now deprecated) pkg_resources from being pulled in the frozen application. +excludedimports = ['pkg_resources'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pytzdata.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pytzdata.py new file mode 100755 index 0000000..e45626c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-pytzdata.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("pytzdata") diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-qtawesome.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-qtawesome.py new file mode 100755 index 0000000..9829a03 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-qtawesome.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2017-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Hook for QtAwesome (https://github.com/spyder-ide/qtawesome). +Font files and charmaps need to be included with module. +Tested with QtAwesome 0.4.4 and Python 3.6 on macOS 10.12.4. +""" + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('qtawesome') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-qtpy.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-qtpy.py new file mode 100755 index 0000000..a6ce00c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-qtpy.py @@ -0,0 +1,25 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import qt as qtutils + +# This module conditionally imports all Qt bindings. Prevent all available bindings from being pulled in by trying to +# select the most applicable one. +# +# The preference order for this module appears to be: PyQt5, PySide2, PyQt6, PySide6. See: +# https://github.com/spyder-ide/qtpy/blob/3238de7a3e038daeb585c1a76fd9a0c4baf22f11/qtpy/__init__.py#L199-L289 +# +# We, however, use the default preference order of the helper function, in order to keep it consistent across multiple +# hooks that use the same helper. +excludedimports = qtutils.exclude_extraneous_qt_bindings( + hook_name="hook-qtpy", + qt_bindings_order=None, +) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scapy.layers.all.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scapy.layers.all.py new file mode 100755 index 0000000..fdcc779 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scapy.layers.all.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_submodules + +# The layers to load can be configured using scapy's conf.load_layers. +# from scapy.config import conf; print(conf.load_layers) +# I decided not to use this, but to include all layer modules. The reason is: When building the package, load_layers may +# not include all the layer modules the program will use later. + +hiddenimports = collect_submodules('scapy.layers') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.io.matlab.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.io.matlab.py new file mode 100755 index 0000000..c69c767 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.io.matlab.py @@ -0,0 +1,13 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# Module scipy.io.matlab allows to parse matlab files. The hidden import is necessary for SciPy 0.11+. +hiddenimports = ['scipy.io.matlab.streams'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.linalg.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.linalg.py new file mode 100755 index 0000000..b1a68b8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.linalg.py @@ -0,0 +1,13 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# The hidden import is necessary for SciPy 0.16+. +hiddenimports = ['scipy.linalg.cython_blas', 'scipy.linalg.cython_lapack'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.py new file mode 100755 index 0000000..7512fd4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.py @@ -0,0 +1,59 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +# ----------------------------------------------------------------------------- + +import glob +import os +import sysconfig + +from PyInstaller.compat import is_win, is_linux +from PyInstaller.utils.hooks import ( + get_module_file_attribute, + check_requirement, + collect_delvewheel_libs_directory, + collect_submodules, +) + +binaries = [] +datas = [] + +# Package the DLL bundle that official scipy wheels for Windows ship The DLL bundle will either be in extra-dll on +# windows proper and in .libs if installed on a virtualenv created from MinGW (Git-Bash for example) +if is_win: + extra_dll_locations = ['extra-dll', '.libs'] + for location in extra_dll_locations: + dll_glob = os.path.join(os.path.dirname(get_module_file_attribute('scipy')), location, "*.dll") + if glob.glob(dll_glob): + binaries.append((dll_glob, ".")) + +# Handle delvewheel-enabled win32 wheels, which have external scipy.libs directory (scipy >= 0.9.2) +if check_requirement("scipy >= 1.9.2") and is_win: + datas, binaries = collect_delvewheel_libs_directory('scipy', datas=datas, binaries=binaries) + +# collect library-wide utility extension modules +hiddenimports = ['scipy._lib.%s' % m for m in ['messagestream', "_ccallback_c", "_fpumode"]] + +# In scipy 1.14.0, `scipy._lib.array_api_compat.numpy` added a programmatic import of its `.fft` submodule, which needs +# to be added to hiddenimports. +if check_requirement("scipy >= 1.14.0"): + hiddenimports += ['scipy._lib.array_api_compat.numpy.fft'] + +# If scipy is provided by Debian's python3-scipy, its scipy.__config__ submodule is renamed to a dynamically imported +# scipy.__config__${SOABI}__ +# https://salsa.debian.org/python-team/packages/scipy/-/blob/1255922cf7c52b05aa44fb733449953cd9adb815/debian/patches/scipy_config_SOABI.patch +if is_linux and "dist-packages" in get_module_file_attribute("scipy"): + hiddenimports.append('scipy.__config__' + sysconfig.get_config_var('SOABI') + '__') + +# The `scipy._lib.array_api_compat.numpy` module performs a `from numpy import *`; in numpy 2.0.0, `numpy.f2py` was +# added to `numpy.__all__` attribute, but at the same time, the upstream numpy hook adds `numpy.f2py` to +# `excludedimports`. Therefore, the `numpy.f2py` sub-package ends up missing. Due to the way exclusion mechanism works, +# we need to add both `numpy.f2py` and all its submodules to hiddenimports here. +if check_requirement("numpy >= 2.0.0"): + hiddenimports += collect_submodules('numpy.f2py', filter=lambda name: name != 'numpy.f2py.tests') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.sparse.csgraph.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.sparse.csgraph.py new file mode 100755 index 0000000..9cabdbd --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.sparse.csgraph.py @@ -0,0 +1,13 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# The hidden import is necessary for SciPy 0.11+. +hiddenimports = ['scipy.sparse.csgraph._validation'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.spatial._ckdtree.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.spatial._ckdtree.py new file mode 100755 index 0000000..00d1a87 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.spatial._ckdtree.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2025, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import is_module_satisfies + +# As of SciPy 1.16.0, `scipy.spatial._ckdtree` extension started to depend on newly-introduced `scipy._cyutility`. +if is_module_satisfies('scipy >= 1.16.0'): + hiddenimports = ['scipy._cyutility'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.spatial.transform.rotation.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.spatial.transform.rotation.py new file mode 100755 index 0000000..4840cf2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.spatial.transform.rotation.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import check_requirement + +# As of scipy 1.6.0, scipy.spatial.transform.rotation is cython-compiled, so we fail to automatically pick up its +# imports. +if check_requirement("scipy >= 1.6.0"): + hiddenimports = ['scipy.spatial.transform._rotation_groups'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.special._ellip_harm_2.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.special._ellip_harm_2.py new file mode 100755 index 0000000..5115b02 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.special._ellip_harm_2.py @@ -0,0 +1,30 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Module hook for the `scipy.special._ellip_harm_2` C extension first introduced by SciPy >= 0.15.0. + +See Also +---------- +https://github.com/scipy/scipy/blob/master/scipy/special/_ellip_harm_2.pyx + This C extension's Cython-based implementation. +""" + +# In SciPy >= 0.15.0: +# +# 1. The "scipy.special.__init__" module imports... +# 2. The "scipy.special._ellip_harm" module imports... +# 3. The "scipy.special._ellip_harm_2" C extension imports... +# 4. The "scipy.integrate" package. +# +# The third import is undetectable by PyInstaller and hence explicitly listed. Since "_ellip_harm" and "_ellip_harm_2" +# were first introduced by SciPy 0.15.0, the following hidden import will only be applied for versions of SciPy +# guaranteed to provide these modules and C extensions. +hiddenimports = ['scipy.integrate'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.special._ufuncs.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.special._ufuncs.py new file mode 100755 index 0000000..f94b22e --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.special._ufuncs.py @@ -0,0 +1,25 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import is_module_satisfies + +# Module scipy.io._ufunc depends on some other C/C++ extensions. The hidden import is necessary for SciPy 0.13+. +# Thanks to dyadkin; see issue #826. +hiddenimports = ['scipy.special._ufuncs_cxx'] + +# SciPy 1.13.0 cythonized cdflib; this introduced new `scipy.special._cdflib` extension that is imported from the +# `scipy.special._ufuncs` extension, and thus we need a hidden import here. +if is_module_satisfies('scipy >= 1.13.0'): + hiddenimports += ['scipy.special._cdflib'] + +# SciPy 1.14.0 introduced `scipy.special._special_ufuncs`, which is imported from `scipy.special._ufuncs` extension. +if is_module_satisfies('scipy >= 1.14.0'): + hiddenimports += ['scipy.special._special_ufuncs'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.stats._stats.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.stats._stats.py new file mode 100755 index 0000000..e5f72a0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scipy.stats._stats.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import check_requirement + +if check_requirement("scipy >= 1.5.0"): + hiddenimports = ['scipy.special.cython_special'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scrapy.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scrapy.py new file mode 100755 index 0000000..f110bb0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-scrapy.py @@ -0,0 +1,18 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# Hook for https://pypi.org/project/Scrapy/ +# https://stackoverflow.com/questions/49085970/no-such-file-or-directory-error-using-pyinstaller-and-scrapy + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +datas = collect_data_files('scrapy') +hiddenimports = collect_submodules('scrapy') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-setuptools._vendor.importlib_metadata.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-setuptools._vendor.importlib_metadata.py new file mode 100755 index 0000000..e7c92d0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-setuptools._vendor.importlib_metadata.py @@ -0,0 +1,21 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import fnmatch +from PyInstaller.utils.hooks.setuptools import setuptools_info + +# Collect metadata for setuptools-vendored copy of importlib-metadata, to match the behavior of hook for +# stand-alone version of the package (i.e., `hook-importlib_metadata.py`). + +# Use cached data files list from setuptools_info, and extract relevant bits (to avoid having to call another +# `collect_data_files` and import `setuptools` in isolated process). +datas = [(src_name, dest_name) for src_name, dest_name in setuptools_info.vendored_data + if fnmatch.fnmatch(src_name, "**/setuptools/_vendor/importlib_metadata-*.dist-info/*")] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-setuptools._vendor.jaraco.text.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-setuptools._vendor.jaraco.text.py new file mode 100755 index 0000000..47e65da --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-setuptools._vendor.jaraco.text.py @@ -0,0 +1,18 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import fnmatch +from PyInstaller.utils.hooks.setuptools import setuptools_info + +# Use cached data files list from setuptools_info, and extract relevant bits (to avoid having to call another +# `collect_data_files` and import `setuptools` in isolated process). +datas = [(src_name, dest_name) for src_name, dest_name in setuptools_info.vendored_data + if fnmatch.fnmatch(src_name, "**/setuptools/_vendor/jaraco/text/*")] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-setuptools.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-setuptools.py new file mode 100755 index 0000000..6c2c1bb --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-setuptools.py @@ -0,0 +1,75 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import compat +from PyInstaller.utils.hooks.setuptools import setuptools_info + +datas = [] + +hiddenimports = [ + # Test case import/test_zipimport2 fails during importing pkg_resources or setuptools when module not present. + 'distutils.command.build_ext', + 'setuptools.msvc', +] + +# Necessary for setuptools on Mac/Unix +if compat.is_unix or compat.is_darwin: + hiddenimports.append('syslog') + +# Prevent the following modules from being collected solely due to reference from anywhere within setuptools (or +# its vendored dependencies). +excludedimports = [ + 'pytest', + 'numpy', # originally from hook-setuptools.msvc + 'docutils', # originally from hool-setuptools._distutils.command.check +] + +# setuptools >= 39.0.0 is "vendoring" its own direct dependencies from "_vendor" to "extern". This also requires +# 'pre_safe_import_module/hook-setuptools.extern.six.moves.py' to make the moves defined in 'setuptools._vendor.six' +# importable under 'setuptools.extern.six'. +# +# With setuptools 71.0.0, the vendored packages are exposed to the outside world by `setuptools._vendor` location being +# appended to `sys.path`, and the `VendorImporter` is gone (i.e., no more mapping to `setuptools.extern`). Since the +# vendored dependencies are now exposed as top-level modules (provided upstream versions are not available, as they +# would take precedence due to `sys.path` ordering), we need pre-safe-import-module hooks that detect when only vendored +# version is available, and add aliases to prevent duplicated collection. For list of vendored packages for which we +# need such pre-safe-import-module hooks, see the code in `PyInstaller.utils.hooks.setuptools`. +# +# The list of submodules from `setuptools._vendor` is now available in `setuptools_info.vendored_modules` (and covers +# all setuptools versions). +# +# NOTE: with setuptools >= 71.0, we do not need to add modules from `setuptools._vendored` to hidden imports anymore, +# because the aliases we set up should ensure that the necessary parts get collected. We still need them for earlier +# versions of setuptools, though. +if setuptools_info.version < (71, 0): + hiddenimports += setuptools_info.vendored_modules + +# The situation with vendored distutils (from `setuptools._distutils`) is a bit more complicated; python >= 3.12 does +# not provide stdlib version of `distutils` anymore, so our corresponding pre-safe-import-module hook sets up aliases. +# In earlier python versions, stdlib version is available as well, and at run-time, we might need both versions present, +# so that whichever is applicable can be used. Therefore, for python < 3.12, we need to add the vendored distuils +# modules to hidden imports. +if setuptools_info.distutils_vendored and not compat.is_py312: + hiddenimports += setuptools_info.distutils_modules + +# With setuptools >= 71.0.0, the vendored packages also have metadata, and might also contain data files that need to +# be collected. The list of corresponding data files is kept cached in `setuptools_info.vendored_data` (to minimize the +# number of times we need to call collect_data_files()). +# +# While it might be tempting to simply collect all data files and be done with it, we actually need to match the +# collection behavior for the stand-alone versions of these packages; i.e., we should collect metadata (and/or data +# files) for the vendored package only if the same data is also collected for stand-alone version. Otherwise, we risk +# inconsistent behavior and potential mismatches; for example, if we collected metadata for vendored package A here, +# but end up collecting stand-alone A, for which we normally do not collect the metadata, then at run-time, we will end +# up with stand-alone copy of A and vendored copy of its metadata being discoverable. +# +# Therefore, if metadata and/or metadata needs to be collected, do it in corresponding sub-package hook (for an example, +# see `hook-setuptools._vendor.jaraco.text.py`). diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-shelve.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-shelve.py new file mode 100755 index 0000000..1df601a --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-shelve.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# Tested on Windows 7 x64 With Python 3.5 + +hiddenimports = ["dbm.ndbm", "dbm.dumb", "dbm.gnu"] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-shiboken6.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-shiboken6.py new file mode 100755 index 0000000..17cf0c3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-shiboken6.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import compat + +# Up until python 3.12, `xxsubtype` was built-in on all OSes. Now it is an extension on non-Windows, and without it, +# shiboken6 initialization segfaults. +if compat.is_py312 and not compat.is_win: + hiddenimports = ['xxsubtype'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-sphinx.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-sphinx.py new file mode 100755 index 0000000..f5a13ac --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-sphinx.py @@ -0,0 +1,41 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules, eval_statement + +# Sphinx consists of several extensions that are lazily loaded. So collect all submodules to ensure we do not miss +# any of them. +hiddenimports = collect_submodules('sphinx') + +# For each extension in sphinx.application.builtin_extensions that does not come from the sphinx package, do a +# collect_submodules(). We need to do this explicitly because collect_submodules() does not seem to work with +# namespace packages, which precludes us from simply doing hiddenimports += collect_submodules('sphinxcontrib') +builtin_extensions = list( + eval_statement( + """ + from sphinx.application import builtin_extensions + print(builtin_extensions) + """ + ) +) +for extension in builtin_extensions: + if extension.startswith('sphinx.'): + continue # Already collected + hiddenimports += collect_submodules(extension) + +# This is inherited from an earlier version of the hook, and seems to have been required in Sphinx v.1.3.1 era due to +# https://github.com/sphinx-doc/sphinx/blob/b87ce32e7dc09773f9e71305e66e8d6aead53dd1/sphinx/cmdline.py#L173. +# It does not hurt to keep it around, just in case. +hiddenimports += ['locale'] + +# Collect all data files: *.html and *.conf files in ``sphinx.themes``, translation files in ``sphinx.locale``, etc. +# Also collect all data files for the alabaster theme. +datas = collect_data_files('sphinx') + collect_data_files('alabaster') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-sqlalchemy.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-sqlalchemy.py new file mode 100755 index 0000000..3aafc50 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-sqlalchemy.py @@ -0,0 +1,88 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import re +import importlib.util + +from PyInstaller import isolated +from PyInstaller.lib.modulegraph.modulegraph import SourceModule +from PyInstaller.utils.hooks import check_requirement, collect_entry_point, logger + +datas = [] + +# 'sqlalchemy.testing' causes bundling a lot of unnecessary modules. +excludedimports = ['sqlalchemy.testing'] + +# Include most common database bindings some database bindings are detected and include some are not. We should +# explicitly include database backends. +hiddenimports = ['pysqlite2', 'MySQLdb', 'psycopg2', 'sqlalchemy.ext.baked'] + +if check_requirement('sqlalchemy >= 1.4'): + hiddenimports.append("sqlalchemy.sql.default_comparator") + + +@isolated.decorate +def _get_dialect_modules(module_name): + import importlib + module = importlib.import_module(module_name) + return [f"{module_name}.{submodule_name}" for submodule_name in module.__all__] + + +# In SQLAlchemy >= 0.6, the "sqlalchemy.dialects" package provides dialects. +# In SQLAlchemy <= 0.5, the "sqlalchemy.databases" package provides dialects. +if check_requirement('sqlalchemy >= 0.6'): + hiddenimports += _get_dialect_modules("sqlalchemy.dialects") +else: + hiddenimports += _get_dialect_modules("sqlalchemy.databases") + +# Collect additional dialects and plugins that are registered via entry-points, under assumption that they are available +# in the build environment for a reason (i.e., they are used). +for entry_point_name in ('sqlalchemy.dialects', 'sqlalchemy.plugins'): + ep_datas, ep_hiddenimports = collect_entry_point(entry_point_name) + datas += ep_datas + hiddenimports += ep_hiddenimports + + +def hook(hook_api): + """ + SQLAlchemy 0.9 introduced the decorator 'util.dependencies'. This decorator does imports. E.g.: + + @util.dependencies("sqlalchemy.sql.schema") + + This hook scans for included SQLAlchemy modules and then scans those modules for any util.dependencies and marks + those modules as hidden imports. + """ + + if not check_requirement('sqlalchemy >= 0.9'): + return + + # this parser is very simplistic but seems to catch all cases as of V1.1 + depend_regex = re.compile(r'@util.dependencies\([\'"](.*?)[\'"]\)') + + hidden_imports_set = set() + known_imports = set() + for node in hook_api.module_graph.iter_graph(start=hook_api.module): + if isinstance(node, SourceModule) and node.identifier.startswith('sqlalchemy.'): + known_imports.add(node.identifier) + + # Read the source... + with open(node.filename, 'rb') as f: + source_code = f.read() + source_code = importlib.util.decode_source(source_code) + + # ... and scan it + for match in depend_regex.findall(source_code): + hidden_imports_set.add(match) + + hidden_imports_set -= known_imports + if len(hidden_imports_set): + logger.info(" Found %d sqlalchemy hidden imports", len(hidden_imports_set)) + hook_api.add_imports(*list(hidden_imports_set)) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-sqlite3.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-sqlite3.py new file mode 100755 index 0000000..805bf8f --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-sqlite3.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = [] + +# On Windows in Python 3.4 'sqlite3' package might contain tests that are not required in frozen application. +for mod in collect_submodules('sqlite3'): + if not mod.startswith('sqlite3.test'): + hiddenimports.append(mod) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-sysconfig.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-sysconfig.py new file mode 100755 index 0000000..d4331cf --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-sysconfig.py @@ -0,0 +1,29 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +import sys + +# see https://github.com/python/cpython/blob/3.9/Lib/sysconfig.py#L593 +# This will exclude `_osx_support`, `distutils`, `distutils.log` for sys.platform != 'darwin' +if sys.platform != 'darwin': + excludedimports = ["_osx_support"] + +# Python 3.6 uses additional modules like `_sysconfigdata_m_linux_x86_64-linux-gnu`, see +# https://github.com/python/cpython/blob/3.6/Lib/sysconfig.py#L417 +# Note: Some versions of Anaconda backport this feature to before 3.6. See issue #3105. +# Note: on Windows, python.org and Anaconda python provide _get_sysconfigdata_name, but calling it fails due to sys +# module lacking abiflags attribute. It does work on MSYS2/MINGW python, where we need to collect corresponding file. +try: + import sysconfig + hiddenimports = [sysconfig._get_sysconfigdata_name()] +except AttributeError: + # Either sysconfig has no attribute _get_sysconfigdata_name (i.e., the function does not exist), or this is Windows + # and the _get_sysconfigdata_name() call failed due to missing sys.abiflags attribute. + pass diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-wcwidth.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-wcwidth.py new file mode 100755 index 0000000..dc7c2dd --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-wcwidth.py @@ -0,0 +1,14 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2017-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('wcwidth') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-win32ctypes.core.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-win32ctypes.core.py new file mode 100755 index 0000000..6971473 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-win32ctypes.core.py @@ -0,0 +1,22 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2020-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# TODO: remove this hook during PyInstaller 4.5 release cycle! + +from PyInstaller.utils.hooks import can_import_module, collect_submodules + +# We need to collect submodules from win32ctypes.core.cffi or win32ctypes.core.ctypes for win32ctypes.core to work. +# Always collect the `ctypes` backend, and add the `cffi` one if `cffi` is available. Having the `ctypes` backend always +# available helps in situations when `cffi` is available in the build environment, but is disabled at run-time or not +# collected (e.g., due to `--exclude cffi`). +hiddenimports = collect_submodules('win32ctypes.core.ctypes') +if can_import_module('cffi'): + hiddenimports += collect_submodules('win32ctypes.core.cffi') diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-xml.dom.domreg.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-xml.dom.domreg.py new file mode 100755 index 0000000..eb7161a --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-xml.dom.domreg.py @@ -0,0 +1,13 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# xml.dom.domreg line 54 +hiddenimports = ['xml.dom.minidom'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-xml.etree.cElementTree.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-xml.etree.cElementTree.py new file mode 100755 index 0000000..95dc702 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-xml.etree.cElementTree.py @@ -0,0 +1,13 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# cElementTree has a hidden import (Python >=2.5 stdlib version) +hiddenimports = ['xml.etree.ElementTree'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-xml.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-xml.py new file mode 100755 index 0000000..d7776a0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-xml.py @@ -0,0 +1,12 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +hiddenimports = ['xml.sax.xmlreader', 'xml.sax.expatreader'] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-zope.interface.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-zope.interface.py new file mode 100755 index 0000000..b43d023 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/hook-zope.interface.py @@ -0,0 +1,12 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +excludedimports = ["unittest"] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/__init__.py new file mode 100755 index 0000000..792d600 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/__init__.py @@ -0,0 +1 @@ +# diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-PyQt5.uic.port_v2.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-PyQt5.uic.port_v2.py new file mode 100755 index 0000000..014c9e2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-PyQt5.uic.port_v2.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_find_module_path(hook_api): + # Forbid imports in the port_v2 directory under Python 3 The code wouldn't import and would crash the build process. + hook_api.search_dirs = [] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-_pyi_rth_utils.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-_pyi_rth_utils.py new file mode 100755 index 0000000..d035df0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-_pyi_rth_utils.py @@ -0,0 +1,25 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +# ----------------------------------------------------------------------------- +""" +This hook allows discovery and collection of PyInstaller's internal _pyi_rth_utils module that provides utility +functions for run-time hooks. + +The module is implemented in 'PyInstaller/fake-modules/_pyi_rth_utils.py'. +""" + +import os + +from PyInstaller import PACKAGEPATH + + +def pre_find_module_path(api): + module_dir = os.path.join(PACKAGEPATH, 'fake-modules') + api.search_dirs = [module_dir] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-distutils.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-distutils.py new file mode 100755 index 0000000..0e7e646 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-distutils.py @@ -0,0 +1,46 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +# ----------------------------------------------------------------------------- +""" +`distutils`-specific pre-find module path hook. + +When run from within a virtual environment, this hook changes the `__path__` of the `distutils` package to +that of the system-wide rather than virtual-environment-specific `distutils` package. While the former is suitable for +freezing, the latter is intended for use _only_ from within virtual environments. + +NOTE: this behavior seems to be specific to virtual environments created by (an old?) version of `virtualenv`; it is not +applicable to virtual environments created by the `venv`. +""" + +import pathlib + +from PyInstaller.utils.hooks import logger, get_module_file_attribute + + +def pre_find_module_path(api): + # Absolute path of the system-wide "distutils" package when run from within a venv or None otherwise. + + # opcode is not a virtualenv module, so we can use it to find the stdlib. Technique taken from virtualenv's + # "distutils" package detection at + # https://github.com/pypa/virtualenv/blob/16.3.0/virtualenv_embedded/distutils-init.py#L5 + # As opcode is a module, stdlib path corresponds to the parent directory of its ``__file__`` attribute. + stdlib_path = pathlib.Path(get_module_file_attribute('opcode')).parent.resolve() + # As distutils is a package, we need to consider the grandparent directory of its ``__file__`` attribute. + distutils_path = pathlib.Path(get_module_file_attribute('distutils')).parent.parent.resolve() + + if distutils_path.name == 'setuptools': + logger.debug("distutils: provided by setuptools") + elif distutils_path == stdlib_path: + logger.debug("distutils: provided by stdlib") + else: + # Find this package in stdlib. + stdlib_path = str(stdlib_path) + logger.debug("distutils: virtualenv shim - retargeting to stdlib dir %r", stdlib_path) + api.search_dirs = [stdlib_path] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-pyi_splash.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-pyi_splash.py new file mode 100755 index 0000000..15f8009 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-pyi_splash.py @@ -0,0 +1,36 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +# ----------------------------------------------------------------------------- +""" +This hook does not move a module that can be installed by a package manager, but points to a PyInstaller internal +module that can be imported into the users python instance. + +The module is implemented in 'PyInstaller/fake-modules/pyi_splash.py'. +""" + +import os + +from PyInstaller import PACKAGEPATH +from PyInstaller.utils.hooks import logger + + +def pre_find_module_path(api): + try: + # Test if a module named 'pyi_splash' is locally installed. This prevents that a potentially required dependency + # is not packed + import pyi_splash # noqa: F401 + except ImportError: + module_dir = os.path.join(PACKAGEPATH, 'fake-modules') + + api.search_dirs = [module_dir] + logger.info('Adding pyi_splash module to application dependencies.') + else: + logger.info('A local module named "pyi_splash" is installed. Use the installed one instead.') + return diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-tkinter.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-tkinter.py new file mode 100755 index 0000000..1cc5a78 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_find_module_path/hook-tkinter.py @@ -0,0 +1,21 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import log as logging +from PyInstaller.utils.hooks import tcl_tk + +logger = logging.getLogger(__name__) + + +def pre_find_module_path(hook_api): + if not tcl_tk.tcltk_info.available: + logger.warning("tkinter installation is broken. It will be excluded from the application") + hook_api.search_dirs = [] diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/__init__.py new file mode 100755 index 0000000..792d600 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/__init__.py @@ -0,0 +1 @@ +# diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-autocommand.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-autocommand.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-autocommand.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-backports.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-backports.py new file mode 100755 index 0000000..3b6a8fc --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-backports.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2025, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This top-level namespace package might be provided by setuptools >= 71.0.0, which makes its vendored dependencies +# public by appending path to its `setuptools._vendored` directory to `sys.path`. The following shared +# pre-safe-import-module hook implementation checks whether this is the case, and, depending on situation, either +# sets up aliases to prevent duplicate collection, or extends the search paths. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module_for_top_level_namespace_packages \ + as pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-backports.tarfile.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-backports.tarfile.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-backports.tarfile.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-distutils.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-distutils.py new file mode 100755 index 0000000..7f88845 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-distutils.py @@ -0,0 +1,23 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import compat +from PyInstaller.utils.hooks.setuptools import setuptools_info + + +def pre_safe_import_module(api): + # `distutils` was removed from from stdlib in python 3.12; if it is available, it is provided by `setuptools`. + # Therefore, we need to create package/module alias entries, which prevent the setuptools._distutils` and its + # submodules from being collected as top-level modules (as `distutils` and its submodules) in addition to being + # collected as their "true" names. + if compat.is_py312 and setuptools_info.distutils_vendored: + for aliased_name, real_vendored_name in setuptools_info.get_distutils_aliases(): + api.add_alias_module(real_vendored_name, aliased_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.overrides.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.overrides.py new file mode 100755 index 0000000..c98573a --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.overrides.py @@ -0,0 +1,26 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2025, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import compat +from PyInstaller.utils import hooks as hookutils + + +def pre_safe_import_module(api): + if compat.is_linux: + # See comment in the adjacent `hook-gi.py`. + try: + paths = hookutils.get_module_attribute(api.module_name, "__path__") + except Exception: + # Most likely `gi.overrides` cannot be imported. + paths = [] + + for path in paths: + api.append_package_path(path) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.py new file mode 100755 index 0000000..409007c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.py @@ -0,0 +1,40 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2022-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import compat +from PyInstaller.utils import hooks as hookutils + + +def pre_safe_import_module(api): + if compat.is_linux: + # RHEL/Fedora RPM package for GObject introspection is known to split the `gi` package into two locations: + # - /usr/lib64/python3.x/site-packages/gi + # - /usr/lib/python3.x/site-packages/gi + # The `__init__.py` is located in the first directory, while `repository` and `overrides` are located in + # the second, and `__init__.py` dynamically extends the `__path__` during package import, using + # `__path__ = pkgutil.extend_path(__path__, __name__)`. + # The modulegraph has no way of knowing this, so we need extend the package path in this hook. Otherwise, + # only the first location is scanned, and the `gi.repository` ends up missing. + # + # ADDENDUM: it looks like the `gi.overrides` can also be split across both locations, so we need a similar + # hook for `gi.overrides` as well. + # + # NOTE: the `get_package_paths`/`get_package_all_paths` helpers read the paths from package's spec without + # importing the (top-level) package, so they do not catch run-time path modifications. Instead, we use + # `get_module_attribute` to import the package in isolated process and query its `__path__` attribute. + try: + paths = hookutils.get_module_attribute(api.module_name, "__path__") + except Exception: + # Most likely `gi` cannot be imported. + paths = [] + + for path in paths: + api.append_package_path(path) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Adw.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Adw.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Adw.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.AppIndicator3.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.AppIndicator3.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.AppIndicator3.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Atk.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Atk.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Atk.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.AyatanaAppIndicator3.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.AyatanaAppIndicator3.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.AyatanaAppIndicator3.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Champlain.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Champlain.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Champlain.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Clutter.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Clutter.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Clutter.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.DBus.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.DBus.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.DBus.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GIRepository.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GIRepository.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GIRepository.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GLib.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GLib.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GLib.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GModule.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GModule.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GModule.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GObject.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GObject.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GObject.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gdk.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gdk.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gdk.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GdkPixbuf.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GdkPixbuf.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GdkPixbuf.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gio.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gio.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gio.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Graphene.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Graphene.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Graphene.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gsk.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gsk.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gsk.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gst.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gst.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gst.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstAllocators.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstAllocators.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstAllocators.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstApp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstApp.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstApp.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstAudio.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstAudio.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstAudio.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstBadAudio.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstBadAudio.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstBadAudio.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstBase.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstBase.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstBase.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstCheck.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstCheck.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstCheck.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstCodecs.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstCodecs.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstCodecs.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstController.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstController.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstController.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGL.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGL.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGL.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGLEGL.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGLEGL.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGLEGL.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGLWayland.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGLWayland.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGLWayland.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGLX11.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGLX11.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGLX11.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstInsertBin.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstInsertBin.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstInsertBin.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstMpegts.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstMpegts.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstMpegts.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstNet.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstNet.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstNet.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstPbutils.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstPbutils.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstPbutils.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstPlay.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstPlay.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstPlay.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstPlayer.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstPlayer.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstPlayer.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstRtp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstRtp.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstRtp.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstRtsp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstRtsp.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstRtsp.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstRtspServer.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstRtspServer.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstRtspServer.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstSdp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstSdp.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstSdp.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstTag.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstTag.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstTag.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstTranscoder.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstTranscoder.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstTranscoder.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVideo.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVideo.py new file mode 100755 index 0000000..e75bfee --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVideo.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert + # them to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVulkan.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVulkan.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVulkan.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVulkanWayland.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVulkanWayland.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVulkanWayland.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVulkanXCB.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVulkanXCB.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVulkanXCB.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstWebRTC.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstWebRTC.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstWebRTC.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gtk.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gtk.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gtk.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkChamplain.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkChamplain.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkChamplain.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkClutter.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkClutter.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkClutter.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkSource.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkSource.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkSource.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkosxApplication.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkosxApplication.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkosxApplication.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.HarfBuzz.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.HarfBuzz.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.HarfBuzz.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.OsmGpsMap.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.OsmGpsMap.py new file mode 100755 index 0000000..cb80208 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.OsmGpsMap.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2025, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Pango.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Pango.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Pango.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.PangoCairo.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.PangoCairo.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.PangoCairo.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Rsvg.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Rsvg.py new file mode 100755 index 0000000..a9978ab --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Rsvg.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.cairo.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.cairo.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.cairo.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.freetype2.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.freetype2.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.freetype2.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.xlib.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.xlib.py new file mode 100755 index 0000000..131ce95 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.xlib.py @@ -0,0 +1,16 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + + +def pre_safe_import_module(api): + # PyGObject modules loaded through the gi repository are marked as MissingModules by modulegraph, so we convert them + # to RuntimeModules in order for their hooks to be loaded and executed. + api.add_runtime_module(api.module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-importlib_metadata.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-importlib_metadata.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-importlib_metadata.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-importlib_resources.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-importlib_resources.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-importlib_resources.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-inflect.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-inflect.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-inflect.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-jaraco.context.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-jaraco.context.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-jaraco.context.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-jaraco.functools.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-jaraco.functools.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-jaraco.functools.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-jaraco.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-jaraco.py new file mode 100755 index 0000000..3b6a8fc --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-jaraco.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2025, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This top-level namespace package might be provided by setuptools >= 71.0.0, which makes its vendored dependencies +# public by appending path to its `setuptools._vendored` directory to `sys.path`. The following shared +# pre-safe-import-module hook implementation checks whether this is the case, and, depending on situation, either +# sets up aliases to prevent duplicate collection, or extends the search paths. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module_for_top_level_namespace_packages \ + as pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-jaraco.text.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-jaraco.text.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-jaraco.text.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-more_itertools.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-more_itertools.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-more_itertools.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-ordered_set.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-ordered_set.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-ordered_set.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-packaging.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-packaging.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-packaging.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-platformdirs.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-platformdirs.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-platformdirs.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-setuptools.extern.six.moves.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-setuptools.extern.six.moves.py new file mode 100755 index 0000000..5a09a89 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-setuptools.extern.six.moves.py @@ -0,0 +1,39 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import isolated + +# This is basically a copy of pre_safe_import_module/hook-six.moves.py adopted to setuptools.extern.six resp. +# setuptools._vendor.six. Please see pre_safe_import_module/hook-six.moves.py for documentation. + +# Note that the moves are defined in 'setuptools._vendor.six' but are imported under 'setuptools.extern.six'. + + +def pre_safe_import_module(api): + @isolated.call + def real_to_six_module_name(): + try: + import setuptools._vendor.six as six + except ImportError: + try: + import setuptools.extern.six as six + except ImportError: + return None # unavailable + + return { + moved.mod: 'setuptools.extern.six.moves.' + moved.name + for moved in six._moved_attributes if isinstance(moved, (six.MovedModule, six.MovedAttribute)) + } + + if real_to_six_module_name is not None: + api.add_runtime_package(api.module_name) + for real_module_name, six_module_name in real_to_six_module_name.items(): + api.add_alias_module(real_module_name, six_module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-six.moves.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-six.moves.py new file mode 100755 index 0000000..1c86669 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-six.moves.py @@ -0,0 +1,62 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import isolated + + +def pre_safe_import_module(api): + """ + Add the `six.moves` module as a dynamically defined runtime module node and all modules mapped by + `six._SixMetaPathImporter` as aliased module nodes to the passed graph. + + The `six.moves` module is dynamically defined at runtime by the `six` module and hence cannot be imported in the + standard way. Instead, this hook adds a placeholder node for the `six.moves` module to the graph, + which implicitly adds an edge from that node to the node for its parent `six` module. This ensures that the `six` + module will be frozen into the executable. (Phew!) + + `six._SixMetaPathImporter` is a PEP 302-compliant module importer converting imports independent of the current + Python version into imports specific to that version (e.g., under Python 3, from `from six.moves import + tkinter_tix` to `import tkinter.tix`). For each such mapping, this hook adds a corresponding module alias to the + graph allowing PyInstaller to translate the former to the latter. + """ + @isolated.call + def real_to_six_module_name(): + """ + Generate a dictionary from conventional module names to "six.moves" attribute names (e.g., from `tkinter.tix` to + `six.moves.tkinter_tix`). + """ + try: + import six + except ImportError: + return None # unavailable + + # Iterate over the "six._moved_attributes" list rather than the "six._importer.known_modules" dictionary, as + # "urllib"-specific moved modules are overwritten in the latter with unhelpful "LazyModule" objects. If this is + # a moved module or attribute, map the corresponding module. In the case of moved attributes, the attribute's + # module is mapped while the attribute itself is mapped at runtime and hence ignored here. + return { + moved.mod: 'six.moves.' + moved.name + for moved in six._moved_attributes if isinstance(moved, (six.MovedModule, six.MovedAttribute)) + } + + # Add "six.moves" as a runtime package rather than module. Modules cannot physically contain submodules; only + # packages can. In "from"-style import statements (e.g., "from six.moves import queue"), this implies that: + # * Attributes imported from customary modules are guaranteed *NOT* to be submodules. Hence, ModuleGraph justifiably + # ignores these attributes. While some attributes declared by "six.moves" are ignorable non-modules (e.g., + # functions, classes), others are non-ignorable submodules that must be imported. Adding "six.moves" as a runtime + # module causes ModuleGraph to ignore these submodules, which defeats the entire point. + # * Attributes imported from packages could be submodules. To disambiguate non-ignorable submodules from ignorable + # non-submodules (e.g., classes, variables), ModuleGraph first attempts to import these attributes as submodules. + # This is exactly what we want. + if real_to_six_module_name is not None: + api.add_runtime_package(api.module_name) + for real_module_name, six_module_name in real_to_six_module_name.items(): + api.add_alias_module(real_module_name, six_module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-tomli.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-tomli.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-tomli.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-typeguard.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-typeguard.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-typeguard.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-typing_extensions.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-typing_extensions.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-typing_extensions.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-urllib3.packages.six.moves.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-urllib3.packages.six.moves.py new file mode 100755 index 0000000..d257f83 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-urllib3.packages.six.moves.py @@ -0,0 +1,34 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from PyInstaller import isolated + +# This basically is a copy of pre_safe_import_module/hook-six.moves.py adopted to urllib3.packages.six. Please see +# pre_safe_import_module/hook-six.moves.py for documentation. + + +def pre_safe_import_module(api): + @isolated.call + def real_to_six_module_name(): + try: + import urllib3.packages.six as six + except ImportError: + return None # unavailable + + return { + moved.mod: 'urllib3.packages.six.moves.' + moved.name + for moved in six._moved_attributes if isinstance(moved, (six.MovedModule, six.MovedAttribute)) + } + + if real_to_six_module_name is not None: + api.add_runtime_package(api.module_name) + for real_module_name, six_module_name in real_to_six_module_name.items(): + api.add_alias_module(real_module_name, six_module_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-wheel.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-wheel.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-wheel.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-zipp.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-zipp.py new file mode 100755 index 0000000..83c7249 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/pre_safe_import_module/hook-zipp.py @@ -0,0 +1,15 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# This package/module might be provided by setuptools >= 71.0.0, which makes its vendored dependencies public by +# appending path to its `setuptools._vendored` directory to `sys.path`. The following shared pre-safe-import-module +# hook implementation checks whether this is the case, and sets up aliases to prevent duplicate collection. +from PyInstaller.utils.hooks.setuptools import pre_safe_import_module # noqa: F401 diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks.dat b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks.dat new file mode 100755 index 0000000..c024452 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks.dat @@ -0,0 +1,23 @@ +{ + 'django': ['pyi_rth_django.py'], + 'gi': ['pyi_rth_gi.py'], + 'gi.repository.Gio': ['pyi_rth_gio.py'], + 'gi.repository.GLib': ['pyi_rth_glib.py'], + 'gi.repository.GdkPixbuf': ['pyi_rth_gdkpixbuf.py'], + 'gi.repository.Gtk': ['pyi_rth_gtk.py'], + 'gi.repository.Gst': ['pyi_rth_gstreamer.py'], + 'gst': ['pyi_rth_gstreamer.py'], + 'inspect': ['pyi_rth_inspect.py'], + 'kivy': ['pyi_rth_kivy.py'], + 'kivy.lib.gstplayer': ['pyi_rth_gstreamer.py'], + 'matplotlib': ['pyi_rth_mplconfig.py'], + 'pkgutil': ['pyi_rth_pkgutil.py'], + 'pkg_resources': ['pyi_rth_pkgres.py'], + 'PyQt5': ['pyi_rth_pyqt5.py'], + 'PyQt6': ['pyi_rth_pyqt6.py'], + 'PySide2': ['pyi_rth_pyside2.py'], + 'PySide6': ['pyi_rth_pyside6.py'], + '_tkinter': ['pyi_rth__tkinter.py'], + 'multiprocessing': ['pyi_rth_multiprocessing.py'], + 'setuptools': ['pyi_rth_setuptools.py'], +} diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/__init__.py new file mode 100755 index 0000000..792d600 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/__init__.py @@ -0,0 +1 @@ +# diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth__tkinter.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth__tkinter.py new file mode 100755 index 0000000..ae154f8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth__tkinter.py @@ -0,0 +1,37 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + + +def _pyi_rthook(): + import os + import sys + + # The directory names must match TCL_ROOTNAME and TK_ROOTNAME constants defined in `PyInstaller.utils.hooks.tcl_tk`. + tcldir = os.path.join(sys._MEIPASS, '_tcl_data') + tkdir = os.path.join(sys._MEIPASS, '_tk_data') + + # Notify "tkinter" of data directories. On macOS, we do not collect data directories if system Tcl/Tk framework is + # used. On other OSes, we always collect them, so their absence is considered an error. + is_darwin = sys.platform == 'darwin' + + if os.path.isdir(tcldir): + os.environ["TCL_LIBRARY"] = tcldir + elif not is_darwin: + raise FileNotFoundError('Tcl data directory "%s" not found.' % tcldir) + + if os.path.isdir(tkdir): + os.environ["TK_LIBRARY"] = tkdir + elif not is_darwin: + raise FileNotFoundError('Tk data directory "%s" not found.' % tkdir) + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_django.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_django.py new file mode 100755 index 0000000..81243bd --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_django.py @@ -0,0 +1,34 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# This Django rthook was tested with Django 1.8.3. + + +def _pyi_rthook(): + import django.utils.autoreload + + _old_restart_with_reloader = django.utils.autoreload.restart_with_reloader + + def _restart_with_reloader(*args): + import sys + a0 = sys.argv.pop(0) + try: + return _old_restart_with_reloader(*args) + finally: + sys.argv.insert(0, a0) + + # Override restart_with_reloader() function, otherwise the app might complain that some commands do not exist; + # e.g., runserver. + django.utils.autoreload.restart_with_reloader = _restart_with_reloader + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gdkpixbuf.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gdkpixbuf.py new file mode 100755 index 0000000..de8223f --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gdkpixbuf.py @@ -0,0 +1,41 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + + +def _pyi_rthook(): + import atexit + import os + import sys + import tempfile + + pixbuf_file = os.path.join(sys._MEIPASS, 'lib', 'gdk-pixbuf', 'loaders.cache') + + # If we are not on Windows, we need to rewrite the cache -> we rewrite on macOS to support --onefile mode + if os.path.exists(pixbuf_file) and sys.platform != 'win32': + with open(pixbuf_file, 'rb') as fp: + contents = fp.read() + + # Create a temporary file with the cache and cleverly replace the prefix we injected with the actual path. + fd, pixbuf_file = tempfile.mkstemp() + with os.fdopen(fd, 'wb') as fp: + libpath = os.path.join(sys._MEIPASS, 'lib').encode('utf-8') + fp.write(contents.replace(b'@executable_path/lib', libpath)) + + try: + atexit.register(os.unlink, pixbuf_file) + except OSError: + pass + + os.environ['GDK_PIXBUF_MODULE_FILE'] = pixbuf_file + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gi.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gi.py new file mode 100755 index 0000000..3c3b382 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gi.py @@ -0,0 +1,21 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + + +def _pyi_rthook(): + import os + import sys + + os.environ['GI_TYPELIB_PATH'] = os.path.join(sys._MEIPASS, 'gi_typelibs') + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gio.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gio.py new file mode 100755 index 0000000..f9fc307 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gio.py @@ -0,0 +1,21 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + + +def _pyi_rthook(): + import os + import sys + + os.environ['GIO_MODULE_DIR'] = os.path.join(sys._MEIPASS, 'gio_modules') + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_glib.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_glib.py new file mode 100755 index 0000000..35bd7f8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_glib.py @@ -0,0 +1,37 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + + +def _pyi_rthook(): + import os + import sys + + # Prepend the frozen application's data dir to XDG_DATA_DIRS. We need to avoid overwriting the existing paths in + # order to allow the frozen application to run system-installed applications (for example, launch a web browser via + # the webbrowser module on Linux). Should the user desire complete isolation of the frozen application from the + # system, they need to clean up XDG_DATA_DIRS at the start of their program (i.e., remove all entries but first). + pyi_data_dir = os.path.join(sys._MEIPASS, 'share') + + xdg_data_dirs = os.environ.get('XDG_DATA_DIRS', None) + if xdg_data_dirs: + if pyi_data_dir not in xdg_data_dirs: + xdg_data_dirs = pyi_data_dir + os.pathsep + xdg_data_dirs + else: + xdg_data_dirs = pyi_data_dir + os.environ['XDG_DATA_DIRS'] = xdg_data_dirs + + # Cleanup aux variables + del xdg_data_dirs + del pyi_data_dir + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gstreamer.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gstreamer.py new file mode 100755 index 0000000..5663229 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gstreamer.py @@ -0,0 +1,32 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + + +def _pyi_rthook(): + import os + import sys + + # Without this environment variable set to 'no' importing 'gst' causes 100% CPU load. (Tested on macOS.) + os.environ['GST_REGISTRY_FORK'] = 'no' + + gst_plugin_paths = [sys._MEIPASS, os.path.join(sys._MEIPASS, 'gst-plugins')] + os.environ['GST_PLUGIN_PATH'] = os.pathsep.join(gst_plugin_paths) + + # Prevent permission issues on Windows + os.environ['GST_REGISTRY'] = os.path.join(sys._MEIPASS, 'registry.bin') + + # Only use packaged plugins to prevent GStreamer from crashing when it finds plugins from another version which are + # installed system wide. + os.environ['GST_PLUGIN_SYSTEM_PATH'] = '' + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gtk.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gtk.py new file mode 100755 index 0000000..d6ae21c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_gtk.py @@ -0,0 +1,27 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + + +def _pyi_rthook(): + import os + import sys + + os.environ['GTK_DATA_PREFIX'] = sys._MEIPASS + os.environ['GTK_EXE_PREFIX'] = sys._MEIPASS + os.environ['GTK_PATH'] = sys._MEIPASS + + # Include these here, as GTK will import pango automatically. + os.environ['PANGO_LIBDIR'] = sys._MEIPASS + os.environ['PANGO_SYSCONFDIR'] = os.path.join(sys._MEIPASS, 'etc') # TODO? + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_inspect.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_inspect.py new file mode 100755 index 0000000..2575997 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_inspect.py @@ -0,0 +1,99 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + + +def _pyi_rthook(): + import inspect + import os + import sys + import zipfile + + # Use sys._MEIPASS with normalized path component separator. This is necessary on some platforms (i.e., msys2/mingw + # python on Windows), because we use string comparisons on the paths. + SYS_PREFIX = os.path.normpath(sys._MEIPASS) + BASE_LIBRARY = os.path.join(SYS_PREFIX, "base_library.zip") + + # Obtain the list of modules in base_library.zip, so we can use it in our `_pyi_getsourcefile` implementation. + def _get_base_library_files(filename): + # base_library.zip might not exit + if not os.path.isfile(filename): + return set() + + with zipfile.ZipFile(filename, 'r') as zf: + namelist = zf.namelist() + + return set(os.path.normpath(entry) for entry in namelist) + + base_library_files = _get_base_library_files(BASE_LIBRARY) + + # Provide custom implementation of inspect.getsourcefile() for frozen applications that properly resolves relative + # filenames obtained from object (e.g., inspect stack-frames). See #5963. + # + # Although we are overriding `inspect.getsourcefile` function, we are NOT trying to resolve source file here! + # The main purpose of this implementation is to properly resolve relative file names obtained from `co_filename` + # attribute of code objects (which are, in turn, obtained from in turn are obtained from `frame` and `traceback` + # objects). PyInstaller strips absolute paths from `co_filename` when collecting modules, as the original absolute + # paths are not portable/relocatable anyway. The `inspect` module tries to look up the module that corresponds to + # the code object by comparing modules' `__file__` attribute to the value of `co_filename`. Therefore, our override + # needs to resolve the relative file names (usually having a .py suffix) into absolute module names (which, in the + # frozen application, usually have .pyc suffix). + # + # The `inspect` module retrieves the actual source code using `linecache.getlines()`. If the passed source filename + # does not exist, the underlying implementation end up resolving the module, and obtains the source via loader's + # `get_source` method. So for modules in the PYZ archive, it ends up calling `get_source` implementation on our + # `PyiFrozenLoader`. For modules in `base_library.zip`, it ends up calling `get_source` on python's own + # `zipimport.zipimporter`; to properly handle out-of-zip source files, we therefore need to monkey-patch + # `get_source` with our own override that translates the in-zip .pyc filename into out-of-zip .py file location + # and loads the source (this override is done in `pyimod02_importers` module). + # + # The above-described fallback takes place if the .pyc file does not exist on filesystem - if this ever becomes + # a problem, we could consider monkey-patching `linecache.updatecache` (and possibly `checkcache`) to translate + # .pyc paths in `sys._MEIPASS` and `base_library.zip` into .py paths in `sys._MEIPASS` before calling the original + # implementation. + _orig_inspect_getsourcefile = inspect.getsourcefile + + def _pyi_getsourcefile(object): + filename = inspect.getfile(object) + filename = os.path.normpath(filename) # Ensure path component separators are normalized. + if not os.path.isabs(filename): + # Check if given filename matches the basename of __main__'s __file__. + main_file = getattr(sys.modules['__main__'], '__file__', None) + if main_file and filename == os.path.basename(main_file): + return main_file + + # If the relative filename does not correspond to the frozen entry-point script, convert it to the absolute + # path in either `sys._MEIPASS/base_library.zip` or `sys._MEIPASS`, whichever applicable. + # + # The modules in `sys._MEIPASS/base_library.zip` are handled by python's `zipimport.zipimporter`, and have + # their __file__ attribute point to the .pyc file in the archive. So we match the behavior, in order to + # facilitate matching via __file__ attribute and use of loader's `get_source`, as per the earlier comment + # block. + # + # The modules in PYZ archive are handled by our `PyFrozenLoader`, which now sets the module's __file__ + # attribute to point to where .py files would be. Therefore, we can directly merge SYS_PREFIX and filename + # (and if the source .py file exists, it will be loaded directly from filename, without the intermediate + # loader look-up). + pyc_filename = filename + 'c' + if pyc_filename in base_library_files: + return os.path.normpath(os.path.join(BASE_LIBRARY, pyc_filename)) + return os.path.normpath(os.path.join(SYS_PREFIX, filename)) + elif filename.startswith(SYS_PREFIX): + # If filename is already an absolute file path pointing into application's top-level directory, return it + # as-is and prevent any further processing. + return filename + # Use original implementation as a fallback. + return _orig_inspect_getsourcefile(object) + + inspect.getsourcefile = _pyi_getsourcefile + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_kivy.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_kivy.py new file mode 100755 index 0000000..0846401 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_kivy.py @@ -0,0 +1,24 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + + +def _pyi_rthook(): + import os + import sys + + root = os.path.join(sys._MEIPASS, 'kivy_install') + + os.environ['KIVY_DATA_DIR'] = os.path.join(root, 'data') + os.environ['KIVY_MODULES_DIR'] = os.path.join(root, 'modules') + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_mplconfig.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_mplconfig.py new file mode 100755 index 0000000..93fec80 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_mplconfig.py @@ -0,0 +1,46 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# matplotlib will create $HOME/.matplotlib folder in user's home directory. In this directory there is fontList.cache +# file which lists paths to matplotlib fonts. +# +# When you run your onefile exe for the first time it's extracted to for example "_MEIxxxxx" temp directory and +# fontList.cache file is created with fonts paths pointing to this directory. +# +# Second time you run your exe new directory is created "_MEIyyyyy" but fontList.cache file still points to previous +# directory which was deleted. And then you will get error like: +# +# RuntimeError: Could not open facefile +# +# We need to force matplotlib to recreate config directory every time you run your app. + + +def _pyi_rthook(): + import atexit + import os + import shutil + + import _pyi_rth_utils.tempfile # PyInstaller's run-time hook utilities module + + # Isolate matplotlib's config dir into temporary directory. + # Use our replacement for `tempfile.mkdtemp` function that properly restricts access to directory on all platforms. + configdir = _pyi_rth_utils.tempfile.secure_mkdtemp() + os.environ['MPLCONFIGDIR'] = configdir + + try: + # Remove temp directory at application exit and ignore any errors. + atexit.register(shutil.rmtree, configdir, ignore_errors=True) + except OSError: + pass + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_multiprocessing.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_multiprocessing.py new file mode 100755 index 0000000..f596d93 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_multiprocessing.py @@ -0,0 +1,55 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2017-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + + +def _pyi_rthook(): + import sys + + import multiprocessing + import multiprocessing.spawn + + from subprocess import _args_from_interpreter_flags + + # Prevent `spawn` from trying to read `__main__` in from the main script + multiprocessing.process.ORIGINAL_DIR = None + + def _freeze_support(): + # We want to catch the two processes that are spawned by the multiprocessing code: + # - the semaphore tracker, which cleans up named semaphores in the `spawn` multiprocessing mode + # - the fork server, which keeps track of worker processes in the `forkserver` mode. + # Both of these processes are started by spawning a new copy of the running executable, passing it the flags + # from `_args_from_interpreter_flags` and then "-c" and an import statement. + # Look for those flags and the import statement, then `exec()` the code ourselves. + + if ( + len(sys.argv) >= 2 and sys.argv[-2] == '-c' and sys.argv[-1].startswith( + ('from multiprocessing.resource_tracker import main', 'from multiprocessing.forkserver import main') + ) and set(sys.argv[1:-2]) == set(_args_from_interpreter_flags()) + ): + exec(sys.argv[-1]) + sys.exit() + + if multiprocessing.spawn.is_forking(sys.argv): + kwds = {} + for arg in sys.argv[2:]: + name, value = arg.split('=') + if value == 'None': + kwds[name] = None + else: + kwds[name] = int(value) + multiprocessing.spawn.spawn_main(**kwds) + sys.exit() + + multiprocessing.freeze_support = multiprocessing.spawn.freeze_support = _freeze_support + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pkgres.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pkgres.py new file mode 100755 index 0000000..fe59194 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pkgres.py @@ -0,0 +1,178 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# To make pkg_resources work with frozen modules, we need to set the 'Provider' class for PyiFrozenLoader. +# This class decides where to look for resources and other stuff. +# +# 'pkg_resources.NullProvider' is dedicated to abitrary PEP302 loaders, such as our PyiFrozenLoader. It uses method +# __loader__.get_data() in methods pkg_resources.resource_string() and pkg_resources.resource_stream(). +# +# We provide PyiFrozenProvider, which subclasses the NullProvider and implements _has(), _isdir(), and _listdir() +# methods, which are needed for pkg_resources.resource_exists(), resource_isdir(), and resource_listdir() to work. We +# cannot use the DefaultProvider, because it provides filesystem-only implementations (and overrides _get() with a +# filesystem-only one), whereas our provider needs to also support embedded resources. +# +# The PyiFrozenProvider allows querying/listing both PYZ-embedded and on-filesystem resources in a frozen package. The +# results are typically combined for both types of resources (e.g., when listing a directory or checking whether a +# resource exists). When the order of precedence matters, the PYZ-embedded resources take precedence over the +# on-filesystem ones, to keep the behavior consistent with the actual file content retrieval via _get() method (which in +# turn uses PyiFrozenLoader's get_data() method). For example, when checking whether a resource is a directory via +# _isdir(), a PYZ-embedded file will take precedence over a potential on-filesystem directory. Also, in contrast to +# unfrozen packages, the frozen ones do not contain source .py files, which are therefore absent from content listings. + + +def _pyi_rthook(): + import os + import pathlib + import sys + import warnings + + with warnings.catch_warnings(): + warnings.filterwarnings( + "ignore", + category=UserWarning, + message="pkg_resources is deprecated", + ) + import pkg_resources + + import pyimod02_importers # PyInstaller's bootstrap module + + SYS_PREFIX = pathlib.PurePath(sys._MEIPASS) + + class _TocFilesystem: + """ + A prefix tree implementation for embedded filesystem reconstruction. + + NOTE: as of PyInstaller 6.0, the embedded PYZ archive cannot contain data files anymore. Instead, it contains + only .pyc modules - which are by design not returned by `PyiFrozenProvider`. So this implementation has been + reduced to supporting only directories implied by collected packages. + """ + def __init__(self, tree_node): + self._tree = tree_node + + def _get_tree_node(self, path): + path = pathlib.PurePath(path) + current = self._tree + for component in path.parts: + if component not in current: + return None + current = current[component] + return current + + def path_exists(self, path): + node = self._get_tree_node(path) + return isinstance(node, dict) # Directory only + + def path_isdir(self, path): + node = self._get_tree_node(path) + return isinstance(node, dict) # Directory only + + def path_listdir(self, path): + node = self._get_tree_node(path) + if not isinstance(node, dict): + return [] # Non-existent or file + # Return only sub-directories + return [entry_name for entry_name, entry_data in node.items() if isinstance(entry_data, dict)] + + class PyiFrozenProvider(pkg_resources.NullProvider): + """ + Custom pkg_resources provider for PyiFrozenLoader. + """ + def __init__(self, module): + super().__init__(module) + + # Get top-level path; if "module" corresponds to a package, we need the path to the package itself. + # If "module" is a submodule in a package, we need the path to the parent package. + # + # This is equivalent to `pkg_resources.NullProvider.module_path`, except we construct a `pathlib.PurePath` + # for easier manipulation. + # + # NOTE: the path is NOT resolved for symbolic links, as neither are paths that are passed by `pkg_resources` + # to `_has`, `_isdir`, `_listdir` (they are all anchored to `module_path`, which in turn is just + # `os.path.dirname(module.__file__)`. As `__file__` returned by `PyiFrozenLoader` is always anchored to + # `sys._MEIPASS`, we do not have to worry about cross-linked directories in macOS .app bundles, where the + # resolved `__file__` could be either in the `Contents/Frameworks` directory (the "true" `sys._MEIPASS`), or + # in the `Contents/Resources` directory due to cross-linking. + self._pkg_path = pathlib.PurePath(module.__file__).parent + + # Construct _TocFilesystem on top of pre-computed prefix tree provided by pyimod02_importers. + self.embedded_tree = _TocFilesystem(pyimod02_importers.get_pyz_toc_tree()) + + def _normalize_path(self, path): + # Avoid using `Path.resolve`, because it resolves symlinks. This is undesirable, because the pure path in + # `self._pkg_path` does not have symlinks resolved, so comparison between the two would be faulty. Instead, + # use `os.path.normpath` to normalize the path and get rid of any '..' elements (the path itself should + # already be absolute). + return pathlib.Path(os.path.normpath(path)) + + def _is_relative_to_package(self, path): + return path == self._pkg_path or self._pkg_path in path.parents + + def _has(self, path): + # Prevent access outside the package. + path = self._normalize_path(path) + if not self._is_relative_to_package(path): + return False + + # Check the filesystem first to avoid unnecessarily computing the relative path... + if path.exists(): + return True + rel_path = path.relative_to(SYS_PREFIX) + return self.embedded_tree.path_exists(rel_path) + + def _isdir(self, path): + # Prevent access outside the package. + path = self._normalize_path(path) + if not self._is_relative_to_package(path): + return False + + # Embedded resources have precedence over filesystem... + rel_path = path.relative_to(SYS_PREFIX) + node = self.embedded_tree._get_tree_node(rel_path) + if node is None: + return path.is_dir() # No match found; try the filesystem. + else: + # str = file, dict = directory + return not isinstance(node, str) + + def _listdir(self, path): + # Prevent access outside the package. + path = self._normalize_path(path) + if not self._is_relative_to_package(path): + return [] + + # Relative path for searching embedded resources. + rel_path = path.relative_to(SYS_PREFIX) + # List content from embedded filesystem... + content = self.embedded_tree.path_listdir(rel_path) + # ... as well as the actual one. + if path.is_dir(): + # Use os.listdir() to avoid having to convert Path objects to strings... Also make sure to de-duplicate + # the results. + path = str(path) # not is_py36 + content = list(set(content + os.listdir(path))) + return content + + pkg_resources.register_loader_type(pyimod02_importers.PyiFrozenLoader, PyiFrozenProvider) + + # With our PyiFrozenFinder now being a path entry finder, it effectively replaces python's FileFinder. So we need + # to register it with `pkg_resources.find_on_path` to allow metadata to be found on filesystem. + pkg_resources.register_finder(pyimod02_importers.PyiFrozenFinder, pkg_resources.find_on_path) + + # For the above change to fully take effect, we need to re-initialize pkg_resources's master working set (since the + # original one was built with assumption that sys.path entries are handled by python's FileFinder). + # See https://github.com/pypa/setuptools/issues/373 + if hasattr(pkg_resources, '_initialize_master_working_set'): + pkg_resources._initialize_master_working_set() + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pkgutil.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pkgutil.py new file mode 100755 index 0000000..e619d54 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pkgutil.py @@ -0,0 +1,64 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- +# +# The run-time hook provides a custom module iteration function for our PyiFrozenFinder, which allows +# `pkgutil.iter_modules()` to return entries for modules that are embedded in the PYZ archive. The non-embedded modules +# (binary extensions, modules collected as only source .py files, etc.) are enumerated using the `fallback_finder` +# provided by `PyiFrozenFinder` (which typically would be the python's `FileFinder`). +def _pyi_rthook(): + import pkgutil + + import pyimod02_importers # PyInstaller's bootstrap module + + # This could, in fact, be implemented as `iter_modules()` method of the `PyiFrozenFinder`. However, we want to + # avoid importing `pkgutil` in that bootstrap module (i.e., for the `pkgutil.iter_importer_modules()` call on the + # fallback finder). + def _iter_pyi_frozen_finder_modules(finder, prefix=''): + # Fetch PYZ TOC tree from pyimod02_importers + pyz_toc_tree = pyimod02_importers.get_pyz_toc_tree() + + # Finder has already pre-computed the package prefix implied by the search path. Use it to find the starting + # node in the prefix tree. + if finder._pyz_entry_prefix: + pkg_name_parts = finder._pyz_entry_prefix.split('.') + else: + pkg_name_parts = [] + + tree_node = pyz_toc_tree + for pkg_name_part in pkg_name_parts: + tree_node = tree_node.get(pkg_name_part) + if not isinstance(tree_node, dict): + # This check handles two cases: + # a) path does not exist (`tree_node` is `None`) + # b) path corresponds to a module instead of a package (`tree_node` is a leaf node (`str`)). + tree_node = {} + break + + # Dump the contents of the tree node. + for entry_name, entry_data in tree_node.items(): + is_pkg = isinstance(entry_data, dict) + yield prefix + entry_name, is_pkg + + # If our finder has a fall-back finder available, iterate its modules as well. By using the public + # `fallback_finder` attribute, we force creation of the fallback finder as necessary. + # NOTE: we do not care about potential duplicates here, because `pkgutil.iter_modules()` itself + # keeps track of yielded names for purposes of de-duplication. + if finder.fallback_finder is not None: + yield from pkgutil.iter_importer_modules(finder.fallback_finder, prefix) + + pkgutil.iter_importer_modules.register( + pyimod02_importers.PyiFrozenFinder, + _iter_pyi_frozen_finder_modules, + ) + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pyqt5.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pyqt5.py new file mode 100755 index 0000000..fa388e8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pyqt5.py @@ -0,0 +1,68 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# The path to Qt's components may not default to the wheel layout for self-compiled PyQt5 installations. Mandate the +# wheel layout. See ``utils/hooks/qt.py`` for more details. + + +def _pyi_rthook(): + import os + import sys + + from _pyi_rth_utils import is_macos_app_bundle, prepend_path_to_environment_variable + from _pyi_rth_utils import qt as qt_rth_utils + + # Ensure this is the only Qt bindings package in the application. + qt_rth_utils.ensure_single_qt_bindings_package("PyQt5") + + # Try PyQt5 5.15.4-style path first... + pyqt_path = os.path.join(sys._MEIPASS, 'PyQt5', 'Qt5') + if not os.path.isdir(pyqt_path): + # ... and fall back to the older version + pyqt_path = os.path.join(sys._MEIPASS, 'PyQt5', 'Qt') + + os.environ['QT_PLUGIN_PATH'] = os.path.join(pyqt_path, 'plugins') + + if is_macos_app_bundle: + # Special handling for macOS .app bundles. To satisfy codesign requirements, we are forced to split `qml` + # directory into two parts; one that keeps only binaries (rooted in `Contents/Frameworks`) and one that keeps + # only data files (rooted in `Contents/Resources), with files from one directory tree being symlinked to the + # other to maintain illusion of a single mixed-content directory. As Qt seems to compute the identifier of its + # QML components based on location of the `qmldir` file w.r.t. the registered QML import paths, we need to + # register both paths, because the `qmldir` file for a component could be reached via either directory tree. + pyqt_path_res = os.path.normpath( + os.path.join(sys._MEIPASS, '..', 'Resources', os.path.relpath(pyqt_path, sys._MEIPASS)) + ) + os.environ['QML2_IMPORT_PATH'] = os.pathsep.join([ + os.path.join(pyqt_path_res, 'qml'), + os.path.join(pyqt_path, 'qml'), + ]) + else: + os.environ['QML2_IMPORT_PATH'] = os.path.join(pyqt_path, 'qml') + + # Back in the day, this was required because PyQt5 5.12.3 explicitly checked that `Qt5Core.dll` was in `PATH` + # (see #4293), and contemporary PyInstaller versions collected that DLL to `sys._MEIPASS`. + # + # Nowadays, we add `sys._MEIPASS` to `PATH` in order to ensure that `QtNetwork` can discover OpenSSL DLLs that might + # have been collected there (i.e., when they were not shipped with the package, and were collected from an external + # location). + if sys.platform.startswith('win'): + prepend_path_to_environment_variable(sys._MEIPASS, 'PATH') + + # Qt bindings package installed via PyPI wheels typically ensures that its bundled Qt is relocatable, by creating + # embedded `qt.conf` file during its initialization. This run-time generated qt.conf dynamically sets the Qt prefix + # path to the package's Qt directory. For bindings packages that do not create embedded `qt.conf` during their + # initialization (for example, conda-installed packages), try to perform this step ourselves. + qt_rth_utils.create_embedded_qt_conf("PyQt5", pyqt_path) + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pyqt6.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pyqt6.py new file mode 100755 index 0000000..d3ed0cd --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pyqt6.py @@ -0,0 +1,70 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# The path to Qt's components may not default to the wheel layout for self-compiled PyQt6 installations. Mandate the +# wheel layout. See ``utils/hooks/qt.py`` for more details. + + +def _pyi_rthook(): + import os + import sys + + from _pyi_rth_utils import is_macos_app_bundle, prepend_path_to_environment_variable + from _pyi_rth_utils import qt as qt_rth_utils + + # Ensure this is the only Qt bindings package in the application. + qt_rth_utils.ensure_single_qt_bindings_package("PyQt6") + + # Try PyQt6 6.0.3-style path first... + pyqt_path = os.path.join(sys._MEIPASS, 'PyQt6', 'Qt6') + if not os.path.isdir(pyqt_path): + # ... and fall back to the older version. + pyqt_path = os.path.join(sys._MEIPASS, 'PyQt6', 'Qt') + + os.environ['QT_PLUGIN_PATH'] = os.path.join(pyqt_path, 'plugins') + + if is_macos_app_bundle: + # Special handling for macOS .app bundles. To satisfy codesign requirements, we are forced to split `qml` + # directory into two parts; one that keeps only binaries (rooted in `Contents/Frameworks`) and one that keeps + # only data files (rooted in `Contents/Resources), with files from one directory tree being symlinked to the + # other to maintain illusion of a single mixed-content directory. As Qt seems to compute the identifier of its + # QML components based on location of the `qmldir` file w.r.t. the registered QML import paths, we need to + # register both paths, because the `qmldir` file for a component could be reached via either directory tree. + pyqt_path_res = os.path.normpath( + os.path.join(sys._MEIPASS, '..', 'Resources', os.path.relpath(pyqt_path, sys._MEIPASS)) + ) + os.environ['QML2_IMPORT_PATH'] = os.pathsep.join([ + os.path.join(pyqt_path_res, 'qml'), + os.path.join(pyqt_path, 'qml'), + ]) + else: + os.environ['QML2_IMPORT_PATH'] = os.path.join(pyqt_path, 'qml') + + # Add `sys._MEIPASS` to `PATH` in order to ensure that `QtNetwork` can discover OpenSSL DLLs that might have been + # collected there (i.e., when they were not shipped with the package, and were collected from an external location). + if sys.platform.startswith('win'): + prepend_path_to_environment_variable(sys._MEIPASS, 'PATH') + + # For macOS POSIX builds, we need to add `sys._MEIPASS` to `DYLD_LIBRARY_PATH` so that QtNetwork can discover + # OpenSSL dynamic libraries for its `openssl` TLS backend. This also prevents fallback to external locations, such + # as Homebrew. For .app bundles, this is unnecessary because `QtNetwork` explicitly searches `Contents/Frameworks`. + if sys.platform == 'darwin' and not is_macos_app_bundle: + prepend_path_to_environment_variable(sys._MEIPASS, 'DYLD_LIBRARY_PATH') + + # Qt bindings package installed via PyPI wheels typically ensures that its bundled Qt is relocatable, by creating + # embedded `qt.conf` file during its initialization. This run-time generated qt.conf dynamically sets the Qt prefix + # path to the package's Qt directory. For bindings packages that do not create embedded `qt.conf` during their + # initialization (for example, conda-installed packages), try to perform this step ourselves. + qt_rth_utils.create_embedded_qt_conf("PyQt6", pyqt_path) + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pyside2.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pyside2.py new file mode 100755 index 0000000..3aca93b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pyside2.py @@ -0,0 +1,63 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# The path to Qt's components may not default to the wheel layout for self-compiled PySide2 installations. Mandate the +# wheel layout. See ``utils/hooks/qt.py`` for more details. + + +def _pyi_rthook(): + import os + import sys + + from _pyi_rth_utils import is_macos_app_bundle, prepend_path_to_environment_variable + from _pyi_rth_utils import qt as qt_rth_utils + + # Ensure this is the only Qt bindings package in the application. + qt_rth_utils.ensure_single_qt_bindings_package("PySide2") + + if sys.platform.startswith('win'): + pyqt_path = os.path.join(sys._MEIPASS, 'PySide2') + else: + pyqt_path = os.path.join(sys._MEIPASS, 'PySide2', 'Qt') + + os.environ['QT_PLUGIN_PATH'] = os.path.join(pyqt_path, 'plugins') + + if is_macos_app_bundle: + # Special handling for macOS .app bundles. To satisfy codesign requirements, we are forced to split `qml` + # directory into two parts; one that keeps only binaries (rooted in `Contents/Frameworks`) and one that keeps + # only data files (rooted in `Contents/Resources), with files from one directory tree being symlinked to the + # other to maintain illusion of a single mixed-content directory. As Qt seems to compute the identifier of its + # QML components based on location of the `qmldir` file w.r.t. the registered QML import paths, we need to + # register both paths, because the `qmldir` file for a component could be reached via either directory tree. + pyqt_path_res = os.path.normpath( + os.path.join(sys._MEIPASS, '..', 'Resources', os.path.relpath(pyqt_path, sys._MEIPASS)) + ) + os.environ['QML2_IMPORT_PATH'] = os.pathsep.join([ + os.path.join(pyqt_path_res, 'qml'), + os.path.join(pyqt_path, 'qml'), + ]) + else: + os.environ['QML2_IMPORT_PATH'] = os.path.join(pyqt_path, 'qml') + + # Add `sys._MEIPASS` to `PATH` in order to ensure that `QtNetwork` can discover OpenSSL DLLs that might have been + # collected there (i.e., when they were not shipped with the package, and were collected from an external location). + if sys.platform.startswith('win'): + prepend_path_to_environment_variable(sys._MEIPASS, 'PATH') + + # Qt bindings package installed via PyPI wheels typically ensures that its bundled Qt is relocatable, by creating + # embedded `qt.conf` file during its initialization. This run-time generated qt.conf dynamically sets the Qt prefix + # path to the package's Qt directory. For bindings packages that do not create embedded `qt.conf` during their + # initialization (for example, conda-installed packages), try to perform this step ourselves. + qt_rth_utils.create_embedded_qt_conf("PySide2", pyqt_path) + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pyside6.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pyside6.py new file mode 100755 index 0000000..73db137 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_pyside6.py @@ -0,0 +1,69 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# The path to Qt's components may not default to the wheel layout for self-compiled PySide6 installations. Mandate the +# wheel layout. See ``utils/hooks/qt.py`` for more details. + + +def _pyi_rthook(): + import os + import sys + + from _pyi_rth_utils import is_macos_app_bundle, prepend_path_to_environment_variable + from _pyi_rth_utils import qt as qt_rth_utils + + # Ensure this is the only Qt bindings package in the application. + qt_rth_utils.ensure_single_qt_bindings_package("PySide6") + + if sys.platform.startswith('win'): + pyqt_path = os.path.join(sys._MEIPASS, 'PySide6') + else: + pyqt_path = os.path.join(sys._MEIPASS, 'PySide6', 'Qt') + + os.environ['QT_PLUGIN_PATH'] = os.path.join(pyqt_path, 'plugins') + + if is_macos_app_bundle: + # Special handling for macOS .app bundles. To satisfy codesign requirements, we are forced to split `qml` + # directory into two parts; one that keeps only binaries (rooted in `Contents/Frameworks`) and one that keeps + # only data files (rooted in `Contents/Resources), with files from one directory tree being symlinked to the + # other to maintain illusion of a single mixed-content directory. As Qt seems to compute the identifier of its + # QML components based on location of the `qmldir` file w.r.t. the registered QML import paths, we need to + # register both paths, because the `qmldir` file for a component could be reached via either directory tree. + pyqt_path_res = os.path.normpath( + os.path.join(sys._MEIPASS, '..', 'Resources', os.path.relpath(pyqt_path, sys._MEIPASS)) + ) + os.environ['QML2_IMPORT_PATH'] = os.pathsep.join([ + os.path.join(pyqt_path_res, 'qml'), + os.path.join(pyqt_path, 'qml'), + ]) + else: + os.environ['QML2_IMPORT_PATH'] = os.path.join(pyqt_path, 'qml') + + # Add `sys._MEIPASS` to `PATH` in order to ensure that `QtNetwork` can discover OpenSSL DLLs that might have been + # collected there (i.e., when they were not shipped with the package, and were collected from an external location). + if sys.platform.startswith('win'): + prepend_path_to_environment_variable(sys._MEIPASS, 'PATH') + + # For macOS POSIX builds, we need to add `sys._MEIPASS` to `DYLD_LIBRARY_PATH` so that QtNetwork can discover + # OpenSSL dynamic libraries for its `openssl` TLS backend. This also prevents fallback to external locations, such + # as Homebrew. For .app bundles, this is unnecessary because `QtNetwork` explicitly searches `Contents/Frameworks`. + if sys.platform == 'darwin' and not is_macos_app_bundle: + prepend_path_to_environment_variable(sys._MEIPASS, 'DYLD_LIBRARY_PATH') + + # Qt bindings package installed via PyPI wheels typically ensures that its bundled Qt is relocatable, by creating + # embedded `qt.conf` file during its initialization. This run-time generated qt.conf dynamically sets the Qt prefix + # path to the package's Qt directory. For bindings packages that do not create embedded `qt.conf` during their + # initialization (for example, conda-installed packages), try to perform this step ourselves. + qt_rth_utils.create_embedded_qt_conf("PySide6", pyqt_path) + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_setuptools.py b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_setuptools.py new file mode 100755 index 0000000..0a3ffb8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/hooks/rthooks/pyi_rth_setuptools.py @@ -0,0 +1,37 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2022-2023, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# This runtime hook performs the equivalent of the distutils-precedence.pth from the setuptools package; +# it registers a special meta finder that diverts import of distutils to setuptools._distutils, if available. + + +def _pyi_rthook(): + def _install_setuptools_distutils_hack(): + import os + import setuptools + + # We need to query setuptools version at runtime, because the default value for SETUPTOOLS_USE_DISTUTILS + # has changed at version 60.0 from "stdlib" to "local", and we want to mimic that behavior. + setuptools_major = int(setuptools.__version__.split('.')[0]) + default_value = "stdlib" if setuptools_major < 60 else "local" + + if os.environ.get("SETUPTOOLS_USE_DISTUTILS", default_value) == "local": + import _distutils_hack + _distutils_hack.add_shim() + + try: + _install_setuptools_distutils_hack() + except Exception: + pass + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/PyInstaller/isolated/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/isolated/__init__.py new file mode 100755 index 0000000..3016e7d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/isolated/__init__.py @@ -0,0 +1,31 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) or, at the user's discretion, the MIT License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception OR MIT) +# ----------------------------------------------------------------------------- +""" +PyInstaller hooks typically will need to import the package which they are written for but doing so may manipulate +globals such as :data:`sys.path` or :data:`os.environ` in ways that affect the build. For example, on Windows, +Qt's binaries are added to then loaded via ``PATH`` in such a way that if you import multiple Qt variants in one +session then there is no guarantee which variant's binaries each variant will get! + +To get around this, PyInstaller does any such tasks in an isolated Python subprocess and ships a +:mod:`PyInstaller.isolated` submodule to do so in hooks. :: + + from PyInstaller import isolated + +This submodule provides: + +* :func:`isolated.call() ` to evaluate functions in isolation. +* :func:`@isolated.decorate ` to mark a function as always called in isolation. +* :class:`isolated.Python() ` to efficiently call many functions in a single child instance of Python. + +""" + +# flake8: noqa +from ._parent import Python, call, decorate, SubprocessDiedError diff --git a/venv/lib/python3.12/site-packages/PyInstaller/isolated/_child.py b/venv/lib/python3.12/site-packages/PyInstaller/isolated/_child.py new file mode 100755 index 0000000..0709b68 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/isolated/_child.py @@ -0,0 +1,101 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) or, at the user's discretion, the MIT License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception OR MIT) +# ----------------------------------------------------------------------------- +""" +The child process to be invoked by IsolatedPython(). + +This file is to be run directly with pipe handles for reading from and writing to the parent process as command line +arguments. + +""" + +import sys +import os +import types +from marshal import loads, dumps +from base64 import b64encode, b64decode +from traceback import format_exception + +if os.name == "nt": + from msvcrt import open_osfhandle + + def _open(osf_handle, mode): + # Convert system file handles to file descriptors before opening them. + return open(open_osfhandle(osf_handle, 0), mode) +else: + _open = open + + +def run_next_command(read_fh, write_fh): + """ + Listen to **read_fh** for the next function to run. Write the result to **write_fh**. + """ + + # Check the first line of input. Receiving an empty line is the signal that there are no more tasks to be ran. + first_line = read_fh.readline() + if first_line == b"\n": + # It's time to end this child process + return False + + # There are 5 lines to read: The function's code, its default args, its default kwargs, its args, and its kwargs. + code = loads(b64decode(first_line.strip())) + _defaults = loads(b64decode(read_fh.readline().strip())) + _kwdefaults = loads(b64decode(read_fh.readline().strip())) + args = loads(b64decode(read_fh.readline().strip())) + kwargs = loads(b64decode(read_fh.readline().strip())) + + try: + # Define the global namespace available to the function. + GLOBALS = {"__builtins__": __builtins__, "__isolated__": True} + # Reconstruct the function. + function = types.FunctionType(code, GLOBALS) + function.__defaults__ = _defaults + function.__kwdefaults__ = _kwdefaults + + # Run it. + output = function(*args, **kwargs) + + # Verify that the output is serialise-able (i.e. no custom types or module or function references) here so that + # it's caught if it fails. + marshalled = dumps((True, output)) + + except BaseException as ex: + # An exception happened whilst either running the function or serialising its output. Send back a string + # version of the traceback (unfortunately raw traceback objects are not marshal-able) and a boolean to say + # that it failed. + tb_lines = format_exception(type(ex), ex, ex.__traceback__) + if tb_lines[0] == "Traceback (most recent call last):\n": + # This particular line is distracting. Get rid of it. + tb_lines = tb_lines[1:] + marshalled = dumps((False, "".join(tb_lines).rstrip())) + + # Send the output (return value or traceback) back to the parent. + write_fh.write(b64encode(marshalled)) + write_fh.write(b"\n") + write_fh.flush() + + # Signal that an instruction was ran (successfully or otherwise). + return True + + +if __name__ == '__main__': + # Mark this process as PyInstaller's isolated subprocess; this makes attempts at spawning further isolated + # subprocesses via `PyInstaller.isolated` from this process no-op. + sys._pyi_isolated_subprocess = True + + read_from_parent, write_to_parent = map(int, sys.argv[1:]) + + with _open(read_from_parent, "rb") as read_fh: + with _open(write_to_parent, "wb") as write_fh: + sys.path = loads(b64decode(read_fh.readline())) + + # Keep receiving and running instructions until the parent sends the signal to stop. + while run_next_command(read_fh, write_fh): + pass diff --git a/venv/lib/python3.12/site-packages/PyInstaller/isolated/_parent.py b/venv/lib/python3.12/site-packages/PyInstaller/isolated/_parent.py new file mode 100755 index 0000000..0998e93 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/isolated/_parent.py @@ -0,0 +1,437 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2021-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) or, at the user's discretion, the MIT License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception OR MIT) +# ----------------------------------------------------------------------------- + +import os +from pathlib import Path +from marshal import loads, dumps +from base64 import b64encode, b64decode +import functools +import subprocess +import sys + +from PyInstaller import compat +from PyInstaller import log as logging + +logger = logging.getLogger(__name__) + +# WinAPI bindings for Windows-specific codepath +if os.name == "nt": + import msvcrt + import ctypes + import ctypes.wintypes + + # CreatePipe + class SECURITY_ATTRIBUTES(ctypes.Structure): + _fields_ = [ + ("nLength", ctypes.wintypes.DWORD), + ("lpSecurityDescriptor", ctypes.wintypes.LPVOID), + ("bInheritHandle", ctypes.wintypes.BOOL), + ] + + HANDLE_FLAG_INHERIT = 0x0001 + + LPSECURITY_ATTRIBUTES = ctypes.POINTER(SECURITY_ATTRIBUTES) + + CreatePipe = ctypes.windll.kernel32.CreatePipe + CreatePipe.argtypes = [ + ctypes.POINTER(ctypes.wintypes.HANDLE), + ctypes.POINTER(ctypes.wintypes.HANDLE), + LPSECURITY_ATTRIBUTES, + ctypes.wintypes.DWORD, + ] + CreatePipe.restype = ctypes.wintypes.BOOL + + # CloseHandle + CloseHandle = ctypes.windll.kernel32.CloseHandle + CloseHandle.argtypes = [ctypes.wintypes.HANDLE] + CloseHandle.restype = ctypes.wintypes.BOOL + +CHILD_PY = Path(__file__).with_name("_child.py") + + +def create_pipe(read_handle_inheritable, write_handle_inheritable): + """ + Create a one-way pipe for sending data to child processes. + + Args: + read_handle_inheritable: + A boolean flag indicating whether the handle corresponding to the read end-point of the pipe should be + marked as inheritable by subprocesses. + write_handle_inheritable: + A boolean flag indicating whether the handle corresponding to the write end-point of the pipe should be + marked as inheritable by subprocesses. + + Returns: + A read/write pair of file descriptors (which are just integers) on posix or system file handles on Windows. + + The pipe may be used either by this process or subprocesses of this process but not globally. + """ + return _create_pipe_impl(read_handle_inheritable, write_handle_inheritable) + + +def close_pipe_endpoint(pipe_handle): + """ + Close the file descriptor (posix) or handle (Windows) belonging to a pipe. + """ + return _close_pipe_endpoint_impl(pipe_handle) + + +if os.name == "nt": + + def _create_pipe_impl(read_handle_inheritable, write_handle_inheritable): + # Use WinAPI CreatePipe function to create the pipe. Python's os.pipe() does the same, but wraps the resulting + # handles into inheritable file descriptors (https://github.com/python/cpython/issues/77046). Instead, we want + # just handles, and will set the inheritable flag on corresponding handle ourselves. + read_handle = ctypes.wintypes.HANDLE() + write_handle = ctypes.wintypes.HANDLE() + + # SECURITY_ATTRIBUTES with inherit handle set to True + security_attributes = SECURITY_ATTRIBUTES() + security_attributes.nLength = ctypes.sizeof(security_attributes) + security_attributes.bInheritHandle = True + security_attributes.lpSecurityDescriptor = None + + # CreatePipe() + succeeded = CreatePipe( + ctypes.byref(read_handle), # hReadPipe + ctypes.byref(write_handle), # hWritePipe + ctypes.byref(security_attributes), # lpPipeAttributes + 0, # nSize + ) + if not succeeded: + raise ctypes.WinError() + + # Set inheritable flags. Instead of binding and using SetHandleInformation WinAPI function, we can use + # os.set_handle_inheritable(). + os.set_handle_inheritable(read_handle.value, read_handle_inheritable) + os.set_handle_inheritable(write_handle.value, write_handle_inheritable) + + return read_handle.value, write_handle.value + + def _close_pipe_endpoint_impl(pipe_handle): + succeeded = CloseHandle(pipe_handle) + if not succeeded: + raise ctypes.WinError() +else: + + def _create_pipe_impl(read_fd_inheritable, write_fd_inheritable): + # Create pipe, using os.pipe() + read_fd, write_fd = os.pipe() + + # The default behaviour of pipes is that they are process specific. I.e., they can only be used by this + # process to talk to itself. Setting inheritable flags means that child processes may also use these pipes. + os.set_inheritable(read_fd, read_fd_inheritable) + os.set_inheritable(write_fd, write_fd_inheritable) + + return read_fd, write_fd + + def _close_pipe_endpoint_impl(pipe_fd): + os.close(pipe_fd) + + +def child(read_from_parent: int, write_to_parent: int): + """ + Spawn a Python subprocess sending it the two file descriptors it needs to talk back to this parent process. + """ + if os.name != 'nt': + # Explicitly disabling close_fds is a requirement for making file descriptors inheritable by child processes. + extra_kwargs = { + "env": _subprocess_env(), + "close_fds": False, + } + else: + # On Windows, we can use subprocess.STARTUPINFO to explicitly pass the list of file handles to be inherited, + # so we can avoid disabling close_fds + extra_kwargs = { + "env": _subprocess_env(), + "close_fds": True, + "startupinfo": subprocess.STARTUPINFO(lpAttributeList={"handle_list": [read_from_parent, write_to_parent]}) + } + + # Run the _child.py script directly passing it the two file descriptors it needs to talk back to the parent. + cmd, options = compat.__wrap_python([str(CHILD_PY), str(read_from_parent), str(write_to_parent)], extra_kwargs) + + # I'm intentionally leaving stdout and stderr alone so that print() can still be used for emergency debugging and + # unhandled errors in the child are still visible. + return subprocess.Popen(cmd, **options) + + +def _subprocess_env(): + """ + Define the environment variables to be readable in a child process. + """ + from PyInstaller.config import CONF + python_path = CONF["pathex"] + if "PYTHONPATH" in os.environ: + python_path = python_path + [os.environ["PYTHONPATH"]] + env = os.environ.copy() + env["PYTHONPATH"] = os.pathsep.join(python_path) + return env + + +class SubprocessDiedError(RuntimeError): + pass + + +class Python: + """ + Start and connect to a separate Python subprocess. + + This is the lowest level of public API provided by this module. The advantage of using this class directly is + that it allows multiple functions to be evaluated in a single subprocess, making it faster than multiple calls to + :func:`call`. + + The ``strict_mode`` argument controls behavior when the child process fails to shut down; if strict mode is enabled, + an error is raised, otherwise only warning is logged. If the value of ``strict_mode`` is ``None``, the value of + ``PyInstaller.compat.strict_collect_mode`` is used (which in turn is controlled by the + ``PYINSTALLER_STRICT_COLLECT_MODE`` environment variable. + + Examples: + To call some predefined functions ``x = foo()``, ``y = bar("numpy")`` and ``z = bazz(some_flag=True)`` all using + the same isolated subprocess use:: + + with isolated.Python() as child: + x = child.call(foo) + y = child.call(bar, "numpy") + z = child.call(bazz, some_flag=True) + + """ + def __init__(self, strict_mode=None): + self._child = None + + # Re-use the compat.strict_collect_mode and its PYINSTALLER_STRICT_COLLECT_MODE environment variable for + # default strict-mode setting. + self._strict_mode = strict_mode if strict_mode is not None else compat.strict_collect_mode + + # Check if we are already running in PyInstaller's isolated subprocess, to prevent further nesting. + self._already_isolated = getattr(sys, '_pyi_isolated_subprocess', False) + + def __enter__(self): + # No-op if already running in an isolated subprocess. + if self._already_isolated: + return self + + # We need two pipes. One for the child to send data to the parent. The (write) end-point passed to the + # child needs to be marked as inheritable. + read_from_child, write_to_parent = create_pipe(False, True) + # And one for the parent to send data to the child. The (read) end-point passed to the child needs to be + # marked as inheritable. + read_from_parent, write_to_child = create_pipe(True, False) + + # Spawn a Python subprocess sending it the two file descriptors it needs to talk back to this parent process. + self._child = child(read_from_parent, write_to_parent) + + # Close the end-points that were inherited by the child. + close_pipe_endpoint(read_from_parent) + close_pipe_endpoint(write_to_parent) + del read_from_parent + del write_to_parent + + # Open file handles to talk to the child. This should fully transfer ownership of the underlying file + # descriptor to the opened handle; so when we close the latter, the former should be closed as well. + if os.name == 'nt': + # On Windows, we must first open file descriptor on top of the handle using _open_osfhandle (which + # python wraps in msvcrt.open_osfhandle). According to MSDN, this transfers the ownership of the + # underlying file handle to the file descriptors; i.e., they are both closed when the file descriptor + # is closed). + self._write_handle = os.fdopen(msvcrt.open_osfhandle(write_to_child, 0), "wb") + self._read_handle = os.fdopen(msvcrt.open_osfhandle(read_from_child, 0), "rb") + else: + self._write_handle = os.fdopen(write_to_child, "wb") + self._read_handle = os.fdopen(read_from_child, "rb") + + self._send(sys.path) + + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + # No-op if already running in an isolated subprocess. + if self._already_isolated: + return + + if exc_type and issubclass(exc_type, SubprocessDiedError): + self._write_handle.close() + self._read_handle.close() + del self._read_handle, self._write_handle + self._child = None + return + # Send the signal (a blank line) to the child to tell it that it's time to stop. + self._write_handle.write(b"\n") + self._write_handle.flush() + + # Wait for the child process to exit. The timeout is necessary for corner cases when the sub-process fails to + # exit (such as due to dangling non-daemon threads; see #7290). At this point, the subprocess already did all + # its work, so it should be safe to terminate. And as we expect it to shut down quickly (or not at all), the + # timeout is relatively short. + # + # In strict build mode, we raise an error when the subprocess fails to exit on its own, but do so only after + # we attempt to kill the subprocess, to avoid leaving zombie processes. + shutdown_error = False + + try: + self._child.wait(timeout=5) + except subprocess.TimeoutExpired: + logger.warning("Timed out while waiting for the child process to exit!") + shutdown_error = True + self._child.kill() + try: + self._child.wait(timeout=15) + except subprocess.TimeoutExpired: + logger.warning("Timed out while waiting for the child process to be killed!") + # Give up and fall through + + # Close the handles. This should also close the underlying file descriptors. + self._write_handle.close() + self._read_handle.close() + del self._read_handle, self._write_handle + + self._child = None + + # Raise an error in strict mode, after all clean-up has been performed. + if shutdown_error and self._strict_mode: + raise RuntimeError("Timed out while waiting for the child process to exit!") + + def call(self, function, *args, **kwargs): + """ + Call a function in the child Python. Retrieve its return value. Usage of this method is identical to that + of the :func:`call` function. + """ + # If already running in an isolated subprocess, directly execute the function. + if self._already_isolated: + return function(*args, **kwargs) + + if self._child is None: + raise RuntimeError("An isolated.Python object must be used in a 'with' clause.") + + self._send(function.__code__, function.__defaults__, function.__kwdefaults__, args, kwargs) + + # Read a single line of output back from the child. This contains if the function worked and either its return + # value or a traceback. This will block indefinitely until it receives a '\n' byte. + try: + ok, output = loads(b64decode(self._read_handle.readline())) + except (EOFError, BrokenPipeError): + # Subprocess appears to have died in an unhandleable way (e.g. SIGSEV). Raise an error. + raise SubprocessDiedError( + f"Child process died calling {function.__name__}() with args={args} and " + f"kwargs={kwargs}. Its exit code was {self._child.wait()}." + ) from None + + # If all went well, then ``output`` is the return value. + if ok: + return output + + # Otherwise an error happened and ``output`` is a string-ified stacktrace. Raise an error appending the + # stacktrace. Having the output in this order gives a nice fluent transition from parent to child in the stack + # trace. + raise RuntimeError(f"Child process call to {function.__name__}() failed with:\n" + output) + + def _send(self, *objects): + for object in objects: + self._write_handle.write(b64encode(dumps(object))) + self._write_handle.write(b"\n") + # Flushing is very important. Without it, the data is not sent but forever sits in a buffer so that the child is + # forever waiting for its data and the parent in turn is forever waiting for the child's response. + self._write_handle.flush() + + +def call(function, *args, **kwargs): + r""" + Call a function with arguments in a separate child Python. Retrieve its return value. + + Args: + function: + The function to send and invoke. + *args: + **kwargs: + Positional and keyword arguments to send to the function. These must be simple builtin types - not custom + classes. + Returns: + The return value of the function. Again, these must be basic types serialisable by :func:`marshal.dumps`. + Raises: + RuntimeError: + Any exception which happens inside an isolated process is caught and reraised in the parent process. + + To use, define a function which returns the information you're looking for. Any imports it requires must happen in + the body of the function. For example, to safely check the output of ``matplotlib.get_data_path()`` use:: + + # Define a function to be ran in isolation. + def get_matplotlib_data_path(): + import matplotlib + return matplotlib.get_data_path() + + # Call it with isolated.call(). + get_matplotlib_data_path = isolated.call(matplotlib_data_path) + + For single use functions taking no arguments like the above you can abuse the decorator syntax slightly to define + and execute a function in one go. :: + + >>> @isolated.call + ... def matplotlib_data_dir(): + ... import matplotlib + ... return matplotlib.get_data_path() + >>> matplotlib_data_dir + '/home/brenainn/.pyenv/versions/3.9.6/lib/python3.9/site-packages/matplotlib/mpl-data' + + Functions may take positional and keyword arguments and return most generic Python data types. :: + + >>> def echo_parameters(*args, **kwargs): + ... return args, kwargs + >>> isolated.call(echo_parameters, 1, 2, 3) + (1, 2, 3), {} + >>> isolated.call(echo_parameters, foo=["bar"]) + (), {'foo': ['bar']} + + Notes: + To make a function behave differently if it's isolated, check for the ``__isolated__`` global. :: + + if globals().get("__isolated__", False): + # We're inside a child process. + ... + else: + # This is the master process. + ... + + """ + with Python() as isolated: + return isolated.call(function, *args, **kwargs) + + +def decorate(function): + """ + Decorate a function so that it is always called in an isolated subprocess. + + Examples: + + To use, write a function then prepend ``@isolated.decorate``. :: + + @isolated.decorate + def add_1(x): + '''Add 1 to ``x``, displaying the current process ID.''' + import os + print(f"Process {os.getpid()}: Adding 1 to {x}.") + return x + 1 + + The resultant ``add_1()`` function can now be called as you would a + normal function and it'll automatically use a subprocess. + + >>> add_1(4) + Process 4920: Adding 1 to 4. + 5 + >>> add_1(13.2) + Process 4928: Adding 1 to 13.2. + 14.2 + + """ + @functools.wraps(function) + def wrapped(*args, **kwargs): + return call(function, *args, **kwargs) + + return wrapped diff --git a/venv/lib/python3.12/site-packages/PyInstaller/lib/README.rst b/venv/lib/python3.12/site-packages/PyInstaller/lib/README.rst new file mode 100755 index 0000000..a09f6d5 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/lib/README.rst @@ -0,0 +1,49 @@ +Custom modifications of 3rd party libraries +=========================================== + +NOTE: PyInstaller does not extend PYTHONPATH (sys.path) with this directory +that contains bundled 3rd party libraries. + +Some users complained that PyInstaller failed because their apps were using +too old versions of some libraries that PyInstaller uses too and that's why +extending sys.path was dropped. + +All libraries are tweaked to be importable as:: + + from PyInstaller.lib.LIB_NAME import xyz + +In libraries replace imports like:: + + from altgraph import y + from modulegraph import z + +with relative prefix:: + + from ..altgraph import y + from ..modulegraph import z + + +altgraph +---------- + +- add fixed version string to ./altgraph/__init__.py:: + + # For PyInstaller/lib/ define the version here, since there is no + # package-resource. + __version__ = '0.13' + + +modulegraph +----------- + +https://bitbucket.org/ronaldoussoren/modulegraph/downloads + +- TODO Use official modulegraph version when following issue is resolved and pull request merged + https://bitbucket.org/ronaldoussoren/modulegraph/issues/28/__main__-module-being-analyzed-for-wheel + +- add fixed version string to ./modulegraph/__init__.py:: + + # For PyInstaller/lib/ define the version here, since there is no + # package-resource. + __version__ = '0.13' + diff --git a/venv/lib/python3.12/site-packages/PyInstaller/lib/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/lib/__init__.py new file mode 100755 index 0000000..792d600 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/lib/__init__.py @@ -0,0 +1 @@ +# diff --git a/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/__init__.py new file mode 100755 index 0000000..9446169 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/__init__.py @@ -0,0 +1 @@ +__version__ = '0.17' diff --git a/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/__main__.py b/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/__main__.py new file mode 100755 index 0000000..ea4670b --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/__main__.py @@ -0,0 +1,89 @@ +import sys +import os +import argparse +from .modulegraph import ModuleGraph + + +def parse_arguments(): + parser = argparse.ArgumentParser( + conflict_handler='resolve', prog='%s -mmodulegraph' % ( + os.path.basename(sys.executable))) + parser.add_argument( + '-d', action='count', dest='debug', default=1, + help='Increase debug level') + parser.add_argument( + '-q', action='store_const', dest='debug', const=0, + help='Clear debug level') + parser.add_argument( + '-m', '--modules', action='store_true', + dest='domods', default=False, + help='arguments are module names, not script files') + parser.add_argument( + '-x', metavar='NAME', action='append', dest='excludes', + default=[], help='Add NAME to the excludes list') + parser.add_argument( + '-p', action='append', metavar='PATH', dest='addpath', default=[], + help='Add PATH to the module search path') + parser.add_argument( + '-g', '--dot', action='store_const', dest='output', const='dot', + help='Output a .dot graph') + parser.add_argument( + '-h', '--html', action='store_const', + dest='output', const='html', help='Output a HTML file') + parser.add_argument( + 'scripts', metavar='SCRIPT', nargs='+', help='scripts to analyse') + + opts = parser.parse_args() + return opts + + +def create_graph(scripts, domods, debuglevel, excludes, path_extras): + # Set the path based on sys.path and the script directory + path = sys.path[:] + + if domods: + del path[0] + else: + path[0] = os.path.dirname(scripts[0]) + + path = path_extras + path + if debuglevel > 1: + print("path:", file=sys.stderr) + for item in path: + print(" ", repr(item), file=sys.stderr) + + # Create the module finder and turn its crank + mf = ModuleGraph(path, excludes=excludes, debug=debuglevel) + for arg in scripts: + if domods: + if arg[-2:] == '.*': + mf.import_hook(arg[:-2], None, ["*"]) + else: + mf.import_hook(arg) + else: + mf.add_script(arg) + return mf + + +def output_graph(output_format, mf): + if output_format == 'dot': + mf.graphreport() + elif output_format == 'html': + mf.create_xref() + else: + mf.report() + + +def main(): + opts = parse_arguments() + mf = create_graph( + opts.scripts, opts.domods, opts.debug, + opts.excludes, opts.addpath) + output_graph(opts.output, mf) + + +if __name__ == '__main__': # pragma: no cover + try: + main() + except KeyboardInterrupt: + print("\n[interrupt]") diff --git a/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/find_modules.py b/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/find_modules.py new file mode 100755 index 0000000..b383b28 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/find_modules.py @@ -0,0 +1,61 @@ +""" +modulegraph.find_modules - High-level module dependency finding interface +========================================================================= + +History +........ + +Originally (loosely) based on code in py2exe's build_exe.py by Thomas Heller. +""" +import os +import pkgutil + +from .modulegraph import Alias + +def get_implies(): + def _xml_etree_modules(): + import xml.etree + return [ + f"xml.etree.{module_name}" + for _, module_name, is_package in pkgutil.iter_modules(xml.etree.__path__) + if not is_package + ] + + result = { + # imports done from C code in built-in and/or extension modules + # (untrackable by modulegraph). + "_curses": ["curses"], + "posix": ["resource"], + "gc": ["time"], + "time": ["_strptime"], + "datetime": ["time"], + "parser": ["copyreg"], + "codecs": ["encodings"], + "_sre": ["copy", "re"], + "zipimport": ["zlib"], + + # _frozen_importlib is part of the interpreter itself + "_frozen_importlib": None, + + # os.path is an alias for a platform specific module, + # ensure that the graph shows this. + "os.path": Alias(os.path.__name__), + + # Python >= 3.2: + "_datetime": ["time", "_strptime"], + "_json": ["json.decoder"], + "_pickle": ["codecs", "copyreg", "_compat_pickle"], + "_posixsubprocess": ["gc"], + "_ssl": ["socket"], + + # Python >= 3.3: + "_elementtree": ["pyexpat"] + _xml_etree_modules(), + + # This is not C extension, but it uses __import__ + "anydbm": ["dbhash", "gdbm", "dbm", "dumbdbm", "whichdb"], + + # Known package aliases + "wxPython.wx": Alias('wx'), + } + + return result diff --git a/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/modulegraph.py b/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/modulegraph.py new file mode 100755 index 0000000..a3699cc --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/modulegraph.py @@ -0,0 +1,3107 @@ +""" +Find modules used by a script, using bytecode analysis. + +Based on the stdlib modulefinder by Thomas Heller and Just van Rossum, +but uses a graph data structure and 2.3 features + +XXX: Verify all calls to _import_hook (and variants) to ensure that +imports are done in the right way. +""" +#FIXME: To decrease the likelihood of ModuleGraph exceeding the recursion limit +#and hence unpredictably raising fatal exceptions, increase the recursion +#limit at PyInstaller startup (i.e., in the +#PyInstaller.building.build_main.build() function). For details, see: +# https://github.com/pyinstaller/pyinstaller/issues/1919#issuecomment-216016176 + +import ast +import os +import pkgutil +import sys +import types +import re +from collections import deque, namedtuple, defaultdict +import urllib.request +import warnings +import importlib.util +import importlib.machinery + +# The logic in PyInstaller.compat ensures that these are available and +# of correct version. +if sys.version_info >= (3, 10): + import importlib.metadata as importlib_metadata +else: + import importlib_metadata + +# The latest version of altgraph at the time of writing (v0.17.4) still +# uses pkg_resources to query its own version. With setuptools >= 80.9.0, +# this triggers deprecation warnings. In 2025-11-30, pkg_resources will be +# removed altogether. Give altgraph just enough of a mocked pkg_resources that +# it can still be imported. +try: + _pkg_resources_not_imported = object() + _old_pkg_resources = sys.modules.get("pkg_resources", _pkg_resources_not_imported) + sys.modules["pkg_resources"] = fake_pkg_resources = types.SimpleNamespace() + fake_pkg_resources.require = lambda name: [importlib_metadata.distribution(name)] + + from altgraph.ObjectGraph import ObjectGraph + from altgraph import GraphError +finally: + if _old_pkg_resources is not _pkg_resources_not_imported: + sys.modules["pkg_resources"] = _old_pkg_resources + else: + del sys.modules["pkg_resources"] + +from . import util + + +class BUILTIN_MODULE: + def is_package(fqname): + return False + + +class NAMESPACE_PACKAGE: + def __init__(self, namespace_dirs): + self.namespace_dirs = namespace_dirs + + def is_package(self, fqname): + return True + + +#FIXME: Leverage this rather than magic numbers below. +ABSOLUTE_OR_RELATIVE_IMPORT_LEVEL = -1 +""" +Constant instructing the builtin `__import__()` function to attempt both +absolute and relative imports. +""" + + +#FIXME: Leverage this rather than magic numbers below. +ABSOLUTE_IMPORT_LEVEL = 0 +""" +Constant instructing the builtin `__import__()` function to attempt only +absolute imports. +""" + + +#FIXME: Leverage this rather than magic numbers below. +DEFAULT_IMPORT_LEVEL = ABSOLUTE_IMPORT_LEVEL +""" +Constant instructing the builtin `__import__()` function to attempt the default +import style specific to the active Python interpreter. + +Specifically, under: + +* Python 2, this defaults to attempting both absolute and relative imports. +* Python 3, this defaults to attempting only absolute imports. +""" + + +class InvalidRelativeImportError (ImportError): + pass + + +def _path_from_importerror(exc, default): + # This is a hack, but sadly enough the necessary information + # isn't available otherwise. + m = re.match(r'^No module named (\S+)$', str(exc)) + if m is not None: + return m.group(1) + + return default + + +#FIXME: What is this? Do we actually need this? This appears to provide +#significantly more fine-grained metadata than PyInstaller will ever require. +#It consumes a great deal of space (slots or no slots), since we store an +#instance of this class for each edge of the graph. +class DependencyInfo (namedtuple("DependencyInfo", + ["conditional", "function", "tryexcept", "fromlist"])): + __slots__ = () + + def _merged(self, other): + if (not self.conditional and not self.function and not self.tryexcept) \ + or (not other.conditional and not other.function and not other.tryexcept): + return DependencyInfo( + conditional=False, + function=False, + tryexcept=False, + fromlist=self.fromlist and other.fromlist) + + else: + return DependencyInfo( + conditional=self.conditional or other.conditional, + function=self.function or other.function, + tryexcept=self.tryexcept or other.tryexcept, + fromlist=self.fromlist and other.fromlist) + + +#FIXME: Shift the following Node class hierarchy into a new +#"PyInstaller.lib.modulegraph.node" module. This module is much too long. +#FIXME: Refactor "_deferred_imports" from a tuple into a proper lightweight +#class leveraging "__slots__". If not for backward compatibility, we'd just +#leverage a named tuple -- but this should do just as well. +#FIXME: Move the "packagepath" attribute into the "Package" class. Only +#packages define the "__path__" special attribute. The codebase currently +#erroneously tests whether "module.packagepath is not None" to determine +#whether a node is a package or not. However, "isinstance(module, Package)" is +#a significantly more reliable test. Refactor the former into the latter. +class Node: + """ + Abstract base class (ABC) of all objects added to a `ModuleGraph`. + + Attributes + ---------- + code : codeobject + Code object of the pure-Python module corresponding to this graph node + if any _or_ `None` otherwise. + graphident : str + Synonym of `identifier` required by the `ObjectGraph` superclass of the + `ModuleGraph` class. For readability, the `identifier` attribute should + typically be used instead. + filename : str + Absolute path of this graph node's corresponding module, package, or C + extension if any _or_ `None` otherwise. + identifier : str + Fully-qualified name of this graph node's corresponding module, + package, or C extension. + packagepath : str + List of the absolute paths of all directories comprising this graph + node's corresponding package. If this is a: + * Non-namespace package, this list contains exactly one path. + * Namespace package, this list contains one or more paths. + _deferred_imports : list + List of all target modules imported by the source module corresponding + to this graph node whole importations have been deferred for subsequent + processing in between calls to the `_ModuleGraph._scan_code()` and + `_ModuleGraph._process_imports()` methods for this source module _or_ + `None` otherwise. Each element of this list is a 3-tuple + `(have_star, _safe_import_hook_args, _safe_import_hook_kwargs)` + collecting the importation of a target module from this source module + for subsequent processing, where: + * `have_star` is a boolean `True` only if this is a `from`-style star + import (e.g., resembling `from {target_module_name} import *`). + * `_safe_import_hook_args` is a (typically non-empty) sequence of all + positional arguments to be passed to the `_safe_import_hook()` method + to add this importation to the graph. + * `_safe_import_hook_kwargs` is a (typically empty) dictionary of all + keyword arguments to be passed to the `_safe_import_hook()` method + to add this importation to the graph. + Unlike functional languages, Python imposes a maximum depth on the + interpreter stack (and hence recursion). On breaching this depth, + Python raises a fatal `RuntimeError` exception. Since `ModuleGraph` + parses imports recursively rather than iteratively, this depth _was_ + commonly breached before the introduction of this list. Python + environments installing a large number of modules (e.g., Anaconda) were + particularly susceptible. Why? Because `ModuleGraph` concurrently + descended through both the abstract syntax trees (ASTs) of all source + modules being parsed _and_ the graph of all target modules imported by + these source modules being built. The stack thus consisted of + alternating layers of AST and graph traversal. To unwind such + alternation and effectively halve the stack depth, `ModuleGraph` now + descends through the abstract syntax tree (AST) of each source module + being parsed and adds all importations originating within this module + to this list _before_ descending into the graph of these importations. + See pyinstaller/pyinstaller/#1289 for further details. + _global_attr_names : set + Set of the unqualified names of all global attributes (e.g., classes, + variables) defined in the pure-Python module corresponding to this + graph node if any _or_ the empty set otherwise. This includes the names + of all attributes imported via `from`-style star imports from other + existing modules (e.g., `from {target_module_name} import *`). This + set is principally used to differentiate the non-ignorable importation + of non-existent submodules in a package from the ignorable importation + of existing global attributes defined in that package's pure-Python + `__init__` submodule in `from`-style imports (e.g., `bar` in + `from foo import bar`, which may be either a submodule or attribute of + `foo`), as such imports ambiguously allow both. This set is _not_ used + to differentiate submodules from attributes in `import`-style imports + (e.g., `bar` in `import foo.bar`, which _must_ be a submodule of + `foo`), as such imports unambiguously allow only submodules. + _starimported_ignored_module_names : set + Set of the fully-qualified names of all existing unparsable modules + that the existing parsable module corresponding to this graph node + attempted to perform one or more "star imports" from. If this module + either does _not_ exist or does but is unparsable, this is the empty + set. Equivalently, this set contains each fully-qualified name + `{trg_module_name}` for which: + * This module contains an import statement of the form + `from {trg_module_name} import *`. + * The module whose name is `{trg_module_name}` exists but is _not_ + parsable by `ModuleGraph` (e.g., due to _not_ being pure-Python). + **This set is currently defined but otherwise ignored.** + _submodule_basename_to_node : dict + Dictionary mapping from the unqualified name of each submodule + contained by the parent module corresponding to this graph node to that + submodule's graph node. If this dictionary is non-empty, this parent + module is typically but _not_ always a package (e.g., the non-package + `os` module containing the `os.path` submodule). + """ + + __slots__ = [ + 'code', + 'filename', + 'graphident', + 'identifier', + 'packagepath', + '_deferred_imports', + '_global_attr_names', + '_starimported_ignored_module_names', + '_submodule_basename_to_node', + ] + + def __init__(self, identifier): + """ + Initialize this graph node. + + Parameters + ---------- + identifier : str + Fully-qualified name of this graph node's corresponding module, + package, or C extension. + """ + + self.code = None + self.filename = None + self.graphident = identifier + self.identifier = identifier + self.packagepath = None + self._deferred_imports = None + self._global_attr_names = set() + self._starimported_ignored_module_names = set() + self._submodule_basename_to_node = dict() + + + def is_global_attr(self, attr_name): + """ + `True` only if the pure-Python module corresponding to this graph node + defines a global attribute (e.g., class, variable) with the passed + name. + + If this module is actually a package, this method instead returns + `True` only if this package's pure-Python `__init__` submodule defines + such a global attribute. In this case, note that this package may still + contain an importable submodule of the same name. Callers should + attempt to import this attribute as a submodule of this package + _before_ assuming this attribute to be an ignorable global. See + "Examples" below for further details. + + Parameters + ---------- + attr_name : str + Unqualified name of the attribute to be tested. + + Returns + ---------- + bool + `True` only if this module defines this global attribute. + + Examples + ---------- + Consider a hypothetical module `foo` containing submodules `bar` and + `__init__` where the latter assigns `bar` to be a global variable + (possibly star-exported via the special `__all__` global variable): + + >>> # In "foo.__init__": + >>> bar = 3.1415 + + Python 2 and 3 both permissively permit this. This method returns + `True` in this case (i.e., when called on the `foo` package's graph + node, passed the attribute name `bar`) despite the importability of the + `foo.bar` submodule. + """ + + return attr_name in self._global_attr_names + + + def is_submodule(self, submodule_basename): + """ + `True` only if the parent module corresponding to this graph node + contains the submodule with the passed name. + + If `True`, this parent module is typically but _not_ always a package + (e.g., the non-package `os` module containing the `os.path` submodule). + + Parameters + ---------- + submodule_basename : str + Unqualified name of the submodule to be tested. + + Returns + ---------- + bool + `True` only if this parent module contains this submodule. + """ + + return submodule_basename in self._submodule_basename_to_node + + + def add_global_attr(self, attr_name): + """ + Record the global attribute (e.g., class, variable) with the passed + name to be defined by the pure-Python module corresponding to this + graph node. + + If this module is actually a package, this method instead records this + attribute to be defined by this package's pure-Python `__init__` + submodule. + + Parameters + ---------- + attr_name : str + Unqualified name of the attribute to be added. + """ + + self._global_attr_names.add(attr_name) + + + def add_global_attrs_from_module(self, target_module): + """ + Record all global attributes (e.g., classes, variables) defined by the + target module corresponding to the passed graph node to also be defined + by the source module corresponding to this graph node. + + If the source module is actually a package, this method instead records + these attributes to be defined by this package's pure-Python `__init__` + submodule. + + Parameters + ---------- + target_module : Node + Graph node of the target module to import attributes from. + """ + + self._global_attr_names.update(target_module._global_attr_names) + + + def add_submodule(self, submodule_basename, submodule_node): + """ + Add the submodule with the passed name and previously imported graph + node to the parent module corresponding to this graph node. + + This parent module is typically but _not_ always a package (e.g., the + non-package `os` module containing the `os.path` submodule). + + Parameters + ---------- + submodule_basename : str + Unqualified name of the submodule to add to this parent module. + submodule_node : Node + Graph node of this submodule. + """ + + self._submodule_basename_to_node[submodule_basename] = submodule_node + + + def get_submodule(self, submodule_basename): + """ + Graph node of the submodule with the passed name in the parent module + corresponding to this graph node. + + If this parent module does _not_ contain this submodule, an exception + is raised. Else, this parent module is typically but _not_ always a + package (e.g., the non-package `os` module containing the `os.path` + submodule). + + Parameters + ---------- + module_basename : str + Unqualified name of the submodule to retrieve. + + Returns + ---------- + Node + Graph node of this submodule. + """ + + return self._submodule_basename_to_node[submodule_basename] + + + def get_submodule_or_none(self, submodule_basename): + """ + Graph node of the submodule with the passed unqualified name in the + parent module corresponding to this graph node if this module contains + this submodule _or_ `None`. + + This parent module is typically but _not_ always a package (e.g., the + non-package `os` module containing the `os.path` submodule). + + Parameters + ---------- + submodule_basename : str + Unqualified name of the submodule to retrieve. + + Returns + ---------- + Node + Graph node of this submodule if this parent module contains this + submodule _or_ `None`. + """ + + return self._submodule_basename_to_node.get(submodule_basename) + + + def remove_global_attr_if_found(self, attr_name): + """ + Record the global attribute (e.g., class, variable) with the passed + name if previously recorded as defined by the pure-Python module + corresponding to this graph node to be subsequently undefined by the + same module. + + If this module is actually a package, this method instead records this + attribute to be undefined by this package's pure-Python `__init__` + submodule. + + This method is intended to be called on globals previously defined by + this module that are subsequently undefined via the `del` built-in by + this module, thus "forgetting" or "undoing" these globals. + + For safety, there exists no corresponding `remove_global_attr()` + method. While defining this method is trivial, doing so would invite + `KeyError` exceptions on scanning valid Python that lexically deletes a + global in a scope under this module's top level (e.g., in a function) + _before_ defining this global at this top level. Since `ModuleGraph` + cannot and should not (re)implement a full-blown Python interpreter, + ignoring out-of-order deletions is the only sane policy. + + Parameters + ---------- + attr_name : str + Unqualified name of the attribute to be removed. + """ + + if self.is_global_attr(attr_name): + self._global_attr_names.remove(attr_name) + + def __eq__(self, other): + try: + otherIdent = getattr(other, 'graphident') + except AttributeError: + return False + + return self.graphident == otherIdent + + def __ne__(self, other): + try: + otherIdent = getattr(other, 'graphident') + except AttributeError: + return True + + return self.graphident != otherIdent + + def __lt__(self, other): + try: + otherIdent = getattr(other, 'graphident') + except AttributeError: + return NotImplemented + + return self.graphident < otherIdent + + def __le__(self, other): + try: + otherIdent = getattr(other, 'graphident') + except AttributeError: + return NotImplemented + + return self.graphident <= otherIdent + + def __gt__(self, other): + try: + otherIdent = getattr(other, 'graphident') + except AttributeError: + return NotImplemented + + return self.graphident > otherIdent + + def __ge__(self, other): + try: + otherIdent = getattr(other, 'graphident') + except AttributeError: + return NotImplemented + + return self.graphident >= otherIdent + + def __hash__(self): + return hash(self.graphident) + + def infoTuple(self): + return (self.identifier,) + + def __repr__(self): + return '%s%r' % (type(self).__name__, self.infoTuple()) + + +class Alias(str): + """ + Placeholder aliasing an existing source module to a non-existent target + module (i.e., the desired alias). + + For obscure reasons, this class subclasses `str`. Each instance of this + class is the fully-qualified name of the existing source module being + aliased. Unlike the related `AliasNode` class, instances of this class are + _not_ actual nodes and hence _not_ added to the graph; they only facilitate + communication between the `ModuleGraph.alias_module()` and + `ModuleGraph.find_node()` methods. + """ + + +class AliasNode(Node): + """ + Graph node representing the aliasing of an existing source module under a + non-existent target module name (i.e., the desired alias). + """ + + def __init__(self, name, node=None): + """ + Initialize this alias. + + Parameters + ---------- + name : str + Fully-qualified name of the non-existent target module to be + created (as an alias of the existing source module). + node : Node + Graph node of the existing source module being aliased. Optional; + if not provided here, the attributes from referred node should + be copied later using `copyAttributesFromReferredNode` method. + """ + super(AliasNode, self).__init__(name) + + # Copy attributes from referred node, if provided + self.copyAttributesFromReferredNode(node) + + def copyAttributesFromReferredNode(self, node): + """ + Copy a subset of attributes from referred node (source module) into this target alias. + """ + # FIXME: Why only some? Why not *EVERYTHING* except "graphident", which + # must remain equal to "name" for lookup purposes? This is, after all, + # an alias. The idea is for the two nodes to effectively be the same. + for attr_name in ( + 'identifier', 'packagepath', + '_global_attr_names', '_starimported_ignored_module_names', + '_submodule_basename_to_node'): + if hasattr(node, attr_name): + setattr(self, attr_name, getattr(node, attr_name)) + + def infoTuple(self): + return (self.graphident, self.identifier) + + +class BadModule(Node): + pass + + +class ExcludedModule(BadModule): + pass + + +class MissingModule(BadModule): + pass + + +class InvalidRelativeImport (BadModule): + def __init__(self, relative_path, from_name): + identifier = relative_path + if relative_path.endswith('.'): + identifier += from_name + else: + identifier += '.' + from_name + super(InvalidRelativeImport, self).__init__(identifier) + self.relative_path = relative_path + self.from_name = from_name + + def infoTuple(self): + return (self.relative_path, self.from_name) + + +class Script(Node): + def __init__(self, filename): + super(Script, self).__init__(filename) + self.filename = filename + + def infoTuple(self): + return (self.filename,) + + +class BaseModule(Node): + def __init__(self, name, filename=None, path=None): + super(BaseModule, self).__init__(name) + self.filename = filename + self.packagepath = path + + def infoTuple(self): + return tuple(filter(None, (self.identifier, self.filename, self.packagepath))) + + +class BuiltinModule(BaseModule): + pass + + +class SourceModule(BaseModule): + pass + + +class InvalidSourceModule(SourceModule): + pass + + +class CompiledModule(BaseModule): + pass + + +class InvalidCompiledModule(BaseModule): + pass + + +class Extension(BaseModule): + pass + + +class Package(BaseModule): + """ + Graph node representing a non-namespace package. + """ + pass + + +class ExtensionPackage(Extension, Package): + """ + Graph node representing a package where the __init__ module is an extension + module. + """ + pass + + +class NamespacePackage(Package): + """ + Graph node representing a namespace package. + """ + pass + + +class RuntimeModule(BaseModule): + """ + Graph node representing a non-package Python module dynamically defined at + runtime. + + Most modules are statically defined on-disk as standard Python files. + Some modules, however, are dynamically defined in-memory at runtime + (e.g., `gi.repository.Gst`, dynamically defined by the statically + defined `gi.repository.__init__` module). + + This node represents such a runtime module. Since this is _not_ a package, + all attempts to import submodules from this module in `from`-style import + statements (e.g., the `queue` submodule in `from six.moves import queue`) + will be silently ignored. + + To ensure that the parent package of this module if any is also imported + and added to the graph, this node is typically added to the graph by + calling the `ModuleGraph.add_module()` method. + """ + pass + + +class RuntimePackage(Package): + """ + Graph node representing a non-namespace Python package dynamically defined + at runtime. + + Most packages are statically defined on-disk as standard subdirectories + containing `__init__.py` files. Some packages, however, are dynamically + defined in-memory at runtime (e.g., `six.moves`, dynamically defined by + the statically defined `six` module). + + This node represents such a runtime package. All attributes imported from + this package in `from`-style import statements that are submodules of this + package (e.g., the `queue` submodule in `from six.moves import queue`) will + be imported rather than ignored. + + To ensure that the parent package of this package if any is also imported + and added to the graph, this node is typically added to the graph by + calling the `ModuleGraph.add_module()` method. + """ + pass + + +#FIXME: Safely removable. We don't actually use this anywhere. After removing +#this class, remove the corresponding entry from "compat". +class FlatPackage(BaseModule): + def __init__(self, *args, **kwds): + warnings.warn( + "This class will be removed in a future version of modulegraph", + DeprecationWarning) + super(FlatPackage, *args, **kwds) + + +#FIXME: Safely removable. We don't actually use this anywhere. After removing +#this class, remove the corresponding entry from "compat". +class ArchiveModule(BaseModule): + def __init__(self, *args, **kwds): + warnings.warn( + "This class will be removed in a future version of modulegraph", + DeprecationWarning) + super(FlatPackage, *args, **kwds) + + +# HTML templates for ModuleGraph generator +header = """\ + + + + + %(TITLE)s + + + +

%(TITLE)s

""" +entry = """ +
+ + %(CONTENT)s +
""" +contpl = """%(NAME)s %(TYPE)s""" +contpl_linked = """\ +%(NAME)s +%(TYPE)s""" +imports = """\ +
+%(HEAD)s: + %(LINKS)s +
+""" +footer = """ + +""" + + +def _ast_names(names): + result = [] + for nm in names: + if isinstance(nm, ast.alias): + result.append(nm.name) + else: + result.append(nm) + + result = [r for r in result if r != '__main__'] + return result + + +def uniq(seq): + """Remove duplicates from a list, preserving order""" + # Taken from https://stackoverflow.com/questions/480214 + seen = set() + seen_add = seen.add + return [x for x in seq if not (x in seen or seen_add(x))] + + +DEFAULT_IMPORT_LEVEL = 0 + + +class _Visitor(ast.NodeVisitor): + def __init__(self, graph, module): + self._graph = graph + self._module = module + self._level = DEFAULT_IMPORT_LEVEL + self._in_if = [False] + self._in_def = [False] + self._in_tryexcept = [False] + + @property + def in_if(self): + return self._in_if[-1] + + @property + def in_def(self): + return self._in_def[-1] + + @property + def in_tryexcept(self): + return self._in_tryexcept[-1] + + + def _collect_import(self, name, fromlist, level): + have_star = False + if fromlist is not None: + fromlist = uniq(fromlist) + if '*' in fromlist: + fromlist.remove('*') + have_star = True + + # Record this import as originating from this module for subsequent + # handling by the _process_imports() method. + self._module._deferred_imports.append( + (have_star, + (name, self._module, fromlist, level), + {'edge_attr': DependencyInfo( + conditional=self.in_if, + tryexcept=self.in_tryexcept, + function=self.in_def, + fromlist=False)})) + + + def visit_Import(self, node): + for nm in _ast_names(node.names): + self._collect_import(nm, None, self._level) + + def visit_ImportFrom(self, node): + level = node.level if node.level != 0 else self._level + self._collect_import(node.module or '', _ast_names(node.names), level) + + def visit_If(self, node): + self._in_if.append(True) + self.generic_visit(node) + self._in_if.pop() + + def visit_FunctionDef(self, node): + self._in_def.append(True) + self.generic_visit(node) + self._in_def.pop() + + visit_AsyncFunctionDef = visit_FunctionDef + + def visit_Try(self, node): + self._in_tryexcept.append(True) + self.generic_visit(node) + self._in_tryexcept.pop() + + def visit_TryExcept(self, node): + self._in_tryexcept.append(True) + self.generic_visit(node) + self._in_tryexcept.pop() + + def visit_Expression(self, node): + # Expression node's cannot contain import statements or + # other nodes that are relevant for us. + pass + + # Expression isn't actually used as such in AST trees, + # therefore define visitors for all kinds of expression nodes. + visit_BoolOp = visit_Expression + visit_BinOp = visit_Expression + visit_UnaryOp = visit_Expression + visit_Lambda = visit_Expression + visit_IfExp = visit_Expression + visit_Dict = visit_Expression + visit_Set = visit_Expression + visit_ListComp = visit_Expression + visit_SetComp = visit_Expression + visit_ListComp = visit_Expression + visit_GeneratorExp = visit_Expression + visit_Compare = visit_Expression + visit_Yield = visit_Expression + visit_YieldFrom = visit_Expression + visit_Await = visit_Expression + visit_Call = visit_Expression + visit_Await = visit_Expression + + +class ModuleGraph(ObjectGraph): + """ + Directed graph whose nodes represent modules and edges represent + dependencies between these modules. + """ + + + def createNode(self, cls, name, *args, **kw): + m = self.find_node(name) + + if m is None: + #assert m is None, m + m = super(ModuleGraph, self).createNode(cls, name, *args, **kw) + + return m + + + def __init__(self, path=None, excludes=(), replace_paths=(), implies=(), graph=None, debug=0): + super(ModuleGraph, self).__init__(graph=graph, debug=debug) + if path is None: + path = sys.path + self.path = path + self.lazynodes = {} + # excludes is stronger than implies + self.lazynodes.update(dict(implies)) + for m in excludes: + self.lazynodes[m] = None + self.replace_paths = replace_paths + + # Maintain own list of package path mappings in the scope of Modulegraph + # object. + self._package_path_map = {} + + # Legacy namespace-package paths. Initialized by scan_legacy_namespace_packages. + self._legacy_ns_packages = {} + + def scan_legacy_namespace_packages(self): + """ + Resolve extra package `__path__` entries for legacy setuptools-based + namespace packages, by reading `namespace_packages.txt` from dist + metadata. + """ + legacy_ns_packages = defaultdict(lambda: set()) + + for dist in importlib_metadata.distributions(): + ns_packages = dist.read_text("namespace_packages.txt") + if ns_packages is None: + continue + ns_packages = ns_packages.splitlines() + # Obtain path to dist metadata directory + dist_path = getattr(dist, '_path') + if dist_path is None: + continue + for package_name in ns_packages: + path = os.path.join( + str(dist_path.parent), # might be zipfile.Path if in zipped .egg + *package_name.split('.'), + ) + legacy_ns_packages[package_name].add(path) + + # Convert into dictionary of lists + self._legacy_ns_packages = { + package_name: list(paths) + for package_name, paths in legacy_ns_packages.items() + } + + def implyNodeReference(self, node, other, edge_data=None): + """ + Create a reference from the passed source node to the passed other node, + implying the former to depend upon the latter. + + While the source node _must_ be an existing graph node, the target node + may be either an existing graph node _or_ a fully-qualified module name. + In the latter case, the module with that name and all parent packages of + that module will be imported _without_ raising exceptions and for each + newly imported module or package: + + * A new graph node will be created for that module or package. + * A reference from the passed source node to that module or package will + be created. + + This method allows dependencies between Python objects _not_ importable + with standard techniques (e.g., module aliases, C extensions). + + Parameters + ---------- + node : str + Graph node for this reference's source module or package. + other : {Node, str} + Either a graph node _or_ fully-qualified name for this reference's + target module or package. + """ + + if isinstance(other, Node): + self._updateReference(node, other, edge_data) + else: + if isinstance(other, tuple): + raise ValueError(other) + others = self._safe_import_hook(other, node, None) + for other in others: + self._updateReference(node, other, edge_data) + + def outgoing(self, fromnode): + """ + Yield all nodes that `fromnode` dependes on (that is, + all modules that `fromnode` imports. + """ + + node = self.find_node(fromnode) + out_edges, _ = self.get_edges(node) + return out_edges + + getReferences = outgoing + + def incoming(self, tonode, collapse_missing_modules=True): + node = self.find_node(tonode) + _, in_edges = self.get_edges(node) + + if collapse_missing_modules: + for n in in_edges: + if isinstance(n, MissingModule): + for n in self.incoming(n, False): + yield n + + else: + yield n + + else: + for n in in_edges: + yield n + + getReferers = incoming + + def hasEdge(self, fromnode, tonode): + """ Return True iff there is an edge from 'fromnode' to 'tonode' """ + fromnode = self.find_node(fromnode) + tonode = self.find_node(tonode) + + return self.graph.edge_by_node(fromnode, tonode) is not None + + def foldReferences(self, packagenode): + """ + Create edges to/from `packagenode` based on the edges to/from all + submodules of that package _and_ then hide the graph nodes + corresponding to those submodules. + """ + + pkg = self.find_node(packagenode) + + for n in self.nodes(): + if not n.identifier.startswith(pkg.identifier + '.'): + continue + + iter_out, iter_inc = self.get_edges(n) + for other in iter_out: + if other.identifier.startswith(pkg.identifier + '.'): + continue + + if not self.hasEdge(pkg, other): + # Ignore circular dependencies + self._updateReference(pkg, other, 'pkg-internal-import') + + for other in iter_inc: + if other.identifier.startswith(pkg.identifier + '.'): + # Ignore circular dependencies + continue + + if not self.hasEdge(other, pkg): + self._updateReference(other, pkg, 'pkg-import') + + self.graph.hide_node(n) + + # TODO: unfoldReferences(pkg) that restore the submodule nodes and + # removes 'pkg-import' and 'pkg-internal-import' edges. Care should + # be taken to ensure that references are correct if multiple packages + # are folded and then one of them in unfolded + + def _updateReference(self, fromnode, tonode, edge_data): + try: + ed = self.edgeData(fromnode, tonode) + except (KeyError, GraphError): # XXX: Why 'GraphError' + return self.add_edge(fromnode, tonode, edge_data) + + if not (isinstance(ed, DependencyInfo) and isinstance(edge_data, DependencyInfo)): + self.updateEdgeData(fromnode, tonode, edge_data) + else: + self.updateEdgeData(fromnode, tonode, ed._merged(edge_data)) + + def add_edge(self, fromnode, tonode, edge_data='direct'): + """ + Create a reference from fromnode to tonode + """ + return super(ModuleGraph, self).createReference(fromnode, tonode, edge_data=edge_data) + + createReference = add_edge + + def find_node(self, name, create_nspkg=True): + """ + Graph node uniquely identified by the passed fully-qualified module + name if this module has been added to the graph _or_ `None` otherwise. + + If (in order): + + . A namespace package with this identifier exists _and_ the passed + `create_nspkg` parameter is `True`, this package will be + instantiated and returned. + . A lazy node with this identifier and: + * No dependencies exists, this node will be instantiated and + returned. + * Dependencies exists, this node and all transitive dependencies of + this node be instantiated and this node returned. + . A non-lazy node with this identifier exists, this node will be + returned as is. + + Parameters + ---------- + name : str + Fully-qualified name of the module whose graph node is to be found. + create_nspkg : bool + Ignored. + + Returns + ---------- + Node + Graph node of this module if added to the graph _or_ `None` + otherwise. + """ + + data = super(ModuleGraph, self).findNode(name) + + if data is not None: + return data + + if name in self.lazynodes: + deps = self.lazynodes.pop(name) + + if deps is None: + # excluded module + m = self.createNode(ExcludedModule, name) + elif isinstance(deps, Alias): + # NOTE: the AliasNode must be created and added to graph + # before trying to create the referred node; that might + # (due to recursive import analysis) lead to another + # attempt to resolve the aliased node (and if there is + # a real node that we are trying to shadow with the alias, + # that will end up added to the graph and prevent the + # alias node from being added). + m = self.createNode(AliasNode, name) + + # Create the referred node. + other = self._safe_import_hook(deps, None, None).pop() + + # Copy attributes; this used to be done by AliasNode + # constructor, back when referred node was created before + # the AliasNode (and could thus be passed to its constructor). + m.copyAttributesFromReferredNode(other) + + self.implyNodeReference(m, other) + else: + m = self._safe_import_hook(name, None, None).pop() + for dep in deps: + self.implyNodeReference(m, dep) + + return m + + return None + + findNode = find_node + iter_graph = ObjectGraph.flatten + + def add_script(self, pathname, caller=None): + """ + Create a node by path (not module name). It is expected to be a Python + source file, and will be scanned for dependencies. + """ + self.msg(2, "run_script", pathname) + + pathname = os.path.realpath(pathname) + m = self.find_node(pathname) + if m is not None: + return m + + with open(pathname, 'rb') as fp: + contents = fp.read() + contents = importlib.util.decode_source(contents) + + co_ast = compile(contents, pathname, 'exec', ast.PyCF_ONLY_AST, True) + co = compile(co_ast, pathname, 'exec', 0, True) + m = self.createNode(Script, pathname) + self._updateReference(caller, m, None) + n = self._scan_code(m, co, co_ast) + self._process_imports(n) + m.code = co + if self.replace_paths: + m.code = self._replace_paths_in_code(m.code) + return m + + + #FIXME: For safety, the "source_module" parameter should default to the + #root node of the current graph if unpassed. This parameter currently + #defaults to None, thus disconnected modules imported in this manner (e.g., + #hidden imports imported by depend.analysis.initialize_modgraph()). + def import_hook( + self, + target_module_partname, + source_module=None, + target_attr_names=None, + level=DEFAULT_IMPORT_LEVEL, + edge_attr=None, + ): + """ + Import the module with the passed name, all parent packages of this + module, _and_ all submodules and attributes in this module with the + passed names from the previously imported caller module signified by + the passed graph node. + + Unlike most import methods (e.g., `_safe_import_hook()`), this method + is designed to be publicly called by both external and internal + callers and hence is public. + + Parameters + ---------- + target_module_partname : str + Partially-qualified name of the target module to be imported. See + `_safe_import_hook()` for further details. + source_module : Node + Graph node for the previously imported **source module** (i.e., + module containing the `import` statement triggering the call to + this method) _or_ `None` if this module is to be imported in a + "disconnected" manner. **Passing `None` is _not_ recommended.** + Doing so produces a disconnected graph in which the graph node + created for the module to be imported will be disconnected and + hence unreachable from all other nodes -- which frequently causes + subtle issues in external callers (namely PyInstaller, which + silently ignores unreachable nodes). + target_attr_names : list + List of the unqualified names of all submodules and attributes to + be imported from the module to be imported if this is a "from"- + style import (e.g., `[encode_base64, encode_noop]` for the import + `from email.encoders import encode_base64, encode_noop`) _or_ + `None` otherwise. + level : int + Whether to perform an absolute or relative import. See + `_safe_import_hook()` for further details. + + Returns + ---------- + list + List of the graph nodes created for all modules explicitly imported + by this call, including the passed module and all submodules listed + in `target_attr_names` _but_ excluding all parent packages + implicitly imported by this call. If `target_attr_names` is `None` + or the empty list, this is guaranteed to be a list of one element: + the graph node created for the passed module. + + Raises + ---------- + ImportError + If the target module to be imported is unimportable. + """ + self.msg(3, "_import_hook", target_module_partname, source_module, source_module, level) + + source_package = self._determine_parent(source_module) + target_package, target_module_partname = self._find_head_package( + source_package, target_module_partname, level) + + self.msgin(4, "load_tail", target_package, target_module_partname) + + submodule = target_package + while target_module_partname: + i = target_module_partname.find('.') + if i < 0: + i = len(target_module_partname) + head, target_module_partname = target_module_partname[ + :i], target_module_partname[i+1:] + mname = "%s.%s" % (submodule.identifier, head) + submodule = self._safe_import_module(head, mname, submodule) + + if submodule is None: + # FIXME: Why do we no longer return a MissingModule instance? + # result = self.createNode(MissingModule, mname) + self.msgout(4, "raise ImportError: No module named", mname) + raise ImportError("No module named " + repr(mname)) + + self.msgout(4, "load_tail ->", submodule) + + target_module = submodule + target_modules = [target_module] + + # If this is a "from"-style import *AND* this target module is + # actually a package, import all submodules of this package specified + # by the "import" half of this import (e.g., the submodules "bar" and + # "car" of the target package "foo" in "from foo import bar, car"). + # + # If this target module is a non-package, it could still contain + # importable submodules (e.g., the non-package `os` module containing + # the `os.path` submodule). In this case, these submodules are already + # imported by this target module's pure-Python code. Since our import + # scanner already detects such imports, these submodules need *NOT* be + # reimported here. + if target_attr_names and isinstance(target_module, + (Package, AliasNode)): + for target_submodule in self._import_importable_package_submodules( + target_module, target_attr_names): + if target_submodule not in target_modules: + target_modules.append(target_submodule) + + # Add an edge from this source module to each target module. + for target_module in target_modules: + self._updateReference( + source_module, target_module, edge_data=edge_attr) + + return target_modules + + + def _determine_parent(self, caller): + """ + Determine the package containing a node. + """ + self.msgin(4, "determine_parent", caller) + + parent = None + if caller: + pname = caller.identifier + + if isinstance(caller, Package): + parent = caller + + elif '.' in pname: + pname = pname[:pname.rfind('.')] + parent = self.find_node(pname) + + elif caller.packagepath: + # XXX: I have no idea why this line + # is necessary. + parent = self.find_node(pname) + + self.msgout(4, "determine_parent ->", parent) + return parent + + + def _find_head_package( + self, + source_package, + target_module_partname, + level=DEFAULT_IMPORT_LEVEL): + """ + Import the target package providing the target module with the passed + name to be subsequently imported from the previously imported source + package corresponding to the passed graph node. + + Parameters + ---------- + source_package : Package + Graph node for the previously imported **source package** (i.e., + package containing the module containing the `import` statement + triggering the call to this method) _or_ `None` if this module is + to be imported in a "disconnected" manner. **Passing `None` is + _not_ recommended.** See the `_import_hook()` method for further + details. + target_module_partname : str + Partially-qualified name of the target module to be imported. See + `_safe_import_hook()` for further details. + level : int + Whether to perform absolute or relative imports. See the + `_safe_import_hook()` method for further details. + + Returns + ---------- + (target_package, target_module_tailname) + 2-tuple describing the imported target package, where: + * `target_package` is the graph node created for this package. + * `target_module_tailname` is the unqualified name of the target + module to be subsequently imported (e.g., `text` when passed a + `target_module_partname` of `email.mime.text`). + + Raises + ---------- + ImportError + If the package to be imported is unimportable. + """ + self.msgin(4, "find_head_package", source_package, target_module_partname, level) + + #FIXME: Rename all local variable names to something sensible. No, + #"p_fqdn" is not a sensible name. + + # If this target module is a submodule... + if '.' in target_module_partname: + target_module_headname, target_module_tailname = ( + target_module_partname.split('.', 1)) + # Else, this target module is a top-level module. + else: + target_module_headname = target_module_partname + target_module_tailname = '' + + # If attempting both absolute and relative imports... + if level == ABSOLUTE_OR_RELATIVE_IMPORT_LEVEL: + if source_package: + target_package_name = source_package.identifier + '.' + target_module_headname + else: + target_package_name = target_module_headname + # Else if attempting only absolute imports... + elif level == ABSOLUTE_IMPORT_LEVEL: + target_package_name = target_module_headname + + # Absolute import, ignore the parent + source_package = None + # Else if attempting only relative imports... + else: + if source_package is None: + self.msg(2, "Relative import outside of package") + raise InvalidRelativeImportError( + "Relative import outside of package (name=%r, parent=%r, level=%r)" % ( + target_module_partname, source_package, level)) + + for i in range(level - 1): + if '.' not in source_package.identifier: + self.msg(2, "Relative import outside of package") + raise InvalidRelativeImportError( + "Relative import outside of package (name=%r, parent=%r, level=%r)" % ( + target_module_partname, source_package, level)) + + p_fqdn = source_package.identifier.rsplit('.', 1)[0] + new_parent = self.find_node(p_fqdn) + if new_parent is None: + #FIXME: Repetition detected. Exterminate. Exterminate. + self.msg(2, "Relative import outside of package") + raise InvalidRelativeImportError( + "Relative import outside of package (name=%r, parent=%r, level=%r)" % ( + target_module_partname, source_package, level)) + + assert new_parent is not source_package, ( + new_parent, source_package) + source_package = new_parent + + if target_module_headname: + target_package_name = ( + source_package.identifier + '.' + target_module_headname) + else: + target_package_name = source_package.identifier + + # Graph node of this target package. + target_package = self._safe_import_module( + target_module_headname, target_package_name, source_package) + + # If this target package is *NOT* importable and a source package was + # passed, attempt to import this target package as an absolute import. + # + # ADDENDUM: but do this only if the passed "level" is either + # ABSOLUTE_IMPORT_LEVEL (0) or ABSOLUTE_OR_RELATIVE_IMPORT_LEVEL (-1). + # Otherwise, an attempt at relative import of a missing sub-module + # (from .module import something) might pull in an unrelated + # but eponymous top-level module, which should not happen. + if target_package is None and source_package is not None and level <= ABSOLUTE_IMPORT_LEVEL: + target_package_name = target_module_headname + source_package = None + + # Graph node for the target package, again. + target_package = self._safe_import_module( + target_module_headname, target_package_name, source_package) + + # If this target package is importable, return this package. + if target_package is not None: + self.msgout(4, "find_head_package ->", (target_package, target_module_tailname)) + return target_package, target_module_tailname + + # Else, raise an exception. + self.msgout(4, "raise ImportError: No module named", target_package_name) + raise ImportError("No module named " + target_package_name) + + + + + #FIXME: Refactor from a generator yielding graph nodes into a non-generator + #returning a list or tuple of all yielded graph nodes. This method is only + #called once above and the return value of that call is only iterated over + #as a list or tuple. There's no demonstrable reason for this to be a + #generator. Generators are great for their intended purposes (e.g., as + #continuations). This isn't one of those purposes. + def _import_importable_package_submodules(self, package, attr_names): + """ + Generator importing and yielding each importable submodule (of the + previously imported package corresponding to the passed graph node) + whose unqualified name is in the passed list. + + Elements of this list that are _not_ importable submodules of this + package are either: + + * Ignorable attributes (e.g., classes, globals) defined at the top + level of this package's `__init__` submodule, which will be ignored. + * Else, unignorable unimportable submodules, in which case an + exception is raised. + + Parameters + ---------- + package : Package + Graph node of the previously imported package containing the + modules to be imported and yielded. + + attr_names : list + List of the unqualified names of all attributes of this package to + attempt to import as submodules. This list will be internally + converted into a set, safely ignoring any duplicates in this list + (e.g., reducing the "from"-style import + `from foo import bar, car, far, bar, car, far` to merely + `from foo import bar, car, far`). + + Yields + ---------- + Node + Graph node created for the currently imported submodule. + + Raises + ---------- + ImportError + If any attribute whose name is in `attr_names` is neither: + * An importable submodule of this package. + * An ignorable global attribute (e.g., class, variable) defined at + the top level of this package's `__init__` submodule. + In this case, this attribute _must_ be an unimportable submodule of + this package. + """ + + # Ignore duplicate submodule names in the passed list. + attr_names = set(attr_names) + self.msgin(4, "_import_importable_package_submodules", package, attr_names) + + #FIXME: This test *SHOULD* be superfluous and hence safely removable. + #The higher-level _scan_bytecode() and _collect_import() methods + #already guarantee "*" characters to be removed from fromlists. + if '*' in attr_names: + attr_names.update(self._find_all_submodules(package)) + attr_names.remove('*') + + # self.msg(4, '_import_importable_package_submodules (global attrs)', package.identifier, package._global_attr_names) + + # For the name of each attribute to be imported from this package... + for attr_name in attr_names: + # self.msg(4, '_import_importable_package_submodules (fromlist attr)', package.identifier, attr_name) + + # Graph node of this attribute if this attribute is a previously + # imported module or None otherwise. + submodule = package.get_submodule_or_none(attr_name) + + # If this attribute is *NOT* a previously imported module, attempt + # to import this attribute as a submodule of this package. + if submodule is None: + # Fully-qualified name of this submodule. + submodule_name = package.identifier + '.' + attr_name + + # Graph node of this submodule if importable or None otherwise. + submodule = self._safe_import_module( + attr_name, submodule_name, package) + + # If this submodule is unimportable... + if submodule is None: + # If this attribute is a global (e.g., class, variable) + # defined at the top level of this package's "__init__" + # submodule, this importation is safely ignorable. Do so + # and skip to the next attribute. + # + # This behaviour is non-conformant with Python behaviour, + # which is bad, but is required to sanely handle all + # possible edge cases, which is good. In Python, a global + # attribute defined at the top level of a package's + # "__init__" submodule shadows a submodule of the same name + # in that package. Attempting to import that submodule + # instead imports that attribute; thus, that submodule is + # effectively unimportable. In this method and elsewhere, + # that submodule is tested for first and hence shadows that + # attribute -- the opposite logic. Attempts to import that + # attribute are mistakenly seen as attempts to import that + # submodule! Why? + # + # Edge cases. PyInstaller (and by extension ModuleGraph) + # only cares about module imports. Global attribute imports + # are parsed only as the means to this ends and are + # otherwise ignorable. The cost of erroneously shadowing: + # + # * Submodules by attributes is significant. Doing so + # prevents such submodules from being frozen and hence + # imported at application runtime. + # * Attributes by submodules is insignificant. Doing so + # could erroneously freeze such submodules despite their + # never being imported at application runtime. However, + # ModuleGraph is incapable of determining with certainty + # that Python logic in another module other than the + # "__init__" submodule containing these attributes does + # *NOT* delete these attributes and hence unshadow these + # submodules, which would then become importable at + # runtime and require freezing. Hence, ModuleGraph *MUST* + # permissively assume submodules of the same name as + # attributes to be unshadowed elsewhere and require + # freezing -- even if they do not. + # + # It is practically difficult (albeit technically feasible) + # for ModuleGraph to determine whether or not the target + # attribute names of "from"-style import statements (e.g., + # "bar" and "car" in "from foo import bar, car") refer to + # non-ignorable submodules or ignorable non-module globals + # during opcode scanning. Distinguishing these two cases + # during opcode scanning would require a costly call to the + # _find_module() method, which would subsequently be + # repeated during import-graph construction. This could be + # ameliorated with caching, which itself would require + # costly space consumption and developer time. + # + # Since opcode scanning fails to distinguish these two + # cases, this and other methods subsequently called at + # import-graph construction time (e.g., + # _safe_import_hook()) must do so. Since submodules of the + # same name as attributes must assume to be unshadowed + # elsewhere and require freezing, the only solution is to + # attempt to import an attribute as a non-ignorable module + # *BEFORE* assuming an attribute to be an ignorable + # non-module. Which is what this and other methods do. + # + # See Package.is_global_attr() for similar discussion. + if package.is_global_attr(attr_name): + self.msg(4, '_import_importable_package_submodules: ignoring from-imported global', package.identifier, attr_name) + continue + # Else, this attribute is an unimportable submodule. Since + # this is *NOT* safely ignorable, raise an exception. + else: + raise ImportError("No module named " + submodule_name) + + # Yield this submodule's graph node to the caller. + yield submodule + + self.msgin(4, "_import_importable_package_submodules ->") + + + def _find_all_submodules(self, m): + if not m.packagepath: + return + # 'suffixes' used to be a list hardcoded to [".py", ".pyc", ".pyo"]. + # But we must also collect Python extension modules - although + # we cannot separate normal dlls from Python extensions. + for path in m.packagepath: + try: + names = os.listdir(path) + except (os.error, IOError): + self.msg(2, "can't list directory", path) + continue + for name in names: + for suffix in importlib.machinery.all_suffixes(): + if path.endswith(suffix): + name = os.path.basename(path)[:-len(suffix)] + break + else: + continue + if name != '__init__': + yield name + + + def alias_module(self, src_module_name, trg_module_name): + """ + Alias the source module to the target module with the passed names. + + This method ensures that the next call to findNode() given the target + module name will resolve this alias. This includes importing and adding + a graph node for the source module if needed as well as adding a + reference from the target to source module. + + Parameters + ---------- + src_module_name : str + Fully-qualified name of the existing **source module** (i.e., the + module being aliased). + trg_module_name : str + Fully-qualified name of the non-existent **target module** (i.e., + the alias to be created). + """ + self.msg(3, 'alias_module "%s" -> "%s"' % (src_module_name, trg_module_name)) + # print('alias_module "%s" -> "%s"' % (src_module_name, trg_module_name)) + assert isinstance(src_module_name, str), '"%s" not a module name.' % str(src_module_name) + assert isinstance(trg_module_name, str), '"%s" not a module name.' % str(trg_module_name) + + # If the target module has already been added to the graph as either a + # non-alias or as a different alias, raise an exception. + trg_module = self.find_node(trg_module_name) + if trg_module is not None and not ( + isinstance(trg_module, AliasNode) and + trg_module.identifier == src_module_name): + raise ValueError( + 'Target module "%s" already imported as "%s".' % ( + trg_module_name, trg_module)) + + # See findNode() for details. + self.lazynodes[trg_module_name] = Alias(src_module_name) + + + def add_module(self, module): + """ + Add the passed module node to the graph if not already added. + + If that module has a parent module or package with a previously added + node, this method also adds a reference from this module node to its + parent node and adds this module node to its parent node's namespace. + + This high-level method wraps the low-level `addNode()` method, but is + typically _only_ called by graph hooks adding runtime module nodes. For + all other node types, the `import_module()` method should be called. + + Parameters + ---------- + module : BaseModule + Graph node of the module to be added. + """ + self.msg(3, 'add_module', module) + + # If no node exists for this module, add such a node. + module_added = self.find_node(module.identifier) + if module_added is None: + self.addNode(module) + else: + assert module == module_added, 'New module %r != previous %r.' % (module, module_added) + + # If this module has a previously added parent, reference this module to + # its parent and add this module to its parent's namespace. + parent_name, _, module_basename = module.identifier.rpartition('.') + if parent_name: + parent = self.find_node(parent_name) + if parent is None: + self.msg(4, 'add_module parent not found:', parent_name) + else: + self.add_edge(module, parent) + parent.add_submodule(module_basename, module) + + + def append_package_path(self, package_name, directory): + """ + Modulegraph does a good job at simulating Python's, but it can not + handle packagepath '__path__' modifications packages make at runtime. + + Therefore there is a mechanism whereby you can register extra paths + in this map for a package, and it will be honored. + + NOTE: This method has to be called before a package is resolved by + modulegraph. + + Parameters + ---------- + module : str + Fully-qualified module name. + directory : str + Absolute or relative path of the directory to append to the + '__path__' attribute. + """ + + paths = self._package_path_map.setdefault(package_name, []) + paths.append(directory) + + + def _safe_import_module( + self, module_partname, module_name, parent_module): + """ + Create a new graph node for the module with the passed name under the + parent package signified by the passed graph node _without_ raising + `ImportError` exceptions. + + If this module has already been imported, this module's existing graph + node will be returned; else if this module is importable, a new graph + node will be added for this module and returned; else this module is + unimportable, in which case `None` will be returned. Like the + `_safe_import_hook()` method, this method does _not_ raise + `ImportError` exceptions when this module is unimportable. + + Parameters + ---------- + module_partname : str + Unqualified name of the module to be imported (e.g., `text`). + module_name : str + Fully-qualified name of this module (e.g., `email.mime.text`). + parent_module : Package + Graph node of the previously imported parent module containing this + submodule _or_ `None` if this is a top-level module (i.e., + `module_name` contains no `.` delimiters). This parent module is + typically but _not_ always a package (e.g., the `os.path` submodule + contained by the `os` module). + + Returns + ---------- + Node + Graph node created for this module _or_ `None` if this module is + unimportable. + """ + self.msgin(3, "safe_import_module", module_partname, module_name, parent_module) + + # If this module has *NOT* already been imported, do so. + module = self.find_node(module_name) + if module is None: + # List of the absolute paths of all directories to be searched for + # this module. This effectively defaults to "sys.path". + search_dirs = None + + # If this module has a parent package... + if parent_module is not None: + # ...with a list of the absolute paths of all directories + # comprising this package, prefer that to "sys.path". + if parent_module.packagepath is not None: + search_dirs = parent_module.packagepath + # Else, something is horribly wrong. Return emptiness. + else: + self.msgout(3, "safe_import_module -> None (parent_parent.packagepath is None)") + return None + + try: + pathname, loader = self._find_module( + module_partname, search_dirs, parent_module) + except ImportError as exc: + self.msgout(3, "safe_import_module -> None (%r)" % exc) + return None + + (module, co) = self._load_module(module_name, pathname, loader) + if co is not None: + try: + if isinstance(co, ast.AST): + co_ast = co + co = compile(co_ast, pathname, 'exec', 0, True) + else: + co_ast = None + n = self._scan_code(module, co, co_ast) + self._process_imports(n) + + if self.replace_paths: + co = self._replace_paths_in_code(co) + module.code = co + except SyntaxError: + self.msg( + 1, "safe_import_module: SyntaxError in ", pathname, + ) + cls = InvalidSourceModule + module = self.createNode(cls, module_name) + + # If this is a submodule rather than top-level module... + if parent_module is not None: + self.msg(4, "safe_import_module create reference", module, "->", parent_module) + + # Add an edge from this submodule to its parent module. + self._updateReference( + module, parent_module, edge_data=DependencyInfo( + conditional=False, + fromlist=False, + function=False, + tryexcept=False, + )) + + # Add this submodule to its parent module. + parent_module.add_submodule(module_partname, module) + + # Return this module. + self.msgout(3, "safe_import_module ->", module) + return module + + def _load_module(self, fqname, pathname, loader): + from importlib._bootstrap_external import ExtensionFileLoader + self.msgin(2, "load_module", fqname, pathname, + loader.__class__.__name__) + partname = fqname.rpartition(".")[-1] + + if loader.is_package(partname): + if isinstance(loader, NAMESPACE_PACKAGE): + # This is a PEP-420 namespace package. + m = self.createNode(NamespacePackage, fqname) + m.filename = '-' + m.packagepath = loader.namespace_dirs[:] # copy for safety + else: + # Regular package. + # + # NOTE: this might be a legacy setuptools (pkg_resources) + # based namespace package (with __init__.py, but calling + # `pkg_resources.declare_namespace(__name__)`). To properly + # handle the case when such a package is split across + # multiple locations, we need to resolve the package + # paths via metadata. + ns_pkgpaths = self._legacy_ns_packages.get(fqname, []) + + if isinstance(loader, ExtensionFileLoader): + m = self.createNode(ExtensionPackage, fqname) + else: + m = self.createNode(Package, fqname) + m.filename = pathname + # PEP-302-compliant loaders return the pathname of the + # `__init__`-file, not the package directory. + assert os.path.basename(pathname).startswith('__init__.') + m.packagepath = [os.path.dirname(pathname)] + ns_pkgpaths + + # As per comment at top of file, simulate runtime packagepath + # additions + m.packagepath = m.packagepath + self._package_path_map.get( + fqname, []) + + if isinstance(m, NamespacePackage): + return (m, None) + + co = None + if loader is BUILTIN_MODULE: + cls = BuiltinModule + elif isinstance(loader, ExtensionFileLoader): + cls = Extension + + # Look for accompanying .py or .pyi file, which might allow + # us to perform basic import analysis for the extension. + def _co_from_accompanying_source(extension_filename): + path = os.path.dirname(extension_filename) + basename = os.path.basename(extension_filename).split('.')[0] + + for ext in {'.py', '.pyi'}: + src_filename = os.path.join(path, basename + ext) + if not os.path.isfile(src_filename): + continue + + try: + with open(src_filename, 'rb') as fp: + src = fp.read() + co = compile(src, src_filename, 'exec', ast.PyCF_ONLY_AST, True) + return co + except Exception as e: + pass + + co = _co_from_accompanying_source(pathname) + else: + try: + src = loader.get_source(partname) + except (UnicodeDecodeError, SyntaxError) as e: + # The `UnicodeDecodeError` is typically raised here when the + # source file contains non-ASCII characters in some local + # encoding that is different from UTF-8, but fails to + # declare it via PEP361 encoding header. Python seems to + # be able to load and run such module, but we cannot retrieve + # the source for it via the `loader.get_source()`. + # + # The `UnicodeDecoreError` in turn triggers a `SyntaxError` + # when such invalid character appears on the first line of + # the source file (and interrupts the scan for PEP361 + # encoding header). + # + # In such cases, we try to fall back to reading the source + # as raw data file. + + # If `SyntaxError` was not raised during handling of + # a `UnicodeDecodeError`, it was likely a genuine syntax + # error, so re-raise it. + if isinstance(e, SyntaxError): + if not isinstance(e.__context__, UnicodeDecodeError): + raise + + self.msg(2, "load_module: failed to obtain source for " + f"{partname}: {e}! Falling back to reading as " + "raw data!") + + path = loader.get_filename(partname) + src = loader.get_data(path) + + if src is not None: + try: + co = compile(src, pathname, 'exec', ast.PyCF_ONLY_AST, True) + cls = SourceModule + except SyntaxError: + co = None + cls = InvalidSourceModule + except Exception as exc: # FIXME: more specific? + cls = InvalidSourceModule + self.msg(2, "load_module: InvalidSourceModule", pathname, + exc) + else: + # no src available + try: + co = loader.get_code(partname) + cls = (CompiledModule if co is not None + else InvalidCompiledModule) + except Exception as exc: # FIXME: more specific? + self.msg(2, "load_module: InvalidCompiledModule, " + "Cannot load code", pathname, exc) + cls = InvalidCompiledModule + + m = self.createNode(cls, fqname) + m.filename = pathname + + self.msgout(2, "load_module ->", m) + return (m, co) + + def _safe_import_hook( + self, target_module_partname, source_module, target_attr_names, + level=DEFAULT_IMPORT_LEVEL, edge_attr=None): + """ + Import the module with the passed name and all parent packages of this + module from the previously imported caller module signified by the + passed graph node _without_ raising `ImportError` exceptions. + + This method wraps the lowel-level `_import_hook()` method. On catching + an `ImportError` exception raised by that method, this method creates + and adds a `MissingNode` instance describing the unimportable module to + the graph instead. + + Parameters + ---------- + target_module_partname : str + Partially-qualified name of the module to be imported. If `level` + is: + * `ABSOLUTE_OR_RELATIVE_IMPORT_LEVEL` (e.g., the Python 2 default) + or a positive integer (e.g., an explicit relative import), the + fully-qualified name of this module is the concatenation of the + fully-qualified name of the caller module's package and this + parameter. + * `ABSOLUTE_IMPORT_LEVEL` (e.g., the Python 3 default), this name + is already fully-qualified. + * A non-negative integer (e.g., `1`), this name is typically the + empty string. In this case, this is a "from"-style relative + import (e.g., "from . import bar") and the fully-qualified name + of this module is dynamically resolved by import machinery. + source_module : Node + Graph node for the previously imported **caller module** (i.e., + module containing the `import` statement triggering the call to + this method) _or_ `None` if this module is to be imported in a + "disconnected" manner. **Passing `None` is _not_ recommended.** + Doing so produces a disconnected graph in which the graph node + created for the module to be imported will be disconnected and + hence unreachable from all other nodes -- which frequently causes + subtle issues in external callers (e.g., PyInstaller, which + silently ignores unreachable nodes). + target_attr_names : list + List of the unqualified names of all submodules and attributes to + be imported via a `from`-style import statement from this target + module if any (e.g., the list `[encode_base64, encode_noop]` for + the import `from email.encoders import encode_base64, encode_noop`) + _or_ `None` otherwise. Ignored unless `source_module` is the graph + node of a package (i.e., is an instance of the `Package` class). + Why? Because: + * Consistency. The `_import_importable_package_submodules()` + method accepts a similar list applicable only to packages. + * Efficiency. Unlike packages, modules cannot physically contain + submodules. Hence, any target module imported via a `from`-style + import statement as an attribute from another target parent + module must itself have been imported in that target parent + module. The import statement responsible for that import must + already have been previously parsed by `ModuleGraph`, in which + case that target module will already be frozen by PyInstaller. + These imports are safely ignorable here. + level : int + Whether to perform an absolute or relative import. This parameter + corresponds exactly to the parameter of the same name accepted by + the `__import__()` built-in: "The default is -1 which indicates + both absolute and relative imports will be attempted. 0 means only + perform absolute imports. Positive values for level indicate the + number of parent directories to search relative to the directory of + the module calling `__import__()`." Defaults to -1 under Python 2 + and 0 under Python 3. Since this default depends on the major + version of the current Python interpreter, depending on this + default can result in unpredictable and non-portable behaviour. + Callers are strongly recommended to explicitly pass this parameter + rather than implicitly accept this default. + + Returns + ---------- + list + List of the graph nodes created for all modules explicitly imported + by this call, including the passed module and all submodules listed + in `target_attr_names` _but_ excluding all parent packages + implicitly imported by this call. If `target_attr_names` is either + `None` or the empty list, this is guaranteed to be a list of one + element: the graph node created for the passed module. As above, + `MissingNode` instances are created for all unimportable modules. + """ + self.msg(3, "_safe_import_hook", target_module_partname, source_module, target_attr_names, level) + + def is_swig_candidate(): + return (source_module is not None and + target_attr_names is None and + level == ABSOLUTE_IMPORT_LEVEL and + type(source_module) is SourceModule and + target_module_partname == + '_' + source_module.identifier.rpartition('.')[2]) + + def is_swig_wrapper(source_module): + with open(source_module.filename, 'rb') as fp: + contents = fp.read() + contents = importlib.util.decode_source(contents) + first_line = contents.splitlines()[0] if contents else '' + self.msg(5, 'SWIG wrapper candidate first line: %r' % (first_line)) + return "automatically generated by SWIG" in first_line + + + # List of the graph nodes created for all target modules both + # imported by and returned from this call, whose: + # + # * First element is the graph node for the core target module + # specified by the "target_module_partname" parameter. + # * Remaining elements are the graph nodes for all target submodules + # specified by the "target_attr_names" parameter. + target_modules = None + + # True if this is a Python 2-style implicit relative import of a + # SWIG-generated C extension. False if we checked and it is not SWIG. + # None if we haven't checked yet. + is_swig_import = None + + # Attempt to import this target module in the customary way. + try: + target_modules = self.import_hook( + target_module_partname, source_module, + target_attr_names=None, level=level, edge_attr=edge_attr) + # Failing that, defer to custom module importers handling non-standard + # import schemes (namely, SWIG). + except InvalidRelativeImportError: + self.msgout(2, "Invalid relative import", level, + target_module_partname, target_attr_names) + result = [] + for sub in target_attr_names or '*': + m = self.createNode(InvalidRelativeImport, + '.' * level + target_module_partname, sub) + self._updateReference(source_module, m, edge_data=edge_attr) + result.append(m) + return result + except ImportError as msg: + # If this is an absolute top-level import under Python 3 and if the + # name to be imported is the caller's name prefixed by "_", this + # could be a SWIG-generated Python 2-style implicit relative import. + # SWIG-generated files contain functions named swig_import_helper() + # importing dynamic libraries residing in the same directory. For + # example, a SWIG-generated caller module "csr.py" might resemble: + # + # # This file was automatically generated by SWIG (http://www.swig.org). + # ... + # def swig_import_helper(): + # ... + # try: + # fp, pathname, description = imp.find_module('_csr', + # [dirname(__file__)]) + # except ImportError: + # import _csr + # return _csr + # + # While there exists no reasonable means for modulegraph to parse + # the call to imp.find_module(), the subsequent implicit relative + # import is trivially parsable. This import is prohibited under + # Python 3, however, and thus parsed only if the caller's file is + # parsable plaintext (as indicated by a filetype of ".py") and the + # first line of this file is the above SWIG header comment. + # + # The constraint that this library's name be the caller's name + # prefixed by '_' is explicitly mandated by SWIG and thus a + # reliable indicator of "SWIG-ness". The SWIG documentation states: + # "When linking the module, the name of the output file has to match + # the name of the module prefixed by an underscore." + # + # Only source modules (e.g., ".py"-suffixed files) are SWIG import + # candidates. All other node types are safely ignorable. + if is_swig_candidate(): + self.msg( + 4, + 'SWIG import candidate (name=%r, caller=%r, level=%r)' % ( + target_module_partname, source_module, level)) + is_swig_import = is_swig_wrapper(source_module) + if is_swig_import: + # Convert this Python 2-compliant implicit relative + # import prohibited by Python 3 into a Python + # 3-compliant explicit relative "from"-style import for + # the duration of this function call by overwriting the + # original parameters passed to this call. + target_attr_names = [target_module_partname] + target_module_partname = '' + level = 1 + self.msg(2, + 'SWIG import (caller=%r, fromlist=%r, level=%r)' + % (source_module, target_attr_names, level)) + # Import this target SWIG C extension's package. + try: + target_modules = self.import_hook( + target_module_partname, source_module, + target_attr_names=None, + level=level, + edge_attr=edge_attr) + except ImportError as msg: + self.msg(2, "SWIG ImportError:", str(msg)) + + # If this module remains unimportable... + if target_modules is None: + self.msg(2, "ImportError:", str(msg)) + + # Add this module as a MissingModule node. + target_module = self.createNode( + MissingModule, + _path_from_importerror(msg, target_module_partname)) + self._updateReference( + source_module, target_module, edge_data=edge_attr) + + # Initialize this list to this node. + target_modules = [target_module] + + # Ensure that the above logic imported exactly one target module. + assert len(target_modules) == 1, ( + 'Expected import_hook() to' + 'return only one module but received: {}'.format(target_modules)) + + # Target module imported above. + target_module = target_modules[0] + + if isinstance(target_module, MissingModule) \ + and is_swig_import is None and is_swig_candidate() \ + and is_swig_wrapper(source_module): + # if this possible swig C module was previously imported from + # a python module other than its corresponding swig python + # module, then it may have been considered a MissingModule. + # Try to reimport it now. For details see pull-request #2578 + # and issue #1522. + # + # If this module was takes as a SWIG candidate above, but failed + # to import, this would be a MissingModule, too. Thus check if + # this was the case (is_swig_import would be not None) to avoid + # recursion error. If `is_swig_import` is None and we are still a + # swig candidate then that means we haven't properly imported this + # swig module yet so do that below. + # + # Remove the MissingModule node from the graph so that we can + # attempt a reimport and avoid collisions. This node should be + # fine to remove because the proper module will be imported and + # added to the graph in the next line (call to _safe_import_hook). + self.removeNode(target_module) + # Reimport the SWIG C module relative to the wrapper + target_modules = self._safe_import_hook( + target_module_partname, source_module, + target_attr_names=None, level=1, edge_attr=edge_attr) + # return the output regardless because it would just be + # duplicating the processing below + return target_modules + + if isinstance(edge_attr, DependencyInfo): + edge_attr = edge_attr._replace(fromlist=True) + + # If this is a "from"-style import *AND* this target module is a + # package, import all attributes listed by the "import" clause of this + # import that are submodules of this package. If this target module is + # *NOT* a package, these attributes are always ignorable globals (e.g., + # classes, variables) defined at the top level of this module. + # + # If this target module is a non-package, it could still contain + # importable submodules (e.g., the non-package `os` module containing + # the `os.path` submodule). In this case, these submodules are already + # imported by this target module's pure-Python code. Since our import + # scanner already detects these imports, these submodules need *NOT* be + # reimported here. (Doing so would be harmless but inefficient.) + if target_attr_names and isinstance(target_module, + (Package, AliasNode)): + # For the name of each attribute imported from this target package + # into this source module... + for target_submodule_partname in target_attr_names: + #FIXME: Is this optimization *REALLY* an optimization or at all + #necessary? The findNode() method called below should already + #be heavily optimized, in which case this optimization here is + #premature, senseless, and should be eliminated. + + # If this attribute is a previously imported submodule of this + # target module, optimize this edge case. + if target_module.is_submodule(target_submodule_partname): + # Graph node for this submodule. + target_submodule = target_module.get_submodule( + target_submodule_partname) + + #FIXME: What? Shouldn't "target_submodule" *ALWAYS* be + #non-None here? Assert this to be non-None instead. + if target_submodule is not None: + #FIXME: Why does duplication matter? List searches are + #mildly expensive. + + # If this submodule has not already been added to the + # list of submodules to be returned, do so. + if target_submodule not in target_modules: + self._updateReference( + source_module, + target_submodule, + edge_data=edge_attr) + target_modules.append(target_submodule) + continue + + # Fully-qualified name of this submodule. + target_submodule_name = ( + target_module.identifier + '.' + target_submodule_partname) + + # Graph node of this submodule if previously imported or None. + target_submodule = self.find_node(target_submodule_name) + + # If this submodule has not been imported, do so as if this + # submodule were the only attribute listed by the "import" + # clause of this import (e.g., as "from foo import bar" rather + # than "from foo import car, far, bar"). + if target_submodule is None: + # Attempt to import this submodule. + try: + # Ignore the list of graph nodes returned by this + # method. If both this submodule's package and this + # submodule are importable, this method returns a + # 2-element list whose second element is this + # submodule's graph node. However, if this submodule's + # package is importable but this submodule is not, + # this submodule is either: + # + # * An ignorable global attribute defined at the top + # level of this package's "__init__" submodule. In + # this case, this method returns a 1-element list + # without raising an exception. + # * A non-ignorable unimportable submodule. In this + # case, this method raises an "ImportError". + # + # While the first two cases are disambiguatable by the + # length of this list, doing so would render this code + # dependent on import_hook() details subject to change. + # Instead, call findNode() to decide the truthiness. + self.import_hook( + target_module_partname, source_module, + target_attr_names=[target_submodule_partname], + level=level, + edge_attr=edge_attr) + + # Graph node of this submodule imported by the prior + # call if importable or None otherwise. + target_submodule = self.find_node(target_submodule_name) + + # If this submodule does not exist, this *MUST* be an + # ignorable global attribute defined at the top level + # of this package's "__init__" submodule. + if target_submodule is None: + # Assert this to actually be the case. + assert target_module.is_global_attr( + target_submodule_partname), ( + 'No global named {} in {}.__init__'.format( + target_submodule_partname, + target_module.identifier)) + + # Skip this safely ignorable importation to the + # next attribute. See similar logic in the body of + # _import_importable_package_submodules(). + self.msg(4, '_safe_import_hook', 'ignoring imported non-module global', target_module.identifier, target_submodule_partname) + continue + + # If this is a SWIG C extension, instruct PyInstaller + # to freeze this extension under its unqualified rather + # than qualified name (e.g., as "_csr" rather than + # "scipy.sparse.sparsetools._csr"), permitting the + # implicit relative import in its parent SWIG module to + # successfully find this extension. + if is_swig_import: + # If a graph node with this name already exists, + # avoid collisions by emitting an error instead. + if self.find_node(target_submodule_partname): + self.msg( + 2, + 'SWIG import error: %r basename %r ' + 'already exists' % ( + target_submodule_name, + target_submodule_partname)) + else: + self.msg( + 4, + 'SWIG import renamed from %r to %r' % ( + target_submodule_name, + target_submodule_partname)) + target_submodule.identifier = ( + target_submodule_partname) + # If this submodule is unimportable, add a MissingModule. + except ImportError as msg: + self.msg(2, "ImportError:", str(msg)) + target_submodule = self.createNode( + MissingModule, target_submodule_name) + + # Add this submodule to its package. + target_module.add_submodule( + target_submodule_partname, target_submodule) + if target_submodule is not None: + self._updateReference( + target_module, target_submodule, edge_data=edge_attr) + self._updateReference( + source_module, target_submodule, edge_data=edge_attr) + + if target_submodule not in target_modules: + target_modules.append(target_submodule) + + # Return the list of all target modules imported by this call. + return target_modules + + + def _scan_code( + self, + module, + module_code_object, + module_code_object_ast=None): + """ + Parse and add all import statements from the passed code object of the + passed source module to this graph, recursively. + + **This method is at the root of all `ModuleGraph` recursion.** + Recursion begins here and ends when all import statements in all code + objects of all modules transitively imported by the source module + passed to the first call to this method have been added to the graph. + Specifically, this method: + + 1. If the passed `module_code_object_ast` parameter is non-`None`, + parses all import statements from this object. + 2. Else, parses all import statements from the passed + `module_code_object` parameter. + 1. For each such import statement: + 1. Adds to this `ModuleGraph` instance: + 1. Nodes for all target modules of these imports. + 1. Directed edges from this source module to these target + modules. + 2. Recursively calls this method with these target modules. + + Parameters + ---------- + module : Node + Graph node of the module to be parsed. + module_code_object : PyCodeObject + Code object providing this module's disassembled Python bytecode. + Ignored unless `module_code_object_ast` is `None`. + module_code_object_ast : optional[ast.AST] + Optional abstract syntax tree (AST) of this module if any or `None` + otherwise. Defaults to `None`, in which case the passed + `module_code_object` is parsed instead. + Returns + ---------- + module : Node + Graph node of the module to be parsed. + """ + + # For safety, guard against multiple scans of the same module by + # resetting this module's list of deferred target imports. + module._deferred_imports = [] + + # Parse all imports from this module *BEFORE* adding these imports to + # the graph. If an AST is provided, parse that rather than this + # module's code object. + if module_code_object_ast is not None: + # Parse this module's AST for imports. + self._scan_ast(module, module_code_object_ast) + + # Parse this module's code object for all relevant non-imports + # (e.g., global variable declarations and undeclarations). + self._scan_bytecode( + module, module_code_object, is_scanning_imports=False) + # Else, parse this module's code object for imports. + else: + self._scan_bytecode( + module, module_code_object, is_scanning_imports=True) + + return module + + def _scan_ast(self, module, module_code_object_ast): + """ + Parse and add all import statements from the passed abstract syntax + tree (AST) of the passed source module to this graph, non-recursively. + + Parameters + ---------- + module : Node + Graph node of the module to be parsed. + module_code_object_ast : ast.AST + Abstract syntax tree (AST) of this module to be parsed. + """ + + visitor = _Visitor(self, module) + visitor.visit(module_code_object_ast) + + #FIXME: Optimize. Global attributes added by this method are tested by + #other methods *ONLY* for packages, implying this method should scan and + #handle opcodes pertaining to global attributes (e.g., + #"STORE_NAME", "DELETE_GLOBAL") only if the passed "module" + #object is an instance of the "Package" class. For all other module types, + #these opcodes should simply be ignored. + # + #After doing so, the "Node._global_attr_names" attribute and all methods + #using this attribute (e.g., Node.is_global()) should be moved from the + #"Node" superclass to the "Package" subclass. + def _scan_bytecode( + self, module, module_code_object, is_scanning_imports): + """ + Parse and add all import statements from the passed code object of the + passed source module to this graph, non-recursively. + + This method parses all reasonably parsable operations (i.e., operations + that are both syntactically and semantically parsable _without_ + requiring Turing-complete interpretation) directly or indirectly + involving module importation from this code object. This includes: + + * `IMPORT_NAME`, denoting an import statement. Ignored unless + the passed `is_scanning_imports` parameter is `True`. + * `STORE_NAME` and `STORE_GLOBAL`, denoting the + declaration of a global attribute (e.g., class, variable) in this + module. This method stores each such declaration for subsequent + lookup. While global attributes are usually irrelevant to import + parsing, they remain the only means of distinguishing erroneous + non-ignorable attempts to import non-existent submodules of a package + from successful ignorable attempts to import existing global + attributes of a package's `__init__` submodule (e.g., the `bar` in + `from foo import bar`, which is either a non-ignorable submodule of + `foo` or an ignorable global attribute of `foo.__init__`). + * `DELETE_NAME` and `DELETE_GLOBAL`, denoting the + undeclaration of a previously declared global attribute in this + module. + + Since `ModuleGraph` is _not_ intended to replicate the behaviour of a + full-featured Turing-complete Python interpreter, this method ignores + operations that are _not_ reasonably parsable from this code object -- + even those directly or indirectly involving module importation. This + includes: + + * `STORE_ATTR(namei)`, implementing `TOS.name = TOS1`. If `TOS` is the + name of a target module currently imported into the namespace of the + passed source module, this opcode would ideally be parsed to add that + global attribute to that target module. Since this addition only + conditionally occurs on the importation of this source module and + execution of the code branch in this module performing this addition, + however, that global _cannot_ be unconditionally added to that target + module. In short, only Turing-complete behaviour suffices. + * `DELETE_ATTR(namei)`, implementing `del TOS.name`. If `TOS` is the + name of a target module currently imported into the namespace of the + passed source module, this opcode would ideally be parsed to remove + that global attribute from that target module. Again, however, only + Turing-complete behaviour suffices. + + Parameters + ---------- + module : Node + Graph node of the module to be parsed. + module_code_object : PyCodeObject + Code object of the module to be parsed. + is_scanning_imports : bool + `True` only if this method is parsing import statements from + `IMPORT_NAME` opcodes. If `False`, no import statements will be + parsed. This parameter is typically: + * `True` when parsing this module's code object for such imports. + * `False` when parsing this module's abstract syntax tree (AST) + (rather than code object) for such imports. In this case, that + parsing will have already parsed import statements, which this + parsing must avoid repeating. + """ + level = None + fromlist = None + + # 'deque' is a list-like container with fast appends, pops on + # either end, and automatically discarding elements too much. + prev_insts = deque(maxlen=2) + for inst in util.iterate_instructions(module_code_object): + if not inst: + continue + # If this is an import statement originating from this module, + # parse this import. + # + # Note that the related "IMPORT_FROM" opcode need *NOT* be parsed. + # "IMPORT_NAME" suffices. For further details, see + # http://probablyprogramming.com/2008/04/14/python-import_name + if inst.opname == 'IMPORT_NAME': + # If this method is ignoring import statements, skip to the + # next opcode. + if not is_scanning_imports: + continue + + # Python >=2.5: LOAD_CONST flags, LOAD_CONST names, IMPORT_NAME name + # + # Python 3.14 split LOAD_CONST into LOAD_CONST, LOAD_CONST_IMMORTAL, + # and LOAD_SMALL_INT. The former two can be used to load the names, + # while LOAD_SMALL_INT can be also used to load the flags. + if sys.version_info >= (3, 14): + assert prev_insts[-2].opname in {'LOAD_CONST', 'LOAD_CONST_IMMORTAL', 'LOAD_SMALL_INT'} + assert prev_insts[-1].opname in {'LOAD_CONST', 'LOAD_CONST_IMMORTAL'} + else: + assert prev_insts[-2].opname == 'LOAD_CONST' + assert prev_insts[-1].opname == 'LOAD_CONST' + + level = prev_insts[-2].argval + fromlist = prev_insts[-1].argval + + assert fromlist is None or type(fromlist) is tuple + target_module_partname = inst.argval + + #FIXME: The exact same logic appears in _collect_import(), + #which isn't particularly helpful. Instead, defer this logic + #until later by: + # + #* Refactor the "_deferred_imports" list to contain 2-tuples + # "(_safe_import_hook_args, _safe_import_hook_kwargs)" rather + # than 3-tuples "(have_star, _safe_import_hook_args, + # _safe_import_hook_kwargs)". + #* Stop prepending these tuples by a "have_star" boolean both + # here, in _collect_import(), and in _process_imports(). + #* Shift the logic below to _process_imports(). + #* Remove the same logic from _collect_import(). + have_star = False + if fromlist is not None: + fromlist = uniq(fromlist) + if '*' in fromlist: + fromlist.remove('*') + have_star = True + + # Record this import as originating from this module for + # subsequent handling by the _process_imports() method. + module._deferred_imports.append(( + have_star, + (target_module_partname, module, fromlist, level), + {} + )) + + elif inst.opname in ('STORE_NAME', 'STORE_GLOBAL'): + # If this is the declaration of a global attribute (e.g., + # class, variable) in this module, store this declaration for + # subsequent lookup. See method docstring for further details. + # + # Global attributes are usually irrelevant to import parsing, but + # remain the only means of distinguishing erroneous non-ignorable + # attempts to import non-existent submodules of a package from + # successful ignorable attempts to import existing global + # attributes of a package's "__init__" submodule (e.g., the "bar" + # in "from foo import bar", which is either a non-ignorable + # submodule of "foo" or an ignorable global attribute of + # "foo.__init__"). + name = inst.argval + module.add_global_attr(name) + + elif inst.opname in ('DELETE_NAME', 'DELETE_GLOBAL'): + # If this is the undeclaration of a previously declared global + # attribute (e.g., class, variable) in this module, remove that + # declaration to prevent subsequent lookup. See method docstring + # for further details. + name = inst.argval + module.remove_global_attr_if_found(name) + + prev_insts.append(inst) + + + def _process_imports(self, source_module): + """ + Graph all target modules whose importations were previously parsed from + the passed source module by a prior call to the `_scan_code()` method + and methods call by that method (e.g., `_scan_ast()`, + `_scan_bytecode()`, `_scan_bytecode_stores()`). + + Parameters + ---------- + source_module : Node + Graph node of the source module to graph target imports for. + """ + + # If this source module imported no target modules, noop. + if not source_module._deferred_imports: + return + + # For each target module imported by this source module... + for have_star, import_info, kwargs in source_module._deferred_imports: + # Graph node of the target module specified by the "from" portion + # of this "from"-style star import (e.g., an import resembling + # "from {target_module_name} import *") or ignored otherwise. + target_modules = self._safe_import_hook(*import_info, **kwargs) + if not target_modules: + # If _safe_import_hook suppressed the module, quietly drop it. + # Do not create an ExcludedModule instance, because that might + # completely suppress the module whereas it might need to be + # included due to reference from another module (that does + # not exclude it via hook). + continue + target_module = target_modules[0] + + # If this is a "from"-style star import, process this import. + if have_star: + #FIXME: Sadly, the current approach to importing attributes + #from "from"-style star imports is... simplistic. This should + #be revised as follows. If this target module is: + # + #* A package: + # * Whose "__init__" submodule defines the "__all__" global + # attribute, only attributes listed by this attribute should + # be imported. + # * Else, *NO* attributes should be imported. + #* A non-package: + # * Defining the "__all__" global attribute, only attributes + # listed by this attribute should be imported. + # * Else, only public attributes whose names are *NOT* + # prefixed by "_" should be imported. + source_module.add_global_attrs_from_module(target_module) + + source_module._starimported_ignored_module_names.update( + target_module._starimported_ignored_module_names) + + # If this target module has no code object and hence is + # unparsable, record its name for posterity. + if target_module.code is None: + target_module_name = import_info[0] + source_module._starimported_ignored_module_names.add( + target_module_name) + + # For safety, prevent these imports from being reprocessed. + source_module._deferred_imports = None + + + def _find_module(self, name, path, parent=None): + """ + 3-tuple describing the physical location of the module with the passed + name if this module is physically findable _or_ raise `ImportError`. + + This high-level method wraps the low-level `modulegraph.find_module()` + function with additional support for graph-based module caching. + + Parameters + ---------- + name : str + Fully-qualified name of the Python module to be found. + path : list + List of the absolute paths of all directories to search for this + module _or_ `None` if the default path list `self.path` is to be + searched. + parent : Node + Package containing this module if this module is a submodule of a + package _or_ `None` if this is a top-level module. + + Returns + ---------- + (filename, loader) + See `modulegraph._find_module()` for details. + + Raises + ---------- + ImportError + If this module is _not_ found. + """ + + if parent is not None: + # assert path is not None + fullname = parent.identifier + '.' + name + else: + fullname = name + + node = self.find_node(fullname) + if node is not None: + self.msg(3, "find_module: already included?", node) + raise ImportError(name) + + if path is None: + if name in sys.builtin_module_names: + return (None, BUILTIN_MODULE) + + path = self.path + + return self._find_module_path(fullname, name, path) + + + def _find_module_path(self, fullname, module_name, search_dirs): + """ + 3-tuple describing the physical location of the module with the passed + name if this module is physically findable _or_ raise `ImportError`. + + This low-level function is a variant on the standard `imp.find_module()` + function with additional support for: + + * Multiple search paths. The passed list of absolute paths will be + iteratively searched for the first directory containing a file + corresponding to this module. + * Compressed (e.g., zipped) packages. + + For efficiency, the higher level `ModuleGraph._find_module()` method + wraps this function with support for module caching. + + Parameters + ---------- + module_name : str + Fully-qualified name of the module to be found. + search_dirs : list + List of the absolute paths of all directories to search for this + module (in order). Searching will halt at the first directory + containing this module. + + Returns + ---------- + (filename, loader) + 2-tuple describing the physical location of this module, where: + * `filename` is the absolute path of this file. + * `loader` is the import loader. + In case of a namespace package, this is a NAMESPACE_PACKAGE + instance + + Raises + ---------- + ImportError + If this module is _not_ found. + """ + self.msgin(4, "_find_module_path <-", fullname, search_dirs) + + # Top-level 2-tuple to be returned. + path_data = None + + # List of the absolute paths of all directories comprising the + # namespace package to which this module belongs if any. + namespace_dirs = [] + + try: + for search_dir in search_dirs: + # PEP 302-compliant importer making loaders for this directory. + importer = pkgutil.get_importer(search_dir) + + # If this directory is not importable, continue. + if importer is None: + # self.msg(4, "_find_module_path importer not found", search_dir) + continue + + # Get the PEP 302-compliant loader object loading this module. + # + # If this importer defines the PEP 451-compliant find_spec() + # method, use that, and obtain loader from spec. This should + # be available on python >= 3.4. + if hasattr(importer, 'find_spec'): + loader = None + spec = importer.find_spec(module_name) + if spec is not None: + loader = spec.loader + namespace_dirs.extend(spec.submodule_search_locations or []) + # Else if this importer defines the PEP 302-compliant find_loader() + # method, use that. + elif hasattr(importer, 'find_loader'): + loader, loader_namespace_dirs = importer.find_loader( + module_name) + namespace_dirs.extend(loader_namespace_dirs) + # Else if this importer defines the Python 2-specific + # find_module() method, fall back to that. Despite the method + # name, this method returns a loader rather than a module. + elif hasattr(importer, 'find_module'): + loader = importer.find_module(module_name) + # Else, raise an exception. + else: + raise ImportError( + "Module %r importer %r loader unobtainable" % (module_name, importer)) + + # If this module is not loadable from this directory, continue. + if loader is None: + # self.msg(4, "_find_module_path loader not found", search_dir) + continue + + # Absolute path of this module. If this module resides in a + # compressed archive, this is the absolute path of this module + # after extracting this module from that archive and hence + # should not exist; else, this path should typically exist. + pathname = None + + # If this loader defines the PEP 302-compliant get_filename() + # method, preferably call that method first. Most if not all + # loaders (including zipimporter objects) define this method. + if hasattr(loader, 'get_filename'): + pathname = loader.get_filename(module_name) + # Else if this loader provides a "path" attribute, defer to that. + elif hasattr(loader, 'path'): + pathname = loader.path + # Else, raise an exception. + else: + raise ImportError( + "Module %r loader %r path unobtainable" % (module_name, loader)) + + # If no path was found, this is probably a namespace package. In + # such case, continue collecting namespace directories. + if pathname is None: + self.msg(4, "_find_module_path path not found", pathname) + continue + + # Return such metadata. + path_data = (pathname, loader) + break + # Else if this is a namespace package, return such metadata. + else: + if namespace_dirs: + path_data = (namespace_dirs[0], + NAMESPACE_PACKAGE(namespace_dirs)) + except UnicodeDecodeError as exc: + self.msgout(1, "_find_module_path -> unicode error", exc) + # Ensure that exceptions are logged, as this function is typically + # called by the import_module() method which squelches ImportErrors. + except Exception as exc: + self.msgout(4, "_find_module_path -> exception", exc) + raise + + # If this module was not found, raise an exception. + self.msgout(4, "_find_module_path ->", path_data) + if path_data is None: + raise ImportError("No module named " + repr(module_name)) + + return path_data + + + def create_xref(self, out=None): + global header, footer, entry, contpl, contpl_linked, imports + if out is None: + out = sys.stdout + scripts = [] + mods = [] + for mod in self.iter_graph(): + name = os.path.basename(mod.graphident) + if isinstance(mod, Script): + scripts.append((name, mod)) + else: + mods.append((name, mod)) + scripts.sort() + mods.sort() + scriptnames = [sn for sn, m in scripts] + scripts.extend(mods) + mods = scripts + + title = "modulegraph cross reference for " + ', '.join(scriptnames) + print(header % {"TITLE": title}, file=out) + + def sorted_namelist(mods): + lst = [os.path.basename(mod.graphident) for mod in mods if mod] + lst.sort() + return lst + for name, m in mods: + content = "" + if isinstance(m, BuiltinModule): + content = contpl % {"NAME": name, + "TYPE": "(builtin module)"} + elif isinstance(m, Extension): + content = contpl % {"NAME": name, + "TYPE": "%s" % m.filename} + else: + url = urllib.request.pathname2url(m.filename or "") + content = contpl_linked % {"NAME": name, "URL": url, + 'TYPE': m.__class__.__name__} + oute, ince = map(sorted_namelist, self.get_edges(m)) + if oute: + links = [] + for n in oute: + links.append(""" %s\n""" % (n, n)) + # #8226 = bullet-point; can't use html-entities since the + # test-suite uses xml.etree.ElementTree.XMLParser, which + # does't supprot them. + links = " • ".join(links) + content += imports % {"HEAD": "imports", "LINKS": links} + if ince: + links = [] + for n in ince: + links.append(""" %s\n""" % (n, n)) + # #8226 = bullet-point; can't use html-entities since the + # test-suite uses xml.etree.ElementTree.XMLParser, which + # does't supprot them. + links = " • ".join(links) + content += imports % {"HEAD": "imported by", "LINKS": links} + print(entry % {"NAME": name, "CONTENT": content}, file=out) + print(footer, file=out) + + def itergraphreport(self, name='G', flatpackages=()): + # XXX: Can this be implemented using Dot()? + nodes = list(map(self.graph.describe_node, self.graph.iterdfs(self))) + describe_edge = self.graph.describe_edge + edges = deque() + packagenodes = set() + packageidents = {} + nodetoident = {} + inpackages = {} + mainedges = set() + + # XXX - implement + flatpackages = dict(flatpackages) + + def nodevisitor(node, data, outgoing, incoming): + if not isinstance(data, Node): + return {'label': str(node)} + #if isinstance(d, (ExcludedModule, MissingModule, BadModule)): + # return None + s = ' ' + type(data).__name__ + for i, v in enumerate(data.infoTuple()[:1], 1): + s += '| %s' % (i, v) + return {'label': s, 'shape': 'record'} + + + def edgevisitor(edge, data, head, tail): + # XXX: This method nonsense, the edge + # data is never initialized. + if data == 'orphan': + return {'style': 'dashed'} + elif data == 'pkgref': + return {'style': 'dotted'} + return {} + + yield 'digraph %s {\ncharset="UTF-8";\n' % (name,) + attr = dict(rankdir='LR', concentrate='true') + cpatt = '%s="%s"' + for item in attr.items(): + yield '\t%s;\n' % (cpatt % item,) + + # find all packages (subgraphs) + for (node, data, outgoing, incoming) in nodes: + nodetoident[node] = getattr(data, 'graphident', None) + if isinstance(data, Package): + packageidents[data.graphident] = node + inpackages[node] = set([node]) + packagenodes.add(node) + + # create sets for subgraph, write out descriptions + for (node, data, outgoing, incoming) in nodes: + # update edges + for edge in (describe_edge(e) for e in outgoing): + edges.append(edge) + + # describe node + yield '\t"%s" [%s];\n' % ( + node, + ','.join([ + (cpatt % item) for item in + nodevisitor(node, data, outgoing, incoming).items() + ]), + ) + + inside = inpackages.get(node) + if inside is None: + inside = inpackages[node] = set() + ident = nodetoident[node] + if ident is None: + continue + pkgnode = packageidents.get(ident[:ident.rfind('.')]) + if pkgnode is not None: + inside.add(pkgnode) + + graph = [] + subgraphs = {} + for key in packagenodes: + subgraphs[key] = [] + + while edges: + edge, data, head, tail = edges.popleft() + if ((head, tail)) in mainedges: + continue + mainedges.add((head, tail)) + tailpkgs = inpackages[tail] + common = inpackages[head] & tailpkgs + if not common and tailpkgs: + usepkgs = sorted(tailpkgs) + if len(usepkgs) != 1 or usepkgs[0] != tail: + edges.append((edge, data, head, usepkgs[0])) + edges.append((edge, 'pkgref', usepkgs[-1], tail)) + continue + if common: + common = common.pop() + if tail == common: + edges.append((edge, data, tail, head)) + elif head == common: + subgraphs[common].append((edge, 'pkgref', head, tail)) + else: + edges.append((edge, data, common, head)) + edges.append((edge, data, common, tail)) + + else: + graph.append((edge, data, head, tail)) + + def do_graph(edges, tabs): + edgestr = tabs + '"%s" -> "%s" [%s];\n' + # describe edge + for (edge, data, head, tail) in edges: + attribs = edgevisitor(edge, data, head, tail) + yield edgestr % ( + head, + tail, + ','.join([(cpatt % item) for item in attribs.items()]), + ) + + for g, edges in subgraphs.items(): + yield '\tsubgraph "cluster_%s" {\n' % (g,) + yield '\t\tlabel="%s";\n' % (nodetoident[g],) + for s in do_graph(edges, '\t\t'): + yield s + yield '\t}\n' + + for s in do_graph(graph, '\t'): + yield s + + yield '}\n' + + def graphreport(self, fileobj=None, flatpackages=()): + if fileobj is None: + fileobj = sys.stdout + fileobj.writelines(self.itergraphreport(flatpackages=flatpackages)) + + def report(self): + """Print a report to stdout, listing the found modules with their + paths, as well as modules that are missing, or seem to be missing. + """ + print() + print("%-15s %-25s %s" % ("Class", "Name", "File")) + print("%-15s %-25s %s" % ("-----", "----", "----")) + for m in sorted(self.iter_graph(), key=lambda n: n.graphident): + if isinstance(m, AliasNode): + print("%-15s %-25s %s" % (type(m).__name__, m.graphident, m.identifier)) + else: + print("%-15s %-25s %s" % (type(m).__name__, m.graphident, m.filename or "")) + + def _replace_paths_in_code(self, co): + new_filename = original_filename = os.path.normpath(co.co_filename) + for f, r in self.replace_paths: + f = os.path.join(f, '') + r = os.path.join(r, '') + if original_filename.startswith(f): + new_filename = r + original_filename[len(f):] + break + + else: + return co + + consts = list(co.co_consts) + for i in range(len(consts)): + if isinstance(consts[i], type(co)): + consts[i] = self._replace_paths_in_code(consts[i]) + + return co.replace(co_consts=tuple(consts), co_filename=new_filename) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/util.py b/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/util.py new file mode 100755 index 0000000..dab8c06 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/lib/modulegraph/util.py @@ -0,0 +1,21 @@ +import dis +import inspect + + +def iterate_instructions(code_object): + """Delivers the byte-code instructions as a continuous stream. + + Yields `dis.Instruction`. After each code-block (`co_code`), `None` is + yielded to mark the end of the block and to interrupt the steam. + """ + # The arg extension the EXTENDED_ARG opcode represents is automatically handled by get_instructions() but the + # instruction is left in. Get rid of it to make subsequent parsing easier/safer. + yield from (i for i in dis.get_instructions(code_object) if i.opname != "EXTENDED_ARG") + + yield None + + # For each constant in this code object that is itself a code object, + # parse this constant in the same manner. + for constant in code_object.co_consts: + if inspect.iscode(constant): + yield from iterate_instructions(constant) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/loader/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/loader/__init__.py new file mode 100755 index 0000000..792d600 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/loader/__init__.py @@ -0,0 +1 @@ +# diff --git a/venv/lib/python3.12/site-packages/PyInstaller/loader/pyiboot01_bootstrap.py b/venv/lib/python3.12/site-packages/PyInstaller/loader/pyiboot01_bootstrap.py new file mode 100755 index 0000000..b0da1dd --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/loader/pyiboot01_bootstrap.py @@ -0,0 +1,95 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +#-- Start bootstrap process +# Only python built-in modules can be used. + +import sys + +import pyimod02_importers + +# Extend Python import machinery by adding PEP302 importers to sys.meta_path. +pyimod02_importers.install() + +#-- Bootstrap process is complete. +# We can use other python modules (e.g. os) + +import os # noqa: E402 + +# Let other python modules know that the code is running in frozen mode. +if not hasattr(sys, 'frozen'): + sys.frozen = True + +# sys._MEIPASS is now set in the bootloader. Hooray. + +# Python 3 C-API function Py_SetPath() resets sys.prefix to empty string. Python 2 was using PYTHONHOME for sys.prefix. +# Let's do the same for Python 3. +sys.prefix = sys._MEIPASS +sys.exec_prefix = sys.prefix + +# Python 3.3+ defines also sys.base_prefix. Let's set them too. +sys.base_prefix = sys.prefix +sys.base_exec_prefix = sys.exec_prefix + +# Some packages behave differently when running inside virtual environment. E.g., IPython tries to append path +# VIRTUAL_ENV to sys.path. For the frozen app we want to prevent this behavior. +VIRTENV = 'VIRTUAL_ENV' +if VIRTENV in os.environ: + # On some platforms (e.g., AIX) 'os.unsetenv()' is unavailable and deleting the var from os.environ does not + # delete it from the environment. + os.environ[VIRTENV] = '' + del os.environ[VIRTENV] + +# Ensure sys.path contains absolute paths. Otherwise, import of other python modules will fail when current working +# directory is changed by the frozen application. +python_path = [] +for pth in sys.path: + python_path.append(os.path.abspath(pth)) + sys.path = python_path + +# At least on Windows, Python seems to hook up the codecs on this import, so it is not enough to just package up all +# the encodings. +# +# It was also reported that without 'encodings' module, the frozen executable fails to load in some configurations: +# http://www.pyinstaller.org/ticket/651 +# +# Importing 'encodings' module in a run-time hook is not enough, since some run-time hooks require this module, and the +# order of running the code from the run-time hooks is not defined. +try: + import encodings # noqa: F401 +except ImportError: + pass + +# In the Python interpreter 'warnings' module is imported when 'sys.warnoptions' is not empty. Mimic this behavior. +if sys.warnoptions: + import warnings # noqa: F401 + +# Install the hooks for ctypes +import pyimod03_ctypes # noqa: E402 + +pyimod03_ctypes.install() + +# Install the hooks for pywin32 (Windows only) +if sys.platform.startswith('win'): + import pyimod04_pywin32 + pyimod04_pywin32.install() + +# Apply a hack for metadata that was collected from (unzipped) python eggs; the EGG-INFO directories are collected into +# their parent directories (my_package-version.egg/EGG-INFO), and for metadata to be discoverable by +# `importlib.metadata`, the .egg directory needs to be in `sys.path`. The deprecated `pkg_resources` does not have this +# limitation, and seems to work as long as the .egg directory's parent directory (in our case `sys._MEIPASS` is in +# `sys.path`. +for entry in os.listdir(sys._MEIPASS): + entry = os.path.join(sys._MEIPASS, entry) + if not os.path.isdir(entry): + continue + if entry.endswith('.egg'): + sys.path.append(entry) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/loader/pyimod01_archive.py b/venv/lib/python3.12/site-packages/PyInstaller/loader/pyimod01_archive.py new file mode 100755 index 0000000..2d70254 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/loader/pyimod01_archive.py @@ -0,0 +1,140 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# **NOTE** This module is used during bootstrap. +# Import *ONLY* builtin modules or modules that are collected into the base_library.zip archive. +# List of built-in modules: sys.builtin_module_names +# List of modules collected into base_library.zip: PyInstaller.compat.PY3_BASE_MODULES + +import os +import struct +import marshal +import zlib + +# In Python3, the MAGIC_NUMBER value is available in the importlib module. However, in the bootstrap phase we cannot use +# importlib directly, but rather its frozen variant. +import _frozen_importlib + +PYTHON_MAGIC_NUMBER = _frozen_importlib._bootstrap_external.MAGIC_NUMBER + +# Type codes for PYZ PYZ entries +PYZ_ITEM_MODULE = 0 +PYZ_ITEM_PKG = 1 +PYZ_ITEM_DATA = 2 # deprecated; PYZ does not contain any data entries anymore +PYZ_ITEM_NSPKG = 3 # PEP-420 namespace package + + +class ArchiveReadError(RuntimeError): + pass + + +class ZlibArchiveReader: + """ + Reader for PyInstaller's PYZ (ZlibArchive) archive. The archive is used to store collected byte-compiled Python + modules, as individually-compressed entries. + """ + _PYZ_MAGIC_PATTERN = b'PYZ\0' + + def __init__(self, filename, start_offset=None, check_pymagic=False): + self._filename = filename + self._start_offset = start_offset + + self.toc = {} + + # If no offset is given, try inferring it from filename + if start_offset is None: + self._filename, self._start_offset = self._parse_offset_from_filename(filename) + + # Parse header and load TOC. Standard header contains 12 bytes: PYZ magic pattern, python bytecode magic + # pattern, and offset to TOC (32-bit integer). It might be followed by additional fields, depending on + # implementation version. + with open(self._filename, "rb") as fp: + # Read PYZ magic pattern, located at the start of the file + fp.seek(self._start_offset, os.SEEK_SET) + + magic = fp.read(len(self._PYZ_MAGIC_PATTERN)) + if magic != self._PYZ_MAGIC_PATTERN: + raise ArchiveReadError("PYZ magic pattern mismatch!") + + # Read python magic/version number + pymagic = fp.read(len(PYTHON_MAGIC_NUMBER)) + if check_pymagic and pymagic != PYTHON_MAGIC_NUMBER: + raise ArchiveReadError("Python magic pattern mismatch!") + + # Read TOC offset + toc_offset, *_ = struct.unpack('!i', fp.read(4)) + + # Load TOC + fp.seek(self._start_offset + toc_offset, os.SEEK_SET) + self.toc = dict(marshal.load(fp)) + + @staticmethod + def _parse_offset_from_filename(filename): + """ + Parse the numeric offset from filename, stored as: `/path/to/file?offset`. + """ + offset = 0 + + idx = filename.rfind('?') + if idx == -1: + return filename, offset + + try: + offset = int(filename[idx + 1:]) + filename = filename[:idx] # Remove the offset from filename + except ValueError: + # Ignore spurious "?" in the path (for example, like in Windows UNC \\?\). + pass + + return filename, offset + + def extract(self, name, raw=False): + """ + Extract data from entry with the given name. + + If the entry belongs to a module or a package, the data is loaded (unmarshaled) into code object. To retrieve + raw data, set `raw` flag to True. + """ + # Look up entry + entry = self.toc.get(name) + if entry is None: + raise KeyError(f"No entry named {name!r} found in the archive!") + + typecode, entry_offset, entry_length = entry + + # PEP-420 namespace package does not have a data blob. + if typecode == PYZ_ITEM_NSPKG: + return None + + # Read data blob + try: + with open(self._filename, "rb") as fp: + fp.seek(self._start_offset + entry_offset) + obj = fp.read(entry_length) + except FileNotFoundError: + # We open the archive file each time we need to read from it, to avoid locking the file by keeping it open. + # This allows executable to be deleted or moved (renamed) while it is running, which is useful in certain + # scenarios (e.g., automatic update that replaces the executable). The caveat is that once the executable is + # renamed, we cannot read from its embedded PYZ archive anymore. In such case, exit with informative + # message. + raise SystemExit( + f"ERROR: {self._filename} appears to have been moved or deleted since this application was launched. " + "Continouation from this state is impossible. Exiting now." + ) + + try: + obj = zlib.decompress(obj) + if typecode in (PYZ_ITEM_MODULE, PYZ_ITEM_PKG) and not raw: + obj = marshal.loads(obj) + except EOFError as e: + raise ImportError(f"Failed to unmarshal PYZ entry {name!r}!") from e + + return obj diff --git a/venv/lib/python3.12/site-packages/PyInstaller/loader/pyimod02_importers.py b/venv/lib/python3.12/site-packages/PyInstaller/loader/pyimod02_importers.py new file mode 100755 index 0000000..68c22bc --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/loader/pyimod02_importers.py @@ -0,0 +1,781 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +PEP-302 and PEP-451 importers for frozen applications. +""" + +# **NOTE** This module is used during bootstrap. +# Import *ONLY* builtin modules or modules that are collected into the base_library.zip archive. +# List of built-in modules: sys.builtin_module_names +# List of modules collected into base_library.zip: PyInstaller.compat.PY3_BASE_MODULES + +import sys +import os +import io + +import _frozen_importlib +import _thread + +import pyimod01_archive + +if sys.flags.verbose and sys.stderr: + + def trace(msg, *a): + sys.stderr.write(msg % a) + sys.stderr.write("\n") +else: + + def trace(msg, *a): + pass + + +def _decode_source(source_bytes): + """ + Decode bytes representing source code and return the string. Universal newline support is used in the decoding. + Based on CPython's implementation of the same functionality: + https://github.com/python/cpython/blob/3.9/Lib/importlib/_bootstrap_external.py#L679-L688 + """ + # Local import to avoid including `tokenize` and its dependencies in `base_library.zip` + from tokenize import detect_encoding + source_bytes_readline = io.BytesIO(source_bytes).readline + encoding = detect_encoding(source_bytes_readline) + newline_decoder = io.IncrementalNewlineDecoder(decoder=None, translate=True) + return newline_decoder.decode(source_bytes.decode(encoding[0])) + + +# Global instance of PYZ archive reader. Initialized by install(). +pyz_archive = None + +# Some runtime hooks might need to traverse available frozen package/module hierarchy to simulate filesystem. +# Such traversals can be efficiently implemented using a prefix tree (trie), whose computation we defer until first +# access. +_pyz_tree_lock = _thread.RLock() +_pyz_tree = None + + +def get_pyz_toc_tree(): + global _pyz_tree + + with _pyz_tree_lock: + if _pyz_tree is None: + _pyz_tree = _build_pyz_prefix_tree(pyz_archive) + return _pyz_tree + + +# Populate list of unresolved (original) and resolved paths to top-level directory, used when trying to determine +# relative path. +_TOP_LEVEL_DIRECTORY_PATHS = [] + +# Original sys._MEIPASS value; ensure separators are normalized (e.g., when using msys2 python). +_TOP_LEVEL_DIRECTORY = os.path.normpath(sys._MEIPASS) +_TOP_LEVEL_DIRECTORY_PATHS.append(_TOP_LEVEL_DIRECTORY) + +# Fully resolve sys._MEIPASS in case its location is symlinked at some level; for example, system temporary directory +# (used by onefile builds) is usually a symbolic link under macOS. +_RESOLVED_TOP_LEVEL_DIRECTORY = os.path.realpath(_TOP_LEVEL_DIRECTORY) +if os.path.normcase(_RESOLVED_TOP_LEVEL_DIRECTORY) != os.path.normcase(_TOP_LEVEL_DIRECTORY): + _TOP_LEVEL_DIRECTORY_PATHS.append(_RESOLVED_TOP_LEVEL_DIRECTORY) + +# If we are running as macOS .app bundle, compute the alternative top-level directory path as well. +_is_macos_app_bundle = False +if sys.platform == 'darwin' and _TOP_LEVEL_DIRECTORY.endswith("Contents/Frameworks"): + _is_macos_app_bundle = True + + _ALTERNATIVE_TOP_LEVEL_DIRECTORY = os.path.join( + os.path.dirname(_TOP_LEVEL_DIRECTORY), + 'Resources', + ) + _TOP_LEVEL_DIRECTORY_PATHS.append(_ALTERNATIVE_TOP_LEVEL_DIRECTORY) + + _RESOLVED_ALTERNATIVE_TOP_LEVEL_DIRECTORY = os.path.join( + os.path.dirname(_RESOLVED_TOP_LEVEL_DIRECTORY), + 'Resources', + ) + if _RESOLVED_ALTERNATIVE_TOP_LEVEL_DIRECTORY != _ALTERNATIVE_TOP_LEVEL_DIRECTORY: + _TOP_LEVEL_DIRECTORY_PATHS.append(_RESOLVED_ALTERNATIVE_TOP_LEVEL_DIRECTORY) + + +# Helper for computing PYZ prefix tree +def _build_pyz_prefix_tree(pyz_archive): + tree = dict() + for entry_name, entry_data in pyz_archive.toc.items(): + name_components = entry_name.split('.') + typecode = entry_data[0] + current = tree + if typecode in {pyimod01_archive.PYZ_ITEM_PKG, pyimod01_archive.PYZ_ITEM_NSPKG}: + # Package; create new dictionary node for its modules + for name_component in name_components: + current = current.setdefault(name_component, {}) + else: + # Module; create the leaf node (empty string) + for name_component in name_components[:-1]: + current = current.setdefault(name_component, {}) + current[name_components[-1]] = '' + return tree + + +class PyiFrozenFinder: + """ + PyInstaller's frozen path entry finder for specific search path. + + Per-path instances allow us to properly translate the given module name ("fullname") into full PYZ entry name. + For example, with search path being `sys._MEIPASS`, the module "mypackage.mod" would translate to "mypackage.mod" + in the PYZ archive. However, if search path was `sys._MEIPASS/myotherpackage/_vendored` (for example, if + `myotherpacakge` added this path to `sys.path`), then "mypackage.mod" would need to translate to + "myotherpackage._vendored.mypackage.mod" in the PYZ archive. + """ + def __repr__(self): + return f"{self.__class__.__name__}({self._path})" + + @classmethod + def path_hook(cls, path): + trace(f"PyInstaller: running path finder hook for path: {path!r}") + try: + finder = cls(path) + trace("PyInstaller: hook succeeded") + return finder + except Exception as e: + trace(f"PyInstaller: hook failed: {e}") + raise + + def __init__(self, path): + self._path = path # Store original path, as given. + self._pyz_archive = pyz_archive + + # Compute relative path to the top-level application directory. Do not try to resolve the path itself, because + # it might contain symbolic links in parts other than the prefix that corresponds to the top-level application + # directory. See #8994 for an example (files symlinked from a common directory outside of the top-level + # application directory). Instead, try to compute relative path w.r.t. the original and the resolved top-level + # application directory. + for top_level_path in _TOP_LEVEL_DIRECTORY_PATHS: + try: + relative_path = os.path.relpath(path, top_level_path) + except ValueError: + continue # Failed to compute relative path w.r.t. the given top-level directory path. + + if relative_path.startswith('..'): + continue # Relative path points outside of the given top-level directory. + + break # Successful match; stop here. + else: + raise ImportError("Failed to determine relative path w.r.t. top-level application directory.") + + # Ensure that path does not point to a file on filesystem. Strictly speaking, we should be checking that the + # given path is a valid directory, but that would need to check both PYZ and filesystem. So for now, limit the + # check to catch paths pointing to file, because that breaks `runpy.run_path()`, as per #8767. + if os.path.isfile(path): + raise ImportError("only directories are supported") + + if relative_path == '.': + self._pyz_entry_prefix = '' + else: + self._pyz_entry_prefix = '.'.join(relative_path.split(os.path.sep)) + + def _compute_pyz_entry_name(self, fullname): + """ + Convert module fullname into PYZ entry name, subject to the prefix implied by this finder's search path. + """ + tail_module = fullname.rpartition('.')[2] + + if self._pyz_entry_prefix: + return self._pyz_entry_prefix + "." + tail_module + else: + return tail_module + + @property + def fallback_finder(self): + """ + Opportunistically create a *fallback finder* using `sys.path_hooks` entries that are located *after* our hook. + The main goal of this exercise is to obtain an instance of python's FileFinder, but in theory any other hook + that comes after ours is eligible to be a fallback. + + Having this fallback allows our finder to "cooperate" with python's FileFinder, as if the two were a single + finder, which allows us to work around the python's PathFinder permitting only one finder instance per path + without subclassing FileFinder. + """ + if hasattr(self, '_fallback_finder'): + return self._fallback_finder + + # Try to instantiate fallback finder + our_hook_found = False + + self._fallback_finder = None + for idx, hook in enumerate(sys.path_hooks): + if hook == self.path_hook: + our_hook_found = True + continue # Our hook + + if not our_hook_found: + continue # Skip hooks before our hook + + try: + self._fallback_finder = hook(self._path) + break + except ImportError: + pass + + return self._fallback_finder + + def _find_fallback_spec(self, fullname, target): + """ + Attempt to find the spec using fallback finder, which is opportunistically created here. Typically, this would + be python's FileFinder, which can discover specs for on-filesystem modules, such as extension modules and + modules that are collected only as source .py files. + + Having this fallback allows our finder to "cooperate" with python's FileFinder, as if the two were a single + finder, which allows us to work around the python's PathFinder permitting only one finder instance per path + without subclassing FileFinder. + """ + if not hasattr(self, '_fallback_finder'): + self._fallback_finder = self._get_fallback_finder() + + if self._fallback_finder is None: + return None + + return self._fallback_finder.find_spec(fullname, target) + + #-- Core PEP451 finder functionality, modeled after importlib.abc.PathEntryFinder + # https://docs.python.org/3/library/importlib.html#importlib.abc.PathEntryFinder + def invalidate_caches(self): + """ + A method which, when called, should invalidate any internal cache used by the finder. Used by + importlib.invalidate_caches() when invalidating the caches of all finders on sys.meta_path. + + https://docs.python.org/3/library/importlib.html#importlib.abc.MetaPathFinder.invalidate_caches + """ + # We do not use any caches, but if we have created a fallback finder, propagate the function call. + # NOTE: use getattr() with _fallback_finder attribute, in order to avoid unnecessary creation of the + # fallback finder in case when it does not exist yet. + fallback_finder = getattr(self, '_fallback_finder', None) + if fallback_finder is not None: + if hasattr(fallback_finder, 'invalidate_caches'): + fallback_finder.invalidate_caches() + + def find_spec(self, fullname, target=None): + """ + A method for finding a spec for the specified module. The finder will search for the module only within the + path entry to which it is assigned. If a spec cannot be found, None is returned. When passed in, target is a + module object that the finder may use to make a more educated guess about what spec to return. + + https://docs.python.org/3/library/importlib.html#importlib.abc.PathEntryFinder.find_spec + """ + trace(f"{self}: find_spec: called with fullname={fullname!r}, target={fullname!r}") + + # Convert fullname to PYZ entry name. + pyz_entry_name = self._compute_pyz_entry_name(fullname) + + # Try looking up the entry in the PYZ archive + entry_data = self._pyz_archive.toc.get(pyz_entry_name) + if entry_data is None: + # Entry not found - try using fallback finder (for example, python's own FileFinder) to resolve on-disk + # resources, such as extension modules and modules that are collected only as source .py files. + trace(f"{self}: find_spec: {fullname!r} not found in PYZ...") + + if self.fallback_finder is not None: + trace(f"{self}: find_spec: attempting resolve using fallback finder {self.fallback_finder!r}.") + fallback_spec = self.fallback_finder.find_spec(fullname, target) + trace(f"{self}: find_spec: fallback finder returned spec: {fallback_spec!r}.") + return fallback_spec + else: + trace(f"{self}: find_spec: fallback finder is not available.") + + return None + + # Entry found + typecode = entry_data[0] + trace(f"{self}: find_spec: found {fullname!r} in PYZ as {pyz_entry_name!r}, typecode={typecode}") + + if typecode == pyimod01_archive.PYZ_ITEM_NSPKG: + # PEP420 namespace package + # We can use regular list for submodule_search_locations; the caller (i.e., python's PathFinder) takes care + # of constructing _NamespacePath from it. + spec = _frozen_importlib.ModuleSpec(fullname, None) + spec.submodule_search_locations = [ + # NOTE: since we are using sys._MEIPASS as prefix, we need to construct path from resolved PYZ entry + # name (equivalently, we could combine `self._path` and last part of `fullname`). + os.path.join(sys._MEIPASS, pyz_entry_name.replace('.', os.path.sep)), + ] + return spec + + is_package = typecode == pyimod01_archive.PYZ_ITEM_PKG + + # Instantiate frozen loader for the module + loader = PyiFrozenLoader( + name=fullname, + pyz_archive=self._pyz_archive, + pyz_entry_name=pyz_entry_name, + is_package=is_package, + ) + + # Resolve full filename, as if the module/package was located on filesystem. This is done by the loader. + origin = loader.path + + # Construct spec for module, using all collected information. + spec = _frozen_importlib.ModuleSpec( + fullname, + loader, + is_package=is_package, + origin=origin, + ) + + # Make the import machinery set __file__. + # PEP 451 says: "has_location" is true if the module is locatable. In that case the spec's origin is used + # as the location and __file__ is set to spec.origin. If additional location information is required + # (e.g., zipimport), that information may be stored in spec.loader_state. + spec.has_location = True + + # Set submodule_search_locations for packages. Seems to be required for importlib_resources from 3.2.0; + # see issue #5395. + if is_package: + spec.submodule_search_locations = [os.path.dirname(origin)] + + return spec + + # The following methods are part of legacy PEP302 finder interface. They have been deprecated since python 3.4, + # and removed in python 3.12. Provide compatibility shims to accommodate code that might still be using them. + if sys.version_info[:2] < (3, 12): + + def find_loader(self, fullname): + """ + A legacy method for finding a loader for the specified module. Returns a 2-tuple of (loader, portion) where + portion is a sequence of file system locations contributing to part of a namespace package. The loader may + be None while specifying portion to signify the contribution of the file system locations to a namespace + package. An empty list can be used for portion to signify the loader is not part of a namespace package. If + loader is None and portion is the empty list then no loader or location for a namespace package were found + (i.e. failure to find anything for the module). + + Deprecated since python 3.4, removed in 3.12. + """ + # Based on: + # https://github.com/python/cpython/blob/v3.11.9/Lib/importlib/_bootstrap_external.py#L1587-L1600 + spec = self.find_spec(fullname) + if spec is None: + return None, [] + return spec.loader, spec.submodule_search_locations or [] + + def find_module(self, fullname): + """ + A concrete implementation of Finder.find_module() which is equivalent to self.find_loader(fullname)[0]. + + Deprecated since python 3.4, removed in 3.12. + """ + # Based on: + # https://github.com/python/cpython/blob/v3.11.9/Lib/importlib/_bootstrap_external.py#L1585 + # https://github.com/python/cpython/blob/v3.11.9/Lib/importlib/_bootstrap_external.py#L622-L639 + # + loader, portions = self.find_loader(fullname) + return loader + + +# Helper for enforcing module name in PyiFrozenLoader methods. +def _check_name(method): + def _check_name_wrapper(self, name, *args, **kwargs): + if self.name != name: + raise ImportError(f'loader for {self.name} cannot handle {name}', name=name) + return method(self, name, *args, **kwargs) + + return _check_name_wrapper + + +class PyiFrozenLoader: + """ + PyInstaller's frozen loader for modules in the PYZ archive, which are discovered by PyiFrozenFinder. + + Since this loader is instantiated only from PyiFrozenFinder and since each loader instance is tied to a specific + module, the fact that the loader was instantiated serves as the proof that the module exists in the PYZ archive. + Hence, we can avoid any additional validation in the implementation of the loader's methods. + """ + def __init__(self, name, pyz_archive, pyz_entry_name, is_package): + # Store the reference to PYZ archive (for code object retrieval), as well as full PYZ entry name + # and typecode, all of which are passed from the PyiFrozenFinder. + self._pyz_archive = pyz_archive + self._pyz_entry_name = pyz_entry_name + self._is_package = is_package + + # Compute the module file path, as if module was located on filesystem. + # + # Rather than returning path to the .pyc file, return the path to .py file - which might actually exist, if it + # was explicitly collected into the frozen application). This improves compliance with + # https://docs.python.org/3/library/importlib.html#importlib.abc.ExecutionLoader.get_filename + # as well as general compatibility with 3rd party code that blindly assumes that module's file path points to + # the source .py file. + # + # NOTE: since we are using sys._MEIPASS as prefix, we need to construct path from full PYZ entry name + # (so that a module with `name`=`jaraco.text` and `pyz_entry_name`=`setuptools._vendor.jaraco.text` + # ends up with path set to `sys._MEIPASS/setuptools/_vendor/jaraco/text/__init__.pyc` instead of + # `sys._MEIPASS/jaraco/text/__init__.pyc`). + if is_package: + module_file = os.path.join(sys._MEIPASS, pyz_entry_name.replace('.', os.path.sep), '__init__.py') + else: + module_file = os.path.join(sys._MEIPASS, pyz_entry_name.replace('.', os.path.sep) + '.py') + + # These properties are defined as part of importlib.abc.FileLoader. They are used by our implementation + # (e.g., module name validation, get_filename(), get_source(), get_resource_reader()), and might also be used + # by 3rd party code that naively expects to be dealing with a FileLoader instance. + self.name = name # The name of the module the loader can handle. + self.path = module_file # Path to the file of the module + + #-- Core PEP451 loader functionality as defined by importlib.abc.Loader + # https://docs.python.org/3/library/importlib.html#importlib.abc.Loader + def create_module(self, spec): + """ + A method that returns the module object to use when importing a module. This method may return None, indicating + that default module creation semantics should take place. + + https://docs.python.org/3/library/importlib.html#importlib.abc.Loader.create_module + """ + return None + + def exec_module(self, module): + """ + A method that executes the module in its own namespace when a module is imported or reloaded. The module + should already be initialized when exec_module() is called. When this method exists, create_module() + must be defined. + + https://docs.python.org/3/library/importlib.html#importlib.abc.Loader.exec_module + """ + spec = module.__spec__ + bytecode = self.get_code(spec.name) # NOTE: get_code verifies that `spec.name` matches `self.name`! + if bytecode is None: + raise RuntimeError(f"Failed to retrieve bytecode for {spec.name!r}!") + + # Set by the import machinery + assert hasattr(module, '__file__') + + # If `submodule_search_locations` is not None, this is a package; set __path__. + if spec.submodule_search_locations is not None: + module.__path__ = spec.submodule_search_locations + + exec(bytecode, module.__dict__) + + # The following method is part of legacy PEP302 loader interface. It has been deprecated since python 3.4, and + # slated for removal in python 3.12, although that has not happened yet. Provide compatibility shim to accommodate + # code that might still be using it. + if True: + + @_check_name + def load_module(self, fullname): + """ + A legacy method for loading a module. If the module cannot be loaded, ImportError is raised, otherwise the + loaded module is returned. + + Deprecated since python 3.4, slated for removal in 3.12 (but still present in python's own FileLoader in + both v3.12.4 and v3.13.0rc1). + """ + # Based on: + # https://github.com/python/cpython/blob/v3.11.9/Lib/importlib/_bootstrap_external.py#L942-L945 + import importlib._bootstrap as _bootstrap + return _bootstrap._load_module_shim(self, fullname) + + #-- PEP302 protocol extensions as defined by importlib.abc.ExecutionLoader + # https://docs.python.org/3/library/importlib.html#importlib.abc.ExecutionLoader + @_check_name + def get_filename(self, fullname): + """ + A method that is to return the value of __file__ for the specified module. If no path is available, ImportError + is raised. + + If source code is available, then the method should return the path to the source file, regardless of whether a + bytecode was used to load the module. + + https://docs.python.org/3/library/importlib.html#importlib.abc.ExecutionLoader.get_filename + """ + return self.path + + #-- PEP302 protocol extensions as defined by importlib.abc.InspectLoader + # https://docs.python.org/3/library/importlib.html#importlib.abc.InspectLoader + @_check_name + def get_code(self, fullname): + """ + Return the code object for a module, or None if the module does not have a code object (as would be the case, + for example, for a built-in module). Raise an ImportError if loader cannot find the requested module. + + https://docs.python.org/3/library/importlib.html#importlib.abc.InspectLoader.get_code + """ + return self._pyz_archive.extract(self._pyz_entry_name) + + @_check_name + def get_source(self, fullname): + """ + A method to return the source of a module. It is returned as a text string using universal newlines, translating + all recognized line separators into '\n' characters. Returns None if no source is available (e.g. a built-in + module). Raises ImportError if the loader cannot find the module specified. + + https://docs.python.org/3/library/importlib.html#importlib.abc.InspectLoader.get_source + """ + # The `path` attribute (which is also returned from `get_filename()`) already points to where the source .py + # file should exist, if it is available. + filename = self.path + + try: + # Read in binary mode, then decode + with open(filename, 'rb') as fp: + source_bytes = fp.read() + return _decode_source(source_bytes) + except FileNotFoundError: + pass + + # Source code is unavailable. + return None + + @_check_name + def is_package(self, fullname): + """ + A method to return a true value if the module is a package, a false value otherwise. ImportError is raised if + the loader cannot find the module. + + https://docs.python.org/3/library/importlib.html#importlib.abc.InspectLoader.is_package + """ + return self._is_package + + #-- PEP302 protocol extensions as dfined by importlib.abc.ResourceLoader + # https://docs.python.org/3/library/importlib.html#importlib.abc.ResourceLoader + def get_data(self, path): + """ + A method to return the bytes for the data located at path. Loaders that have a file-like storage back-end that + allows storing arbitrary data can implement this abstract method to give direct access to the data stored. + OSError is to be raised if the path cannot be found. The path is expected to be constructed using a module’s + __file__ attribute or an item from a package’s __path__. + + https://docs.python.org/3/library/importlib.html#importlib.abc.ResourceLoader.get_data + """ + # Try to fetch the data from the filesystem. Since __file__ attribute works properly, just try to open the file + # and read it. + with open(path, 'rb') as fp: + return fp.read() + + #-- Support for `importlib.resources`. + @_check_name + def get_resource_reader(self, fullname): + """ + Return resource reader compatible with `importlib.resources`. + """ + return PyiFrozenResourceReader(self) + + +class PyiFrozenResourceReader: + """ + Resource reader for importlib.resources / importlib_resources support. + + Supports only on-disk resources, which should cover the typical use cases, i.e., the access to data files; + PyInstaller collects data files onto filesystem, and as of v6.0.0, the embedded PYZ archive is guaranteed + to contain only .pyc modules. + + When listing resources, source .py files will not be listed as they are not collected by default. Similarly, + sub-directories that contained only .py files are not reconstructed on filesystem, so they will not be listed, + either. If access to .py files is required for whatever reason, they need to be explicitly collected as data files + anyway, which will place them on filesystem and make them appear as resources. + + For on-disk resources, we *must* return path compatible with pathlib.Path() in order to avoid copy to a temporary + file, which might break under some circumstances, e.g., metpy with importlib_resources back-port, due to: + https://github.com/Unidata/MetPy/blob/a3424de66a44bf3a92b0dcacf4dff82ad7b86712/src/metpy/plots/wx_symbols.py#L24-L25 + (importlib_resources tries to use 'fonts/wx_symbols.ttf' as a temporary filename suffix, which fails as it contains + a separator). + + Furthermore, some packages expect files() to return either pathlib.Path or zipfile.Path, e.g., + https://github.com/tensorflow/datasets/blob/master/tensorflow_datasets/core/utils/resource_utils.py#L81-L97 + This makes implementation of mixed support for on-disk and embedded resources using importlib.abc.Traversable + protocol rather difficult. + + So in order to maximize compatibility with unfrozen behavior, the below implementation is basically equivalent of + importlib.readers.FileReader from python 3.10: + https://github.com/python/cpython/blob/839d7893943782ee803536a47f1d4de160314f85/Lib/importlib/readers.py#L11 + and its underlying classes, importlib.abc.TraversableResources and importlib.abc.ResourceReader: + https://github.com/python/cpython/blob/839d7893943782ee803536a47f1d4de160314f85/Lib/importlib/abc.py#L422 + https://github.com/python/cpython/blob/839d7893943782ee803536a47f1d4de160314f85/Lib/importlib/abc.py#L312 + """ + def __init__(self, loader): + # Local import to avoid including `pathlib` and its dependencies in `base_library.zip` + import pathlib + # This covers both modules and (regular) packages. Note that PEP-420 namespace packages are not handled by this + # resource reader (since they are not handled by PyiFrozenLoader, which uses this reader). + self.path = pathlib.Path(loader.path).parent + + def open_resource(self, resource): + return self.files().joinpath(resource).open('rb') + + def resource_path(self, resource): + return str(self.path.joinpath(resource)) + + def is_resource(self, path): + return self.files().joinpath(path).is_file() + + def contents(self): + return (item.name for item in self.files().iterdir()) + + def files(self): + return self.path + + +class PyiFrozenEntryPointLoader: + """ + A special loader that enables retrieval of the code-object for the __main__ module. + """ + def __repr__(self): + return self.__class__.__name__ + + def get_code(self, fullname): + if fullname == '__main__': + # Special handling for __main__ module; the bootloader should store code object to _pyi_main_co + # attribute of the module. + return sys.modules['__main__']._pyi_main_co + + raise ImportError(f'{self} cannot handle module {fullname!r}') + + +def install(): + """ + Install PyInstaller's frozen finders/loaders/importers into python's import machinery. + """ + # Setup PYZ archive reader. + # + # The bootloader should store the path to PYZ archive (the path to the PKG archive and the offset within it; for + # executable-embedded archive, this is for example /path/executable_name?117568) into _pyinstaller_pyz + # attribute of the sys module. + global pyz_archive + + if not hasattr(sys, '_pyinstaller_pyz'): + raise RuntimeError("Bootloader did not set sys._pyinstaller_pyz!") + + try: + pyz_archive = pyimod01_archive.ZlibArchiveReader(sys._pyinstaller_pyz, check_pymagic=True) + except Exception as e: + raise RuntimeError("Failed to setup PYZ archive reader!") from e + + delattr(sys, '_pyinstaller_pyz') + + # On Windows, there is finder called `_frozen_importlib.WindowsRegistryFinder`, which looks for Python module + # locations in Windows registry. The frozen application should not look for those, so remove this finder + # from `sys.meta_path`. + for entry in sys.meta_path: + if getattr(entry, '__name__', None) == 'WindowsRegistryFinder': + sys.meta_path.remove(entry) + break + + # Insert our hook for `PyiFrozenFinder` into `sys.path_hooks`. Place it after `zipimporter`, if available. + for idx, entry in enumerate(sys.path_hooks): + if getattr(entry, '__name__', None) == 'zipimporter': + trace(f"PyInstaller: inserting our finder hook at index {idx + 1} in sys.path_hooks.") + sys.path_hooks.insert(idx + 1, PyiFrozenFinder.path_hook) + break + else: + trace("PyInstaller: zipimporter hook not found in sys.path_hooks! Prepending our finder hook to the list.") + sys.path_hooks.insert(0, PyiFrozenFinder.path_hook) + + # Monkey-patch `zipimporter.get_source` to allow loading out-of-zip source .py files for modules that are + # in `base_library.zip`. + _patch_zipimporter_get_source() + + # Python might have already created a `FileFinder` for `sys._MEIPASS`. Remove the entry from path importer cache, + # so that next loading attempt creates `PyiFrozenFinder` instead. This could probably be avoided altogether if + # we refrained from adding `sys._MEIPASS` to `sys.path` until our importer hooks is in place. + sys.path_importer_cache.pop(sys._MEIPASS, None) + + # Set the PyiFrozenEntryPointLoader as loader for __main__, in order for python to treat __main__ as a module + # instead of a built-in, and to allow its code object to be retrieved. + try: + sys.modules['__main__'].__loader__ = PyiFrozenEntryPointLoader() + except Exception: + pass + + # Apply hack for python >= 3.11 and its frozen stdlib modules. + if sys.version_info >= (3, 11): + _fixup_frozen_stdlib() + + +# A hack for python >= 3.11 and its frozen stdlib modules. Unless `sys._stdlib_dir` is set, these modules end up +# missing __file__ attribute, which causes problems with 3rd party code. At the time of writing, python interpreter +# configuration API does not allow us to influence `sys._stdlib_dir` - it always resets it to `None`. Therefore, +# we manually set the path, and fix __file__ attribute on modules. +def _fixup_frozen_stdlib(): + import _imp # built-in + + # If sys._stdlib_dir is None or empty, override it with sys._MEIPASS + if not sys._stdlib_dir: + try: + sys._stdlib_dir = sys._MEIPASS + except AttributeError: + pass + + # The sys._stdlib_dir set above should affect newly-imported python-frozen modules. However, most of them have + # been already imported during python initialization and our bootstrap, so we need to retroactively fix their + # __file__ attribute. + for module_name, module in sys.modules.items(): + if not _imp.is_frozen(module_name): + continue + + is_pkg = _imp.is_frozen_package(module_name) + + # Determine "real" name from __spec__.loader_state. + loader_state = module.__spec__.loader_state + + orig_name = loader_state.origname + if is_pkg: + orig_name += '.__init__' + + # We set suffix to .pyc to be consistent with our PyiFrozenLoader. + filename = os.path.join(sys._MEIPASS, *orig_name.split('.')) + '.pyc' + + # Fixup the __file__ attribute + if not hasattr(module, '__file__'): + try: + module.__file__ = filename + except AttributeError: + pass + + # Fixup the loader_state.filename + # Except for _frozen_importlib (importlib._bootstrap), whose loader_state.filename appears to be left at + # None in python. + if loader_state.filename is None and orig_name != 'importlib._bootstrap': + loader_state.filename = filename + + +# Monkey-patch the `get_source` implementation of python's `zipimport.zipimporter` with our custom implementation that +# looks up for source files in top-level application directory instead of within the zip file. This allows us to collect +# source .py files for modules that are collected in the `base_library.zip` in the same way as for modules in the PYZ +# archive. +def _patch_zipimporter_get_source(): + import zipimport + + _orig_get_source = zipimport.zipimporter.get_source + + def _get_source(self, fullname): + # Call original implementation first, in case we are dealing with a zip file other than `base_library.zip` (or + # if the source .py file is actually in there, for whatever reason). This also implicitly validates the module + # name, as it raises exception if module does not exist and returns None if module exists but the source code + # is not present in the archive. + source = _orig_get_source(self, fullname) + if source is not None: + return source + + # Our override should apply only to `base_library.zip`. + if os.path.basename(self.archive) != 'base_library.zip': + return None + + # Translate module/package name into .py filename in the top-level application directory. + if self.is_package(fullname): + filename = os.path.join(*fullname.split('.'), '__init__.py') + else: + filename = os.path.join(*fullname.split('.')) + '.py' + filename = os.path.join(_RESOLVED_TOP_LEVEL_DIRECTORY, filename) + + try: + # Read in binary mode, then decode + with open(filename, 'rb') as fp: + source_bytes = fp.read() + return _decode_source(source_bytes) + except FileNotFoundError: + pass + + # Source code is unavailable. + return None + + zipimport.zipimporter.get_source = _get_source diff --git a/venv/lib/python3.12/site-packages/PyInstaller/loader/pyimod03_ctypes.py b/venv/lib/python3.12/site-packages/PyInstaller/loader/pyimod03_ctypes.py new file mode 100755 index 0000000..ccb9c8d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/loader/pyimod03_ctypes.py @@ -0,0 +1,131 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License with exception +# for distributing bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +#----------------------------------------------------------------------------- +""" +Hooks to make ctypes.CDLL, .PyDLL, etc. look in sys._MEIPASS first. +""" + +import sys + + +def install(): + """ + Install the hooks. + + This must be done from a function as opposed to at module-level, because when the module is imported/executed, + the import machinery is not completely set up yet. + """ + + import os + + try: + import ctypes + except ImportError: + # ctypes is not included in the frozen application + return + + def _frozen_name(name): + # If the given (file)name does not exist, fall back to searching for its basename in sys._MEIPASS, where + # PyInstaller usually collects shared libraries. + if name and not os.path.isfile(name): + frozen_name = os.path.join(sys._MEIPASS, os.path.basename(name)) + if os.path.isfile(frozen_name): + name = frozen_name + return name + + class PyInstallerImportError(OSError): + def __init__(self, name): + self.msg = ( + "Failed to load dynlib/dll %r. Most likely this dynlib/dll was not found when the application " + "was frozen." % name + ) + self.args = (self.msg,) + + class PyInstallerCDLL(ctypes.CDLL): + def __init__(self, name, *args, **kwargs): + name = _frozen_name(name) + try: + super().__init__(name, *args, **kwargs) + except Exception as base_error: + raise PyInstallerImportError(name) from base_error + + ctypes.CDLL = PyInstallerCDLL + ctypes.cdll = ctypes.LibraryLoader(PyInstallerCDLL) + + class PyInstallerPyDLL(ctypes.PyDLL): + def __init__(self, name, *args, **kwargs): + name = _frozen_name(name) + try: + super().__init__(name, *args, **kwargs) + except Exception as base_error: + raise PyInstallerImportError(name) from base_error + + ctypes.PyDLL = PyInstallerPyDLL + ctypes.pydll = ctypes.LibraryLoader(PyInstallerPyDLL) + + if sys.platform.startswith('win'): + + class PyInstallerWinDLL(ctypes.WinDLL): + def __init__(self, name, *args, **kwargs): + name = _frozen_name(name) + try: + super().__init__(name, *args, **kwargs) + except Exception as base_error: + raise PyInstallerImportError(name) from base_error + + ctypes.WinDLL = PyInstallerWinDLL + ctypes.windll = ctypes.LibraryLoader(PyInstallerWinDLL) + + class PyInstallerOleDLL(ctypes.OleDLL): + def __init__(self, name, *args, **kwargs): + name = _frozen_name(name) + try: + super().__init__(name, *args, **kwargs) + except Exception as base_error: + raise PyInstallerImportError(name) from base_error + + ctypes.OleDLL = PyInstallerOleDLL + ctypes.oledll = ctypes.LibraryLoader(PyInstallerOleDLL) + + try: + import ctypes.util + except ImportError: + # ctypes.util is not included in the frozen application + return + + # Same implementation as ctypes.util.find_library, except it prepends sys._MEIPASS to the search directories. + def pyinstaller_find_library(name): + if name in ('c', 'm'): + return ctypes.util.find_msvcrt() + # See MSDN for the REAL search order. + search_dirs = [sys._MEIPASS] + os.environ['PATH'].split(os.pathsep) + for directory in search_dirs: + fname = os.path.join(directory, name) + if os.path.isfile(fname): + return fname + if fname.lower().endswith(".dll"): + continue + fname = fname + ".dll" + if os.path.isfile(fname): + return fname + return None + + ctypes.util.find_library = pyinstaller_find_library + + +# On macOS insert sys._MEIPASS in the first position of the list of paths that ctypes uses to search for libraries. +# +# Note: 'ctypes' module will NOT be bundled with every app because code in this module is not scanned for module +# dependencies. It is safe to wrap 'ctypes' module into 'try/except ImportError' block. +if sys.platform.startswith('darwin'): + try: + from ctypes.macholib import dyld + dyld.DEFAULT_LIBRARY_FALLBACK.insert(0, sys._MEIPASS) + except ImportError: + # Do nothing when module 'ctypes' is not available. + pass diff --git a/venv/lib/python3.12/site-packages/PyInstaller/loader/pyimod04_pywin32.py b/venv/lib/python3.12/site-packages/PyInstaller/loader/pyimod04_pywin32.py new file mode 100755 index 0000000..b635d75 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/loader/pyimod04_pywin32.py @@ -0,0 +1,56 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License with exception +# for distributing bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +#----------------------------------------------------------------------------- +""" +Set search path for pywin32 DLLs. Due to the large number of pywin32 modules, we use a single loader-level script +instead of per-module runtime hook scripts. +""" + +import os +import sys + + +def install(): + # Sub-directories containing extensions. In original python environment, these are added to `sys.path` by the + # `pywin32.pth` so the extensions end up treated as top-level modules. We attempt to preserve the directory + # layout, so we need to add these directories to `sys.path` ourselves. + pywin32_ext_paths = ('win32', 'pythonwin') + pywin32_ext_paths = [os.path.join(sys._MEIPASS, pywin32_ext_path) for pywin32_ext_path in pywin32_ext_paths] + pywin32_ext_paths = [path for path in pywin32_ext_paths if os.path.isdir(path)] + sys.path.extend(pywin32_ext_paths) + + # Additional handling of `pywin32_system32` DLL directory + pywin32_system32_path = os.path.join(sys._MEIPASS, 'pywin32_system32') + + if not os.path.isdir(pywin32_system32_path): + # Either pywin32 is not collected, or we are dealing with version that does not use the pywin32_system32 + # sub-directory. In the latter case, the pywin32 DLLs should be in `sys._MEIPASS`, and nothing + # else needs to be done here. + return + + # Add the DLL directory to `sys.path`. + # This is necessary because `__import_pywin32_system_module__` from `pywintypes` module assumes that in a frozen + # application, the pywin32 DLLs (`pythoncom3X.dll` and `pywintypes3X.dll`) that are normally found in + # `pywin32_system32` sub-directory in `sys.path` (site-packages, really) are located directly in `sys.path`. + # This obviously runs afoul of our attempts at preserving the directory layout and placing them in the + # `pywin32_system32` sub-directory instead of the top-level application directory. + sys.path.append(pywin32_system32_path) + + # Add the DLL directory to DLL search path using os.add_dll_directory(). + # This allows extensions from win32 directory (e.g., win32api, win32crypt) to be loaded on their own without + # importing pywintypes first. The extensions are linked against pywintypes3X.dll. + os.add_dll_directory(pywin32_system32_path) + + # Add the DLL directory to PATH. This is necessary under certain versions of + # Anaconda python, where `os.add_dll_directory` does not work. + path = os.environ.get('PATH', None) + if not path: + path = pywin32_system32_path + else: + path = pywin32_system32_path + os.pathsep + path + os.environ['PATH'] = path diff --git a/venv/lib/python3.12/site-packages/PyInstaller/log.py b/venv/lib/python3.12/site-packages/PyInstaller/log.py new file mode 100755 index 0000000..7c5b5ce --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/log.py @@ -0,0 +1,64 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Logging module for PyInstaller. +""" + +__all__ = ['getLogger', 'INFO', 'WARN', 'DEBUG', 'TRACE', 'ERROR', 'FATAL', 'DEPRECATION'] + +import os +import logging +from logging import DEBUG, ERROR, FATAL, INFO, WARN, getLogger + +TRACE = DEBUG - 5 +logging.addLevelName(TRACE, 'TRACE') +DEPRECATION = WARN + 5 +logging.addLevelName(DEPRECATION, 'DEPRECATION') +LEVELS = { + 'TRACE': TRACE, + 'DEBUG': DEBUG, + 'INFO': INFO, + 'WARN': WARN, + 'DEPRECATION': DEPRECATION, + 'ERROR': ERROR, + 'FATAL': FATAL, +} + +FORMAT = '%(relativeCreated)d %(levelname)s: %(message)s' +_env_level = os.environ.get("PYI_LOG_LEVEL", "INFO") +try: + level = LEVELS[_env_level.upper()] +except KeyError: + raise SystemExit(f"ERROR: Invalid PYI_LOG_LEVEL value '{_env_level}'. Should be one of {list(LEVELS)}.") +logging.basicConfig(format=FORMAT, level=level) +logger = getLogger('PyInstaller') + + +def __add_options(parser): + parser.add_argument( + '--log-level', + choices=LEVELS, + metavar="LEVEL", + dest='loglevel', + help='Amount of detail in build-time console messages. LEVEL may be one of %s (default: INFO). ' + 'Also settable via and overrides the PYI_LOG_LEVEL environment variable.' % ', '.join(LEVELS), + ) + + +def __process_options(parser, opts): + if opts.loglevel: + try: + level = opts.loglevel.upper() + _level = LEVELS[level] + except KeyError: + parser.error('Unknown log level `%s`' % opts.loglevel) + logger.setLevel(_level) + os.environ["PYI_LOG_LEVEL"] = level diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/__init__.py new file mode 100755 index 0000000..792d600 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/__init__.py @@ -0,0 +1 @@ +# diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/__init__.py new file mode 100755 index 0000000..792d600 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/__init__.py @@ -0,0 +1 @@ +# diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/archive_viewer.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/archive_viewer.py new file mode 100755 index 0000000..24d3fc5 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/archive_viewer.py @@ -0,0 +1,271 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Viewer for PyInstaller-generated archives. +""" + +import argparse +import os +import sys + +import PyInstaller.log +from PyInstaller.archive.readers import CArchiveReader, ZlibArchiveReader + +try: + from argcomplete import autocomplete +except ImportError: + + def autocomplete(parser): + return None + + +class ArchiveViewer: + def __init__(self, filename, interactive_mode, recursive_mode, brief_mode): + self.filename = filename + self.interactive_mode = interactive_mode + self.recursive_mode = recursive_mode + self.brief_mode = brief_mode + + self.stack = [] + + # Recursive mode implies non-interactive mode + if self.recursive_mode: + self.interactive_mode = False + + def main(self): + # Open top-level (initial) archive + archive = self._open_toplevel_archive(self.filename) + archive_name = os.path.basename(self.filename) + self.stack.append((archive_name, archive)) + + # Not-interactive mode + if not self.interactive_mode: + return self._non_interactive_processing() + + # Interactive mode; show top-level archive + self._show_archive_contents(archive_name, archive) + + # Interactive command processing + while True: + # Read command + try: + tokens = input('? ').split(None, 1) + except EOFError: + # Ctrl-D + print(file=sys.stderr) # Clear line. + break + + # Print usage? + if not tokens: + self._print_usage() + continue + + # Process + command = tokens[0].upper() + if command == 'Q': + break + elif command == 'U': + self._move_up_the_stack() + elif command == 'O': + self._open_embedded_archive(*tokens[1:]) + elif command == 'X': + self._extract_file(*tokens[1:]) + elif command == 'S': + archive_name, archive = self.stack[-1] + self._show_archive_contents(archive_name, archive) + else: + self._print_usage() + + def _non_interactive_processing(self): + archive_count = 0 + + while self.stack: + archive_name, archive = self.stack.pop() + archive_count += 1 + + if archive_count > 1: + print("") + self._show_archive_contents(archive_name, archive) + + if not self.recursive_mode: + continue + + # Scan for embedded archives + if isinstance(archive, CArchiveReader): + for name, (*_, typecode) in archive.toc.items(): + if typecode == 'z': + try: + embedded_archive = archive.open_embedded_archive(name) + except Exception as e: + print(f"Could not open embedded archive {name!r}: {e}", file=sys.stderr) + self.stack.append((name, embedded_archive)) + + def _print_usage(self): + print("U: go up one level", file=sys.stderr) + print("O : open embedded archive with given name", file=sys.stderr) + print("X : extract file with given name", file=sys.stderr) + print("S: list the contents of current archive again", file=sys.stderr) + print("Q: quit", file=sys.stderr) + + def _move_up_the_stack(self): + if len(self.stack) > 1: + self.stack.pop() + archive_name, archive = self.stack[-1] + self._show_archive_contents(archive_name, archive) + else: + print("Already in the top archive!", file=sys.stderr) + + def _open_toplevel_archive(self, filename): + if not os.path.isfile(filename): + print(f"Archive {filename} does not exist!", file=sys.stderr) + sys.exit(1) + + if filename[-4:].lower() == '.pyz': + return ZlibArchiveReader(filename) + return CArchiveReader(filename) + + def _open_embedded_archive(self, archive_name=None): + # Ask for name if not provided + if not archive_name: + archive_name = input('Open name? ') + archive_name = archive_name.strip() + + # No name given; abort + if not archive_name: + return + + # Open the embedded archive + _, parent_archive = self.stack[-1] + + if not hasattr(parent_archive, 'open_embedded_archive'): + print("Archive does not support embedded archives!", file=sys.stderr) + return + + try: + archive = parent_archive.open_embedded_archive(archive_name) + except Exception as e: + print(f"Could not open embedded archive {archive_name!r}: {e}", file=sys.stderr) + return + + # Add to stack and display contents + self.stack.append((archive_name, archive)) + self._show_archive_contents(archive_name, archive) + + def _extract_file(self, name=None): + # Ask for name if not provided + if not name: + name = input('Extract name? ') + name = name.strip() + + # Archive + archive_name, archive = self.stack[-1] + + # Retrieve data + try: + if isinstance(archive, CArchiveReader): + data = archive.extract(name) + elif isinstance(archive, ZlibArchiveReader): + data = archive.extract(name, raw=True) + if data is None: + raise ValueError("Entry has no associated data!") + else: + raise NotImplementedError(f"Extraction from archive type {type(archive)} not implemented!") + except Exception as e: + print(f"Failed to extract data for entry {name!r} from {archive_name!r}: {e}", file=sys.stderr) + return + + # Write to file + filename = input('Output filename? ') + if not filename: + print(repr(data)) + else: + with open(filename, 'wb') as fp: + fp.write(data) + + def _show_archive_contents(self, archive_name, archive): + if isinstance(archive, CArchiveReader): + if archive.options: + print(f"Options in {archive_name!r} (PKG/CArchive):") + for option in archive.options: + print(f" {option}") + print(f"Contents of {archive_name!r} (PKG/CArchive):") + if self.brief_mode: + for name in archive.toc.keys(): + print(f" {name}") + else: + print(" position, length, uncompressed_length, is_compressed, typecode, name") + for name, (position, length, uncompressed_length, is_compressed, typecode) in archive.toc.items(): + print(f" {position}, {length}, {uncompressed_length}, {is_compressed}, {typecode!r}, {name!r}") + elif isinstance(archive, ZlibArchiveReader): + print(f"Contents of {archive_name!r} (PYZ):") + if self.brief_mode: + for name in archive.toc.keys(): + print(f" {name}") + else: + print(" typecode, position, length, name") + for name, (typecode, position, length) in archive.toc.items(): + print(f" {typecode}, {position}, {length}, {name!r}") + else: + print(f"Contents of {name} (unknown)") + print(f"FIXME: implement content listing for archive type {type(archive)}!") + + +def run(): + parser = argparse.ArgumentParser() + parser.add_argument( + '-l', + '--list', + default=False, + action='store_true', + dest='listing_mode', + help='List the archive contents and exit (default: %(default)s).', + ) + parser.add_argument( + '-r', + '--recursive', + default=False, + action='store_true', + dest='recursive', + help='Recursively print an archive log (default: %(default)s). Implies --list.', + ) + parser.add_argument( + '-b', + '--brief', + default=False, + action='store_true', + dest='brief', + help='When displaying archive contents, show only file names. (default: %(default)s).', + ) + PyInstaller.log.__add_options(parser) + parser.add_argument( + 'filename', + metavar='pyi_archive', + help="PyInstaller archive to process.", + ) + + autocomplete(parser) + args = parser.parse_args() + PyInstaller.log.__process_options(parser, args) + + try: + viewer = ArchiveViewer( + filename=args.filename, + interactive_mode=not args.listing_mode, + recursive_mode=args.recursive, + brief_mode=args.brief, + ) + viewer.main() + except KeyboardInterrupt: + raise SystemExit("Aborted by user.") + + +if __name__ == '__main__': + run() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/bindepend.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/bindepend.py new file mode 100755 index 0000000..ebd5fdf --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/bindepend.py @@ -0,0 +1,58 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Show dll dependencies of executable files or other dynamic libraries. +""" + +import argparse +import glob + +import PyInstaller.depend.bindepend +import PyInstaller.log + +try: + from argcomplete import autocomplete +except ImportError: + + def autocomplete(parser): + return None + + +def run(): + parser = argparse.ArgumentParser() + PyInstaller.log.__add_options(parser) + parser.add_argument( + 'filenames', + nargs='+', + metavar='executable-or-dynamic-library', + help="executables or dynamic libraries for which the dependencies should be shown", + ) + + autocomplete(parser) + args = parser.parse_args() + PyInstaller.log.__process_options(parser, args) + + # Suppress all informative messages from the dependency code. + PyInstaller.log.getLogger('PyInstaller.build.bindepend').setLevel(PyInstaller.log.WARN) + + try: + for input_filename_or_pattern in args.filenames: + for filename in glob.glob(input_filename_or_pattern): + print(f"{filename}:") + for lib_name, lib_path in sorted(PyInstaller.depend.bindepend.get_imports(filename)): + print(f" {lib_name} => {lib_path}") + print("") + except KeyboardInterrupt: + raise SystemExit("Aborted by user request.") + + +if __name__ == '__main__': + run() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/grab_version.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/grab_version.py new file mode 100755 index 0000000..f8e1193 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/grab_version.py @@ -0,0 +1,59 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import argparse +import codecs + +try: + from argcomplete import autocomplete +except ImportError: + + def autocomplete(parser): + return None + + +def run(): + parser = argparse.ArgumentParser( + epilog=( + 'The printed output may be saved to a file, edited and used as the input for a version resource on any of ' + 'the executable targets in a PyInstaller .spec file.' + ) + ) + parser.add_argument( + 'exe_file', + metavar='exe-file', + help="full pathname of a Windows executable", + ) + parser.add_argument( + 'out_filename', + metavar='out-filename', + nargs='?', + default='file_version_info.txt', + help="filename where the grabbed version info will be saved", + ) + + autocomplete(parser) + args = parser.parse_args() + + try: + from PyInstaller.utils.win32 import versioninfo + info = versioninfo.read_version_info_from_executable(args.exe_file) + if not info: + raise SystemExit("ERROR: VersionInfo resource not found in exe") + with codecs.open(args.out_filename, 'w', 'utf-8') as fp: + fp.write(str(info)) + print(f"Version info written to: {args.out_filename!r}") + except KeyboardInterrupt: + raise SystemExit("Aborted by user request.") + + +if __name__ == '__main__': + run() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/makespec.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/makespec.py new file mode 100755 index 0000000..6225759 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/makespec.py @@ -0,0 +1,61 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Automatically build a spec file containing the description of the project. +""" + +import argparse +import os + +import PyInstaller.building.makespec +import PyInstaller.log + +try: + from argcomplete import autocomplete +except ImportError: + + def autocomplete(parser): + return None + + +def generate_parser(): + p = argparse.ArgumentParser() + PyInstaller.building.makespec.__add_options(p) + PyInstaller.log.__add_options(p) + p.add_argument( + 'scriptname', + nargs='+', + ) + return p + + +def run(): + p = generate_parser() + autocomplete(p) + args = p.parse_args() + PyInstaller.log.__process_options(p, args) + + # Split pathex by using the path separator. + temppaths = args.pathex[:] + args.pathex = [] + for p in temppaths: + args.pathex.extend(p.split(os.pathsep)) + + try: + name = PyInstaller.building.makespec.main(args.scriptname, **vars(args)) + print('Wrote %s.' % name) + print('Now run pyinstaller.py to build the executable.') + except KeyboardInterrupt: + raise SystemExit("Aborted by user request.") + + +if __name__ == '__main__': + run() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/set_version.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/set_version.py new file mode 100755 index 0000000..b936692 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/cliutils/set_version.py @@ -0,0 +1,51 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import argparse +import os + +try: + from argcomplete import autocomplete +except ImportError: + + def autocomplete(parser): + return None + + +def run(): + parser = argparse.ArgumentParser() + parser.add_argument( + 'info_file', + metavar='info-file', + help="text file containing version info", + ) + parser.add_argument( + 'exe_file', + metavar='exe-file', + help="full pathname of a Windows executable", + ) + autocomplete(parser) + args = parser.parse_args() + + info_file = os.path.abspath(args.info_file) + exe_file = os.path.abspath(args.exe_file) + + try: + from PyInstaller.utils.win32 import versioninfo + info = versioninfo.load_version_info_from_text_file(info_file) + versioninfo.write_version_info_to_executable(exe_file, info) + print(f"Version info written to: {exe_file!r}") + except KeyboardInterrupt: + raise SystemExit("Aborted by user request.") + + +if __name__ == '__main__': + run() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/conftest.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/conftest.py new file mode 100755 index 0000000..a62b15d --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/conftest.py @@ -0,0 +1,578 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import contextlib +import copy +import glob +import logging +import os +import re +import shutil +import subprocess +import sys +import time + +# Set a handler for the root-logger to inhibit 'basicConfig()' (called in PyInstaller.log) is setting up a stream +# handler writing to stderr. This avoids log messages to be written (and captured) twice: once on stderr and +# once by pytests's caplog. +logging.getLogger().addHandler(logging.NullHandler()) + +# psutil is used for process tree clean-up on time-out when running the test frozen application. If unavailable +# (for example, on cygwin), we fall back to trying to terminate only the main application process. +try: + import psutil # noqa: E402 +except ModuleNotFoundError: + psutil = None + +import pytest # noqa: E402 + +from PyInstaller import __main__ as pyi_main # noqa: E402 +from PyInstaller import configure # noqa: E402 +from PyInstaller.compat import is_cygwin, is_darwin, is_win # noqa: E402 +from PyInstaller.depend.analysis import initialize_modgraph # noqa: E402 +from PyInstaller.archive.readers import pkg_archive_contents # noqa: E402 +from PyInstaller.utils.tests import gen_sourcefile # noqa: E402 +from PyInstaller.utils.win32 import winutils # noqa: E402 + +# Timeout for running the executable. If executable does not exit in this time, it is interpreted as a test failure. +_EXE_TIMEOUT = 3 * 60 # In sec. +# All currently supported platforms +SUPPORTED_OSES = {"darwin", "linux", "win32"} +# Have pyi_builder fixure clean-up the temporary directories of successful tests. Controlled by environment variable. +_PYI_BUILDER_CLEANUP = os.environ.get("PYI_BUILDER_CLEANUP", "1") == "1" + +# Fixtures +# -------- + + +def pytest_runtest_setup(item): + """ + Markers to skip tests based on the current platform. + https://pytest.org/en/stable/example/markers.html#marking-platform-specific-tests-with-pytest + + Available markers: see pytest.ini markers + - @pytest.mark.darwin (macOS) + - @pytest.mark.linux (GNU/Linux) + - @pytest.mark.win32 (Windows) + """ + supported_platforms = SUPPORTED_OSES.intersection(mark.name for mark in item.iter_markers()) + plat = sys.platform + if supported_platforms and plat not in supported_platforms: + pytest.skip(f"does not run on {plat}") + + +@pytest.hookimpl(tryfirst=True, hookwrapper=True) +def pytest_runtest_makereport(item, call): + # Execute all other hooks to obtain the report object. + outcome = yield + rep = outcome.get_result() + + # Set a report attribute for each phase of a call, which can be "setup", "call", "teardown". + setattr(item, f"rep_{rep.when}", rep) + + +# Return the base directory which contains the current test module. +def _get_base_dir(request): + return request.path.resolve().parent # pathlib.Path instance + + +# Directory with Python scripts for functional tests. +def _get_script_dir(request): + return _get_base_dir(request) / 'scripts' + + +# Directory with testing modules used in some tests. +def _get_modules_dir(request): + return _get_base_dir(request) / 'modules' + + +# Directory with .toc log files. +def _get_logs_dir(request): + return _get_base_dir(request) / 'logs' + + +# Return the directory where data for tests is located. +def _get_data_dir(request): + return _get_base_dir(request) / 'data' + + +# Directory with .spec files used in some tests. +def _get_spec_dir(request): + return _get_base_dir(request) / 'specs' + + +@pytest.fixture +def spec_dir(request): + """ + Return the directory where the test spec-files reside. + """ + return _get_spec_dir(request) + + +@pytest.fixture +def script_dir(request): + """ + Return the directory where the test scripts reside. + """ + return _get_script_dir(request) + + +# A fixture that copies test's data directory into test's temporary directory. The data directory is assumed to be +# `data/{test-name}` found next to the .py file that contains test. +@pytest.fixture +def data_dir( + # The request object for this test. Used to infer name of the test and location of the source .py file. + # See + # https://pytest.org/latest/builtin.html#_pytest.python.FixtureRequest + # and + # https://pytest.org/latest/fixture.html#fixtures-can-introspect-the-requesting-test-context. + request, + # The tmp_path object for this test. See: https://pytest.org/latest/tmp_path.html. + tmp_path +): + # Strip the leading 'test_' from the test's name. + test_name = request.function.__name__[5:] + + # Copy to data dir and return the path. + source_data_dir = _get_data_dir(request) / test_name + tmp_data_dir = tmp_path / 'data' + # Copy the data. + shutil.copytree(source_data_dir, tmp_data_dir) + # Return the temporary data directory, so that the copied data can now be used. + return tmp_data_dir + + +class AppBuilder: + def __init__(self, tmp_path, request, bundle_mode): + self._tmp_path = tmp_path + self._request = request + self._mode = bundle_mode + self._spec_dir = tmp_path + self._dist_dir = tmp_path / 'dist' + self._build_dir = tmp_path / 'build' + self._is_spec = False + + def test_spec(self, specfile, *args, **kwargs): + """ + Test a Python script that is referenced in the supplied .spec file. + """ + __tracebackhide__ = True + specfile = _get_spec_dir(self._request) / specfile + # 'test_script' should handle .spec properly as script. + self._is_spec = True + return self.test_script(specfile, *args, **kwargs) + + def test_source(self, source, *args, **kwargs): + """ + Test a Python script given as source code. + + The source will be written into a file named like the test-function. This file will then be passed to + `test_script`. If you need other related file, e.g., as `.toc`-file for testing the content, put it at at the + normal place. Just mind to take the basnename from the test-function's name. + + :param script: Source code to create executable from. This will be saved into a temporary file which is then + passed on to `test_script`. + + :param test_id: Test-id for parametrized tests. If given, it will be appended to the script filename, separated + by two underscores. + + All other arguments are passed straight on to `test_script`. + """ + __tracebackhide__ = True + # For parametrized test append the test-id. + scriptfile = gen_sourcefile(self._tmp_path, source, kwargs.setdefault('test_id')) + del kwargs['test_id'] + return self.test_script(scriptfile, *args, **kwargs) + + def _display_message(self, step_name, message): + # Print the given message to both stderr and stdout, and it with APP-BUILDER to make it clear where it + # originates from. + print(f'[APP-BUILDER:{step_name}] {message}', file=sys.stdout) + print(f'[APP-BUILDER:{step_name}] {message}', file=sys.stderr) + + def test_script( + self, script, pyi_args=None, app_name=None, app_args=None, runtime=None, run_from_path=False, **kwargs + ): + """ + Main method to wrap all phases of testing a Python script. + + :param script: Name of script to create executable from. + :param pyi_args: Additional arguments to pass to PyInstaller when creating executable. + :param app_name: Name of the executable. This is equivalent to argument --name=APPNAME. + :param app_args: Additional arguments to pass to + :param runtime: Time in seconds how long to keep executable running. + :param toc_log: List of modules that are expected to be bundled with the executable. + """ + __tracebackhide__ = True + + # Skip interactive tests (the ones with `runtime` set) if `psutil` is unavailable, as we need it to properly + # clean up the process tree. + if runtime and psutil is None: + pytest.skip('Interactive tests require psutil for proper cleanup.') + + if pyi_args is None: + pyi_args = [] + if app_args is None: + app_args = [] + + if app_name: + if not self._is_spec: + pyi_args.extend(['--name', app_name]) + else: + # Derive name from script name. + app_name = os.path.splitext(os.path.basename(script))[0] + + # Relative path means that a script from _script_dir is referenced. + if not os.path.isabs(script): + script = _get_script_dir(self._request) / script + self.script = str(script) # might be a pathlib.Path at this point! + assert os.path.exists(self.script), f'Script {self.script!r} not found.' + + self._display_message('TEST-SCRIPT', 'Starting build...') + if not self._test_building(args=pyi_args): + pytest.fail(f'Building of {script} failed.') + + self._display_message('TEST-SCRIPT', 'Build finished, now running executable...') + self._test_executables(app_name, args=app_args, runtime=runtime, run_from_path=run_from_path, **kwargs) + self._display_message('TEST-SCRIPT', 'Running executable finished.') + + def _test_executables(self, name, args, runtime, run_from_path, **kwargs): + """ + Run created executable to make sure it works. + + Multipackage-tests generate more than one exe-file and all of them have to be run. + + :param args: CLI options to pass to the created executable. + :param runtime: Time in seconds how long to keep the executable running. + + :return: Exit code of the executable. + """ + __tracebackhide__ = True + exes = self._find_executables(name) + # Empty list means that PyInstaller probably failed to create any executable. + assert exes != [], 'No executable file was found.' + for exe in exes: + # Try to find .toc log file. .toc log file has the same basename as exe file. + toc_log = os.path.splitext(os.path.basename(exe))[0] + '.toc' + toc_log = _get_logs_dir(self._request) / toc_log + if toc_log.exists(): + if not self._examine_executable(exe, toc_log): + pytest.fail(f'Matching .toc of {exe} failed.') + retcode = self._run_executable(exe, args, run_from_path, runtime) + if retcode != kwargs.get('retcode', 0): + pytest.fail(f'Running exe {exe} failed with return-code {retcode}.') + + def _find_executables(self, name): + """ + Search for all executables generated by the testcase. + + If the test-case is called e.g. 'test_multipackage1', this is searching for each of 'test_multipackage1.exe' + and 'multipackage1_?.exe' in both one-file- and one-dir-mode. + + :param name: Name of the executable to look for. + + :return: List of executables + """ + exes = [] + onedir_pt = str(self._dist_dir / name / name) + onefile_pt = str(self._dist_dir / name) + patterns = [ + onedir_pt, + onefile_pt, + # Multipackage one-dir + onedir_pt + '_?', + # Multipackage one-file + onefile_pt + '_?' + ] + # For Windows append .exe extension to patterns. + if is_win: + patterns = [pt + '.exe' for pt in patterns] + # For macOS append pattern for .app bundles. + if is_darwin: + # e.g: ./dist/name.app/Contents/MacOS/name + app_bundle_pt = str(self._dist_dir / f'{name}.app' / 'Contents' / 'MacOS' / name) + patterns.append(app_bundle_pt) + # Apply file patterns. + for pattern in patterns: + for prog in glob.glob(pattern): + if os.path.isfile(prog): + exes.append(prog) + return exes + + def _run_executable(self, prog, args, run_from_path, runtime): + """ + Run executable created by PyInstaller. + + :param args: CLI options to pass to the created executable. + """ + # Run the test in a clean environment to make sure they're really self-contained. + prog_env = copy.deepcopy(os.environ) + prog_env['PATH'] = '' + del prog_env['PATH'] + # For Windows we need to keep minimal PATH for successful running of some tests. + if is_win: + # Minimum Windows PATH is in most cases: C:\Windows\system32;C:\Windows + prog_env['PATH'] = os.pathsep.join(winutils.get_system_path()) + # Same for Cygwin - if /usr/bin is not in PATH, cygwin1.dll cannot be discovered. + if is_cygwin: + prog_env['PATH'] = os.pathsep.join(['/usr/local/bin', '/usr/bin']) + # On macOS, we similarly set up minimal PATH with system directories, in case utilities from there are used by + # tested python code (for example, matplotlib >= 3.9.0 uses `system_profiler` that is found in /usr/sbin). + if is_darwin: + # The following paths are registered when application is launched via Finder, and are a subset of what is + # typically available in the shell. + prog_env['PATH'] = os.pathsep.join(['/usr/bin', '/bin', '/usr/sbin', '/sbin']) + + exe_path = prog + if run_from_path: + # Run executable in the temp directory. Add the directory containing the executable to $PATH. Basically, + # pretend we are a shell executing the program from $PATH. + prog_cwd = str(self._tmp_path) + prog_name = os.path.basename(prog) + prog_env['PATH'] = os.pathsep.join([prog_env.get('PATH', ''), os.path.dirname(prog)]) + + else: + # Run executable in the directory where it is. + prog_cwd = os.path.dirname(prog) + # The executable will be called with argv[0] as relative not absolute path. + prog_name = os.path.join(os.curdir, os.path.basename(prog)) + + args = [prog_name] + args + # Using sys.stdout/sys.stderr for subprocess fixes printing messages in Windows command prompt. Py.test is then + # able to collect stdout/sterr messages and display them if a test fails. + return self._run_executable_(args, exe_path, prog_env, prog_cwd, runtime) + + def _run_executable_(self, args, exe_path, prog_env, prog_cwd, runtime): + # Use psutil.Popen, if available; otherwise, fall back to subprocess.Popen + popen_implementation = subprocess.Popen if psutil is None else psutil.Popen + + # Run the executable + self._display_message('RUN-EXE', f'Running {exe_path!r}, args: {args!r}') + start_time = time.time() + process = popen_implementation(args, executable=exe_path, env=prog_env, cwd=prog_cwd) + + # Wait for the process to finish. If no run-time (= timeout) is specified, we expect the process to exit on + # its own, and use global _EXE_TIMEOUT. If run-time is specified, we expect the application to be running + # for at least the specified amount of time, which is useful in "interactive" test applications that are not + # expected exit on their own. + stdout = stderr = None + try: + timeout = runtime if runtime else _EXE_TIMEOUT + stdout, stderr = process.communicate(timeout=timeout) + elapsed = time.time() - start_time + retcode = process.returncode + self._display_message( + 'RUN-EXE', f'Process exited on its own after {elapsed:.1f} seconds with return code {retcode}.' + ) + except (subprocess.TimeoutExpired) if psutil is None else (psutil.TimeoutExpired, subprocess.TimeoutExpired): + if runtime: + # When 'runtime' is set, the expired timeout is a good sign that the executable was running successfully + # for the specified time. + self._display_message('RUN-EXE', f'Process reached expected run-time of {runtime} seconds.') + retcode = 0 + else: + # Executable is still running and it is not interactive. Clean up the process tree, and fail the test. + self._display_message('RUN-EXE', f'Timeout while running executable (timeout: {timeout} seconds)!') + retcode = 1 + + if psutil is None: + # We are using subprocess.Popen(). Without psutil, we have no access to process tree; this poses a + # problem for onefile builds, where we would need to first kill the child (main application) process, + # and let the onefile parent perform its cleanup. As a best-effort approach, we can first call + # process.terminate(); on POSIX systems, this sends SIGTERM to the parent process, and in most + # situations, the bootloader will forward it to the child process. Then wait 5 seconds, and call + # process.kill() if necessary. On Windows, however, both process.terminate() and process.kill() do + # the same. Therefore, we should avoid running "interactive" tests with expected run-time if we do + # not have psutil available. + try: + self._display_message('RUN-EXE', 'Stopping the process using Popen.terminate()...') + process.terminate() + stdout, stderr = process.communicate(timeout=5) + self._display_message('RUN-EXE', 'Process stopped.') + except subprocess.TimeoutExpired: + # Kill the process. + try: + self._display_message('RUN-EXE', 'Stopping the process using Popen.kill()...') + process.kill() + # process.communicate() waits for end-of-file, which may never arrive if there is a child + # process still alive. Nothing we can really do about it here, so add a short timeout and + # display a warning. + stdout, stderr = process.communicate(timeout=1) + self._display_message('RUN-EXE', 'Process stopped.') + except subprocess.TimeoutExpired: + self._display_message('RUN-EXE', 'Failed to stop the process (or its child process(es))!') + else: + # We are using psutil.Popen(). First, force-kill all child processes; in onefile mode, this includes + # the application process, whose termination should trigger cleanup and exit of the parent onefile + # process. + self._display_message('RUN-EXE', 'Stopping child processes...') + for child_process in list(process.children(recursive=True)): + with contextlib.suppress(psutil.NoSuchProcess): + self._display_message('RUN-EXE', f'Stopping child process {child_process.pid}...') + child_process.kill() + + # Give the main process 5 seconds to exit on its own (to accommodate cleanup in onefile mode). + try: + self._display_message('RUN-EXE', f'Waiting for main process ({process.pid}) to stop...') + stdout, stderr = process.communicate(timeout=5) + self._display_message('RUN-EXE', 'Process stopped on its own.') + except (psutil.TimeoutExpired, subprocess.TimeoutExpired): + # End of the line - kill the main process. + self._display_message('RUN-EXE', 'Stopping the process using Popen.kill()...') + with contextlib.suppress(psutil.NoSuchProcess): + process.kill() + # Try to retrieve stdout/stderr - but keep a short timeout, just in case... + try: + stdout, stderr = process.communicate(timeout=1) + self._display_message('RUN-EXE', 'Process stopped.') + except (psutil.TimeoutExpired, subprocess.TimeoutExpire): + self._display_message('RUN-EXE', 'Failed to stop the process (or its child process(es))!') + + self._display_message('RUN-EXE', f'Done! Return code: {retcode}') + + return retcode + + def _test_building(self, args): + """ + Run building of test script. + + :param args: additional CLI options for PyInstaller. + + Return True if build succeeded False otherwise. + """ + if self._is_spec: + default_args = [ + '--distpath', str(self._dist_dir), + '--workpath', str(self._build_dir), + '--log-level', 'INFO', + ] # yapf: disable + else: + default_args = [ + '--debug=bootloader', + '--noupx', + '--specpath', str(self._spec_dir), + '--distpath', str(self._dist_dir), + '--workpath', str(self._build_dir), + '--path', str(_get_modules_dir(self._request)), + '--log-level', 'INFO', + ] # yapf: disable + + # Choose bundle mode. + if self._mode == 'onedir': + default_args.append('--onedir') + elif self._mode == 'onefile': + default_args.append('--onefile') + # if self._mode is None then just the spec file was supplied. + + pyi_args = [self.script, *default_args, *args] + # TODO: fix return code in running PyInstaller programmatically. + PYI_CONFIG = configure.get_config() + # Override CACHEDIR for PyInstaller; relocate cache into `self._tmp_path`. + PYI_CONFIG['cachedir'] = str(self._tmp_path) + + pyi_main.run(pyi_args, PYI_CONFIG) + retcode = 0 + + return retcode == 0 + + def _examine_executable(self, exe, toc_log): + """ + Compare log files (now used mostly by multipackage test_name). + + :return: True if .toc files match + """ + self._display_message('EXAMINE-EXE', f'Matching against TOC log: {str(toc_log)!r}') + fname_list = pkg_archive_contents(exe) + with open(toc_log, 'r', encoding='utf-8') as f: + pattern_list = eval(f.read()) + # Alphabetical order of patterns. + pattern_list.sort() + missing = [] + for pattern in pattern_list: + for fname in fname_list: + if re.match(pattern, fname): + self._display_message('EXAMINE-EXE', f'Entry found: {pattern!r} --> {fname!r}') + break + else: + # No matching entry found + missing.append(pattern) + self._display_message('EXAMINE-EXE', f'Entry MISSING: {pattern!r}') + + # We expect the missing list to be empty + return not missing + + +# Scope 'session' should keep the object unchanged for whole tests. This fixture caches basic module graph dependencies +# that are same for every executable. +@pytest.fixture(scope='session') +def pyi_modgraph(): + # Explicitly set the log level since the plugin `pytest-catchlog` (un-) sets the root logger's level to NOTSET for + # the setup phase, which will lead to TRACE messages been written out. + import PyInstaller.log as logging + logging.logger.setLevel(logging.DEBUG) + initialize_modgraph() + + +# Run by default test as onedir and onefile. +@pytest.fixture(params=['onedir', 'onefile']) +def pyi_builder(tmp_path, monkeypatch, request, pyi_modgraph): + # Save/restore environment variable PATH. + monkeypatch.setenv('PATH', os.environ['PATH']) + # PyInstaller or a test case might manipulate 'sys.path'. Reset it for every test. + monkeypatch.syspath_prepend(None) + # Set current working directory to + monkeypatch.chdir(tmp_path) + # Clean up configuration and force PyInstaller to do a clean configuration for another app/test. The value is same + # as the original value. + monkeypatch.setattr('PyInstaller.config.CONF', {'pathex': []}) + + yield AppBuilder(tmp_path, request, request.param) + + # Clean up the temporary directory of a successful test + if _PYI_BUILDER_CLEANUP and request.node.rep_setup.passed and request.node.rep_call.passed: + if tmp_path.exists(): + shutil.rmtree(tmp_path, ignore_errors=True) + + +# Fixture for .spec based tests. With .spec it does not make sense to differentiate onefile/onedir mode. +@pytest.fixture +def pyi_builder_spec(tmp_path, request, monkeypatch, pyi_modgraph): + # Save/restore environment variable PATH. + monkeypatch.setenv('PATH', os.environ['PATH']) + # Set current working directory to + monkeypatch.chdir(tmp_path) + # PyInstaller or a test case might manipulate 'sys.path'. Reset it for every test. + monkeypatch.syspath_prepend(None) + # Clean up configuration and force PyInstaller to do a clean configuration for another app/test. The value is same + # as the original value. + monkeypatch.setattr('PyInstaller.config.CONF', {'pathex': []}) + + yield AppBuilder(tmp_path, request, None) + + # Clean up the temporary directory of a successful test + if _PYI_BUILDER_CLEANUP and request.node.rep_setup.passed and request.node.rep_call.passed: + if tmp_path.exists(): + shutil.rmtree(tmp_path, ignore_errors=True) + + +@pytest.fixture +def pyi_windowed_builder(pyi_builder: AppBuilder): + """A pyi_builder equivalent for testing --windowed applications.""" + + # psutil.Popen() somehow bypasses an application's windowed/console mode so that any application built in + # --windowed mode but invoked with psutil still receives valid std{in,out,err} handles and behaves exactly like + # a console application. In short, testing windowed mode with psutil is a null test. We must instead use subprocess. + + def _run_executable_(args, exe_path, prog_env, prog_cwd, runtime): + return subprocess.run([exe_path, *args], env=prog_env, cwd=prog_cwd, timeout=runtime).returncode + + pyi_builder._run_executable_ = _run_executable_ + yield pyi_builder diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/__init__.py new file mode 100755 index 0000000..60cc591 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/__init__.py @@ -0,0 +1,1343 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +from __future__ import annotations + +import copy +import os +import textwrap +import fnmatch +from pathlib import Path +from collections import deque +from typing import Callable + +import packaging.requirements + +from PyInstaller import HOMEPATH, compat +from PyInstaller import log as logging +from PyInstaller.depend.imphookapi import PostGraphAPI +from PyInstaller import isolated +from PyInstaller.compat import importlib_metadata + +logger = logging.getLogger(__name__) + +# These extensions represent Python executables and should therefore be ignored when collecting data files. +# NOTE: .dylib files are not Python executable and should not be in this list. +PY_IGNORE_EXTENSIONS = set(compat.ALL_SUFFIXES) + +# Some hooks need to save some values. This is the dict that can be used for that. +# +# When running tests this variable should be reset before every test. +# +# For example the 'wx' module needs variable 'wxpubsub'. This tells PyInstaller which protocol of the wx module +# should be bundled. +hook_variables = {} + + +def __exec_python_cmd(cmd, env=None, capture_stdout=True): + """ + Executes an externally spawned Python interpreter. If capture_stdout is set to True, returns anything that was + emitted in the standard output as a single string. Otherwise, returns the exit code. + """ + # 'PyInstaller.config' cannot be imported as other top-level modules. + from PyInstaller.config import CONF + if env is None: + env = {} + # Update environment. Defaults to 'os.environ' + pp_env = copy.deepcopy(os.environ) + pp_env.update(env) + # Prepend PYTHONPATH with pathex. + # Some functions use some PyInstaller code in subprocess, so add PyInstaller HOMEPATH to sys.path as well. + pp = os.pathsep.join(CONF['pathex'] + [HOMEPATH]) + + # PYTHONPATH might be already defined in the 'env' argument or in the original 'os.environ'. Prepend it. + if 'PYTHONPATH' in pp_env: + pp = os.pathsep.join([pp_env.get('PYTHONPATH'), pp]) + pp_env['PYTHONPATH'] = pp + + if capture_stdout: + txt = compat.exec_python(*cmd, env=pp_env) + return txt.strip() + else: + return compat.exec_python_rc(*cmd, env=pp_env) + + +def __exec_statement(statement, capture_stdout=True): + statement = textwrap.dedent(statement) + cmd = ['-c', statement] + return __exec_python_cmd(cmd, capture_stdout=capture_stdout) + + +def exec_statement(statement: str): + """ + Execute a single Python statement in an externally-spawned interpreter, and return the resulting standard output + as a string. + + Examples:: + + tk_version = exec_statement("from _tkinter import TK_VERSION; print(TK_VERSION)") + + mpl_data_dir = exec_statement("import matplotlib; print(matplotlib.get_data_path())") + datas = [ (mpl_data_dir, "") ] + + Notes: + As of v5.0, usage of this function is discouraged in favour of the + new :mod:`PyInstaller.isolated` module. + + """ + return __exec_statement(statement, capture_stdout=True) + + +def exec_statement_rc(statement: str): + """ + Executes a Python statement in an externally spawned interpreter, and returns the exit code. + """ + return __exec_statement(statement, capture_stdout=False) + + +def eval_statement(statement: str): + """ + Execute a single Python statement in an externally-spawned interpreter, and :func:`eval` its output (if any). + + Example:: + + databases = eval_statement(''' + import sqlalchemy.databases + print(sqlalchemy.databases.__all__) + ''') + for db in databases: + hiddenimports.append("sqlalchemy.databases." + db) + + Notes: + As of v5.0, usage of this function is discouraged in favour of the + new :mod:`PyInstaller.isolated` module. + + """ + txt = exec_statement(statement).strip() + if not txt: + # Return an empty string, which is "not true" but is iterable. + return '' + return eval(txt) + + +@isolated.decorate +def get_pyextension_imports(module_name: str): + """ + Return list of modules required by binary (C/C++) Python extension. + + Python extension files ends with .so (Unix) or .pyd (Windows). It is almost impossible to analyze binary extension + and its dependencies. + + Module cannot be imported directly. + + Let's at least try import it in a subprocess and observe the difference in module list from sys.modules. + + This function could be used for 'hiddenimports' in PyInstaller hooks files. + """ + import sys + import importlib + + original = set(sys.modules.keys()) + + # When importing this module - sys.modules gets updated. + importlib.import_module(module_name) + + # Find and return which new modules have been loaded. + return list(set(sys.modules.keys()) - original - {module_name}) + + +def get_homebrew_path(formula: str = ''): + """ + Return the homebrew path to the requested formula, or the global prefix when called with no argument. + + Returns the path as a string or None if not found. + """ + import subprocess + brewcmd = ['brew', '--prefix'] + path = None + if formula: + brewcmd.append(formula) + dbgstr = 'homebrew formula "%s"' % formula + else: + dbgstr = 'homebrew prefix' + try: + path = subprocess.check_output(brewcmd).strip() + logger.debug('Found %s at "%s"' % (dbgstr, path)) + except OSError: + logger.debug('Detected homebrew not installed') + except subprocess.CalledProcessError: + logger.debug('homebrew formula "%s" not installed' % formula) + if path: + return path.decode('utf8') # macOS filenames are UTF-8 + else: + return None + + +def remove_prefix(string: str, prefix: str): + """ + This function removes the given prefix from a string, if the string does indeed begin with the prefix; otherwise, + it returns the original string. + """ + if string.startswith(prefix): + return string[len(prefix):] + else: + return string + + +def remove_suffix(string: str, suffix: str): + """ + This function removes the given suffix from a string, if the string does indeed end with the suffix; otherwise, + it returns the original string. + """ + # Special case: if suffix is empty, string[:0] returns ''. So, test for a non-empty suffix. + if suffix and string.endswith(suffix): + return string[:-len(suffix)] + else: + return string + + +# TODO: Do we really need a helper for this? This is pretty trivially obvious. +def remove_file_extension(filename: str): + """ + This function returns filename without its extension. + + For Python C modules it removes even whole '.cpython-34m.so' etc. + """ + for suff in compat.EXTENSION_SUFFIXES: + if filename.endswith(suff): + return filename[0:filename.rfind(suff)] + # Fallback to ordinary 'splitext'. + return os.path.splitext(filename)[0] + + +def can_import_module(module_name: str): + """ + Check if the specified module can be imported. + + Intended as a silent module availability check, as it does not print ModuleNotFoundError traceback to stderr when + the module is unavailable. + + Parameters + ---------- + module_name : str + Fully-qualified name of the module. + + Returns + ---------- + bool + Boolean indicating whether the module can be imported or not. + """ + + # Run the check in isolated sub-process, so we can gracefully handle cases when importing the module ends up + # crashing python interpreter. + @isolated.decorate + def _can_import_module(module_name): + try: + __import__(module_name) + return True + except Exception: + return False + + try: + return _can_import_module(module_name) + except isolated.SubprocessDiedError: + return False + + +# TODO: Replace most calls to exec_statement() with calls to this function. +def get_module_attribute(module_name: str, attr_name: str): + """ + Get the string value of the passed attribute from the passed module if this attribute is defined by this module + _or_ raise `AttributeError` otherwise. + + Since modules cannot be directly imported during analysis, this function spawns a subprocess importing this module + and returning the string value of this attribute in this module. + + Parameters + ---------- + module_name : str + Fully-qualified name of this module. + attr_name : str + Name of the attribute in this module to be retrieved. + + Returns + ---------- + str + String value of this attribute. + + Raises + ---------- + AttributeError + If this attribute is undefined. + """ + @isolated.decorate + def _get_module_attribute(module_name, attr_name): + import importlib + module = importlib.import_module(module_name) + return getattr(module, attr_name) + + # Return AttributeError on any kind of errors, to preserve old behavior. + try: + return _get_module_attribute(module_name, attr_name) + except Exception as e: + raise AttributeError(f"Failed to retrieve attribute {attr_name} from module {module_name}") from e + + +def get_module_file_attribute(package: str): + """ + Get the absolute path to the specified module or package. + + Modules and packages *must not* be directly imported in the main process during the analysis. Therefore, to + avoid leaking the imports, this function uses an isolated subprocess when it needs to import the module and + obtain its ``__file__`` attribute. + + Parameters + ---------- + package : str + Fully-qualified name of module or package. + + Returns + ---------- + str + Absolute path of this module. + """ + # First, try to use 'importlib.util.find_spec' and obtain loader from the spec (and filename from the loader). + # It is the fastest way, but does not work on certain modules in pywin32 that replace all module attributes with + # those of the .dll. In addition, we need to avoid it for submodules/subpackages, because it ends up importing + # their parent package, which would cause an import leak during the analysis. + filename: str | None = None + if '.' not in package: + try: + import importlib.util + loader = importlib.util.find_spec(package).loader + filename = loader.get_filename(package) + # Apparently in the past, ``None`` could be returned for built-in ``datetime`` module. Just in case this + # is still possible, return only if filename is valid. + if filename: + return filename + except (ImportError, AttributeError, TypeError, ValueError): + pass + + # Second attempt: try to obtain module/package's __file__ attribute in an isolated subprocess. + @isolated.decorate + def _get_module_file_attribute(package): + # First, try to use 'importlib.util.find_spec' and obtain loader from the spec (and filename from the loader). + # This should return the filename even if the module or package cannot be imported (e.g., a C-extension module + # with missing dependencies). + try: + import importlib.util + loader = importlib.util.find_spec(package).loader + filename = loader.get_filename(package) + # Safe-guard against ``None`` being returned (see comment in the non-isolated codepath). + if filename: + return filename + except (ImportError, AttributeError, TypeError, ValueError): + pass + + # Fall back to import attempt + import importlib + p = importlib.import_module(package) + return p.__file__ + + # The old behavior was to return ImportError (and that is what the test are also expecting...). + try: + filename = _get_module_file_attribute(package) + except Exception as e: + raise ImportError(f"Failed to obtain the __file__ attribute of package/module {package}!") from e + + return filename + + +def get_pywin32_module_file_attribute(module_name): + """ + Get the absolute path of the PyWin32 DLL specific to the PyWin32 module with the passed name (`pythoncom` + or `pywintypes`). + + On import, each PyWin32 module: + + * Imports a DLL specific to that module. + * Overwrites the values of all module attributes with values specific to that DLL. This includes that module's + `__file__` attribute, which then provides the absolute path of that DLL. + + This function imports the module in isolated subprocess and retrieves its `__file__` attribute. + """ + + # NOTE: we cannot use `get_module_file_attribute` as it does not account for the __file__ rewriting magic + # done by the module. Use `get_module_attribute` instead. + return get_module_attribute(module_name, '__file__') + + +def check_requirement(requirement: str): + """ + Check if a :pep:`0508` requirement is satisfied. Usually used to check if a package distribution is installed, + or if it is installed and satisfies the specified version requirement. + + Parameters + ---------- + requirement : str + Requirement string in :pep:`0508` format. + + Returns + ---------- + bool + Boolean indicating whether the requirement is satisfied or not. + + Examples + -------- + + :: + + # Assume Pillow 10.0.0 is installed. + >>> from PyInstaller.utils.hooks import check_requirement + >>> check_requirement('Pillow') + True + >>> check_requirement('Pillow < 9.0') + False + >>> check_requirement('Pillow >= 9.0, < 11.0') + True + """ + parsed_requirement = packaging.requirements.Requirement(requirement) + + # Fetch the actual version of the specified dist + try: + version = importlib_metadata.version(parsed_requirement.name) + except importlib_metadata.PackageNotFoundError: + return False # Not available at all + + # If specifier is not given, the only requirement is that dist is available + if not parsed_requirement.specifier: + return True + + # Parse specifier, and compare version. Enable pre-release matching, + # because we need "package >= 2.0.0" to match "2.5.0b1". + return parsed_requirement.specifier.contains(version, prereleases=True) + + +# Keep the `is_module_satisfies` as an alias for backwards compatibility with existing hooks. The old fallback +# to module version check does not work any more, though. +def is_module_satisfies( + requirements: str, + version: None = None, + version_attr: None = None, +): + """ + A compatibility wrapper for :func:`check_requirement`, intended for backwards compatibility with existing hooks. + + In contrast to original implementation from PyInstaller < 6, this implementation only checks the specified + :pep:`0508` requirement string; i.e., it tries to retrieve the distribution metadata, and compare its version + against optional version specifier(s). It does not attempt to fall back to checking the module's version attribute, + nor does it support ``version`` and ``version_attr`` arguments. + + Parameters + ---------- + requirements : str + Requirements string passed to the :func:`check_requirement`. + version : None + Deprecated and unsupported. Must be ``None``. + version_attr : None + Deprecated and unsupported. Must be ``None``. + + Returns + ---------- + bool + Boolean indicating whether the requirement is satisfied or not. + + Raises + ---------- + ValueError + If either ``version`` or ``version_attr`` are specified and are not None. + """ + if version is not None: + raise ValueError("Calling is_module_satisfies with version argument is not supported anymore.") + if version_attr is not None: + raise ValueError("Calling is_module_satisfies with version argument_attr is not supported anymore.") + return check_requirement(requirements) + + +def is_package(module_name: str): + """ + Check if a Python module is really a module or is a package containing other modules, without importing anything + in the main process. + + :param module_name: Module name to check. + :return: True if module is a package else otherwise. + """ + def _is_package(module_name: str): + """ + Determines whether the given name represents a package or not. If the name represents a top-level module or + a package, it is not imported. If the name represents a sub-module or a sub-package, its parent is imported. + In such cases, this function should be called from an isolated suprocess. + + NOTE: the fallback check for `__init__.py` is there because `_distutils_hack.DistutilsMetaFinder` from + `setuptools` does not set spec.submodule_search_locations for `distutils` / `setuptools._distutils` even though + it is a package. The alternative would be to always perform full import, and check for the `__path__` attribute, + but that would also always require full isolation. + """ + try: + import importlib.util + spec = importlib.util.find_spec(module_name) + return bool(spec.submodule_search_locations) or spec.origin.endswith('__init__.py') + except Exception: + return False + + # For top-level packages/modules, we can perform check in the main process; otherwise, we need to isolate the + # call to prevent import leaks in the main process. + if '.' not in module_name: + return _is_package(module_name) + else: + return isolated.call(_is_package, module_name) + + +def get_all_package_paths(package: str): + """ + Given a package name, return all paths associated with the package. Typically, packages have a single location + path, but PEP 420 namespace packages may be split across multiple locations. Returns an empty list if the specified + package is not found or is not a package. + """ + def _get_package_paths(package: str): + """ + Retrieve package path(s), as advertised by submodule_search_paths attribute of the spec obtained via + importlib.util.find_spec(package). If the name represents a top-level package, the package is not imported. + If the name represents a sub-module or a sub-package, its parent is imported. In such cases, this function + should be called from an isolated suprocess. Returns an empty list if specified package is not found or is not + a package. + """ + try: + import importlib.util + spec = importlib.util.find_spec(package) + if not spec or not spec.submodule_search_locations: + return [] + return [str(path) for path in spec.submodule_search_locations] + except Exception: + return [] + + # For top-level packages/modules, we can perform check in the main process; otherwise, we need to isolate the + # call to prevent import leaks in the main process. + if '.' not in package: + pkg_paths = _get_package_paths(package) + else: + pkg_paths = isolated.call(_get_package_paths, package) + + return pkg_paths + + +def package_base_path(package_path: str, package: str): + """ + Given a package location path and package name, return the package base path, i.e., the directory in which the + top-level package is located. For example, given the path ``/abs/path/to/python/libs/pkg/subpkg`` and + package name ``pkg.subpkg``, the function returns ``/abs/path/to/python/libs``. + """ + return remove_suffix(package_path, package.replace('.', os.sep)) # Base directory + + +def get_package_paths(package: str): + """ + Given a package, return the path to packages stored on this machine and also returns the path to this particular + package. For example, if pkg.subpkg lives in /abs/path/to/python/libs, then this function returns + ``(/abs/path/to/python/libs, /abs/path/to/python/libs/pkg/subpkg)``. + + NOTE: due to backwards compatibility, this function returns only one package path along with its base directory. + In case of PEP 420 namespace package with multiple location, only first location is returned. To obtain all + package paths, use the ``get_all_package_paths`` function and obtain corresponding base directories using the + ``package_base_path`` helper. + """ + pkg_paths = get_all_package_paths(package) + if not pkg_paths: + raise ValueError(f"Package '{package}' does not exist or is not a package!") + + if len(pkg_paths) > 1: + logger.warning( + "get_package_paths - package %s has multiple paths (%r); returning only first one!", package, pkg_paths + ) + + pkg_dir = pkg_paths[0] + pkg_base = package_base_path(pkg_dir, package) + + return pkg_base, pkg_dir + + +def collect_submodules( + package: str, + filter: Callable[[str], bool] = lambda name: True, + on_error: str = "warn once", +): + """ + List all submodules of a given package. + + Arguments: + package: + An ``import``-able package. + filter: + Filter the submodules found: A callable that takes a submodule name and returns True if it should be + included. + on_error: + The action to take when a submodule fails to import. May be any of: + + - raise: Errors are reraised and terminate the build. + - warn: Errors are downgraded to warnings. + - warn once: The first error issues a warning but all + subsequent errors are ignored to minimise *stderr pollution*. This + is the default. + - ignore: Skip all errors. Don't warn about anything. + Returns: + All submodules to be assigned to ``hiddenimports`` in a hook. + + This function is intended to be used by hook scripts, not by main PyInstaller code. + + Examples:: + + # Collect all submodules of Sphinx don't contain the word ``test``. + hiddenimports = collect_submodules( + "Sphinx", ``filter=lambda name: 'test' not in name) + + .. versionchanged:: 4.5 + Add the **on_error** parameter. + + """ + # Accept only strings as packages. + if not isinstance(package, str): + raise TypeError('package must be a str') + if on_error not in ("ignore", "warn once", "warn", "raise"): + raise ValueError( + f"Invalid on-error action '{on_error}': Must be one of ('ignore', 'warn once', 'warn', 'raise')" + ) + + logger.debug('Collecting submodules for %s', package) + + # Skip a module which is not a package. + if not is_package(package): + logger.debug('collect_submodules - %s is not a package.', package) + # If module is importable, return its name in the list, in order to keep behavior consistent with the + # one we have for packages (i.e., we include the package in the list of returned names) + if can_import_module(package): + return [package] + return [] + + # Determine the filesystem path(s) to the specified package. + package_submodules = [] + + todo = deque() + todo.append(package) + + with isolated.Python() as isolated_python: + while todo: + # Scan the given (sub)package + name = todo.pop() + modules, subpackages, on_error = isolated_python.call(_collect_submodules, name, on_error) + + # Add modules to the list of all submodules + package_submodules += [module for module in modules if filter(module)] + + # Add sub-packages to deque for subsequent recursion + for subpackage_name in subpackages: + if filter(subpackage_name): + todo.append(subpackage_name) + + package_submodules = sorted(package_submodules) + + logger.debug("collect_submodules - found submodules: %s", package_submodules) + return package_submodules + + +# This function is called in an isolated sub-process via `isolated.Python.call`. +def _collect_submodules(name, on_error): + import sys + import pkgutil + from traceback import format_exception_only + + from PyInstaller.utils.hooks import logger + + logger.debug("collect_submodules - scanning (sub)package %s", name) + + modules = [] + subpackages = [] + + # Resolve package location(s) + try: + __import__(name) + except Exception as ex: + # Catch all errors and either raise, warn, or ignore them as determined by the *on_error* parameter. + if on_error in ("warn", "warn once"): + from PyInstaller.log import logger + ex = "".join(format_exception_only(type(ex), ex)).strip() + logger.warning(f"Failed to collect submodules for '{name}' because importing '{name}' raised: {ex}") + if on_error == "warn once": + on_error = "ignore" + return modules, subpackages, on_error + elif on_error == "raise": + raise ImportError(f"Unable to load subpackage '{name}'.") from ex + + # Do not attempt to recurse into package if it did not make it into sys.modules. + if name not in sys.modules: + return modules, subpackages, on_error + + # Or if it does not have __path__ attribute. + paths = getattr(sys.modules[name], '__path__', None) or [] + if not paths: + return modules, subpackages, on_error + + # Package was successfully imported - include it in the list of modules. + modules.append(name) + + # Iterate package contents + logger.debug("collect_submodules - scanning (sub)package %s in location(s): %s", name, paths) + for importer, name, ispkg in pkgutil.iter_modules(paths, name + '.'): + if not ispkg: + modules.append(name) + else: + subpackages.append(name) + + return modules, subpackages, on_error + + +def is_module_or_submodule(name: str, mod_or_submod: str): + """ + This helper function is designed for use in the ``filter`` argument of :func:`collect_submodules`, by returning + ``True`` if the given ``name`` is a module or a submodule of ``mod_or_submod``. + + Examples: + + The following excludes ``foo.test`` and ``foo.test.one`` but not ``foo.testifier``. :: + + collect_submodules('foo', lambda name: not is_module_or_submodule(name, 'foo.test'))`` + """ + return name.startswith(mod_or_submod + '.') or name == mod_or_submod + + +# Patterns of dynamic library filenames that might be bundled with some installed Python packages. +PY_DYLIB_PATTERNS = [ + '*.dll', + '*.dylib', + 'lib*.so', +] + + +def collect_dynamic_libs(package: str, destdir: str | None = None, search_patterns: list = PY_DYLIB_PATTERNS): + """ + This function produces a list of (source, dest) of dynamic library files that reside in package. Its output can be + directly assigned to ``binaries`` in a hook script. The package parameter must be a string which names the package. + + :param destdir: Relative path to ./dist/APPNAME where the libraries should be put. + :param search_patterns: List of dynamic library filename patterns to collect. + """ + logger.debug('Collecting dynamic libraries for %s' % package) + + # Accept only strings as packages. + if not isinstance(package, str): + raise TypeError('package must be a str') + + # Skip a module which is not a package. + if not is_package(package): + logger.warning( + "collect_dynamic_libs - skipping library collection for module '%s' as it is not a package.", package + ) + return [] + + pkg_dirs = get_all_package_paths(package) + dylibs = [] + for pkg_dir in pkg_dirs: + pkg_base = package_base_path(pkg_dir, package) + # Recursively glob for all file patterns in the package directory + for pattern in search_patterns: + files = Path(pkg_dir).rglob(pattern) + for source in files: + # Produce the tuple ('/abs/path/to/source/mod/submod/file.pyd', 'mod/submod') + if destdir: + # Put libraries in the specified target directory. + dest = destdir + else: + # Preserve original directory hierarchy. + dest = source.parent.relative_to(pkg_base) + logger.debug(' %s, %s' % (source, dest)) + dylibs.append((str(source), str(dest))) + + return dylibs + + +def collect_data_files( + package: str, + include_py_files: bool = False, + subdir: str | os.PathLike | None = None, + excludes: list | None = None, + includes: list | None = None, +): + r""" + This function produces a list of ``(source, dest)`` entries for data files that reside in ``package``. + Its output can be directly assigned to ``datas`` in a hook script; for example, see ``hook-sphinx.py``. + The data files are all files that are not shared libraries / binary python extensions (based on extension + check) and are not python source (.py) files or byte-compiled modules (.pyc). Collection of the .py and .pyc + files can be toggled via the ``include_py_files`` flag. + Parameters: + + - The ``package`` parameter is a string which names the package. + - By default, python source files and byte-compiled modules (files with ``.py`` and ``.pyc`` suffix) are not + collected; setting the ``include_py_files`` argument to ``True`` collects these files as well. This is typically + used when a package requires source .py files to be available; for example, JIT compilation used in + deep-learning frameworks, code that requires access to .py files (for example, to check their date), or code + that tries to extend `sys.path` with subpackage paths in a way that is incompatible with PyInstaller's frozen + importer.. However, in contemporary PyInstaller versions, the preferred way of collecting source .py files is by + using the **module collection mode** setting (which enables collection of source .py files in addition to or + in lieu of collecting byte-compiled modules into PYZ archive). + - The ``subdir`` argument gives a subdirectory relative to ``package`` to search, which is helpful when submodules + are imported at run-time from a directory lacking ``__init__.py``. + - The ``excludes`` argument contains a sequence of strings or Paths. These provide a list of + `globs `_ + to exclude from the collected data files; if a directory matches the provided glob, all files it contains will + be excluded as well. All elements must be relative paths, which are relative to the provided package's path + (/ ``subdir`` if provided). + + Therefore, ``*.txt`` will exclude only ``.txt`` files in ``package``\ 's path, while ``**/*.txt`` will exclude + all ``.txt`` files in ``package``\ 's path and all its subdirectories. Likewise, ``**/__pycache__`` will exclude + all files contained in any subdirectory named ``__pycache__``. + - The ``includes`` function like ``excludes``, but only include matching paths. ``excludes`` override + ``includes``: a file or directory in both lists will be excluded. + + This function does not work on zipped Python eggs. + + This function is intended to be used by hook scripts, not by main PyInstaller code. + """ + logger.debug('Collecting data files for %s' % package) + + # Accept only strings as packages. + if not isinstance(package, str): + raise TypeError('package must be a str') + + # Skip a module which is not a package. + if not is_package(package): + logger.warning("collect_data_files - skipping data collection for module '%s' as it is not a package.", package) + return [] + + # Make sure the excludes are a list; this also makes a copy, so we don't modify the original. + excludes = list(excludes) if excludes else [] + # These excludes may contain directories which need to be searched. + excludes_len = len(excludes) + # Including py files means don't exclude them. This pattern will search any directories for containing files, so + # do not modify ``excludes_len``. + if not include_py_files: + excludes += ['**/*' + s for s in compat.ALL_SUFFIXES] + else: + # include_py_files should collect only .py and .pyc files, and not the extensions / shared libs. + excludes += ['**/*' + s for s in compat.ALL_SUFFIXES if s not in {'.py', '.pyc'}] + + # Never, ever, collect .pyc files from __pycache__. + excludes.append('**/__pycache__/*.pyc') + + # If not specified, include all files. Follow the same process as the excludes. + includes = list(includes) if includes else ["**/*"] + includes_len = len(includes) + + # A helper function to glob the in/ex "cludes", adding a wildcard to refer to all files under a subdirectory if a + # subdirectory is matched by the first ``clude_len`` patterns. Otherwise, it in/excludes the matched file. + # **This modifies** ``cludes``. + def clude_walker( + # Package directory to scan + pkg_dir, + # A list of paths relative to ``pkg_dir`` to in/exclude. + cludes, + # The number of ``cludes`` for which matching directories should be searched for all files under them. + clude_len, + # True if the list is includes, False for excludes. + is_include + ): + for i, c in enumerate(cludes): + for g in Path(pkg_dir).glob(c): + if g.is_dir(): + # Only files are sources. Subdirectories are not. + if i < clude_len: + # In/exclude all files under a matching subdirectory. + cludes.append(str((g / "**/*").relative_to(pkg_dir))) + else: + # In/exclude a matching file. + sources.add(g) if is_include else sources.discard(g) + + # Obtain all paths for the specified package, and process each path independently. + datas = [] + + pkg_dirs = get_all_package_paths(package) + for pkg_dir in pkg_dirs: + sources = set() # Reset sources set + + pkg_base = package_base_path(pkg_dir, package) + if subdir: + pkg_dir = os.path.join(pkg_dir, subdir) + + # Process the package path with clude walker + clude_walker(pkg_dir, includes, includes_len, True) + clude_walker(pkg_dir, excludes, excludes_len, False) + + # Transform the sources into tuples for ``datas``. + datas += [(str(s), str(s.parent.relative_to(pkg_base))) for s in sources] + + logger.debug("collect_data_files - Found files: %s", datas) + return datas + + +def collect_system_data_files(path: str, destdir: str | os.PathLike | None = None, include_py_files: bool = False): + """ + This function produces a list of (source, dest) non-Python (i.e., data) files that reside somewhere on the system. + Its output can be directly assigned to ``datas`` in a hook script. + + This function is intended to be used by hook scripts, not by main PyInstaller code. + """ + # Accept only strings as paths. + if not isinstance(path, str): + raise TypeError('path must be a str') + + # Walk through all file in the given package, looking for data files. + datas = [] + for dirpath, dirnames, files in os.walk(path): + for f in files: + extension = os.path.splitext(f)[1] + if include_py_files or (extension not in PY_IGNORE_EXTENSIONS): + # Produce the tuple: (/abs/path/to/source/mod/submod/file.dat, mod/submod/destdir) + source = os.path.join(dirpath, f) + dest = str(Path(dirpath).relative_to(path)) + if destdir is not None: + dest = os.path.join(destdir, dest) + datas.append((source, dest)) + + return datas + + +def copy_metadata(package_name: str, recursive: bool = False): + """ + Collect distribution metadata so that ``importlib.metadata.distribution()`` or ``pkg_resources.get_distribution()`` + can find it. + + This function returns a list to be assigned to the ``datas`` global variable. This list instructs PyInstaller to + copy the metadata for the given package to the frozen application's data directory. + + Parameters + ---------- + package_name : str + Specifies the name of the package for which metadata should be copied. + recursive : bool + If true, collect metadata for the package's dependencies too. This enables use of + ``importlib.metadata.requires('package')`` or ``pkg_resources.require('package')`` inside the frozen + application. + + Returns + ------- + list + This should be assigned to ``datas``. + + Examples + -------- + >>> from PyInstaller.utils.hooks import copy_metadata + >>> copy_metadata('sphinx') + [('c:\\python27\\lib\\site-packages\\Sphinx-1.3.2.dist-info', + 'Sphinx-1.3.2.dist-info')] + + + Some packages rely on metadata files accessed through the ``importlib.metadata`` (or the now-deprecated + ``pkg_resources``) module. PyInstaller does not collect these metadata files by default. + If a package fails without the metadata (either its own, or of another package that it depends on), you can use this + function in a hook to collect the corresponding metadata files into the frozen application. The tuples in the + returned list contain two strings. The first is the full path to the package's metadata directory on the system. The + second is the destination name, which typically corresponds to the basename of the metadata directory. Adding these + tuples the the ``datas`` hook global variable, the metadata is collected into top-level application directory (where + it is usually searched for). + + .. versionchanged:: 4.3.1 + + Prevent ``dist-info`` metadata folders being renamed to ``egg-info`` which broke ``pkg_resources.require`` with + *extras* (see :issue:`#3033`). + + .. versionchanged:: 4.4.0 + + Add the **recursive** option. + """ + from collections import deque + + todo = deque([package_name]) + done = set() + out = [] + + while todo: + package_name = todo.pop() + if package_name in done: + continue + + dist = importlib_metadata.distribution(package_name) + + # We support only `importlib_metadata.PathDistribution`, since we need to rely on its private `_path` attribute + # to obtain the path to metadata file/directory. But we need to account for possible sub-classes and vendored + # variants (`setuptools._vendor.importlib_metadata.PathDistribution`), so just check that `_path` is available. + if not hasattr(dist, '_path'): + raise RuntimeError( + f"Unsupported distribution type {type(dist)} for {package_name} - does not have _path attribute" + ) + src_path = dist._path + + # We expect the `_path` attribute to be an instance of `pathlib.Path`. This assumption is violated when the + # package happens to be installed as a zipped egg. In such case, `_path` is an instance of either `zipp.Path` + # (when using `importlib.metadata` from `importlib-metadata`, which in turn uses 3rd party `zipp` package) or + # `zipfile.Path` (when using stdlib's `importlib.metadata`). While we could attempt to read the metadata + # from the zip, we dropped geberal support for zipped eggs from PyInstaller in 6.0, so raise an error. + if not isinstance(src_path, Path): + # NOTE: `src_path.parent` is also an instance of `zipfile.Path` or `zipp.Path`, and calling its `is_file()` + # method returns False, because the root of zip file is (rightfully) considered a directory. Therefore, we + # convert the path to `pathlib.Path` by taking the parent of `src_path.parent` (which turns out to be a + # `pathlib.Path`) and add to it the name of the `src_path.parent` (the name of .egg file). + try: + src_parent = src_path.parent.parent / src_path.parent.name + except Exception: + src_parent = src_path.parent + + if src_parent.is_file() and src_parent.name.endswith('.egg'): + raise RuntimeError( + f"Cannot collect metadata from path {str(src_path)!r}, which appears to be inside a zipped egg. " + f"PyInstaller >= 6.0 does not support zipped eggs anymore. Please reinstall {package_name!r} " + "using modern package installation method instead of deprecated 'python setup.py install'. " + "For example, if you are using pip package manager:\n" + "1. uninstall the zipped egg:\n" + f" pip uninstall {package_name}\n" + "2. make sure pip and its dependencies are up-to-date:\n" + " python -m pip install --upgrade pip setuptools\n" + "3. install the package:\n" + f" pip install {package_name}\n" + "To install a package from source, pass the path to the source directory to 'pip install' command." + ) + else: + # Generic message for unforeseen cases. + raise RuntimeError( + f"Cannot collect metadata from path {src_path!r}, which is of unsupported type {type(src_path)}." + ) + + if src_path.is_dir(): + # The metadata is stored in a directory (.egg-info, .dist-info), so collect the whole directory. If the + # package is installed as an egg, the metadata directory is ([...]/package_name-version.egg/EGG-INFO), + # and requires special handling (as of PyInstaller v6, we support only non-zipped eggs). + if src_path.name == 'EGG-INFO' and src_path.parent.name.endswith('.egg'): + dest_path = os.path.join(*src_path.parts[-2:]) + else: + dest_path = src_path.name + elif src_path.is_file(): + # The metadata is stored in a single file. Collect it into top-level application directory. + # The .egg-info file is commonly used by Debian/Ubuntu when packaging python packages. + dest_path = '.' + else: + raise RuntimeError( + f"Distribution metadata path {src_path!r} for {package_name} is neither file nor directory!" + ) + + # Hack for metadata from packages vendored by setuptools >= 71. If source path is rooted in setuptools/_vendor, + # prepend the same to the destination path and avoid collecting into top-level directory. + if src_path.parent.name == '_vendor' and src_path.parent.parent.name == 'setuptools': + dest_path = os.path.join('setuptools', '_vendor', dest_path) + + out.append((str(src_path), str(dest_path))) + + if not recursive: + return out + done.add(package_name) + + # Process requirements; `importlib.metadata` has no API for parsing requirements, so we need to use + # `packaging.requirements`. This is necessary to discard requirements with markers that do not match the + # environment (e.g., `python_version`, `sys_platform`). + requirements = [packaging.requirements.Requirement(req) for req in dist.requires or []] + requirements = [req.name for req in requirements if req.marker is None or req.marker.evaluate()] + + todo += requirements + + return out + + +def get_installer(dist_name: str): + """ + Try to find which package manager installed the specified distribution (e.g., pip, conda, rpm) by reading INSTALLER + file from distribution's metadata. + + If the specified distribution does not exist, fall back to treating the passed name as importable package/module + name, and attempt to look up its associated distribution name; this matches the behavior of implementation found + in older PyInstaller versions (<= v6.12.0). + + :param dist_name: Name of distribution to look up + :return: Name of package manager or None + + .. versionchanged:: 6.13 + The passed name is now first treated as a distribution name (direct look-up), and only if that fails, it is + treated as importable package/module name. + """ + + # First, perform direct look-up via the passed name, treating it as distribution name. + try: + dist = importlib_metadata.distribution(dist_name) + installer_text = dist.read_text('INSTALLER') + if installer_text is not None: + return installer_text.strip() + else: + # Distribution exists, but does not have an INSTALLER file; stop the search here. + return None + except importlib_metadata.PackageNotFoundError: + pass + + # Fall back to treating the passed name as importable package/module name, and try to resolve its associated + # distribution name (e.g., enchant -> pyenchant). This requires distributions to explicitly list their top-level + # importable names in `top_level.txt` file in metadata, or `importlib.metadata` that can inferring top-level + # importable names (available in stdlib for python >= 3.11, or in importlib-metadata >= 4.8.1). + module_name = dist_name + pkg_to_dist = importlib_metadata.packages_distributions() + dist_names = pkg_to_dist.get(module_name) + + # A namespace package might result in multiple dists; take the first one that has INSTALLER file available... + for dist_name in dist_names or []: + try: + dist = importlib_metadata.distribution(dist_name) + installer_text = dist.read_text('INSTALLER') + if installer_text is not None: + return installer_text.strip() + except importlib_metadata.PackageNotFoundError: + # This might happen with eggs if the egg directory name does not match the dist name declared in the + # metadata. + pass + + return None + + +def collect_all( + package_name: str, + include_py_files: bool = True, + filter_submodules: Callable = lambda name: True, + exclude_datas: list | None = None, + include_datas: list | None = None, + on_error: str = "warn once", +): + """ + Collect everything for a given package name. + + Arguments: + package_name: + An ``import``-able package name. + include_py_files: + Forwarded to :func:`collect_data_files`. + filter_submodules: + Forwarded to :func:`collect_submodules`. + exclude_datas: + Forwarded to :func:`collect_data_files`. + include_datas: + Forwarded to :func:`collect_data_files`. + on_error: + Forwarded onto :func:`collect_submodules`. + + Returns: + tuple: A ``(datas, binaries, hiddenimports)`` triplet containing: + + - All data files, raw Python files (if **include_py_files**), and distribution metadata directories (if + applicable). + - All dynamic libraries as returned by :func:`collect_dynamic_libs`. + - All submodules of **package_name**. + + Typical use:: + + datas, binaries, hiddenimports = collect_all('my_package_name') + """ + datas = collect_data_files(package_name, include_py_files, excludes=exclude_datas, includes=include_datas) + binaries = collect_dynamic_libs(package_name) + hiddenimports = collect_submodules(package_name, on_error=on_error, filter=filter_submodules) + + # `copy_metadata` requires a dist name instead of importable/package name. + # A namespace package might belong to multiple distributions, so process all of them. + pkg_to_dist = importlib_metadata.packages_distributions() + dist_names = set(pkg_to_dist.get(package_name, [])) + for dist_name in dist_names: + # Copy metadata + try: + datas += copy_metadata(dist_name) + except Exception: + pass + + return datas, binaries, hiddenimports + + +def collect_entry_point(name: str): + """ + Collect modules and metadata for all exporters of a given entry point. + + Args: + name: + The name of the entry point. Check the documentation for the library that uses the entry point to find + its name. + Returns: + A ``(datas, hiddenimports)`` pair that should be assigned to the ``datas`` and ``hiddenimports``, respectively. + + For libraries, such as ``pytest`` or ``keyring``, that rely on plugins to extend their behaviour. + + Examples: + Pytest uses an entry point called ``'pytest11'`` for its extensions. + To collect all those extensions use:: + + datas, hiddenimports = collect_entry_point("pytest11") + + These values may be used in a hook or added to the ``datas`` and ``hiddenimports`` arguments in the ``.spec`` + file. See :ref:`using spec files`. + + .. versionadded:: 4.3 + """ + datas = [] + imports = [] + for entry_point in importlib_metadata.entry_points(group=name): + datas += copy_metadata(entry_point.dist.name) + imports.append(entry_point.module) + return datas, imports + + +def get_hook_config(hook_api: PostGraphAPI, module_name: str, key: str): + """ + Get user settings for hooks. + + Args: + module_name: + The module/package for which the key setting belong to. + key: + A key for the config. + Returns: + The value for the config. ``None`` if not set. + + The ``get_hook_config`` function will lookup settings in the ``Analysis.hooksconfig`` dict. + + The hook settings can be added to ``.spec`` file in the form of:: + + a = Analysis(["my-app.py"], + ... + hooksconfig = { + "gi": { + "icons": ["Adwaita"], + "themes": ["Adwaita"], + "languages": ["en_GB", "zh_CN"], + }, + }, + ... + ) + """ + config = hook_api.analysis.hooksconfig + value = None + if module_name in config and key in config[module_name]: + value = config[module_name][key] + return value + + +def include_or_exclude_file( + filename: str, + include_list: list | None = None, + exclude_list: list | None = None, +): + """ + Generic inclusion/exclusion decision function based on filename and list of include and exclude patterns. + + Args: + filename: + Filename considered for inclusion. + include_list: + List of inclusion file patterns. + exclude_list: + List of exclusion file patterns. + + Returns: + A boolean indicating whether the file should be included or not. + + If ``include_list`` is provided, True is returned only if the filename matches one of include patterns (and does not + match any patterns in ``exclude_list``, if provided). If ``include_list`` is not provided, True is returned if + filename does not match any patterns in ``exclude list``, if provided. If neither list is provided, True is + returned for any filename. + """ + if include_list is not None: + for pattern in include_list: + if fnmatch.fnmatch(filename, pattern): + break + else: + return False # Not explicitly included; exclude + + if exclude_list is not None: + for pattern in exclude_list: + if fnmatch.fnmatch(filename, pattern): + return False # Explicitly excluded + + return True + + +def collect_delvewheel_libs_directory(package_name, libdir_name=None, datas=None, binaries=None): + """ + Collect data files and binaries from the .libs directory of a delvewheel-enabled python wheel. Such wheels ship + their shared libraries in a .libs directory that is located next to the package directory, and therefore falls + outside the purview of the collect_dynamic_libs() utility function. + + Args: + package_name: + Name of the package (e.g., scipy). + libdir_name: + Optional name of the .libs directory (e.g., scipy.libs). If not provided, ".libs" is added to + ``package_name``. + datas: + Optional list of datas to which collected data file entries are added. The combined result is retuned + as part of the output tuple. + binaries: + Optional list of binaries to which collected binaries entries are added. The combined result is retuned + as part of the output tuple. + + Returns: + tuple: A ``(datas, binaries)`` pair that should be assigned to the ``datas`` and ``binaries``, respectively. + + Examples: + Collect the ``scipy.libs`` delvewheel directory belonging to the Windows ``scipy`` wheel:: + + datas, binaries = collect_delvewheel_libs_directory("scipy") + + When the collected entries should be added to existing ``datas`` and ``binaries`` listst, the following form + can be used to avoid using intermediate temporary variables and merging those into existing lists:: + + datas, binaries = collect_delvewheel_libs_directory("scipy", datas=datas, binaries=binaries) + + .. versionadded:: 5.6 + """ + + datas = datas or [] + binaries = binaries or [] + + if libdir_name is None: + libdir_name = package_name + '.libs' + + # delvewheel is applicable only to Windows wheels + if not compat.is_win: + return datas, binaries + + # Get package's parent path + pkg_base, pkg_dir = get_package_paths(package_name) + pkg_base = Path(pkg_base) + libs_dir = pkg_base / libdir_name + + if not libs_dir.is_dir(): + return datas, binaries + + # Collect all dynamic libs - collect them as binaries in order to facilitate proper binary dependency analysis + # (for example, to ensure that system-installed VC runtime DLLs are collected, if needed). + # As of PyInstaller 5.4, this should be safe (should not result in duplication), because binary dependency + # analysis attempts to preserve the DLL directory structure. + binaries += [(str(dll_file), str(dll_file.parent.relative_to(pkg_base))) for dll_file in libs_dir.glob('*.dll')] + + # Collect the .load-order file; strictly speaking, this should be necessary only under python < 3.8, but let us + # collect it for completeness sake. Differently named variants have been observed: `.load_order`, `.load-order`, + # and `.load-order-Name`. + datas += [(str(load_order_file), str(load_order_file.parent.relative_to(pkg_base))) + for load_order_file in libs_dir.glob('.load[-_]order*')] + + return datas, binaries + + +if compat.is_pure_conda: + from PyInstaller.utils.hooks import conda as conda_support # noqa: F401 +elif compat.is_conda: + from PyInstaller.utils.hooks.conda import CONDA_META_DIR as _tmp + logger.warning( + "Assuming this is not an Anaconda environment or an additional venv/pipenv/... environment manager is being " + "used on top, because the conda-meta folder %s does not exist.", _tmp + ) + del _tmp diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/conda.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/conda.py new file mode 100755 index 0000000..8848f43 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/conda.py @@ -0,0 +1,401 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# language=rst +""" +Additional helper methods for working specifically with Anaconda distributions are found at +:mod:`PyInstaller.utils.hooks.conda_support` +which is designed to mimic (albeit loosely) the `importlib.metadata`_ package. These functions find and parse the +distribution metadata from json files located in the ``conda-meta`` directory. + +.. versionadded:: 4.2.0 + +This module is available only if run inside a Conda environment. Usage of this module should therefore be wrapped in +a conditional clause:: + + from PyInstaller.compat import is_pure_conda + + if is_pure_conda: + from PyInstaller.utils.hooks import conda_support + + # Code goes here. e.g. + binaries = conda_support.collect_dynamic_libs("numpy") + ... + +Packages are all referenced by the *distribution name* you use to install it, rather than the *package name* you import +it with. I.e., use ``distribution("pillow")`` instead of ``distribution("PIL")`` or use ``package_distribution("PIL")``. +""" +from __future__ import annotations + +import fnmatch +import json +import pathlib +import sys +from typing import Iterable, List +from importlib.metadata import PackagePath as _PackagePath + +from PyInstaller import compat +from PyInstaller.log import logger + +# Conda virtual environments each get their own copy of `conda-meta` so the use of `sys.prefix` instead of +# `sys.base_prefix`, `sys.real_prefix` or anything from our `compat` module is intentional. +CONDA_ROOT = pathlib.Path(sys.prefix) +CONDA_META_DIR = CONDA_ROOT / "conda-meta" + +# Find all paths in `sys.path` that are inside Conda root. +PYTHONPATH_PREFIXES = [] +for _path in sys.path: + _path = pathlib.Path(_path) + try: + PYTHONPATH_PREFIXES.append(_path.relative_to(sys.prefix)) + except ValueError: + pass + +PYTHONPATH_PREFIXES.sort(key=lambda p: len(p.parts), reverse=True) + + +class Distribution: + """ + A bucket class representation of a Conda distribution. + + This bucket exports the following attributes: + + :ivar name: The distribution's name. + :ivar version: Its version. + :ivar files: All filenames as :meth:`PackagePath`\\ s included with this distribution. + :ivar dependencies: Names of other distributions that this distribution depends on (with version constraints + removed). + :ivar packages: Names of importable packages included in this distribution. + + This class is not intended to be constructed directly by users. Rather use :meth:`distribution` or + :meth:`package_distribution` to provide one for you. + """ + def __init__(self, json_path: str): + try: + self._json_path = pathlib.Path(json_path) + assert self._json_path.exists() + except (TypeError, AssertionError): + raise TypeError( + "Distribution requires a path to a conda-meta json. Perhaps you want " + "`distribution({})` instead?".format(repr(json_path)) + ) + + # Everything we need (including this distribution's name) is kept in the metadata json. + self.raw: dict = json.loads(self._json_path.read_text()) + + # Unpack the more useful contents of the json. + self.name: str = self.raw["name"] + self.version: str = self.raw["version"] + self.files = [PackagePath(i) for i in self.raw["files"]] + self.dependencies = self._init_dependencies() + self.packages = self._init_package_names() + + def __repr__(self): + return "{}(name=\"{}\", packages={})".format(type(self).__name__, self.name, self.packages) + + def _init_dependencies(self): + """ + Read dependencies from ``self.raw["depends"]``. + + :return: Dependent distribution names. + :rtype: list + + The names in ``self.raw["depends"]`` come with extra version constraint information which must be stripped. + """ + dependencies = [] + # For each dependency: + for dependency in self.raw["depends"]: + # ``dependency`` is a string of the form: "[name] [version constraints]" + name, *version_constraints = dependency.split(maxsplit=1) + dependencies.append(name) + return dependencies + + def _init_package_names(self): + """ + Search ``self.files`` for package names shipped by this distribution. + + :return: Package names. + :rtype: list + + These are names you would ``import`` rather than names you would install. + """ + packages = [] + for file in self.files: + package = _get_package_name(file) + if package is not None: + packages.append(package) + return packages + + @classmethod + def from_name(cls, name: str): + """ + Get distribution information for a given distribution **name** (i.e., something you would ``conda install``). + + :rtype: :class:`Distribution` + """ + if name in distributions: + return distributions[name] + raise ModuleNotFoundError( + "Distribution {} is either not installed or was not installed using Conda.".format(name) + ) + + @classmethod + def from_package_name(cls, name: str): + """ + Get distribution information for a **package** (i.e., something you would import). + + :rtype: :class:`Distribution` + + For example, the package ``pkg_resources`` belongs to the distribution ``setuptools``, which contains three + packages. + + >>> package_distribution("pkg_resources") + Distribution(name="setuptools", + packages=['easy_install', 'pkg_resources', 'setuptools']) + """ + if name in distributions_by_package: + return distributions_by_package[name] + raise ModuleNotFoundError("Package {} is either not installed or was not installed using Conda.".format(name)) + + +distribution = Distribution.from_name +package_distribution = Distribution.from_package_name + + +class PackagePath(_PackagePath): + """ + A filename relative to Conda's root (``sys.prefix``). + + This class inherits from :class:`pathlib.PurePosixPath` even on non-Posix OSs. To convert to a :class:`pathlib.Path` + pointing to the real file, use the :meth:`locate` method. + """ + def locate(self): + """ + Return a path-like object for this path pointing to the file's true location. + """ + return pathlib.Path(sys.prefix) / self + + +def walk_dependency_tree(initial: str, excludes: Iterable[str] | None = None): + """ + Collect a :class:`Distribution` and all direct and indirect dependencies of that distribution. + + Arguments: + initial: + Distribution name to collect from. + excludes: + Distributions to exclude. + Returns: + A ``{name: distribution}`` mapping where ``distribution`` is the output of + :func:`conda_support.distribution(name) `. + """ + if excludes is not None: + excludes = set(excludes) + + # Rather than use true recursion, mimic it with a to-do queue. + from collections import deque + done = {} + names_to_do = deque([initial]) + + while names_to_do: + # Grab a distribution name from the to-do list. + name = names_to_do.pop() + try: + # Collect and save it's metadata. + done[name] = distribution = Distribution.from_name(name) + logger.debug("Collected Conda distribution '%s', a dependency of '%s'.", name, initial) + except ModuleNotFoundError: + logger.warning( + "Conda distribution '%s', dependency of '%s', was not found. " + "If you installed this distribution with pip then you may ignore this warning.", name, initial + ) + continue + # For each dependency: + for _name in distribution.dependencies: + if _name in done: + # Skip anything already done. + continue + if _name == name: + # Avoid infinite recursion if a distribution depends on itself. This will probably never happen but I + # certainly would not chance it. + continue + if excludes is not None and _name in excludes: + # Do not recurse to excluded dependencies. + continue + names_to_do.append(_name) + return done + + +def _iter_distributions(name, dependencies, excludes): + if dependencies: + return walk_dependency_tree(name, excludes).values() + else: + return [Distribution.from_name(name)] + + +def requires(name: str, strip_versions: bool = False) -> List[str]: + """ + List requirements of a distribution. + + Arguments: + name: + The name of the distribution. + strip_versions: + List only their names, not their version constraints. + Returns: + A list of distribution names. + """ + if strip_versions: + return distribution(name).dependencies + return distribution(name).raw["depends"] + + +def files(name: str, dependencies: bool = False, excludes: list | None = None) -> List[PackagePath]: + """ + List all files belonging to a distribution. + + Arguments: + name: + The name of the distribution. + dependencies: + Recursively collect files of dependencies too. + excludes: + Distributions to ignore if **dependencies** is true. + Returns: + All filenames belonging to the given distribution. + + With ``dependencies=False``, this is just a shortcut for:: + + conda_support.distribution(name).files + """ + return [file for dist in _iter_distributions(name, dependencies, excludes) for file in dist.files] + + +if compat.is_win: + lib_dir = pathlib.PurePath("Library", "bin") +else: + lib_dir = pathlib.PurePath("lib") + + +def collect_dynamic_libs(name: str, dest: str = ".", dependencies: bool = True, excludes: Iterable[str] | None = None): + """ + Collect DLLs for distribution **name**. + + Arguments: + name: + The distribution's project-name. + dest: + Target destination, defaults to ``'.'``. + dependencies: + Recursively collect libs for dependent distributions (recommended). + excludes: + Dependent distributions to skip, defaults to ``None``. + Returns: + List of DLLs in PyInstaller's ``(source, dest)`` format. + + This collects libraries only from Conda's shared ``lib`` (Unix) or ``Library/bin`` (Windows) folders. To collect + from inside a distribution's installation use the regular :func:`PyInstaller.utils.hooks.collect_dynamic_libs`. + """ + DLL_SUFFIXES = ("*.dll", "*.dylib", "*.so", "*.so.*") + _files = [] + for file in files(name, dependencies, excludes): + # A file is classified as a dynamic library if: + # 1) it lives inside the dedicated ``lib_dir`` DLL folder. + # + # NOTE: `file` is an instance of `PackagePath`, which inherits from `pathlib.PurePosixPath` even on Windows. + # Therefore, it does not properly handle cases when metadata paths contain Windows-style separator, which does + # seem to be used on some Windows installations (see #9113). Therefore, cast `file` to `pathlib.PurePath` + # before comparing its parent to `lib_dir` (which should also be a `pathlib.PurePath`). + if pathlib.PurePath(file).parent != lib_dir: + continue + # 2) it is a file (and not a directory or a symbolic link pointing to a directory) + resolved_file = file.locate() + if not resolved_file.is_file(): + continue + # 3) has a correct suffix + if not any([resolved_file.match(suffix) for suffix in DLL_SUFFIXES]): + continue + + _files.append((str(resolved_file), dest)) + return _files + + +# --- Map packages to distributions and vice-versa --- + + +def _get_package_name(file: PackagePath): + """ + Determine the package name of a Python file in :data:`sys.path`. + + Arguments: + file: + A Python filename relative to Conda root (sys.prefix). + Returns: + Package name or None. + + This function only considers single file packages e.g. ``foo.py`` or top level ``foo/__init__.py``\\ s. + Anything else is ignored (returning ``None``). + """ + file = pathlib.Path(file) + # TODO: Handle PEP 420 namespace packages (which are missing `__init__` module). No such Conda PEP 420 namespace + # packages are known. + + # Get top-level folders by finding parents of `__init__.xyz`s + if file.stem == "__init__" and file.suffix in compat.ALL_SUFFIXES: + file = file.parent + elif file.suffix not in compat.ALL_SUFFIXES: + # Keep single-file packages but skip DLLs, data and junk files. + return + + # Check if this file/folder's parent is in ``sys.path`` i.e. it's directly importable. This intentionally excludes + # submodules which would cause confusion because ``sys.prefix`` is in ``sys.path``, meaning that every file in an + # Conda installation is a submodule. + for prefix in PYTHONPATH_PREFIXES: + if len(file.parts) != len(prefix.parts) + 1: + # This check is redundant but speeds it up quite a bit. + continue + # There are no wildcards involved here. The use of ``fnmatch`` is simply to handle the `if case-insensitive + # file system: use case-insensitive string matching.` + if fnmatch.fnmatch(str(file.parent), str(prefix)): + return file.stem + + +# All the information we want is organised the wrong way. + +# We want to look up distribution based on package names, but we can only search for packages using distribution names. +# And we would like to search for a distribution's json file, but, due to the noisy filenames of the jsons, we can only +# find a json's distribution rather than a distribution's json. + +# So we have to read everything, then regroup distributions in the ways we want them grouped. This will likely be a +# spectacular bottleneck on full-blown Conda (non miniconda) with 250+ packages by default at several GiBs. I suppose we +# could cache this on a per-json basis if it gets too much. + + +def _init_distributions(): + distributions = {} + for path in CONDA_META_DIR.glob("*.json"): + dist = Distribution(path) + distributions[dist.name] = dist + return distributions + + +distributions = _init_distributions() + + +def _init_packages(): + distributions_by_package = {} + for distribution in distributions.values(): + for package in distribution.packages: + distributions_by_package[package] = distribution + return distributions_by_package + + +distributions_by_package = _init_packages() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/django.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/django.py new file mode 100755 index 0000000..5b8bdae --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/django.py @@ -0,0 +1,152 @@ +# ---------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +# ---------------------------------------------------------------------------- +import os + +from PyInstaller import isolated + + +@isolated.decorate +def django_dottedstring_imports(django_root_dir): + """ + An isolated helper that returns list of all Django dependencies, parsed from the `mysite.settings` module. + + NOTE: With newer version of Django this is most likely the part of PyInstaller that will be broken. + + Tested with Django 2.2 + """ + + import sys + import os + + import PyInstaller.utils.misc + from PyInstaller.utils import hooks as hookutils + + # Extra search paths to add to sys.path: + # - parent directory of the django_root_dir + # - django_root_dir itself; often, Django users do not specify absolute imports in the settings module. + search_paths = [ + PyInstaller.utils.misc.get_path_to_toplevel_modules(django_root_dir), + django_root_dir, + ] + sys.path += search_paths + + # Set the path to project's settings module + default_settings_module = os.path.basename(django_root_dir) + '.settings' + settings_module = os.environ.get('DJANGO_SETTINGS_MODULE', default_settings_module) + os.environ['DJANGO_SETTINGS_MODULE'] = settings_module + + # Calling django.setup() avoids the exception AppRegistryNotReady() and also reads the user settings + # from DJANGO_SETTINGS_MODULE. + # https://stackoverflow.com/questions/24793351/django-appregistrynotready + import django # noqa: E402 + + django.setup() + + # This allows to access all django settings even from the settings.py module. + from django.conf import settings # noqa: E402 + + hiddenimports = list(settings.INSTALLED_APPS) + + # Do not fail script when settings does not have such attributes. + if hasattr(settings, 'TEMPLATE_CONTEXT_PROCESSORS'): + hiddenimports += list(settings.TEMPLATE_CONTEXT_PROCESSORS) + + if hasattr(settings, 'TEMPLATE_LOADERS'): + hiddenimports += list(settings.TEMPLATE_LOADERS) + + hiddenimports += [settings.ROOT_URLCONF] + + def _remove_class(class_name): + return '.'.join(class_name.split('.')[0:-1]) + + #-- Changes in Django 1.7. + + # Remove class names and keep just modules. + if hasattr(settings, 'AUTHENTICATION_BACKENDS'): + for cl in settings.AUTHENTICATION_BACKENDS: + cl = _remove_class(cl) + hiddenimports.append(cl) + # Deprecated since 4.2, may be None until it is removed + cl = getattr(settings, 'DEFAULT_FILE_STORAGE', None) + if cl: + hiddenimports.append(_remove_class(cl)) + if hasattr(settings, 'FILE_UPLOAD_HANDLERS'): + for cl in settings.FILE_UPLOAD_HANDLERS: + cl = _remove_class(cl) + hiddenimports.append(cl) + if hasattr(settings, 'MIDDLEWARE_CLASSES'): + for cl in settings.MIDDLEWARE_CLASSES: + cl = _remove_class(cl) + hiddenimports.append(cl) + # Templates is a dict: + if hasattr(settings, 'TEMPLATES'): + for templ in settings.TEMPLATES: + backend = _remove_class(templ['BACKEND']) + hiddenimports.append(backend) + # Include context_processors. + if hasattr(templ, 'OPTIONS'): + if hasattr(templ['OPTIONS'], 'context_processors'): + # Context processors are functions - strip last word. + mods = templ['OPTIONS']['context_processors'] + mods = [_remove_class(x) for x in mods] + hiddenimports += mods + # Include database backends - it is a dict. + for v in settings.DATABASES.values(): + hiddenimports.append(v['ENGINE']) + + # Add templatetags and context processors for each installed app. + for app in settings.INSTALLED_APPS: + app_templatetag_module = app + '.templatetags' + app_ctx_proc_module = app + '.context_processors' + hiddenimports.append(app_templatetag_module) + hiddenimports += hookutils.collect_submodules(app_templatetag_module) + hiddenimports.append(app_ctx_proc_module) + + # Deduplicate imports. + hiddenimports = list(set(hiddenimports)) + + # Return the hidden imports + return hiddenimports + + +def django_find_root_dir(): + """ + Return path to directory (top-level Python package) that contains main django files. Return None if no directory + was detected. + + Main Django project directory contain files like '__init__.py', 'settings.py' and 'url.py'. + + In Django 1.4+ the script 'manage.py' is not in the directory with 'settings.py' but usually one level up. We + need to detect this special case too. + """ + # 'PyInstaller.config' cannot be imported as other top-level modules. + from PyInstaller.config import CONF + + # Get the directory with manage.py. Manage.py is supplied to PyInstaller as the first main executable script. + manage_py = CONF['main_script'] + manage_dir = os.path.dirname(os.path.abspath(manage_py)) + + # Get the Django root directory. The directory that contains settings.py and url.py. It could be the directory + # containing manage.py or any of its subdirectories. + settings_dir = None + files = set(os.listdir(manage_dir)) + if ('settings.py' in files or 'settings' in files) and 'urls.py' in files: + settings_dir = manage_dir + else: + for f in files: + if os.path.isdir(os.path.join(manage_dir, f)): + subfiles = os.listdir(os.path.join(manage_dir, f)) + # Subdirectory contains critical files. + if ('settings.py' in subfiles or 'settings' in subfiles) and 'urls.py' in subfiles: + settings_dir = os.path.join(manage_dir, f) + break # Find the first directory. + + return settings_dir diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/gi.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/gi.py new file mode 100755 index 0000000..9ae06ce --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/gi.py @@ -0,0 +1,457 @@ +# ---------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +# ---------------------------------------------------------------------------- +import os +import pathlib +import shutil +import subprocess +import hashlib +import re + +from PyInstaller.depend.utils import _resolveCtypesImports +from PyInstaller.utils.hooks import collect_submodules, collect_system_data_files, get_hook_config +from PyInstaller import isolated +from PyInstaller import log as logging +from PyInstaller import compat +from PyInstaller.depend.bindepend import findSystemLibrary + +logger = logging.getLogger(__name__) + + +class GiModuleInfo: + def __init__(self, module, version, hook_api=None): + self.name = module + self.version = version + self.available = False + self.sharedlibs = [] + self.typelib = None + self.dependencies = [] + + # If hook API is available, use it to override the version from hookconfig. + if hook_api is not None: + module_versions = get_hook_config(hook_api, 'gi', 'module-versions') + if module_versions: + self.version = module_versions.get(module, version) + + logger.debug("Gathering GI module info for %s %s", module, self.version) + + @isolated.decorate + def _get_module_info(module, version): + import gi + + # Ideally, we would use gi.Repository, which provides common abstraction for some of the functions we use in + # this codepath (e.g., `require`, `get_typelib_path`, `get_immediate_dependencies`). However, it lacks the + # `get_shared_library` function, which is why we are using "full" bindings via `gi.repository.GIRepository`. + # + # PyGObject 3.52.0 switched from girepository-1.0 to girepository-2.0, which means that GIRepository version + # has changed from 2.0 to 3.0 and some of the API has changed. + try: + gi.require_version("GIRepository", "3.0") + new_api = True + except ValueError: + gi.require_version("GIRepository", "2.0") + new_api = False + + from gi.repository import GIRepository + + # The old API had `get_default` method to obtain global singleton object; it was removed in the new API, + # which requires creation of separate GIRepository instances. + if new_api: + repo = GIRepository.Repository() + try: + repo.require(module, version, GIRepository.RepositoryLoadFlags.LAZY) + except ValueError: + return None # Module not available + + # The new API returns the list of shared libraries. + sharedlibs = repo.get_shared_libraries(module) + else: + repo = GIRepository.Repository.get_default() + try: + repo.require(module, version, GIRepository.RepositoryLoadFlags.IREPOSITORY_LOAD_FLAG_LAZY) + except ValueError: + return None # Module not available + + # Shared library/libraries + # Comma-separated list of paths to shared libraries, or None if none are associated. Convert to list. + sharedlibs = repo.get_shared_library(module) + sharedlibs = [lib.strip() for lib in sharedlibs.split(",")] if sharedlibs else [] + + # Path to .typelib file + typelib = repo.get_typelib_path(module) + + # Dependencies + # GIRepository.Repository.get_immediate_dependencies is available from gobject-introspection v1.44 on + if hasattr(repo, 'get_immediate_dependencies'): + dependencies = repo.get_immediate_dependencies(module) + else: + dependencies = repo.get_dependencies(module) + + return { + 'sharedlibs': sharedlibs, + 'typelib': typelib, + 'dependencies': dependencies, + } + + # Try to query information; if this fails, mark module as unavailable. + try: + info = _get_module_info(module, self.version) + if info is None: + logger.debug("GI module info %s %s not found.", module, self.version) + else: + logger.debug("GI module info %s %s found.", module, self.version) + self.sharedlibs = info['sharedlibs'] + self.typelib = info['typelib'] + self.dependencies = info['dependencies'] + self.available = True + except Exception as e: + logger.warning("Failed to query GI module %s %s: %s", module, self.version, e) + + def get_libdir(self): + """ + Return the path to shared library used by the module. If no libraries are associated with the typelib, None is + returned. If multiple library names are associated with the typelib, the path to the first resolved shared + library is returned. Raises exception if module is unavailable or none of the shared libraries could be + resolved. + """ + # Module unavailable + if not self.available: + raise ValueError(f"Module {self.name} {self.version} is unavailable!") + # Module has no associated shared libraries + if not self.sharedlibs: + return None + for lib in self.sharedlibs: + path = findSystemLibrary(lib) + if path: + return os.path.normpath(os.path.dirname(path)) + raise ValueError(f"Could not resolve any shared library of {self.name} {self.version}: {self.sharedlibs}!") + + def collect_typelib_data(self): + """ + Return a tuple of (binaries, datas, hiddenimports) to be used by PyGObject related hooks. + """ + datas = [] + binaries = [] + hiddenimports = [] + + logger.debug("Collecting module data for %s %s", self.name, self.version) + + # Module unavailable + if not self.available: + raise ValueError(f"Module {self.name} {self.version} is unavailable!") + + # Find shared libraries + resolved_libs = _resolveCtypesImports(self.sharedlibs) + for resolved_lib in resolved_libs: + logger.debug("Collecting shared library %s at %s", resolved_lib[0], resolved_lib[1]) + binaries.append((resolved_lib[1], ".")) + + # Find and collect .typelib file. Run it through the `gir_library_path_fix` to fix the library path, if + # necessary. + typelib_entry = gir_library_path_fix(self.typelib) + if typelib_entry: + logger.debug('Collecting gir typelib at %s', typelib_entry[0]) + datas.append(typelib_entry) + + # Overrides for the module + hiddenimports += collect_submodules('gi.overrides', lambda name: name.endswith('.' + self.name)) + + # Module dependencies + for dep in self.dependencies: + dep_module, _ = dep.rsplit('-', 1) + hiddenimports += [f'gi.repository.{dep_module}'] + + return binaries, datas, hiddenimports + + +# The old function, provided for backwards compatibility in 3rd party hooks. +def get_gi_libdir(module, version): + module_info = GiModuleInfo(module, version) + return module_info.get_libdir() + + +# The old function, provided for backwards compatibility in 3rd party hooks. +def get_gi_typelibs(module, version): + """ + Return a tuple of (binaries, datas, hiddenimports) to be used by PyGObject related hooks. Searches for and adds + dependencies recursively. + + :param module: GI module name, as passed to 'gi.require_version()' + :param version: GI module version, as passed to 'gi.require_version()' + """ + module_info = GiModuleInfo(module, version) + return module_info.collect_typelib_data() + + +def gir_library_path_fix(path): + import subprocess + + # 'PyInstaller.config' cannot be imported as other top-level modules. + from PyInstaller.config import CONF + + path = os.path.abspath(path) + + # On macOS we need to recompile the GIR files to reference the loader path, + # but this is not necessary on other platforms. + if compat.is_darwin: + + # If using a virtualenv, the base prefix and the path of the typelib + # have really nothing to do with each other, so try to detect that. + common_path = os.path.commonprefix([compat.base_prefix, path]) + if common_path == '/': + logger.debug("virtualenv detected? fixing the gir path...") + common_path = os.path.abspath(os.path.join(path, '..', '..', '..')) + + gir_path = os.path.join(common_path, 'share', 'gir-1.0') + + typelib_name = os.path.basename(path) + gir_name = os.path.splitext(typelib_name)[0] + '.gir' + + gir_file = os.path.join(gir_path, gir_name) + + if not os.path.exists(gir_path): + logger.error( + "Unable to find gir directory: %s.\nTry installing your platform's gobject-introspection package.", + gir_path + ) + return None + if not os.path.exists(gir_file): + logger.error( + "Unable to find gir file: %s.\nTry installing your platform's gobject-introspection package.", gir_file + ) + return None + + with open(gir_file, 'r', encoding='utf-8') as f: + lines = f.readlines() + # GIR files are `XML encoded `_, + # which means they are by definition encoded using UTF-8. + with open(os.path.join(CONF['workpath'], gir_name), 'w', encoding='utf-8') as f: + for line in lines: + if 'shared-library' in line: + split = re.split('(=)', line) + files = re.split('(["|,])', split[2]) + for count, item in enumerate(files): + if 'lib' in item: + files[count] = '@loader_path/' + os.path.basename(item) + line = ''.join(split[0:2]) + ''.join(files) + f.write(line) + + # g-ir-compiler expects a file so we cannot just pipe the fixed file to it. + command = subprocess.Popen(( + 'g-ir-compiler', os.path.join(CONF['workpath'], gir_name), + '-o', os.path.join(CONF['workpath'], typelib_name) + )) # yapf: disable + command.wait() + + return os.path.join(CONF['workpath'], typelib_name), 'gi_typelibs' + else: + return path, 'gi_typelibs' + + +@isolated.decorate +def get_glib_system_data_dirs(): + import gi + gi.require_version('GLib', '2.0') + from gi.repository import GLib + return GLib.get_system_data_dirs() + + +def get_glib_sysconf_dirs(): + """ + Try to return the sysconf directories (e.g., /etc). + """ + if compat.is_win: + # On Windows, if you look at gtkwin32.c, sysconfdir is actually relative to the location of the GTK DLL. Since + # that is what we are actually interested in (not the user path), we have to do that the hard way... + return [os.path.join(get_gi_libdir('GLib', '2.0'), 'etc')] + + @isolated.call + def data_dirs(): + import gi + gi.require_version('GLib', '2.0') + from gi.repository import GLib + return GLib.get_system_config_dirs() + + return data_dirs + + +def collect_glib_share_files(*path): + """ + Path is relative to the system data directory (e.g., /usr/share). + """ + glib_data_dirs = get_glib_system_data_dirs() + if glib_data_dirs is None: + return [] + + destdir = os.path.join('share', *path) + + # TODO: will this return too much? + collected = [] + for data_dir in glib_data_dirs: + p = os.path.join(data_dir, *path) + collected += collect_system_data_files(p, destdir=destdir, include_py_files=False) + + return collected + + +def collect_glib_etc_files(*path): + """ + Path is relative to the system config directory (e.g., /etc). + """ + glib_config_dirs = get_glib_sysconf_dirs() + if glib_config_dirs is None: + return [] + + destdir = os.path.join('etc', *path) + + # TODO: will this return too much? + collected = [] + for config_dir in glib_config_dirs: + p = os.path.join(config_dir, *path) + collected += collect_system_data_files(p, destdir=destdir, include_py_files=False) + + return collected + + +_glib_translations = None + + +def collect_glib_translations(prog, lang_list=None): + """ + Return a list of translations in the system locale directory whose names equal prog.mo. + """ + global _glib_translations + if _glib_translations is None: + if lang_list is not None: + trans = [] + for lang in lang_list: + trans += collect_glib_share_files(os.path.join("locale", lang)) + _glib_translations = trans + else: + _glib_translations = collect_glib_share_files('locale') + + names = [os.sep + prog + '.mo', os.sep + prog + '.po'] + namelen = len(names[0]) + + return [(src, dst) for src, dst in _glib_translations if src[-namelen:] in names] + + +# Not a hook utility function per-se (used by main Analysis class), but kept here to have all GLib/GObject functions +# in one place... +def compile_glib_schema_files(datas_toc, workdir, collect_source_files=False): + """ + Compile collected GLib schema files. Extracts the list of GLib schema files from the given input datas TOC, copies + them to temporary working directory, and compiles them. The resulting `gschemas.compiled` file is added to the + output TOC, replacing any existing entry with that name. If `collect_source_files` flag is set, the source XML + schema files are also (re)added to the output TOC; by default, they are not. This function is no-op (returns the + original TOC) if no GLib schemas are found in TOC or if `glib-compile-schemas` executable is not found in `PATH`. + """ + SCHEMA_DEST_DIR = pathlib.PurePath("share/glib-2.0/schemas") + workdir = pathlib.Path(workdir) + + schema_files = [] + output_toc = [] + for toc_entry in datas_toc: + dest_name, src_name, typecode = toc_entry + dest_name = pathlib.PurePath(dest_name) + src_name = pathlib.PurePath(src_name) + + # Pass-through for non-schema files, identified based on the destination directory. + if dest_name.parent != SCHEMA_DEST_DIR: + output_toc.append(toc_entry) + continue + + # It seems schemas directory contains different files with different suffices: + # - .gschema.xml + # - .schema.override + # - .enums.xml + # To avoid omitting anything, simply collect everything into temporary directory. + # Exemptions are gschema.dtd (which should be unnecessary) and gschemas.compiled (which we will generate + # ourselves in this function). + if src_name.name in {"gschema.dtd", "gschemas.compiled"}: + continue + + schema_files.append(src_name) + + # If there are no schema files available, simply return the input datas TOC. + if not schema_files: + return datas_toc + + # Ensure that `glib-compile-schemas` executable is in PATH, just in case... + schema_compiler_exe = shutil.which('glib-compile-schemas') + if not schema_compiler_exe: + logger.warning("GLib schema compiler (glib-compile-schemas) not found! Skipping GLib schema recompilation...") + return datas_toc + + # If `gschemas.compiled` file already exists in the temporary working directory, record its modification time and + # hash. This will allow us to restore the modification time on the newly-compiled copy, if the latter turns out + # to be identical to the existing old one. Just in case, if the file becomes subject to timestamp-based caching + # mechanism. + compiled_file = workdir / "gschemas.compiled" + old_compiled_file_hash = None + old_compiled_file_stat = None + + if compiled_file.is_file(): + # Record creation/modification time + old_compiled_file_stat = compiled_file.stat() + # Compute SHA1 hash; since compiled schema files are relatively small, do it in single step. + old_compiled_file_hash = hashlib.sha1(compiled_file.read_bytes()).digest() + + # Ensure that temporary working directory exists, and is empty. + if workdir.exists(): + shutil.rmtree(workdir) + workdir.mkdir(exist_ok=True) + + # Copy schema (source) files to temporary working directory + for schema_file in schema_files: + shutil.copy(schema_file, workdir) + + # Compile. The glib-compile-schema might produce warnings on its own (e.g., schemas using deprecated paths, or + # overrides for non-existent keys). Since these are non-actionable, capture and display them only as a DEBUG + # message, or as a WARNING one if the command fails. + logger.info("Compiling collected GLib schema files in %r...", str(workdir)) + try: + cmd_args = [schema_compiler_exe, str(workdir), '--targetdir', str(workdir)] + p = subprocess.run( + cmd_args, + stdin=subprocess.DEVNULL, + stdout=subprocess.PIPE, + stderr=subprocess.STDOUT, + check=True, + errors='ignore', + encoding='utf-8', + ) + logger.debug("Output from glib-compile-schemas:\n%s", p.stdout) + except subprocess.CalledProcessError as e: + # The called glib-compile-schema returned error. Display stdout/stderr, and return original datas TOC to + # minimize damage. + logger.warning("Failed to recompile GLib schemas! Returning collected files as-is!", exc_info=True) + logger.warning("Output from glib-compile-schemas:\n%s", e.stdout) + return datas_toc + except Exception: + # Compilation failed for whatever reason. Return original datas TOC to minimize damage. + logger.warning("Failed to recompile GLib schemas! Returning collected files as-is!", exc_info=True) + return datas_toc + + # Compute the checksum of the new compiled file, and if it matches the old checksum, restore the modification time. + if old_compiled_file_hash is not None: + new_compiled_file_hash = hashlib.sha1(compiled_file.read_bytes()).digest() + if new_compiled_file_hash == old_compiled_file_hash: + os.utime(compiled_file, ns=(old_compiled_file_stat.st_atime_ns, old_compiled_file_stat.st_mtime_ns)) + + # Add the resulting gschemas.compiled file to the output TOC + output_toc.append((str(SCHEMA_DEST_DIR / compiled_file.name), str(compiled_file), "DATA")) + + # Include source schema files in the output TOC (optional) + if collect_source_files: + for schema_file in schema_files: + output_toc.append((str(SCHEMA_DEST_DIR / schema_file.name), str(schema_file), "DATA")) + + return output_toc diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/qt/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/qt/__init__.py new file mode 100755 index 0000000..fbefbe3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/qt/__init__.py @@ -0,0 +1,1427 @@ +# ---------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import glob +import os +import pathlib +import re + +from PyInstaller import compat +from PyInstaller import isolated +from PyInstaller import log as logging +from PyInstaller.depend import bindepend +from PyInstaller.utils import hooks, misc +from PyInstaller.utils.hooks.qt import _modules_info + +logger = logging.getLogger(__name__) + +# Qt deployment approach +# ---------------------- +# This is the core of PyInstaller's approach to Qt deployment. It is based on: +# +# - Discovering the location of Qt libraries by introspection, using QtLibraryInfo_. This provides compatibility with +# many variants of Qt5/6 (conda, self-compiled, provided by a Linux distro, etc.) and many versions of Qt5/6, all of +# which vary in the location of Qt files. +# +# - Placing all frozen PyQt5/6 or PySide2/6 Qt files in a standard subdirectory layout, which matches the layout of the +# corresponding wheel on PyPI. This is necessary to support Qt installs which are not in a subdirectory of the PyQt5/6 +# or PySide2/6 wrappers. See ``hooks/rthooks/pyi_rth_qt5.py`` for the use of environment variables to establish this +# layout. +# +# - Emitting warnings on missing QML and translation files which some installations do not have. +# +# - Determining additional files needed for deployment based on the information in the centralized Qt module information +# list in the ``_modules_info`` module. This includes plugins and translation files associated with each Qt python +# extension module, as well as additional python Qt extension modules. +# +# - Collecting additional files that are specific to each module and are handled separately, for example: +# +# - For dynamic OpenGL applications, the ``libEGL.dll``, ``libGLESv2.dll``, ``d3dcompiler_XX.dll`` (the XX is a +# version number), and ``opengl32sw.dll`` libraries need to be collected on Windows. This is handled by the +# "base" bindings hook, for example ``hook-PyQt5.py``. +# +# - If Qt was configured to use ICU, the ``icudtXX.dll``, ``icuinXX.dll``, and ``icuucXX.dll`` libraries need to +# be collected on Windows. This is handled by the "base" bindings hook, for example ``hook-PyQt5.py``. +# +# - Per the `Deploying QML Applications `_ page, QML-based +# applications need the ``qml/`` directory available. This is handled by ``QtQuick`` hook, for example +# ``hook-PyQt5.QtQuick.py``. +# +# - For ``QtWebEngine``-based applications, we follow the `deployWebEngineCore +# `_ +# function copies the following files from ``resources/``, and also copies the web engine process executable. +# - ``icudtl.dat`` +# - ``qtwebengine_devtools_resources.pak`` +# - ``qtwebengine_resources.pak`` +# - ``qtwebengine_resources_100p.pak`` +# - ``qtwebengine_resources_200p.pak`` +# +# This is handled by the ``QtWebEngineCore`` hook, for example ``hook-PyQt5.QtWebEngineCore.py``. +# +# For details and references, see the `original write-up +# `_ +# and the documentation in the ``_modules_info`` module. + + +# QtModuleInfo +# ------------ +# This class contains information about python module (extension), its corresponding Qt module (shared library), and +# associated plugins and translations. It is used within QtLibraryInfo_ to establish name-based mappings for file +# collection. +class QtModuleInfo: + def __init__(self, module, shared_lib=None, translations=None, plugins=None): + # Python module (extension) name without package namespace. For example, `QtCore`. + # Can be None if python bindings do not bind the module, but we still need to establish relationship between + # the Qt module (shared library) and its plugins and translations. + self.module = module + # Associated Qt module (shared library), if any. Used during recursive dependency analysis, where a python + # module (extension) is analyzed for linked Qt modules (shared libraries), and then their corresponding + # python modules (extensions) are added to hidden imports. For example, the Qt module name is `Qt5Core` or + # `Qt6Core`, depending on the Qt version. Can be None for python modules that are not tied to a particular + # Qt shared library (for example, the corresponding Qt module is headers-only) and hence they cannot be + # inferred from recursive link-time dependency analysis. + self.shared_lib = shared_lib + # List of base names of translation files (if any) associated with the Qt module. Multiple base names may be + # associated with a single module. + # For example, `['qt', 'qtbase']` for `QtCore` or `['qtmultimedia']` for `QtMultimedia`. + self.translations = translations or [] + # List of plugins associated with the Qt module. + self.plugins = plugins or [] + + def __repr__(self): + return f"(module={self.module!r}, shared_lib={self.shared_lib!r}, " \ + f"translations={self.translations!r}, plugins={self.plugins!r}" + + +# QtLibraryInfo +# -------------- +# This class uses introspection to determine the location of Qt files. This is essential to deal with the many variants +# of the PyQt5/6 and PySide2/6 package, each of which places files in a different location. Therefore, this class +# provides all location-related members of `QLibraryInfo `_. +class QtLibraryInfo: + def __init__(self, namespace): + if namespace not in ['PyQt5', 'PyQt6', 'PySide2', 'PySide6']: + raise Exception('Invalid namespace: {0}'.format(namespace)) + self.namespace = namespace + # Distinction between PyQt5/6 and PySide2/6 + self.is_pyqt = namespace in {'PyQt5', 'PyQt6'} + # Distinction between Qt5 and Qt6 + self.qt_major = 6 if namespace in {'PyQt6', 'PySide6'} else 5 + # Determine relative path where Qt libraries and data need to be collected in the frozen application. This + # varies between PyQt5/PyQt6/PySide2/PySide6, their versions, and platforms. NOTE: it is tempting to consider + # deriving this path as simply the value of QLibraryInfo.PrefixPath, taken relative to the package's root + # directory. However, we also need to support non-wheel deployments (e.g., with Qt installed in custom path on + # Windows, or with Qt and PyQt5 installed on linux using native package manager), and in those, the Qt + # PrefixPath does not reflect the required relative target path for the frozen application. + if namespace == 'PyQt5': + if self._use_new_layout("PyQt5", "5.15.4", False): + self.qt_rel_dir = os.path.join('PyQt5', 'Qt5') + else: + self.qt_rel_dir = os.path.join('PyQt5', 'Qt') + elif namespace == 'PyQt6': + if self._use_new_layout("PyQt6", "6.0.3", True): + self.qt_rel_dir = os.path.join('PyQt6', 'Qt6') + else: + self.qt_rel_dir = os.path.join('PyQt6', 'Qt') + elif namespace == 'PySide2': + # PySide2 uses PySide2/Qt on linux and macOS, and PySide2 on Windows + if compat.is_win: + self.qt_rel_dir = 'PySide2' + else: + self.qt_rel_dir = os.path.join('PySide2', 'Qt') + else: + # PySide6 follows the same logic as PySide2 + if compat.is_win: + self.qt_rel_dir = 'PySide6' + else: + self.qt_rel_dir = os.path.join('PySide6', 'Qt') + + # Process module information list to construct python-module-name -> info and shared-lib-name -> info mappings. + self._load_module_info() + + def __repr__(self): + return f"QtLibraryInfo({self.namespace})" + + # Delay initialization of the Qt library information until the corresponding attributes are first requested. + def __getattr__(self, name): + if 'version' in self.__dict__: + # Initialization was already done, but requested attribute is not available. + raise AttributeError(name) + + # Load Qt library info... + self._load_qt_info() + # ... and return the requested attribute + return getattr(self, name) + + # Check whether we must use the new layout (e.g. PyQt5/Qt5, PyQt6/Qt6) instead of the old layout (PyQt5/Qt, + # PyQt6/Qt). + @staticmethod + def _use_new_layout(package_basename: str, version: str, fallback_value: bool) -> bool: + # The PyQt wheels come in both non-commercial and commercial variants. So we need to check if a particular + # variant is installed before testing its version. + if hooks.check_requirement(package_basename): + return hooks.check_requirement(f"{package_basename} >= {version}") + if hooks.check_requirement(f"{package_basename}_commercial"): + return hooks.check_requirement(f"{package_basename}_commercial >= {version}") + return fallback_value + + # Load Qt information (called on first access to related fields) + def _load_qt_info(self): + """ + Load and process Qt library information. Called on the first access to the related attributes of the class + (e.g., `version` or `location`). + """ + + # Ensure self.version exists, even if PyQt{5,6}/PySide{2,6} cannot be imported. Hooks and util functions use + # `if .version` to check whether package was imported and other attributes are expected to be available. + # This also serves as a marker that initialization was already done. + self.version = None + + # Get library path information from Qt. See QLibraryInfo_. + @isolated.decorate + def _read_qt_library_info(package): + import os + import sys + import importlib + + # Import the Qt-based package + # equivalent to: from package.QtCore import QLibraryInfo, QCoreApplication + try: + QtCore = importlib.import_module('.QtCore', package) + except ModuleNotFoundError: + return None # Signal that package is unavailable + QLibraryInfo = QtCore.QLibraryInfo + QCoreApplication = QtCore.QCoreApplication + + # QLibraryInfo is not always valid until a QCoreApplication is instantiated. + app = QCoreApplication(sys.argv) # noqa: F841 + + # Qt6 deprecated QLibraryInfo.location() in favor of QLibraryInfo.path(), and + # QLibraryInfo.LibraryLocation enum was replaced by QLibraryInfo.LibraryPath. + if hasattr(QLibraryInfo, 'path'): + # Qt6; enumerate path enum values directly from the QLibraryInfo.LibraryPath enum. + path_names = [x for x in dir(QLibraryInfo.LibraryPath) if x.endswith('Path')] + location = {x: QLibraryInfo.path(getattr(QLibraryInfo.LibraryPath, x)) for x in path_names} + else: + # Qt5; in recent versions, location enum values can be enumeratd from QLibraryInfo.LibraryLocation. + # However, in older versions of Qt5 and its python bindings, that is unavailable. Hence the + # enumeration of "*Path"-named members of QLibraryInfo. + path_names = [x for x in dir(QLibraryInfo) if x.endswith('Path')] + location = {x: QLibraryInfo.location(getattr(QLibraryInfo, x)) for x in path_names} + + # Determine the python-based package location, by looking where the QtCore module is located. + package_location = os.path.dirname(QtCore.__file__) + + # Determine Qt version. Works for Qt 5.8 and later, where QLibraryInfo.version() was introduced. + try: + version = QLibraryInfo.version().segments() + except AttributeError: + version = [] + + return { + 'is_debug_build': QLibraryInfo.isDebugBuild(), + 'version': version, + 'location': location, + 'package_location': package_location, + } + + try: + qt_info = _read_qt_library_info(self.namespace) + except Exception as e: + logger.warning("%s: failed to obtain Qt library info: %s", self, e) + return + + # If package could not be imported, `_read_qt_library_info` returns None. In such cases, emit a debug message + # instead of a warning, because this initialization might be triggered by a helper function that is trying to + # determine availability of bindings by inspecting the `version` attribute of `QtLibraryInfo` for all bindings. + if qt_info is None: + logger.debug("%s: failed to obtain Qt library info: %s.QtCore could not be imported.", self, self.namespace) + return + + for k, v in qt_info.items(): + setattr(self, k, v) + + # Turn package_location into pathlib.Path(), and fully resolve it. + self.package_location = pathlib.Path(self.package_location).resolve() + + # Determine if the Qt is bundled with python package itself; this usually means we are dealing with with PyPI + # wheels. + resolved_qt_prefix_path = pathlib.Path(self.location['PrefixPath']).resolve() + self.qt_inside_package = ( + self.package_location == resolved_qt_prefix_path or # PySide2 and PySide6 Windows PyPI wheels + self.package_location in resolved_qt_prefix_path.parents + ) + + # Determine directory that contains Qt shared libraries. On non-Windows, this is typically location given by + # `LibrariesPath`. On Windows, it is usually `BinariesPath`, except for PySide PyPI wheels, where DLLs are + # placed in top-level `PrefixPath`. + if compat.is_win: + if self.qt_inside_package and not self.is_pyqt: + # Windows PyPI wheel + qt_lib_dir = self.location['PrefixPath'] + else: + qt_lib_dir = self.location['BinariesPath'] + else: + qt_lib_dir = self.location['LibrariesPath'] + self.qt_lib_dir = pathlib.Path(qt_lib_dir).resolve() + + # Module information list loading/processing + def _load_module_info(self): + """ + Process the Qt modules info definition list and construct two dictionaries: + - dictionary that maps Qt python module names to Qt module info entries + - dictionary that maps shared library names to Qt module info entries + """ + + self.python_modules = dict() + self.shared_libraries = dict() + + for entry in _modules_info.QT_MODULES_INFO: + # If entry specifies applicable bindings, check them + if entry.bindings: + applicable_bindings = _modules_info.process_namespace_strings(entry.bindings) + if self.namespace not in applicable_bindings: + continue + + # Create a QtModuleInfo entry + info_entry = QtModuleInfo( + module=entry.module, + shared_lib=f"Qt{self.qt_major}{entry.shared_lib}" if entry.shared_lib else None, + translations=entry.translations, + plugins=entry.plugins + ) + + # If we have python module (extension) name, create python-module-name -> info mapping. + if info_entry.module is not None: + self.python_modules[info_entry.module] = info_entry + + # If we have Qt module (shared library) name, create shared-lib-name -> info mapping. + if info_entry.shared_lib is not None: + self.shared_libraries[info_entry.shared_lib.lower()] = info_entry + + def _normalize_shared_library_name(self, filename): + """ + Normalize a shared library name into common form that we can use for look-ups and comparisons. + Primarily intended for Qt shared library names. + """ + + # Take base name, remove suffix, and lower case it. + lib_name = os.path.splitext(os.path.basename(filename))[0].lower() + # Linux libraries sometimes have a dotted version number -- ``libfoo.so.3``. It is now ''libfoo.so``, + # but the ``.so`` must also be removed. + if compat.is_linux and os.path.splitext(lib_name)[1] == '.so': + lib_name = os.path.splitext(lib_name)[0] + # Remove the "lib" prefix (Linux, macOS). + if lib_name.startswith('lib'): + lib_name = lib_name[3:] + # macOS: handle different naming schemes. PyPI wheels ship framework-enabled Qt builds, where shared + # libraries are part of .framework bundles (e.g., ``PyQt5/Qt5/lib/QtCore.framework/Versions/5/QtCore``). + # In Anaconda (Py)Qt installations, the shared libraries are installed in environment's library directory, + # and contain versioned extensions, e.g., ``libQt5Core.5.dylib``. + if compat.is_darwin: + if lib_name.startswith('qt') and not lib_name.startswith('qt' + str(self.qt_major)): + # Qt library from a framework bundle (e.g., ``QtCore``); change prefix from ``qt`` to ``qt5`` or + # ``qt6`` to match names in Windows/Linux. + lib_name = 'qt' + str(self.qt_major) + lib_name[2:] + if lib_name.endswith('.' + str(self.qt_major)): + # Qt library from Anaconda, which originally had versioned extension, e.g., ``libfoo.5.dynlib``. + # The above processing turned it into ``foo.5``, so we need to remove the last two characters. + lib_name = lib_name[:-2] + + # Handle cases with QT_LIBINFIX set to '_conda', i.e. conda-forge builds. + if lib_name.endswith('_conda'): + lib_name = lib_name[:-6] + + return lib_name + + # Collection + def collect_module(self, module_name): + """ + Collect all dependencies (hiddenimports, binaries, datas) for the given Qt python module. + + This function performs recursive analysis of extension module's link-time dependencies, and uses dictionaries + built by `_load_module_info` to discover associated plugin types, translation file base names, and hidden + imports that need to be collected. + """ + + # Accumulate all dependencies in a set to avoid duplicates. + hiddenimports = set() + translation_base_names = set() + plugin_types = set() + + # Exit if the requested library cannot be imported. + # NOTE: self..version can be empty list on older Qt5 versions (#5381). + if self.version is None: + return [], [], [] + + logger.debug('%s: processing module %s...', self, module_name) + + # Look up the associated Qt module information by python module name. + # This allows us to collect associated module data directly, even if there is no associated shared library + # (e.g., header-only Qt module, or statically-built one). + short_module_name = module_name.split('.', 1)[-1] # PySide2.QtModule -> QtModule + if short_module_name in self.python_modules: + qt_module_info = self.python_modules[short_module_name] + + # NOTE: no need to add a hiddenimport here, because this is the module under consideration. + + # Add plugins + plugin_types.update(qt_module_info.plugins) + + # Add translation base name(s) + translation_base_names.update(qt_module_info.translations) + + # Find the actual module extension file. + module_file = hooks.get_module_file_attribute(module_name) + + # Additional search path for shared library resolution. This is mostly required for library resolution on + # Windows (Linux and macOS binaries use run paths to find Qt libs). + qtlib_search_paths = [ + # For PyQt5 and PyQt6 wheels, shared libraries should be in BinariesPath, while for PySide2 and PySide6, + # they should be in PrefixPath. + self.location['BinariesPath' if self.is_pyqt else 'PrefixPath'], + ] + + # Walk through all the link-time dependencies of a dynamically-linked library (``.so``/``.dll``/``.dylib``). + imported_libraries = bindepend.get_imports(module_file, qtlib_search_paths) + while imported_libraries: + imported_lib_name, imported_lib_path = imported_libraries.pop() # (name, fullpath) tuple + + # Skip unresolved libraries + if imported_lib_path is None: + logger.debug("%s: ignoring unresolved library import %r", self, imported_lib_name) + continue + + # Normalize the shared library name + lib_name = self._normalize_shared_library_name(imported_lib_path) + logger.debug( + '%s: imported library %r, full path %r -> parsed name %r.', self, imported_lib_name, imported_lib_path, + lib_name + ) + + # PySide2 and PySide6 on linux seem to link all extension modules against libQt5Core, libQt5Network, and + # libQt5Qml (or their libQt6* equivalents). While the first two are reasonable, the libQt5Qml dependency + # pulls in whole QtQml module, along with its data and plugins, which in turn pull in several other Qt + # libraries, greatly inflating the bundle size (see #6447). + # + # Similarly, some extension modules (QtWebChannel, QtWebEngine*) seem to be also linked against libQt5Qml, + # even when the module can be used without having the whole QtQml module collected. + # + # Therefore, we explicitly prevent inclusion of QtQml based on the dynamic library dependency, except for + # QtQml* and QtQuick* modules, whose use directly implies the use of QtQml. + if lib_name in ("qt5qml", "qt6qml"): + if not short_module_name.startswith(('QtQml', 'QtQuick')): + logger.debug('%s: ignoring imported library %r.', self, lib_name) + continue + + # Use the parsed library name to look up associated Qt module information. + if lib_name in self.shared_libraries: + logger.debug('%s: collecting Qt module associated with %r.', self, lib_name) + + # Look up associated module info + qt_module_info = self.shared_libraries[lib_name] + + # If there is a python extension module associated with Qt module, add it to hiddenimports. Since this + # means that we (most likely) have a hook available for that module, we can avoid analyzing the shared + # library itself (i.e., stop the recursive analysis), because this will be done by the corresponding + # hook. + if qt_module_info.module: + if qt_module_info.module == short_module_name: + # The one exception is if we are analyzing shared library associated with the input module; in + # that case, avoid adding a hidden import and analyze the library's link-time dependencies. We + # do not need to worry about plugins and translations for this particular module, because those + # have been handled at the beginning of this function. + imported_libraries.update(bindepend.get_imports(imported_lib_path, qtlib_search_paths)) + else: + hiddenimports.add(self.namespace + "." + qt_module_info.module) + continue + + # Add plugins + plugin_types.update(qt_module_info.plugins) + + # Add translation base name(s) + translation_base_names.update(qt_module_info.translations) + + # Analyze the linked shared libraries for its dependencies (recursive analysis). + imported_libraries.update(bindepend.get_imports(imported_lib_path, qtlib_search_paths)) + + # Collect plugin files. + binaries = [] + for plugin_type in plugin_types: + binaries += self.collect_plugins(plugin_type) + + # Collect translation files. + datas = [] + translation_src = self.location['TranslationsPath'] + translation_dst = os.path.join(self.qt_rel_dir, 'translations') + + for translation_base_name in translation_base_names: + # Not all PyQt5 installations include translations. See + # https://github.com/pyinstaller/pyinstaller/pull/3229#issuecomment-359479893 + # and + # https://github.com/pyinstaller/pyinstaller/issues/2857#issuecomment-368744341. + translation_pattern = os.path.join(translation_src, translation_base_name + '_*.qm') + translation_files = glob.glob(translation_pattern) + if translation_files: + datas += [(translation_file, translation_dst) for translation_file in translation_files] + else: + logger.warning( + '%s: could not find translations with base name %r! These translations will not be collected.', + self, translation_base_name + ) + + # Convert hiddenimports to a list. + hiddenimports = list(hiddenimports) + + logger.debug( + '%s: dependencies for %s:\n' + ' hiddenimports = %r\n' + ' binaries = %r\n' + ' datas = %r', self, module_name, hiddenimports, binaries, datas + ) + + return hiddenimports, binaries, datas + + @staticmethod + def _filter_release_plugins(plugin_files): + """ + Filter the provided list of Qt plugin files and remove the debug variants, under the assumption that both the + release version of a plugin (qtplugin.dll) and its debug variant (qtplugind.dll) appear in the list. + """ + # All basenames for lookup + plugin_basenames = {os.path.normcase(os.path.basename(f)) for f in plugin_files} + # Process all given filenames + release_plugin_files = [] + for plugin_filename in plugin_files: + plugin_basename = os.path.normcase(os.path.basename(plugin_filename)) + if plugin_basename.endswith('d.dll'): + # If we can find a variant without trailing 'd' in the plugin list, then the DLL we are dealing with is + # a debug variant and needs to be excluded. + release_name = os.path.splitext(plugin_basename)[0][:-1] + '.dll' + if release_name in plugin_basenames: + continue + release_plugin_files.append(plugin_filename) + return release_plugin_files + + def collect_plugins(self, plugin_type): + """ + Collect all plugins of the specified type from the Qt plugin directory. + + Returns list of (src, dst) tuples. + """ + # Ensure plugin directory exists + plugin_src_dir = self.location['PluginsPath'] + if not os.path.isdir(plugin_src_dir): + raise Exception(f"Qt plugin directory '{plugin_src_dir}' does not exist!") + + # Collect all shared lib files in plugin type (sub)directory + plugin_files = misc.dlls_in_dir(os.path.join(plugin_src_dir, plugin_type)) + + # Windows: + # + # dlls_in_dir() grabs all files ending with ``*.dll``, ``*.so`` and ``*.dylib`` in a certain directory. On + # Windows this would grab debug copies of Qt plugins, which then causes PyInstaller to add a dependency on the + # Debug CRT *in addition* to the release CRT. + if compat.is_win: + plugin_files = self._filter_release_plugins(plugin_files) + + logger.debug("%s: found plugin files for plugin type %r: %r", self, plugin_type, plugin_files) + + plugin_dst_dir = os.path.join(self.qt_rel_dir, 'plugins', plugin_type) + + # Exclude plugins with invalid Qt dependencies. + binaries = [] + for plugin_file in plugin_files: + valid, reason = self._validate_plugin_dependencies(plugin_file) + if valid: + binaries.append((plugin_file, plugin_dst_dir)) + else: + logger.debug("%s: excluding plugin %r (%r)! Reason: %s", self, plugin_file, plugin_type, reason) + return binaries + + def _validate_plugin_dependencies(self, plugin_file): + """ + Validate Qt dependencies of the given Qt plugin file. For the plugin to pass validation, all its Qt dependencies + must be available (resolvable), and must be resolvable from the default Qt shared library directory (to avoid + pulling in libraries from unrelated Qt installations that happen to be in search path). + """ + + imported_libraries = bindepend.get_imports(plugin_file, search_paths=[self.qt_lib_dir]) + for imported_lib_name, imported_lib_path in imported_libraries: + # Parse/normalize the (unresolved) library name, to determine if dependency is a Qt shared library. If not, + # skip the validation. + lib_name = self._normalize_shared_library_name(imported_lib_name) + if not lib_name.startswith(f"qt{self.qt_major}"): + continue + + if imported_lib_path is None: + return False, f"Missing Qt dependency {imported_lib_name!r}." + + imported_lib_path = pathlib.Path(imported_lib_path).resolve() + if self.qt_lib_dir not in imported_lib_path.parents: + return ( + False, + f"Qt dependency {imported_lib_name!r} ({str(imported_lib_path)!r}) has been resolved outside of " + f"the Qt shared library directory ({str(self.qt_lib_dir)!r})." + ) + + return True, None + + def _collect_all_or_none(self, mandatory_dll_patterns, optional_dll_patterns=None): + """ + Try to find Qt DLLs from the specified mandatory pattern list. If all mandatory patterns resolve to DLLs, + collect them all, as well as any DLLs from the optional pattern list. If a mandatory pattern fails to resolve + to a DLL, return an empty list. + + This allows all-or-none collection of particular groups of Qt DLLs that may or may not be available. + """ + optional_dll_patterns = optional_dll_patterns or [] + + # Package parent path; used to preserve the directory structure when DLLs are collected from the python + # package (e.g., PyPI wheels). + package_parent_path = self.package_location.parent + + # On Windows, DLLs are typically placed in `location['BinariesPath']`, except for PySide PyPI wheels, where + # `location['PrefixPath']` is used. This difference is already handled by `qt_lib_dir`, which is also fully + # resolved. + dll_path = self.qt_lib_dir + + # Helper for processing single DLL pattern + def _process_dll_pattern(dll_pattern): + discovered_dlls = [] + + dll_files = dll_path.glob(dll_pattern) + for dll_file in dll_files: + if package_parent_path in dll_file.parents: + # The DLL is located within python package; preserve the layout + dst_dll_dir = dll_file.parent.relative_to(package_parent_path) + else: + # The DLL is not located within python package; collect into top-level directory + dst_dll_dir = '.' + discovered_dlls.append((str(dll_file), str(dst_dll_dir))) + + return discovered_dlls + + # Process mandatory patterns + collected_dlls = [] + for pattern in mandatory_dll_patterns: + discovered_dlls = _process_dll_pattern(pattern) + if not discovered_dlls: + return [] # Mandatory pattern resulted in no DLLs; abort + collected_dlls += discovered_dlls + + # Process optional patterns + for pattern in optional_dll_patterns: + collected_dlls += _process_dll_pattern(pattern) + + return collected_dlls + + # Collect required Qt binaries, but only if all binaries in a group exist. + def collect_extra_binaries(self): + """ + Collect extra binaries/DLLs required by Qt. These include ANGLE DLLs, OpenGL software renderer DLL, and ICU + DLLs. Applicable only on Windows (on other OSes, empty list is returned). + """ + + binaries = [] + + # Applicable only to Windows. + if not compat.is_win: + return [] + + # OpenGL: EGL/GLES via ANGLE, software OpenGL renderer. + binaries += self._collect_all_or_none(['libEGL.dll', 'libGLESv2.dll'], ['d3dcompiler_??.dll']) + binaries += self._collect_all_or_none(['opengl32sw.dll']) + + # Include ICU files, if they exist. + # See the "Deployment approach" section at the top of this file. + binaries += self._collect_all_or_none(['icudt??.dll', 'icuin??.dll', 'icuuc??.dll']) + + return binaries + + # Collect additional shared libraries required for SSL support in QtNetwork, if they are available. + # Primarily applicable to Windows (see issue #3520, #4048). + def collect_qtnetwork_files(self): + """ + Collect extra binaries/shared libraries required by the QtNetwork module, such as OpenSSL shared libraries. + """ + + # No-op if requested Qt-based package is not available. + if self.version is None: + return [] + + # Check if QtNetwork supports SSL and has OpenSSL backend available (Qt >= 6.1). + # Also query the run-time OpenSSL version, so we know what dynamic libraries we need to search for. + @isolated.decorate + def _check_if_openssl_enabled(package): + import sys + import importlib + + # Import the Qt-based package + # equivalent to: from package.QtCore import QCoreApplication + QtCore = importlib.import_module('.QtCore', package) + QCoreApplication = QtCore.QCoreApplication + QLibraryInfo = QtCore.QLibraryInfo + # equivalent to: from package.QtNetwork import QSslSocket + QtNetwork = importlib.import_module('.QtNetwork', package) + QSslSocket = QtNetwork.QSslSocket + + # Instantiate QCoreApplication to suppress warnings + app = QCoreApplication(sys.argv) # noqa: F841 + + if not QSslSocket.supportsSsl(): + return False, None + + # Query the run-time OpenSSL version + openssl_version = QSslSocket.sslLibraryVersionNumber() + + # For Qt >= 6.1, check if `openssl` TLS backend is available + try: + qt_version = QLibraryInfo.version().segments() + except AttributeError: + qt_version = [] # Qt <= 5.8 + + if qt_version < [6, 1]: + return True, openssl_version # TLS backends not implemented yet + + return ('openssl' in QSslSocket.availableBackends(), openssl_version) + + openssl_enabled, openssl_version = _check_if_openssl_enabled(self.namespace) + if not openssl_enabled or openssl_version == 0: + logger.debug("%s: QtNetwork: does not support SSL or does not use OpenSSL.", self) + return [] + + # The actual search is handled in OS-specific ways. + if compat.is_win: + return self._collect_qtnetwork_openssl_windows(openssl_version) + elif compat.is_darwin: + return self._collect_qtnetwork_openssl_macos(openssl_version) + elif compat.is_linux: + return self._collect_qtnetwork_openssl_linux(openssl_version) + else: + logger.warning("%s: QtNetwork: collection of OpenSSL not implemented for this platform!") + return [] + + def _collect_qtnetwork_openssl_windows(self, openssl_version): + """ + Windows-specific collection of OpenSSL DLLs required by QtNetwork module. + """ + + # Package parent path; used to preserve the directory structure when DLLs are collected from the python + # package (e.g., PyPI wheels). + package_parent_path = self.package_location.parent + + # The OpenSSL DLLs might be shipped with PyPI wheel (PyQt5), might be available in the environment (msys2, + # anaconda), or might be expected to be available in the environment (PySide2, PySide6, PyQt6 PyPI wheels). + # + # The OpenSSL DLL naming scheme depends on the version: + # - OpenSSL 1.0.x: libeay32.dll, ssleay32.dll + # - OpenSSL 1.1.x 32-bit: libssl-1_1.dll, libcrypto-1_1.dll + # - OpenSSL 1.1.x 64-bit: libssl-1_1-x64.dll, libcrypto-1_1-x64.dll + # - OpenSSL 3.0.x 32-bit: libssl-1.dll, libcrypto-3.dll + # - OpenSSL 3.0.x 64-bit: libssl-3-x64.dll, libcrypto-3-x64.dll + # + # The official Qt builds (which are used by PySide and PyQt PyPI wheels) seem to be build against: + # - OpenSSL 1.1.x starting with Qt5 5.14.2: + # https://www.qt.io/blog/2019/06/17/qt-5-12-4-released-support-openssl-1-1-1 + # - OpenSSL 3.x starting with Qt6 6.5.0: + # https://www.qt.io/blog/moving-to-openssl-3-in-binary-builds-starting-from-qt-6.5-beta-2 + # + # However, a package can build Qt against OpenSSL version of their own choice. For example, at the time of + # writing, both mingw-w64-x86_64-qt5-base 5.15.11+kde+r138-1 and mingw-w64-x86_64-qt6-base 6.6.0-2 packages + # depend on mingw-w64-x86_64-openssl 3.1.4-1 (so OpenSSL 3). + # + # Luckily, we can query the run-time version of OpenSSL by calling `QSslSocket.sslLibraryVersionNumber()`, + # and narrow down the search for specific version. + if openssl_version >= 0x10000000 and openssl_version < 0x10100000: + # OpenSSL 1.0.x - used by old Qt5 builds + dll_names = ( + 'libeay32.dll', + 'ssleay32.dll', + ) + logger.debug("%s: QtNetwork: looking for OpenSSL 1.0.x DLLs: %r", self, dll_names) + elif openssl_version >= 0x10100000 and openssl_version < 0x30000000: + # OpenSSL 1.1.x + dll_names = ( + 'libssl-1_1-x64.dll' if compat.is_64bits else 'libssl-1_1.dll', + 'libcrypto-1_1-x64.dll' if compat.is_64bits else 'libcrypto-1_1.dll', + ) + logger.debug("%s: QtNetwork: looking for OpenSSL 1.1.x DLLs: %r", self, dll_names) + elif openssl_version >= 0x30000000 and openssl_version < 0x40000000: + # OpenSSL 3.0.x + dll_names = ( + 'libssl-3-x64.dll' if compat.is_64bits else 'libssl-3.dll', + 'libcrypto-3-x64.dll' if compat.is_64bits else 'libcrypto-3.dll', + ) + logger.debug("%s: QtNetwork: looking for OpenSSL 3.0.x DLLs: %r", self, dll_names) + else: + dll_names = [] # Nothing to search for + logger.warning("%s: QtNetwork: unsupported OpenSSL version: %X", self, openssl_version) + + binaries = [] + found_in_package = False + for dll in dll_names: + # Attempt to resolve the DLL path + dll_file_path = bindepend.resolve_library_path(dll, search_paths=[self.qt_lib_dir]) + if dll_file_path is None: + continue + dll_file_path = pathlib.Path(dll_file_path).resolve() + if package_parent_path in dll_file_path.parents: + # The DLL is located within python package; preserve the layout + dst_dll_path = dll_file_path.parent.relative_to(package_parent_path) + found_in_package = True + else: + # The DLL is not located within python package; collect into top-level directory + dst_dll_path = '.' + binaries.append((str(dll_file_path), str(dst_dll_path))) + + # If we found at least one OpenSSL DLL in the bindings' python package directory, discard all external + # OpenSSL DLLs. + if found_in_package: + binaries = [(dll_src_path, dll_dest_path) for dll_src_path, dll_dest_path in binaries + if package_parent_path in pathlib.Path(dll_src_path).parents] + + return binaries + + def _collect_qtnetwork_openssl_macos(self, openssl_version): + """ + macOS-specific collection of OpenSSL dylibs required by QtNetwork module. + """ + + # The official Qt5 builds on macOS (shipped by PyPI wheels) appear to be built with Apple's SecureTransport API + # instead of OpenSSL; for example, `QSslSocket.sslLibraryVersionNumber` returns 0, while + # `sslLibraryVersionString()` returns "Secure Transport, macOS 12.6". So with PySide2 and PyQt5, we do not need + # to worry about collection of OpenSSL shared libraries. + # + # Support for OpenSSL was introduced in Qt 6.1 with `openssl` TLS backend; the official Qt6 builds prior to 6.5 + # seem to be built with OpenSSL 1.1.x, and later versions with 3.0.x. However, PySide6 and PyQt6 PyPI wheels do + # not ship OpenSSL dynamic libraries at all , so whether `openssl` TLS backend is used or not depends on the + # presence of externally provided OpenSSL dynamic libraries (for example, provided by Homebrew). It is worth + # noting that python.org python installers *do* provide OpenSSL shared libraries (1.1.x for python <= 3.10, + # 3.0.x for python >= 3.12, and both for python 3.11) for its `_ssl` extension - however, these are NOT visible + # to Qt and its QtNetwork module. + # + # When the frozen application is built and we collect python's `_ssl` extension, we also collect the OpenSSL + # shared libraries shipped by python. So at least in theory, those should be available to QtNetwork module as + # well (assuming they are of compatible version). However, this is not exactly the case - QtNetwork looks for + # the libraries in locations given by `DYLD_LIBRARY_PATH` environment variable and in .app/Contents/Frameworks + # (if the program is an .app bundle): + # + # https://github.com/qt/qtbase/blob/6.6.0/src/plugins/tls/openssl/qsslsocket_openssl_symbols.cpp#L590-L599 + # + # So it works out-of-the box for our .app bundles, because starting with PyInstaller 6.0, `sys._MEIPASS` is in + # .app/Contents/Frameworks. But it does not with POSIX builds, because bootloader does not modify the + # `DYLD_LIBRARY_PATH` environment variable to include `sys._MEIPASS` (since we usually do not need that; + # regular linked library resolution in our macOS builds is done via path rewriting and rpaths). So either we + # need a run-time hook to add `sys._MEIPASS` to `DYLD_LIBRARY_PATH`, or modify the bootloader to always do that. + # + # Collecting the OpenSSL library and making it discoverable by adding `sys._MEIPASS` to `DYLD_LIBRARY_PATH` + # should also prevent QtNetwork from "accidentally" pulling in Homebrew version at run-time (if Homebrew is + # installed on the target system and provides compatible OpenSSL version). + # + # Therefore, try to resolve OpenSSL library via the version indicated by `QSslSocket.sslLibraryVersionNumber`; + # however, we first explicitly search only {sys.base_prefix}/lib (which is where python.org builds put their + # dynamic libs), and only if that fails, perform regular dylib path resolution. This way we ensure that if the + # OpenSSL dylibs are provided by python itself, we always prefer those over the Homebrew version (since we are + # very likely going to collect them for python's `_ssl` extension anyway). + + # As per above text, we need to worry only about Qt6, and thus OpenSSL 1.1.x or 3.0.x + if openssl_version >= 0x10100000 and openssl_version < 0x30000000: + # OpenSSL 1.1.x + dylib_names = ( + 'libcrypto.1.1.dylib', + 'libssl.1.1.dylib', + ) + logger.debug("%s: QtNetwork: looking for OpenSSL 1.1.x dylibs: %r", self, dylib_names) + elif openssl_version >= 0x30000000 and openssl_version < 0x40000000: + # OpenSSL 3.0.x + dylib_names = ( + 'libcrypto.3.dylib', + 'libssl.3.dylib', + ) + logger.debug("%s: QtNetwork: looking for OpenSSL 3.0.x dylibs: %r", self, dylib_names) + else: + dylib_names = [] # Nothing to search for + logger.warning("%s: QtNetwork: unsupported OpenSSL version: %X", self, openssl_version) + + # Compared to Windows, we do not have to worry about dylib's path preservation, as these are never part of + # the package, and are therefore always collected to the top-level application directory. + binaries = [] + base_prefix_lib_dir = os.path.join(compat.base_prefix, 'lib') + for dylib in dylib_names: + # First, attempt to resolve using only {sys.base_prefix}/lib - `bindepend.resolve_library_path` uses + # standard dyld search semantics and uses the given search paths as fallback (and would therefore + # favor Homebrew-provided version of the library). + dylib_path = bindepend._resolve_library_path_in_search_paths(dylib, search_paths=[base_prefix_lib_dir]) + if dylib_path is None: + dylib_path = bindepend.resolve_library_path(dylib, search_paths=[base_prefix_lib_dir, self.qt_lib_dir]) + if dylib_path is None: + continue + binaries.append((str(dylib_path), '.')) + + return binaries + + def _collect_qtnetwork_openssl_linux(self, openssl_version): + """ + Linux-specific collection of OpenSSL dylibs required by QtNetwork module. + """ + + # Out of the supported OSes, Linux is by far the most straight-forward, because OpenSSL shared libraries are + # expected to be provided by the system. So we can just use standard library path resolution with library names + # inferred from the run-time OpenSSL version. At run-time, QtNetwork searches paths from `LD_LIBRARY_PATH`, and + # on Linux, our bootloader already adds `sys._MEIPASS` to that environment variable. + + if openssl_version >= 0x10000000 and openssl_version < 0x10100000: + # OpenSSL 1.0.x - used by old Qt5 builds + shlib_names = ( + 'libcrypto.so.10', + 'libssl.so.10', + ) + logger.debug("%s: QtNetwork: looking for OpenSSL 1.0.x shared libraries: %r", self, shlib_names) + elif openssl_version >= 0x10100000 and openssl_version < 0x30000000: + # OpenSSL 1.1.x + shlib_names = ( + 'libcrypto.so.1.1', + 'libssl.so.1.1', + ) + logger.debug("%s: QtNetwork: looking for OpenSSL 1.1.x shared libraries: %r", self, shlib_names) + elif openssl_version >= 0x30000000 and openssl_version < 0x40000000: + # OpenSSL 3.0.x + shlib_names = ( + 'libcrypto.so.3', + 'libssl.so.3', + ) + logger.debug("%s: QtNetwork: looking for OpenSSL 3.0.x shared libraries: %r", self, shlib_names) + else: + shlib_names = [] # Nothing to search for + logger.warning("%s: QtNetwork: unsupported OpenSSL version: %X", self, openssl_version) + + binaries = [] + for shlib in shlib_names: + shlib_path = bindepend.resolve_library_path(shlib) + if shlib_path is None: + continue + binaries.append((str(shlib_path), '.')) + + return binaries + + def collect_qtqml_files(self): + """ + Collect additional binaries and data for QtQml module. + """ + + # No-op if requested Qt-based package is not available. + if self.version is None: + return [], [] + + # Not all PyQt5/PySide2 installs have QML files. In this case, location['Qml2ImportsPath'] is empty. + # Furthermore, even if location path is provided, the directory itself may not exist. + # + # https://github.com/pyinstaller/pyinstaller/pull/3229#issuecomment-359735031 + # https://github.com/pyinstaller/pyinstaller/issues/3864 + # + # In Qt 6, Qml2ImportsPath was deprecated in favor of QmlImportsPath. The former is not available in PySide6 + # 6.4.0 anymore (but is in PyQt6 6.4.0). Use the new QmlImportsPath if available. + if 'QmlImportsPath' in self.location: + qml_src_dir = self.location['QmlImportsPath'] + else: + qml_src_dir = self.location['Qml2ImportsPath'] + if not qml_src_dir or not os.path.isdir(qml_src_dir): + logger.warning('%s: QML directory %r does not exist. QML files not packaged.', self, qml_src_dir) + return [], [] + + qml_src_path = pathlib.Path(qml_src_dir).resolve() + qml_dest_path = pathlib.PurePath(self.qt_rel_dir) / 'qml' + + binaries = [] + datas = [] + + # Helper that computes the destination directory for the given file or directory from a QML plugin directory. + def _compute_dest_dir(src_filename): + if src_filename.is_dir(): + rel_path = src_filename.relative_to(qml_src_path) + else: + rel_path = src_filename.relative_to(qml_src_path).parent + return qml_dest_path / rel_path + + # Discover all QML plugin sub-directories by searching for `qmldir` files. + qmldir_files = qml_src_path.rglob('**/qmldir') + for qmldir_file in sorted(qmldir_files): + plugin_dir = qmldir_file.parent + logger.debug("%s: processing QML plugin directory %s", self, plugin_dir) + + try: + # Obtain lists of source files (separated into binaries and data files). + plugin_binaries, plugin_datas = self._process_qml_plugin(qmldir_file) + # Convert into (src, dest) tuples. + binaries += [(str(src_file), str(_compute_dest_dir(src_file))) for src_file in plugin_binaries] + datas += [(str(src_file), str(_compute_dest_dir(src_file))) for src_file in plugin_datas] + except Exception: + logger.warning("%s: failed to process QML plugin directory %s", self, plugin_dir, exc_info=True) + + return binaries, datas + + # https://doc.qt.io/qt-6/qtqml-modules-qmldir.html#plugin-declaration + # [optional] plugin [ + _qml_plugin_def = re.compile(r"^(?:(?:optional)\s+)?(?:plugin)\s+(?P\w+)(?:\s+(?P\.+))?$") + + def _process_qml_plugin(self, qmldir_file): + """ + Processes the QML directory corresponding to the given `qmldir` file. + + Returns lists of binaries and data files, but only the source file names. It is up to caller to turn these into + lists of (src, dest) tuples. + """ + plugin_dir = qmldir_file.parent + + plugin_binaries = set() + + # Read the `qmldir` file to determine the names of plugin binaries, if any. + contents = qmldir_file.read_text(encoding="utf-8") + for line in contents.splitlines(): + m = self._qml_plugin_def.match(line) + if m is None: + continue + + plugin_name = m.group("name") + plugin_path = m.group("path") + + # We currently do not support custom plugin path - neither relative nor absolute (the latter will never + # be supported, because to make it relocatable, we would need to modify the `qmpldir file`). + if plugin_path is not None: + raise Exception(f"Non-empty plugin path ({plugin_path!r} is not supported yet!") + + # Turn the plugin base name into actual shared lib name. + if compat.is_linux: + plugin_file = plugin_dir / f"lib{plugin_name}.so" + elif compat.is_win: + plugin_file = plugin_dir / f"{plugin_name}.dll" + elif compat.is_darwin: + plugin_file = plugin_dir / f"lib{plugin_name}.dylib" + else: + continue # This implicitly disables subsequent validation on unhandled platforms. + + # Warn if plugin file does not exist + if not plugin_file.is_file(): + logger.warn("%s: QML plugin binary %r does not exist!", str(plugin_file)) + continue + + plugin_binaries.add(plugin_file) + + # Exclude plugins with invalid Qt dependencies. + invalid_binaries = False + for plugin_binary in plugin_binaries: + valid, reason = self._validate_plugin_dependencies(plugin_binary) + if not valid: + logger.debug("%s: excluding QML plugin binary %r! Reason: %s", self, str(plugin_binary), reason) + invalid_binaries = True + + # If there was an invalid binary, discard the plugin. + if invalid_binaries: + logger.debug("%s: excluding QML plugin directory %r due to invalid plugin binaries!", self, str(plugin_dir)) + return [], [] + + # Generate binaries list. + binaries = sorted(plugin_binaries) + + # Generate list of data files - all content of this directory, except for the plugin binaries. Sub-directories + # are included if they do not contain a `qmldir` file (we do not recurse into the directory, but instead pass + # only its name, leaving the recursion to PyInstaller's built-in expansion of paths returned by hooks). + datas = [] + for entry in plugin_dir.iterdir(): + if entry.is_file(): + if entry in plugin_binaries: + continue + else: + if (entry / "qmldir").is_file(): + continue + datas.append(entry) + + return binaries, datas + + def collect_qtwebengine_files(self): + """ + Collect QtWebEngine helper process executable, translations, and resources. + """ + + binaries = [] + datas = [] + + # Output directory (varies between PyQt and PySide and among OSes; the difference is abstracted by + # QtLibraryInfo.qt_rel_dir) + rel_data_path = self.qt_rel_dir + + is_macos_framework = False + if compat.is_darwin: + # Determine if we are dealing with a framework-based Qt build (e.g., PyPI wheels) or a dylib-based one + # (e.g., Anaconda). The former requires special handling, while the latter is handled in the same way as + # Windows and Linux builds. + is_macos_framework = os.path.exists( + os.path.join(self.location['LibrariesPath'], 'QtWebEngineCore.framework') + ) + + if is_macos_framework: + # macOS .framework bundle + src_framework_path = os.path.join(self.location['LibrariesPath'], 'QtWebEngineCore.framework') + + # If Qt libraries are bundled with the package, collect the .framework bundle into corresponding package's + # subdirectory, because binary dependency analysis will also try to preserve the directory structure. + # However, if we are collecting from system-wide Qt installation (e.g., Homebrew-installed Qt), the binary + # depndency analysis will attempt to re-create .framework bundle in top-level directory, so we need to + # collect the extra files there. + bundled_qt_libs = pathlib.Path(self.package_location) in pathlib.Path(src_framework_path).parents + if bundled_qt_libs: + dst_framework_path = os.path.join(rel_data_path, 'lib/QtWebEngineCore.framework') + else: + dst_framework_path = 'QtWebEngineCore.framework' # In top-level directory + + # Determine the version directory - for now, we assume we are dealing with single-version framework; + # i.e., the Versions directory contains only a single directory, and Current symlink to it. + versions = sorted([ + version for version in os.listdir(os.path.join(src_framework_path, 'Versions')) if version != 'Current' + ]) + if len(versions) == 0: + raise RuntimeError("Could not determine version of the QtWebEngineCore.framework!") + elif len(versions) > 1: + logger.warning( + "Found multiple versions in QtWebEngineCore.framework (%r) - using the last one!", versions + ) + version = versions[-1] + + # Collect the Helpers directory. In well-formed .framework bundles (such as the ones provided by Homebrew), + # the Helpers directory is located in the versioned directory, and symlinked to the top-level directory. + src_helpers_path = os.path.join(src_framework_path, 'Versions', version, 'Helpers') + dst_helpers_path = os.path.join(dst_framework_path, 'Versions', version, 'Helpers') + if not os.path.exists(src_helpers_path): + # Alas, the .framework bundles shipped with contemporary PyPI PyQt/PySide wheels are not well-formed + # (presumably because .whl cannot preserve symlinks?). The Helpers in the top-level directory is in fact + # the hard copy, and there is either no Helpers in versioned directory, or there is a duplicate. + # So fall back to collecting from the top-level, but collect into versioned directory in order to + # be compliant with codesign's expectations. + src_helpers_path = os.path.join(src_framework_path, 'Helpers') + + helper_datas = hooks.collect_system_data_files(src_helpers_path, dst_helpers_path) + + # Filter out the actual helper executable from datas, and add it to binaries instead. This ensures that it + # undergoes additional binary processing that rewrites the paths to linked libraries. + HELPER_EXE = 'QtWebEngineProcess.app/Contents/MacOS/QtWebEngineProcess' + for src_name, dest_name in helper_datas: + if src_name.endswith(HELPER_EXE): + binaries.append((src_name, dest_name)) + else: + datas.append((src_name, dest_name)) + + # Collect the Resources directory; same logic is used as with Helpers directory. + src_resources_path = os.path.join(src_framework_path, 'Versions', version, 'Resources') + dst_resources_path = os.path.join(dst_framework_path, 'Versions', version, 'Resources') + if not os.path.exists(src_resources_path): + src_resources_path = os.path.join(src_framework_path, 'Resources') + + datas += hooks.collect_system_data_files(src_resources_path, dst_resources_path) + + # NOTE: the QtWebEngineProcess helper is actually sought within the `QtWebEngineCore.framework/Helpers`, + # which ought to be a symlink to `QtWebEngineCore.framework/Versions/Current/Helpers`, where `Current` + # is also a symlink to the actual version directory, `A`. + # + # These symlinks are created automatically when the TOC list of collected resources is post-processed + # using `PyInstaller.utils.osx.collect_files_from_framework_bundles` helper, so we do not have to + # worry about them here... + else: + # Windows and linux (or Anaconda on macOS) + locales = 'qtwebengine_locales' + resources = 'resources' + + # Translations + datas.append(( + os.path.join(self.location['TranslationsPath'], locales), + os.path.join(rel_data_path, 'translations', locales), + )) + + # Resources; ``DataPath`` is the base directory for ``resources``, as per the + # `docs `_. + datas.append((os.path.join(self.location['DataPath'], resources), os.path.join(rel_data_path, resources)),) + + # Helper process executable (QtWebEngineProcess), located in ``LibraryExecutablesPath``. + # The target directory is determined as `LibraryExecutablesPath` relative to `PrefixPath`. On Windows, + # this should handle the differences between PySide2/PySide6 and PyQt5/PyQt6 PyPI wheel layout. + rel_helper_path = os.path.relpath(self.location['LibraryExecutablesPath'], self.location['PrefixPath']) + + # However, on Linux, we need to account for distribution-packaged Qt, where `LibraryExecutablesPath` might + # be nested deeper under `PrefixPath` than anticipated (w.r.t. PyPI wheel layout). For example, in Fedora, + # the helper is located under `/usr/lib64/qt5/libexec/QtWebEngineProcess`, with `PrefixPath` being `/usr` + # and `LibraryExecutablesPath` being `/usr/lib64/qt5/libexec/`, so the relative path ends up being + # `lib64/qt5/libexec` instead of just `libexec`. So on linux, we explicitly force the PyPI-compliant + # layout, by overriding relative helper path to just `libexec`. + if compat.is_linux and rel_helper_path != "libexec": + logger.info( + "%s: overriding relative destination path of QtWebEngineProcess helper from %r to %r!", self, + rel_helper_path, "libexec" + ) + rel_helper_path = "libexec" + + # Similarly, force the relative helper path for PySide2/PySide6 on Windows to `.`. This is already the case + # with PyPI PySide Windows wheels. But it is not the case with conda-installed PySide2, where the Qt's + # `PrefixPath` is for example `C:/Users//miniconda3/envs//Library`, while the corresponding + # `LibraryExecutablesPath` is `C:/Users//miniconda3/envs//Library/bin`. + if compat.is_win and not self.is_pyqt and rel_helper_path != ".": + logger.info( + "%s: overriding relative destination path of QtWebEngineProcess helper from %r to %r!", self, + rel_helper_path, "." + ) + rel_helper_path = "." + + dest = os.path.normpath(os.path.join(rel_data_path, rel_helper_path)) + binaries.append((os.path.join(self.location['LibraryExecutablesPath'], 'QtWebEngineProcess*'), dest)) + + # The helper QtWebEngineProcess executable should have an accompanying qt.conf file that helps it locate the + # Qt shared libraries. Try collecting it as well + qt_conf_file = os.path.join(self.location['LibraryExecutablesPath'], 'qt.conf') + if not os.path.isfile(qt_conf_file): + # The file seems to have been dropped from Qt 6.3 (and corresponding PySide6 and PyQt6) due to + # redundancy; however, we still need it in the frozen application - so generate our own. + from PyInstaller.config import CONF # workpath + # Relative path to root prefix of bundled Qt - this corresponds to the "inverse" of `rel_helper_path` + # variable that we computed earlier. + if rel_helper_path == '.': + rel_prefix = '.' + else: + # Replace each directory component in `rel_helper_path` with `..`. + rel_prefix = os.path.join(*['..' for _ in range(len(rel_helper_path.split(os.pathsep)))]) + # We expect the relative path to be either . or .. depending on PySide/PyQt layout; if that is not the + # case, warn about irregular path. + if rel_prefix not in ('.', '..'): + logger.warning( + "%s: unexpected relative Qt prefix path for QtWebEngineProcess qt.conf: %s", self, rel_prefix + ) + # The Qt docs on qt.conf (https://doc.qt.io/qt-5/qt-conf.html) recommend using forward slashes on + # Windows as well, due to backslash having to be escaped. This should not matter as we expect the + # relative path to be . or .., but you never know... + if os.sep == '\\': + rel_prefix = rel_prefix.replace(os.sep, '/') + # Create temporary file in workpath + qt_conf_file = os.path.join(CONF['workpath'], "qt.conf") + with open(qt_conf_file, 'w', encoding='utf-8') as fp: + print("[Paths]", file=fp) + print("Prefix = {}".format(rel_prefix), file=fp) + datas.append((qt_conf_file, dest)) + + # Add Linux-specific libraries. + if compat.is_linux: + # The automatic library detection fails for `NSS `_, + # which is used by QtWebEngine. In some distributions, the ``libnss`` supporting libraries are stored in a + # subdirectory ``nss``. Since ``libnss`` is not linked against them but loads them dynamically at run-time, + # we need to search for and add them. + # + # Specifically, the files we are looking for are + # - libfreebl3.so + # - libfreeblpriv3.so + # - libnssckbi.so + # - libnssdbm3.so + # - libsoftokn3.so + # and they might be in the same directory as ``libnss3.so`` (instead of ``nss`` subdirectory); this is + # the case even with contemporary Debian releases. See + # https://packages.debian.org/bullseye/amd64/libnss3/filelist + # vs. + # https://packages.debian.org/bookworm/amd64/libnss3/filelist + + # Analyze imports of ``QtWebEngineCore`` extension module, and look for ``libnss3.so`` to determine its + # parent directory. + libnss_dir = None + module_file = hooks.get_module_file_attribute(self.namespace + '.QtWebEngineCore') + for lib_name, lib_path in bindepend.get_imports(module_file): # (name, fullpath) tuples + if lib_path is None: + continue # Skip unresolved libraries + # Look for ``libnss3.so``. + if os.path.basename(lib_path).startswith('libnss3.so'): + libnss_dir = os.path.dirname(lib_path) + break + + # Search for NSS libraries + logger.debug("%s: QtWebEngineCore is linked against libnss3.so; collecting NSS libraries...", self) + if libnss_dir is not None: + # Libraries to search for + NSS_LIBS = [ + 'libfreebl3.so', + 'libfreeblpriv3.so', + 'libnssckbi.so', + 'libnssdbm3.so', + 'libsoftokn3.so', + ] + # Directories (relative to `libnss_dir`) to search in. Also serve as relative destination paths. + NSS_LIB_SUBDIRS = [ + 'nss', + '.', + ] + + for subdir in NSS_LIB_SUBDIRS: + for lib_name in NSS_LIBS: + lib_file = os.path.normpath(os.path.join(libnss_dir, subdir, lib_name)) + if os.path.isfile(lib_file): + logger.debug("%s: collecting NSS library: %r", self, lib_file) + binaries.append((lib_file, subdir)) + + return binaries, datas + + +# Provide single instances of this class to avoid each hook constructing its own. +pyqt5_library_info = QtLibraryInfo('PyQt5') +pyqt6_library_info = QtLibraryInfo('PyQt6') +pyside2_library_info = QtLibraryInfo('PySide2') +pyside6_library_info = QtLibraryInfo('PySide6') + + +def get_qt_library_info(namespace): + """ + Return QtLibraryInfo instance for the given namespace. + """ + if namespace == 'PyQt5': + return pyqt5_library_info + if namespace == 'PyQt6': + return pyqt6_library_info + elif namespace == 'PySide2': + return pyside2_library_info + elif namespace == 'PySide6': + return pyside6_library_info + + raise ValueError(f'Invalid namespace: {namespace}!') + + +# add_qt_dependencies +# -------------------- +# Generic implemnentation that finds the Qt 5/6 dependencies based on the hook name of a PyQt5/PyQt6/PySide2/PySide6 +# hook. Returns (hiddenimports, binaries, datas). Typical usage: +# ``hiddenimports, binaries, datas = add_qt5_dependencies(__file__)``. +def add_qt_dependencies(hook_file): + # Find the module underlying this Qt hook: change ``/path/to/hook-PyQt5.blah.py`` to ``PyQt5.blah``. + hook_name, hook_ext = os.path.splitext(os.path.basename(hook_file)) + assert hook_ext.startswith('.py') + assert hook_name.startswith('hook-') + module_name = hook_name[5:] + namespace = module_name.split('.')[0] + + # Retrieve Qt library info structure.... + qt_info = get_qt_library_info(namespace) + # ... and use it to collect module dependencies + return qt_info.collect_module(module_name) + + +# add_qt5_dependencies +# -------------------- +# Find the Qt5 dependencies based on the hook name of a PySide2/PyQt5 hook. Returns (hiddenimports, binaries, datas). +# Typical usage: ``hiddenimports, binaries, datas = add_qt5_dependencies(__file__)``. +add_qt5_dependencies = add_qt_dependencies # Use generic implementation + +# add_qt6_dependencies +# -------------------- +# Find the Qt6 dependencies based on the hook name of a PySide6/PyQt6 hook. Returns (hiddenimports, binaries, datas). +# Typical usage: ``hiddenimports, binaries, datas = add_qt6_dependencies(__file__)``. +add_qt6_dependencies = add_qt_dependencies # Use generic implementation + + +# A helper for ensuring that only one Qt bindings package is collected into frozen application. Intended to be called +# from hooks for top-level bindings packages. +def ensure_single_qt_bindings_package(qt_bindings): + # For the lack of better alternative, use CONF structure. Note that this enforces single bindings for the whole + # spec file instead of individual Analysis instances! + from PyInstaller.config import CONF + + seen_qt_bindings = CONF.get("_seen_qt_bindings") + if seen_qt_bindings is None: + CONF["_seen_qt_bindings"] = qt_bindings + elif qt_bindings != seen_qt_bindings: + # Raise SystemExit to abort build process + raise SystemExit( + "ERROR: Aborting build process due to attempt to collect multiple Qt bindings packages: attempting to run " + f"hook for {qt_bindings!r}, while hook for {seen_qt_bindings!r} has already been run! PyInstaller does not " + "support multiple Qt bindings packages in a frozen application - either ensure that the build environment " + "has only one Qt bindings package installed, or exclude the extraneous bindings packages via the module " + "exclusion mechanism (--exclude command-line option, or excludes list in the spec file)." + ) + + +# A helper for generating exclude rules for extraneous Qt bindings. Intended for use in hooks for packages that pull in +# multiple Qt bindings packages due to conditional imports (for example, `matplotlib.backends.qt_compat`, `qtpy`). +def exclude_extraneous_qt_bindings(hook_name, qt_bindings_order=None): + _QT_BINDINGS = ['PyQt5', 'PySide2', 'PyQt6', 'PySide6'] # Known bindings, and also their preferred order + _QT_API_ENV = 'QT_API' + + def _create_excludes(selected_bindings): + return [bindings for bindings in _QT_BINDINGS if bindings != selected_bindings] + + logger.debug("%s: selecting Qt bindings package...", hook_name) + + if not qt_bindings_order: + qt_bindings_order = _QT_BINDINGS # Use default preference order + + env_qt_bindings = os.environ.get(_QT_API_ENV) + if env_qt_bindings is not None: + # Case-normalize the value into capitalized name from _QT_BINDINGS for further processing. + normalized_name = {name.lower(): name for name in _QT_BINDINGS}.get(env_qt_bindings.lower()) + if normalized_name is None: + logger.warning( + "%s: ignoring unsupported Qt bindings name %r in %s environment variable (supported values: %r)!", + hook_name, env_qt_bindings, _QT_API_ENV, _QT_BINDINGS + ) + env_qt_bindings = normalized_name + + # First choice: see if a hook for top-level Qt bindings package has already been run; if it has, use that bindings + # package. Due to check in the `ensure_single_qt_bindings_package` that these hooks use, only one such hook could + # have been run. This should cover cases when the entry-point script explicitly imports one of Qt bindings before + # importing a package that supports multiple bindings. + from PyInstaller.config import CONF + seen_qt_bindings = CONF.get("_seen_qt_bindings") + if seen_qt_bindings is not None: + # If bindings are also specified via environment variable and they differ, display a warning. + if env_qt_bindings is not None and env_qt_bindings != seen_qt_bindings: + logger.warning( + "%s: ignoring %s environment variable (%r) because hook for %r has been run!", hook_name, _QT_API_ENV, + env_qt_bindings, seen_qt_bindings + ) + + logger.info( + "%s: selected %r as Qt bindings because hook for %r has been run before.", hook_name, seen_qt_bindings, + seen_qt_bindings + ) + return _create_excludes(seen_qt_bindings) + + # Second choice: honor the QT_API environment variable, if it specified a valid Qt bindings package. + if env_qt_bindings is not None: + logger.info( + "%s: selected %r as Qt bindings as specified by the %s environment variable.", hook_name, env_qt_bindings, + _QT_API_ENV + ) + return _create_excludes(env_qt_bindings) + + # Third choice: select first available bindings (sorted by the given preference order), and display a warning if + # multiple bindings are available. + available_qt_bindings = [] + for bindings_name in qt_bindings_order: + # Check if bindings are available + info = get_qt_library_info(bindings_name) + if info.version is None: + continue + available_qt_bindings.append(bindings_name) + + if not available_qt_bindings: + logger.warning("%s: no Qt bindings are available!", hook_name) + return [] # No need to generate any excludes... + + selected_qt_bindings = available_qt_bindings[0] + if len(available_qt_bindings) == 1: + logger.info("%s: selected %r as the only available Qt bindings.", hook_name, selected_qt_bindings) + else: + # Warn on multiple bindings, and tell user to use QT_API environment variable + logger.warning( + "%s: selected %r as Qt bindings, but multiple bindings are available: %r. Use the %s environment variable " + "to select different bindings and suppress this warning.", hook_name, selected_qt_bindings, + available_qt_bindings, _QT_API_ENV + ) + return _create_excludes(selected_qt_bindings) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/qt/_modules_info.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/qt/_modules_info.py new file mode 100755 index 0000000..cd01bf9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/qt/_modules_info.py @@ -0,0 +1,450 @@ +# ---------------------------------------------------------------------------- +# Copyright (c) 2022-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +# Qt modules information - the core of our Qt collection approach +# ---------------------------------------------------------------- +# +# The python bindings for Qt (``PySide2``, ``PyQt5``, ``PySide6``, ``PyQt6``) consist of several python binary extension +# modules that provide bindings for corresponding Qt modules. For example, the ``PySide2.QtNetwork`` python extension +# module provides bindings for the ``QtNetwork`` Qt module from the ``qt/qtbase`` Qt repository. +# +# A Qt module can be considered as consisting of: +# * a shared library (for example, on Linux, the shared library names for the ``QtNetwork`` Qt module in Qt5 and Qt6 +# are ``libQt5Network.so`` and ``libQt6Network.so``, respectively). +# * plugins: a certain type (or class) of plugins is usually associated with a single Qt module (for example, +# ``imageformats`` plugins are associated with the ``QtGui`` Qt module from the ``qt/qtbase`` Qt repository), but +# additional plugins of that type may come from other Qt repositories. For example, ``imageformats/qsvg`` plugin +# is provided by ``qtsvg/src/plugins/imageformats/svg`` from the ``qt/qtsvg`` repository, and ``imageformats/qpdf`` +# is provided by ``qtwebengine/src/pdf/plugins/imageformats/pdf`` from the ``qt/qtwebengine`` repository. +# * translation files: names of translation files consist of a base name, which typically corresponds to the Qt +# repository name, and language code. A single translation file usually covers all Qt modules contained within +# the same repository. For example, translation files with base name ``qtbase`` contain translations for ``QtCore``, +# ``QtGui``, ``QtWidgets``, ``QtNetwork``, and other Qt modules from the ``qt/qtbase`` Qt repository. +# +# The PyInstaller's built-in analysis of link-time dependencies ensures that when collecting a Qt python extension +# module, we automatically pick up the linked Qt shared libraries. However, collection of linked Qt shared libraries +# does not result in collection of plugins, nor translation files. In addition, the dependency of a Qt python extension +# module on other Qt python extension modules (i.e., at the bindings level) cannot be automatically determined due to +# PyInstaller's inability to scan imports in binary extensions. +# +# PyInstaller < 5.7 solved this problem using a dictionary that associated a Qt shared library name with python +# extension name, plugins, and translation files. For each hooked Qt python extension module, the hook calls a helper +# that analyzes the extension file for link-time dependencies, and matches those against the dictionary. Therefore, +# based on linked shared libraries, we could recursively infer the list of files to collect in addition to the shared +# libraries themselves: +# - plugins and translation files belonging to Qt modules whose shared libraries we collect +# - Qt python extension modules corresponding to the Qt modules that we collect +# +# The above approach ensures that even if analyzed python script contains only ``from PySide2 import QtWidgets``, +# we would also collect ``PySide2.QtGui`` and ``PySide2.QtCore``, as well as all corresponding Qt module files +# (the shared libraries, plugins, translation files). For this to work, a hook must be provided for the +# ``PySide2.QtWidgets`` that performs the recursive analysis of the extension module file; so to ensure that each +# Qt python extension module by itself ensures collection of all its dependencies, we need to hook all Qt python +# extension modules provided by specific python Qt bindings package. +# +# The above approach with single dictionary, however, has several limitations: +# - it cannot provide association for Qt python module that binds a Qt module without a shared library (i.e., a +# headers-only module, or a statically-built module). In such cases, potential plugins and translations should +# be associated directly with the Qt python extension file instead of the Qt module's (non-existent) shared library. +# - it cannot (directly) handle differences between Qt5 and Qt6; we had to build a second dictionary +# - it cannot handle differences between the bindings themselves; for example, PyQt5 binds some Qt modules that +# PySide2 does not bind. Or, the binding's Qt python extension module is named differently in PyQt and PySide +# bindings (or just differently in PyQt5, while PySide2, PySide6, and PyQt6 use the same name). +# +# In order address the above shortcomings, we now store all information a list of structures that contain information +# for a particular Qt python extension and/or Qt module (shared library): +# - python extension name (if applicable) +# - Qt module name base (if applicable) +# - plugins +# - translation files base name +# - applicable Qt version (if necessary) +# - applicable Qt bindings (if necessary) +# +# This list is used to dynamically construct two dictionaries (based on the bindings name and Qt version): +# - mapping python extension names to associated module information +# - mapping Qt shared library names to associated module information +# This allows us to associate plugins and translations with either Qt python extension or with the Qt module's shared +# library (or both), whichever is applicable. +# +# The `qt_dynamic_dependencies_dict`_ from the original approach was constructed using several information sources, as +# documented `here +# `_. +# +# In the current approach, the relations stored in the `QT_MODULES_INFO`_ list were determined directly, by inspecting +# the Qt source code. This requires some prior knowledge of how the Qt code is organized (repositories and individual Qt +# modules within them), as well as some searching based on guesswork. The procedure can be outlined as follows: +# * check out the `main Qt repository `_. This repository contains references to all other +# Qt repositories in the form of git submodules. +# * for Qt5: +# * check out the latest release tag, e.g., v5.15.2, then check out the submodules. +# * search the Qt modules' qmake .pro files; for example, ``qtbase/src/network/network.pro`` for QtNetwork module. +# The plugin types associated with the module are listed in the ``MODULE_PLUGIN_TYPES`` variable (in this case, +# ``bearer``). +# * all translations are gathered in ``qttranslations`` sub-module/repository, and their association with +# individual repositories can be seen in ``qttranslations/translations/translations.pro``. +# * for Qt6: +# * check out the latest release tag, e.g., v6.3.1, then check out the submodules. +# * search the Qt modules' CMake files; for example, ``qtbase/src/network/CMakeLists.txt`` for QtNetwork module. +# The plugin types associated with the module are listed under ``PLUGIN_TYPES`` argument of the +# ``qt_internal_add_module()`` function that defines the Qt module. +# +# The idea is to make a list of all extension modules found in a Qt bindings package, as well as all available plugin +# directories (which correspond to plugin types) and translation files. For each extension, identify the corresponding +# Qt module (shared library name) and its associated plugins and translation files. Once this is done, most of available +# plugins and translations in the python bindings package should have a corresponding python Qt extension module +# available; this gives us associations based on the python extension module names as well as based on the Qt shared +# library names. For any plugins and translation files remaining unassociated, identify the corresponding Qt module; +# this gives us associations based only on Qt shared library names. While this second group of associations are never +# processed directly (due to lack of corresponding python extension), they may end up being processed during the +# recursive dependency analysis, if the corresponding Qt shared library is linked against by some Qt python extension +# or another Qt shared library. + + +# This structure is used to define Qt module information, such as python module/extension name, Qt module (shared +# library) name, translation files' base names, plugins, as well as associated python bindings (which implicitly +# also encode major Qt version). +class _QtModuleDef: + def __init__(self, module, shared_lib=None, translations=None, plugins=None, bindings=None): + # Python module (extension) name without package namespace. For example, `QtCore`. + # Can be None if python bindings do not bind the module, but we still need to establish relationship between + # the Qt module (shared library) and its plugins and translations. + self.module = module + # Associated Qt module (shared library), if any. Used during recursive dependency analysis, where a python + # module (extension) is analyzed for linked Qt modules (shared libraries), and then their corresponding + # python modules (extensions) are added to hidden imports. For example, the Qt module name is `Qt5Core` or + # `Qt6Core`, depending on the Qt version. Can be None for python modules that are not tied to a particular + # Qt shared library (for example, the corresponding Qt module is headers-only) and hence they cannot be + # inferred from recursive link-time dependency analysis. + self.shared_lib = shared_lib + # List of base names of translation files (if any) associated with the Qt module. Multiple base names may be + # associated with a single module. + # For example, `['qt', 'qtbase']` for `QtCore` or `['qtmultimedia']` for `QtMultimedia`. + self.translations = translations or [] + # List of plugins associated with the Qt module. + self.plugins = plugins or [] + # List of bindings (PySide2, PyQt5, PySide6, PyQt6) that provide the python module. This allows association of + # plugins and translations with shared libraries even for bindings that do not provide python module binding + # for the Qt module. + self.bindings = set(bindings or []) + + +# All Qt-based bindings. +ALL_QT_BINDINGS = {"PySide2", "PyQt5", "PySide6", "PyQt6"} + +# Qt modules information - the core of our Qt collection approach. +# +# For every python module/extension (i.e., entry in the list below that has valid `module`), we need a corresponding +# hook, ensuring that the extension file is analyzed, so that we collect the associated plugins and translation +# files, as well as perform recursive analysis of link-time binary dependencies (so that plugins and translation files +# belonging to those dependencies are collected as well). +QT_MODULES_INFO = ( + # *** qt/qt3d *** + _QtModuleDef("Qt3DAnimation", shared_lib="3DAnimation"), + _QtModuleDef("Qt3DCore", shared_lib="3DCore"), + _QtModuleDef("Qt3DExtras", shared_lib="3DExtras"), + _QtModuleDef("Qt3DInput", shared_lib="3DInput", plugins=["3dinputdevices"]), + _QtModuleDef("Qt3DLogic", shared_lib="3DLogic"), + _QtModuleDef( + "Qt3DRender", shared_lib="3DRender", plugins=["geometryloaders", "renderplugins", "renderers", "sceneparsers"] + ), + + # *** qt/qtactiveqt *** + # The python module is called QAxContainer in PyQt bindings, but QtAxContainer in PySide. The associated Qt module + # is header-only, so there is no shared library. + _QtModuleDef("QAxContainer", bindings=["PyQt*"]), + _QtModuleDef("QtAxContainer", bindings=["PySide*"]), + + # *** qt/qtcharts *** + # The python module is called QtChart in PyQt5, and QtCharts in PySide2, PySide6, and PyQt6 (which corresponds to + # the associated Qt module name, QtCharts). + _QtModuleDef("QtChart", shared_lib="Charts", bindings=["PyQt5"]), + _QtModuleDef("QtCharts", shared_lib="Charts", bindings=["!PyQt5"]), + + # *** qt/qtbase *** + # QtConcurrent python module is available only in PySide bindings. + _QtModuleDef(None, shared_lib="Concurrent", bindings=["PyQt*"]), + _QtModuleDef("QtConcurrent", shared_lib="Concurrent", bindings=["PySide*"]), + _QtModuleDef("QtCore", shared_lib="Core", translations=["qt", "qtbase"]), + # QtDBus python module is available in all bindings but PySide2. + _QtModuleDef(None, shared_lib="DBus", bindings=["PySide2"]), + _QtModuleDef("QtDBus", shared_lib="DBus", bindings=["!PySide2"]), + # QtNetwork uses different plugins in Qt5 and Qt6. + _QtModuleDef("QtNetwork", shared_lib="Network", plugins=["bearer"], bindings=["PySide2", "PyQt5"]), + _QtModuleDef( + "QtNetwork", + shared_lib="Network", + plugins=["networkaccess", "networkinformation", "tls"], + bindings=["PySide6", "PyQt6"] + ), + _QtModuleDef( + "QtGui", + shared_lib="Gui", + plugins=[ + "accessiblebridge", + "egldeviceintegrations", + "generic", + "iconengines", + "imageformats", + "platforms", + "platforms/darwin", + "platforminputcontexts", + "platformthemes", + "xcbglintegrations", + # The ``wayland-*`` plugins are part of QtWaylandClient Qt module, whose shared library + # (e.g., libQt5WaylandClient.so) is linked by the wayland-related ``platforms`` plugins. Ideally, we would + # collect these plugins based on the QtWaylandClient shared library entry, but as our Qt hook utilities do + # not scan the plugins for dependencies, that would not work. So instead we list these plugins under QtGui + # to achieve pretty much the same end result. + "wayland-decoration-client", + "wayland-graphics-integration-client", + "wayland-shell-integration" + ] + ), + _QtModuleDef("QtOpenGL", shared_lib="OpenGL"), + # This python module is specific to PySide2 and has no associated Qt module. + _QtModuleDef("QtOpenGLFunctions", bindings=["PySide2"]), + # This Qt module was introduced with Qt6. + _QtModuleDef("QtOpenGLWidgets", shared_lib="OpenGLWidgets", bindings=["PySide6", "PyQt6"]), + _QtModuleDef("QtPrintSupport", shared_lib="PrintSupport", plugins=["printsupport"]), + _QtModuleDef("QtSql", shared_lib="Sql", plugins=["sqldrivers"]), + _QtModuleDef("QtTest", shared_lib="Test"), + _QtModuleDef("QtWidgets", shared_lib="Widgets", plugins=["styles"]), + _QtModuleDef("QtXml", shared_lib="Xml"), + + # *** qt/qtconnectivity *** + _QtModuleDef("QtBluetooth", shared_lib="QtBluetooth", translations=["qtconnectivity"]), + _QtModuleDef("QtNfc", shared_lib="Nfc", translations=["qtconnectivity"]), + + # *** qt/qtdatavis3d *** + _QtModuleDef("QtDataVisualization", shared_lib="DataVisualization"), + + # *** qt/qtdeclarative *** + _QtModuleDef("QtQml", shared_lib="Qml", translations=["qtdeclarative"], plugins=["qmltooling"]), + # Have the Qt5 variant collect translations for qtquickcontrols (qt/qtquickcontrols provides only QtQuick plugins). + _QtModuleDef( + "QtQuick", + shared_lib="Quick", + translations=["qtquickcontrols"], + plugins=["scenegraph"], + bindings=["PySide2", "PyQt5"] + ), + _QtModuleDef("QtQuick", shared_lib="Quick", plugins=["scenegraph"], bindings=["PySide6", "PyQt6"]), + # Qt6-only; in Qt5, this module is part of qt/qtquickcontrols2. Python module is available only in PySide6. + _QtModuleDef(None, shared_lib="QuickControls2", bindings=["PyQt6"]), + _QtModuleDef("QtQuickControls2", shared_lib="QuickControls2", bindings=["PySide6"]), + _QtModuleDef("QtQuickWidgets", shared_lib="QuickWidgets"), + + # *** qt/qtgamepad *** + # No python module; shared library -> plugins association entry. + _QtModuleDef(None, shared_lib="Gamepad", plugins=["gamepads"]), + + # *** qt/qtgraphs *** + # Qt6 >= 6.6.0; python module is available only in PySide6. + _QtModuleDef("QtGraphs", shared_lib="Graphs", bindings=["PySide6"]), + + # *** qt/qthttpserver *** + # Qt6 >= 6.4.0; python module is available only in PySide6. + _QtModuleDef("QtHttpServer", shared_lib="HttpServer", bindings=["PySide6"]), + + # *** qt/qtlocation *** + # QtLocation was reintroduced in Qt6 v6.5.0. + _QtModuleDef( + "QtLocation", + shared_lib="Location", + translations=["qtlocation"], + plugins=["geoservices"], + bindings=["PySide2", "PyQt5", "PySide6"] + ), + _QtModuleDef( + "QtPositioning", + shared_lib="Positioning", + translations=["qtlocation"], + plugins=["position"], + ), + + # *** qt/qtmacextras *** + # Qt5-only Qt module. + _QtModuleDef("QtMacExtras", shared_lib="MacExtras", bindings=["PySide2", "PyQt5"]), + + # *** qt/qtmultimedia *** + # QtMultimedia on Qt6 currently uses only a subset of plugin names from Qt5 counterpart. + _QtModuleDef( + "QtMultimedia", + shared_lib="Multimedia", + translations=["qtmultimedia"], + plugins=[ + "mediaservice", "audio", "video/bufferpool", "video/gstvideorenderer", "video/videonode", "playlistformats", + "resourcepolicy" + ], + bindings=["PySide2", "PyQt5"] + ), + _QtModuleDef( + "QtMultimedia", + shared_lib="Multimedia", + translations=["qtmultimedia"], + # `multimedia` plugins are available as of Qt6 >= 6.4.0; earlier versions had `video/gstvideorenderer` and + # `video/videonode` plugins. + plugins=["multimedia", "video/gstvideorenderer", "video/videonode"], + bindings=["PySide6", "PyQt6"] + ), + _QtModuleDef("QtMultimediaWidgets", shared_lib="MultimediaWidgets"), + # Qt6-only Qt module; python module is available in PySide6 >= 6.4.0 and PyQt6 >= 6.5.0 + _QtModuleDef("QtSpatialAudio", shared_lib="SpatialAudio", bindings=["PySide6", "PyQt6"]), + + # *** qt/qtnetworkauth *** + # QtNetworkAuth python module is available in all bindings but PySide2. + _QtModuleDef(None, shared_lib="NetworkAuth", bindings=["PySide2"]), + _QtModuleDef("QtNetworkAuth", shared_lib="NetworkAuth", bindings=["!PySide2"]), + + # *** qt/qtpurchasing *** + # Qt5-only Qt module, python module is available only in PyQt5. + _QtModuleDef("QtPurchasing", shared_lib="Purchasing", bindings=["PyQt5"]), + + # *** qt/qtquick1 *** + # This is an old, Qt 5.3-era module... + _QtModuleDef( + "QtDeclarative", + shared_lib="Declarative", + translations=["qtquick1"], + plugins=["qml1tooling"], + bindings=["PySide2", "PyQt5"] + ), + + # *** qt/qtquick3d *** + # QtQuick3D python module is available in all bindings but PySide2. + _QtModuleDef(None, shared_lib="Quick3D", bindings=["PySide2"]), + _QtModuleDef("QtQuick3D", shared_lib="Quick3D", bindings=["!PySide2"]), + # No python module; shared library -> plugins association entry. + _QtModuleDef(None, shared_lib="Quick3DAssetImport", plugins=["assetimporters"]), + + # *** qt/qtquickcontrols2 *** + # Qt5-only module; in Qt6, this module is part of qt/declarative. Python module is available only in PySide2. + _QtModuleDef(None, translations=["qtquickcontrols2"], shared_lib="QuickControls2", bindings=["PyQt5"]), + _QtModuleDef( + "QtQuickControls2", translations=["qtquickcontrols2"], shared_lib="QuickControls2", bindings=["PySide2"] + ), + + # *** qt/qtremoteobjects *** + _QtModuleDef("QtRemoteObjects", shared_lib="RemoteObjects"), + + # *** qt/qtscxml *** + # Python module is available only in PySide bindings. Plugins are available only in Qt6. + # PyQt wheels do not seem to ship the corresponding Qt modules (shared libs) at all. + _QtModuleDef("QtScxml", shared_lib="Scxml", bindings=["PySide2"]), + _QtModuleDef("QtScxml", shared_lib="Scxml", plugins=["scxmldatamodel"], bindings=["PySide6"]), + # Qt6-only Qt module, python module is available only in PySide6. + _QtModuleDef("QtStateMachine", shared_lib="StateMachine", bindings=["PySide6"]), + + # *** qt/qtsensors *** + _QtModuleDef("QtSensors", shared_lib="Sensors", plugins=["sensors", "sensorgestures"]), + + # *** qt/qtserialport *** + _QtModuleDef("QtSerialPort", shared_lib="SerialPort", translations=["qtserialport"]), + + # *** qt/qtscript *** + # Qt5-only Qt module, python module is available only in PySide2. PyQt5 wheels do not seem to ship the corresponding + # Qt modules (shared libs) at all. + _QtModuleDef("QtScript", shared_lib="Script", translations=["qtscript"], plugins=["script"], bindings=["PySide2"]), + _QtModuleDef("QtScriptTools", shared_lib="ScriptTools", bindings=["PySide2"]), + + # *** qt/qtserialbus *** + # No python module; shared library -> plugins association entry. + # PySide6 6.5.0 introduced python module. + _QtModuleDef(None, shared_lib="SerialBus", plugins=["canbus"], bindings=["!PySide6"]), + _QtModuleDef("QtSerialBus", shared_lib="SerialBus", plugins=["canbus"], bindings=["PySide6"]), + + # *** qt/qtsvg *** + _QtModuleDef("QtSvg", shared_lib="Svg"), + # Qt6-only Qt module. + _QtModuleDef("QtSvgWidgets", shared_lib="SvgWidgets", bindings=["PySide6", "PyQt6"]), + + # *** qt/qtspeech *** + _QtModuleDef("QtTextToSpeech", shared_lib="TextToSpeech", plugins=["texttospeech"]), + + # *** qt/qttools *** + # QtDesigner python module is available in all bindings but PySide2. + _QtModuleDef(None, shared_lib="Designer", plugins=["designer"], bindings=["PySide2"]), + _QtModuleDef( + "QtDesigner", shared_lib="Designer", translations=["designer"], plugins=["designer"], bindings=["!PySide2"] + ), + _QtModuleDef("QtHelp", shared_lib="Help", translations=["qt_help"]), + # Python module is available only in PySide bindings. + _QtModuleDef("QtUiTools", shared_lib="UiTools", bindings=["PySide*"]), + + # *** qt/qtvirtualkeyboard *** + # No python module; shared library -> plugins association entry. + _QtModuleDef(None, shared_lib="VirtualKeyboard", plugins=["virtualkeyboard"]), + + # *** qt/qtwebchannel *** + _QtModuleDef("QtWebChannel", shared_lib="WebChannel"), + + # *** qt/qtwebengine *** + # QtWebEngine is Qt5-only module (replaced by QtWebEngineQuick in Qt6). + _QtModuleDef("QtWebEngine", shared_lib="WebEngine", bindings=["PySide2", "PyQt5"]), + _QtModuleDef("QtWebEngineCore", shared_lib="WebEngineCore", translations=["qtwebengine"]), + # QtWebEngineQuick is Qt6-only module (replacement for QtWebEngine in Qt5). + _QtModuleDef("QtWebEngineQuick", shared_lib="WebEngineQuick", bindings=["PySide6", "PyQt6"]), + _QtModuleDef("QtWebEngineWidgets", shared_lib="WebEngineWidgets"), + # QtPdf and QtPdfWidgets have python module available in PySide6 and PyQt6 >= 6.4.0. + _QtModuleDef("QtPdf", shared_lib="Pdf", bindings=["PySide6", "PyQt6"]), + _QtModuleDef("QtPdfWidgets", shared_lib="PdfWidgets", bindings=["PySide6", "PyQt6"]), + + # *** qt/qtwebsockets *** + _QtModuleDef("QtWebSockets", shared_lib="WebSockets", translations=["qtwebsockets"]), + + # *** qt/qtwebview *** + # No python module; shared library -> plugins association entry. + _QtModuleDef(None, shared_lib="WebView", plugins=["webview"]), + + # *** qt/qtwinextras *** + # Qt5-only Qt module. + _QtModuleDef("QtWinExtras", shared_lib="WinExtras", bindings=["PySide2", "PyQt5"]), + + # *** qt/qtx11extras *** + # Qt5-only Qt module. + _QtModuleDef("QtX11Extras", shared_lib="X11Extras", bindings=["PySide2", "PyQt5"]), + + # *** qt/qtxmlpatterns *** + # Qt5-only Qt module. + _QtModuleDef( + "QtXmlPatterns", shared_lib="XmlPatterns", translations=["qtxmlpatterns"], bindings=["PySide2", "PyQt5"] + ), + + # *** qscintilla *** + # Python module is available only in PyQt bindings. No associated shared library. + _QtModuleDef("Qsci", translations=["qscintilla"], bindings=["PyQt*"]), +) + + +# Helpers for turning Qt namespace specifiers, such as "!PySide2" or "PyQt*", into set of applicable +# namespaces. +def process_namespace_strings(namespaces): + """"Process list of Qt namespace specifier strings into set of namespaces.""" + bindings = set() + for namespace in namespaces: + bindings |= _process_namespace_string(namespace) + return bindings + + +def _process_namespace_string(namespace): + """Expand a Qt namespace specifier string into set of namespaces.""" + if namespace.startswith("!"): + bindings = _process_namespace_string(namespace[1:]) + return ALL_QT_BINDINGS - bindings + else: + if namespace == "PySide*": + return {"PySide2", "PySide6"} + elif namespace == "PyQt*": + return {"PyQt5", "PyQt6"} + elif namespace in ALL_QT_BINDINGS: + return {namespace} + else: + raise ValueError(f"Invalid Qt namespace specifier: {namespace}!") diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/setuptools.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/setuptools.py new file mode 100755 index 0000000..47a649c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/setuptools.py @@ -0,0 +1,336 @@ +# ---------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +from PyInstaller import log as logging +from PyInstaller import isolated + +logger = logging.getLogger(__name__) + + +# Import setuptools and analyze its properties in an isolated subprocess. This function is called by `SetuptoolsInfo` +# to initialize its properties. +@isolated.decorate +def _retrieve_setuptools_info(): + import importlib + + try: + setuptools = importlib.import_module("setuptools") # noqa: F841 + except ModuleNotFoundError: + return None + + # Delay these imports until after we have confirmed that setuptools is importable. + import pathlib + + import packaging.version + + from PyInstaller.compat import importlib_metadata + from PyInstaller.utils.hooks import ( + collect_data_files, + collect_submodules, + ) + + # Try to retrieve the version. At this point, failure is consider an error. + version_string = importlib_metadata.version("setuptools") + version = packaging.version.Version(version_string).release # Use the version tuple + + # setuptools >= 60.0 its vendored copy of distutils (mainly due to its removal from stdlib in python >= 3.12). + distutils_vendored = False + distutils_modules = [] + if version >= (60, 0): + distutils_vendored = True + distutils_modules += ["_distutils_hack"] + distutils_modules += collect_submodules( + "setuptools._distutils", + # setuptools 71.0.1 ~ 71.0.4 include `setuptools._distutils.tests`; avoid explicitly collecting it + # (t was not included in earlier setuptools releases). + filter=lambda name: name != 'setuptools._distutils.tests', + ) + + # Check if `setuptools._vendor` exists. Some linux distributions opt to de-vendor `setuptools` and remove the + # `setuptools._vendor` directory altogether. If this is the case, most of additional processing below should be + # skipped to avoid errors and warnings about non-existent `setuptools._vendor` module. + try: + setuptools_vendor = importlib.import_module("setuptools._vendor") + except ModuleNotFoundError: + setuptools_vendor = None + + # Check for exposed packages/modules that are vendored by setuptools. If stand-alone version is not provided in the + # environment, setuptools-vendored version is exposed (due to location of `setuptools._vendor` being appended to + # `sys.path`. Applicable to v71.0.0 and later. + vendored_status = dict() + vendored_namespace_package_paths = dict() + if version >= (71, 0) and setuptools_vendor is not None: + VENDORED_TOP_LEVEL_NAMESPACE_CANDIDATES = ( + "backports", # "regular" package, but has namespace semantics due to `pkgutil.extend_path()` + "jaraco", # PEP-420 namespace package + ) + + VENDORED_CANDIDATES = ( + "autocommand", + "backports.tarfile", + "importlib_metadata", + "importlib_resources", + "inflect", + "jaraco.context", + "jaraco.functools", + "jaraco.text", + "more_itertools", + "ordered_set", + "packaging", + "platformdirs", + "tomli", + "typeguard", + "typing_extensions", + "wheel", + "zipp", + ) + + # Resolve path(s) of `setuptools_vendor` package. + setuptools_vendor_paths = [pathlib.Path(path).resolve() for path in setuptools_vendor.__path__] + + # Process each candidate: top-level namespace packages + for candidate_name in VENDORED_TOP_LEVEL_NAMESPACE_CANDIDATES: + try: + candidate = importlib.import_module(candidate_name) + except ImportError: + continue + + # Retrieve the __path__ attribute and store it, so we can re-use it in hooks without having to re-import + # `setuptools` and the candidate package... + candidate_path_attr = getattr(candidate, '__path__', []) + if candidate_path_attr: + candidate_paths = [pathlib.Path(path).resolve() for path in candidate_path_attr] + is_vendored = [ + any([ + setuptools_vendor_path in candidate_path.parents or candidate_path == setuptools_vendor_path + for setuptools_vendor_path in setuptools_vendor_paths + ]) for candidate_path in candidate_paths + ] + # For namespace packages, distinguish between "fully" vendored and "partially" vendored state; i.e., + # whether the part of namespace package in the vendored directory is the only part or not. + if all(is_vendored): + vendored_status[candidate_name] = 'fully' + elif any(is_vendored): + vendored_status[candidate_name] = 'partially' + else: + vendored_status[candidate_name] = False + + # Store paths + vendored_namespace_package_paths[candidate_name] = [str(path) for path in candidate_path_attr] + + # Process each candidate: modules and packages + for candidate_name in VENDORED_CANDIDATES: + try: + candidate = importlib.import_module(candidate_name) + except ImportError: + continue + + # Check the __file__ attribute (modules and regular packages). Will not work with namespace packages, but + # at the moment, there are none (vendored top-level namespace packages have already been handled). + candidate_file_attr = getattr(candidate, '__file__', None) + if candidate_file_attr is not None: + candidate_path = pathlib.Path(candidate_file_attr).parent.resolve() + is_vendored = any([ + setuptools_vendor_path in candidate_path.parents or candidate_path == setuptools_vendor_path + for setuptools_vendor_path in setuptools_vendor_paths + ]) + vendored_status[candidate_name] = is_vendored # True/False + + # Collect submodules from `setuptools._vendor`, regardless of whether the vendored package is exposed or + # not (because setuptools might need/use it either way). + vendored_modules = [] + if setuptools_vendor is not None: + EXCLUDED_VENDORED_MODULES = ( + # Prevent recursing into setuptools._vendor.pyparsing.diagram, which typically fails to be imported due + # to missing dependencies (railroad, pyparsing (?), jinja2) and generates a warning... As the module is + # usually unimportable, it is likely not to be used by setuptools. NOTE: pyparsing was removed from + # vendored packages in setuptools v67.0.0; keep this exclude around for earlier versions. + 'setuptools._vendor.pyparsing.diagram', + # Setuptools >= 71 started shipping vendored dependencies that include tests; avoid collecting those via + # hidden imports. (Note that this also prevents creation of aliases for these module, but that should + # not be an issue, as they should not be referenced from anywhere). + 'setuptools._vendor.importlib_resources.tests', + # These appear to be utility scripts bundled with the jaraco.text package - exclude them. + 'setuptools._vendor.jaraco.text.show-newlines', + 'setuptools._vendor.jaraco.text.strip-prefix', + 'setuptools._vendor.jaraco.text.to-dvorak', + 'setuptools._vendor.jaraco.text.to-qwerty', + ) + vendored_modules += collect_submodules( + 'setuptools._vendor', + filter=lambda name: name not in EXCLUDED_VENDORED_MODULES, + ) + + # `collect_submodules` (and its underlying `pkgutil.iter_modules` do not discover namespace sub-packages, in + # this case `setuptools._vendor.jaraco`. So force a manual scan of modules/packages inside it. + vendored_modules += collect_submodules( + 'setuptools._vendor.jaraco', + filter=lambda name: name not in EXCLUDED_VENDORED_MODULES, + ) + + # *** Data files for vendored packages *** + vendored_data = [] + + if version >= (71, 0) and setuptools_vendor is not None: + # Since the vendored dependencies from `setuptools/_vendor` are now visible to the outside world, make + # sure we collect their metadata. (We cannot use copy_metadata here, because we need to collect data + # files to their original locations). + vendored_data += collect_data_files('setuptools._vendor', includes=['**/*.dist-info']) + # Similarly, ensure that `Lorem ipsum.txt` from vendored jaraco.text is collected + vendored_data += collect_data_files('setuptools._vendor.jaraco.text', includes=['**/Lorem ipsum.txt']) + + # Return dictionary with collected information + return { + "available": True, + "version": version, + "distutils_vendored": distutils_vendored, + "distutils_modules": distutils_modules, + "vendored_status": vendored_status, + "vendored_modules": vendored_modules, + "vendored_data": vendored_data, + "vendored_namespace_package_paths": vendored_namespace_package_paths, + } + + +class SetuptoolsInfo: + def __init__(self): + pass + + def __repr__(self): + return "SetuptoolsInfo" + + # Delay initialization of setuptools information until until the corresponding attributes are first requested. + def __getattr__(self, name): + if 'available' in self.__dict__: + # Initialization was already done, but requested attribute is not available. + raise AttributeError(name) + + # Load setuptools info... + self._load_setuptools_info() + # ... and return the requested attribute + return getattr(self, name) + + def _load_setuptools_info(self): + logger.info("%s: initializing cached setuptools info...", self) + + # Initialize variables so that they might be accessed even if setuptools is unavailable or if initialization + # fails for some reason. + self.available = False + self.version = None + self.distutils_vendored = False + self.distutils_modules = [] + self.vendored_status = dict() + self.vendored_modules = [] + self.vendored_data = [] + self.vendored_namespace_package_paths = dict() + + try: + setuptools_info = _retrieve_setuptools_info() + except Exception as e: + logger.warning("%s: failed to obtain setuptools info: %s", self, e) + return + + # If package could not be imported, `_retrieve_setuptools_info` returns None. In such cases, emit a debug + # message instead of a warning, because this initialization might be triggered by a helper function that is + # trying to determine availability of `setuptools` by inspecting the `available` attribute. + if setuptools_info is None: + logger.debug("%s: failed to obtain setuptools info: setuptools could not be imported.", self) + return + + # Copy properties + for key, value in setuptools_info.items(): + setattr(self, key, value) + + def is_vendored(self, module_name): + return self.vendored_status.get(module_name, False) + + @staticmethod + def _create_vendored_aliases(vendored_name, module_name, modules_list): + # Create aliases for all submodules + prefix_len = len(vendored_name) # Length of target-name prefix to remove + return ((module_name + vendored_module[prefix_len:], vendored_module) for vendored_module in modules_list + if vendored_module.startswith(vendored_name)) + + def get_vendored_aliases(self, module_name): + vendored_name = f"setuptools._vendor.{module_name}" + return self._create_vendored_aliases(vendored_name, module_name, self.vendored_modules) + + def get_distutils_aliases(self): + vendored_name = "setuptools._distutils" + return self._create_vendored_aliases(vendored_name, "distutils", self.distutils_modules) + + +setuptools_info = SetuptoolsInfo() + + +def pre_safe_import_module_for_top_level_namespace_packages(api): + """ + A common implementation of pre_safe_import_module hook function for handling vendored top-level namespace packages + (i.e., `backports` and `jaraco`). + + This function can be either called from the `pre_safe_import_module` function in a pre-safe-import-module hook, or + just imported into the hook and aliased to `pre_safe_import_module`. + """ + module_name = api.module_name + + # Check if the package/module is a vendored copy. This also returns False is setuptools is unavailable, because + # vendored module status dictionary will be empty. + vendored = setuptools_info.is_vendored(module_name) + if not vendored: + return + + if vendored == 'fully': + # For a fully-vendored copy, force creation of aliases; on one hand, this aims to ensure that submodules are + # resolvable, but on the other, it also prevents creation of unvendored top-level package, which should not + # exit in this case. + vendored_name = f"setuptools._vendor.{module_name}" + logger.info( + "Setuptools: %r appears to be a full setuptools-vendored copy - creating alias to %r!", module_name, + vendored_name + ) + # Create aliases for all (sub)modules + for aliased_name, real_vendored_name in setuptools_info.get_vendored_aliases(module_name): + api.add_alias_module(real_vendored_name, aliased_name) + elif vendored == 'partially': + # For a partially-vendored copy, adjust the submodule search paths, so that submodules from all locations are + # discoverable (especially from the setuptools vendor directory, which might not be in the search path yet). + search_paths = setuptools_info.vendored_namespace_package_paths.get(module_name, []) + logger.info( + "Setuptools: %r appears to be a partial setuptools-vendored copy - extending search paths to %r!", + module_name, search_paths + ) + for path in search_paths: + api.append_package_path(path) + else: + logger.warning("Setuptools: %r has unhandled vendored status: %r", module_name, vendored) + + +def pre_safe_import_module(api): + """ + A common implementation of pre_safe_import_module hook function. + + This function can be either called from the `pre_safe_import_module` function in a pre-safe-import-module hook, or + just imported into the hook. + """ + module_name = api.module_name + + # Check if the package/module is a vendored copy. This also returns False is setuptools is unavailable, because + # vendored module status dictionary will be empty. + if not setuptools_info.is_vendored(module_name): + return + + vendored_name = f"setuptools._vendor.{module_name}" + logger.info( + "Setuptools: %r appears to be a setuptools-vendored copy - creating alias to %r!", module_name, vendored_name + ) + + # Create aliases for all (sub)modules + for aliased_name, real_vendored_name in setuptools_info.get_vendored_aliases(module_name): + api.add_alias_module(real_vendored_name, aliased_name) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/tcl_tk.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/tcl_tk.py new file mode 100755 index 0000000..f35f988 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/hooks/tcl_tk.py @@ -0,0 +1,348 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import os +import fnmatch + +from PyInstaller import compat +from PyInstaller import isolated +from PyInstaller import log as logging +from PyInstaller.depend import bindepend + +if compat.is_darwin: + from PyInstaller.utils import osx as osxutils + +logger = logging.getLogger(__name__) + + +@isolated.decorate +def _get_tcl_tk_info(): + """ + Isolated-subprocess helper to retrieve the basic Tcl/Tk information: + - tkinter_extension_file = the value of __file__ attribute of the _tkinter binary extension (path to file). + - tcl_data_dir = path to the Tcl library/data directory. + - tcl_version = Tcl version + - tk_version = Tk version + - tcl_theaded = boolean indicating whether Tcl/Tk is built with multi-threading support. + """ + try: + import tkinter + import _tkinter + except ImportError: + # tkinter unavailable + return None + try: + tcl = tkinter.Tcl() + except tkinter.TclError: # e.g. "Can't find a usable init.tcl in the following directories: ..." + return None + + # Query the location of Tcl library/data directory. + tcl_data_dir = tcl.eval("info library") + + # Check if Tcl/Tk is built with multi-threaded support (built with --enable-threads), as indicated by the presence + # of optional `threaded` member in `tcl_platform` array. + try: + tcl.getvar("tcl_platform(threaded)") # Ignore the actual value. + tcl_threaded = True + except tkinter.TclError: + tcl_threaded = False + + return { + "available": True, + # If `_tkinter` is a built-in (as opposed to an extension), it does not have a `__file__` attribute. + "tkinter_extension_file": getattr(_tkinter, '__file__', None), + "tcl_version": _tkinter.TCL_VERSION, + "tk_version": _tkinter.TK_VERSION, + "tcl_threaded": tcl_threaded, + "tcl_data_dir": tcl_data_dir, + } + + +class TclTkInfo: + # Root directory names of Tcl and Tk library/data directories in the frozen application. These directories are + # originally fully versioned (e.g., tcl8.6 and tk8.6); we want to remap them to unversioned variants, so that our + # run-time hook (pyi_rthook__tkinter.py) does not have to determine version numbers when setting `TCL_LIBRARY` + # and `TK_LIBRARY` environment variables. + # + # We also cannot use plain "tk" and "tcl", because on macOS, the Tcl and Tk shared libraries might come from + # framework bundles, and would therefore end up being collected as "Tcl" and "Tk" in the top-level application + # directory, causing clash due to filesystem being case-insensitive by default. + TCL_ROOTNAME = '_tcl_data' + TK_ROOTNAME = '_tk_data' + + def __init__(self): + pass + + def __repr__(self): + return "TclTkInfo" + + # Delay initialization of Tcl/Tk information until until the corresponding attributes are first requested. + def __getattr__(self, name): + if 'available' in self.__dict__: + # Initialization was already done, but requested attribute is not available. + raise AttributeError(name) + + # Load Qt library info... + self._load_tcl_tk_info() + # ... and return the requested attribute + return getattr(self, name) + + def _load_tcl_tk_info(self): + logger.info("%s: initializing cached Tcl/Tk info...", self) + + # Initialize variables so that they might be accessed even if tkinter/Tcl/Tk is unavailable or if initialization + # fails for some reason. + self.available = False + self.tkinter_extension_file = None + self.tcl_version = None + self.tk_version = None + self.tcl_threaded = False + self.tcl_data_dir = None + + self.tk_data_dir = None + self.tcl_module_dir = None + + self.is_macos_system_framework = False + self.tcl_shared_library = None + self.tk_shared_library = None + + self.data_files = [] + + try: + tcl_tk_info = _get_tcl_tk_info() + except Exception as e: + logger.warning("%s: failed to obtain Tcl/Tk info: %s", self, e) + return + + # If tkinter could not be imported, `_get_tcl_tk_info` returns None. In such cases, emit a debug message instead + # of a warning, because this initialization might be triggered by a helper function that is trying to determine + # availability of `tkinter` by inspecting the `available` attribute. + if tcl_tk_info is None: + logger.debug("%s: failed to obtain Tcl/Tk info: tkinter/_tkinter could not be imported.", self) + return + + # Copy properties + for key, value in tcl_tk_info.items(): + setattr(self, key, value) + + # Parse Tcl/Tk version into (major, minor) tuple. + self.tcl_version = tuple((int(x) for x in self.tcl_version.split(".")[:2])) + self.tk_version = tuple((int(x) for x in self.tk_version.split(".")[:2])) + + # Determine full path to Tcl and Tk shared libraries against which the `_tkinter` extension module is linked. + # This can only be done when `_tkinter` is in fact an extension, and not a built-in. In the latter case, the + # Tcl/Tk libraries are statically linked into python shared library, so there are no shared libraries for us + # to discover. + if self.tkinter_extension_file: + try: + ( + self.tcl_shared_library, + self.tk_shared_library, + ) = self._find_tcl_tk_shared_libraries(self.tkinter_extension_file) + except Exception: + logger.warning("%s: failed to determine Tcl and Tk shared library location!", self, exc_info=True) + + # macOS: check if _tkinter is linked against system-provided Tcl.framework and Tk.framework. This is the + # case with python3 from XCode tools (and was the case with very old homebrew python builds). In such cases, + # we should not be collecting Tcl/Tk files. + if compat.is_darwin: + self.is_macos_system_framework = self._check_macos_system_framework(self.tcl_shared_library) + + # Emit a warning in the unlikely event that we are dealing with Teapot-distributed version of ActiveTcl. + if not self.is_macos_system_framework: + self._warn_if_using_activetcl_or_teapot(self.tcl_data_dir) + + # Infer location of Tk library/data directory. Ideally, we could infer this by running + # + # import tkinter + # root = tkinter.Tk() + # tk_data_dir = root.tk.exprstring('$tk_library') + # + # in the isolated subprocess as part of `_get_tcl_tk_info`. However, that is impractical, as it shows the empty + # window, and on some platforms (e.g., linux) requires display server. Therefore, try to guess the location, + # based on the following heuristic: + # - if TK_LIBRARY is defined use it. + # - if Tk is built as macOS framework bundle, look for Scripts sub-directory in Resources directory next to + # the shared library. + # - otherwise, look for: $tcl_root/../tkX.Y, where X and Y are Tk major and minor version. + if "TK_LIBRARY" in os.environ: + self.tk_data_dir = os.environ["TK_LIBRARY"] + elif compat.is_darwin and self.tk_shared_library and ( + # is_framework_bundle_lib handles only fully-versioned framework library paths... + (osxutils.is_framework_bundle_lib(self.tk_shared_library)) or + # ... so manually handle top-level-symlinked variant for now. + (self.tk_shared_library).endswith("Tk.framework/Tk") + ): + # Fully resolve the library path, in case it is a top-level symlink; for example, resolve + # /Library/Frameworks/Python.framework/Versions/3.13/Frameworks/Tk.framework/Tk + # into + # /Library/Frameworks/Python.framework/Versions/3.13/Frameworks/Tk.framework/Versions/8.6/Tk + tk_lib_realpath = os.path.realpath(self.tk_shared_library) + # Resources/Scripts directory next to the shared library + self.tk_data_dir = os.path.join(os.path.dirname(tk_lib_realpath), "Resources", "Scripts") + else: + self.tk_data_dir = os.path.join( + os.path.dirname(self.tcl_data_dir), + f"tk{self.tk_version[0]}.{self.tk_version[1]}", + ) + + # Infer location of Tcl module directory. The modules directory is separate from the library/data one, and + # is located at $tcl_root/../tclX, where X is the major Tcl version. + self.tcl_module_dir = os.path.join( + os.path.dirname(self.tcl_data_dir), + f"tcl{self.tcl_version[0]}", + ) + + # Find all data files + if self.is_macos_system_framework: + logger.info("%s: using macOS system Tcl/Tk framework - not collecting data files.", self) + else: + # Collect Tcl and Tk scripts from their corresponding library/data directories. See comment at the + # definition of TK_ROOTNAME and TK_ROOTNAME variables. + if os.path.isdir(self.tcl_data_dir): + self.data_files += self._collect_files_from_directory( + self.tcl_data_dir, + prefix=self.TCL_ROOTNAME, + excludes=['demos', '*.lib', 'tclConfig.sh'], + ) + else: + logger.warning("%s: Tcl library/data directory %r does not exist!", self, self.tcl_data_dir) + + if os.path.isdir(self.tk_data_dir): + self.data_files += self._collect_files_from_directory( + self.tk_data_dir, + prefix=self.TK_ROOTNAME, + excludes=['demos', '*.lib', 'tkConfig.sh'], + ) + else: + logger.warning("%s: Tk library/data directory %r does not exist!", self, self.tk_data_dir) + + # Collect Tcl modules from modules directory + if os.path.isdir(self.tcl_module_dir): + self.data_files += self._collect_files_from_directory( + self.tcl_module_dir, + prefix=os.path.basename(self.tcl_module_dir), + ) + else: + logger.warning("%s: Tcl module directory %r does not exist!", self, self.tcl_module_dir) + + @staticmethod + def _collect_files_from_directory(root, prefix=None, excludes=None): + """ + A minimal port of PyInstaller.building.datastruct.Tree() functionality, which allows us to avoid using Tree + here. This way, the TclTkInfo data structure can be used without having PyInstaller's config context set up. + """ + excludes = excludes or [] + + todo = [(root, prefix)] + output = [] + while todo: + target_dir, prefix = todo.pop() + + for entry in os.listdir(target_dir): + # Basic name-based exclusion + if any((fnmatch.fnmatch(entry, exclude) for exclude in excludes)): + continue + + src_path = os.path.join(target_dir, entry) + dest_path = os.path.join(prefix, entry) if prefix else entry + + if os.path.isdir(src_path): + todo.append((src_path, dest_path)) + else: + # Return 3-element tuples with fully-resolved dest path, since other parts of code depend on that. + output.append((dest_path, src_path, 'DATA')) + + return output + + @staticmethod + def _find_tcl_tk_shared_libraries(tkinter_ext_file): + """ + Find Tcl and Tk shared libraries against which the _tkinter extension module is linked. + """ + tcl_lib = None + tk_lib = None + + for _, lib_path in bindepend.get_imports(tkinter_ext_file): # (name, fullpath) tuple + if lib_path is None: + continue # Skip unresolved entries + + # For comparison, take basename of lib_path. On macOS, lib_name returned by get_imports is in fact + # referenced name, which is not necessarily just a basename. + lib_name = os.path.basename(lib_path) + lib_name_lower = lib_name.lower() # lower-case for comparisons + + if 'tcl' in lib_name_lower: + tcl_lib = lib_path + elif 'tk' in lib_name_lower: + tk_lib = lib_path + + return tcl_lib, tk_lib + + @staticmethod + def _check_macos_system_framework(tcl_shared_lib): + # Starting with macOS 11, system libraries are hidden (unless both Python and PyInstaller's bootloader are built + # against macOS 11.x SDK). Therefore, Tcl shared library might end up unresolved (None); but that implicitly + # indicates that the system framework is used. + if tcl_shared_lib is None: + return True + + # Check if the path corresponds to the system framework, i.e., [/System]/Library/Frameworks/Tcl.framework/Tcl + return 'Library/Frameworks/Tcl.framework' in tcl_shared_lib + + @staticmethod + def _warn_if_using_activetcl_or_teapot(tcl_root): + """ + Check if Tcl installation is a Teapot-distributed version of ActiveTcl, and log a non-fatal warning that the + resulting frozen application will (likely) fail to run on other systems. + + PyInstaller does *not* freeze all ActiveTcl dependencies -- including Teapot, which is typically ignorable. + Since Teapot is *not* ignorable in this case, this function warns of impending failure. + + See Also + ------- + https://github.com/pyinstaller/pyinstaller/issues/621 + """ + if tcl_root is None: + return + + # Read the "init.tcl" script and look for mentions of "activetcl" and "teapot" + init_tcl = os.path.join(tcl_root, 'init.tcl') + if not os.path.isfile(init_tcl): + return + + mentions_activetcl = False + mentions_teapot = False + + # Tcl/Tk reads files using the system encoding (https://www.tcl.tk/doc/howto/i18n.html#system_encoding); + # on macOS, this is UTF-8. + with open(init_tcl, 'r', encoding='utf8') as fp: + for line in fp.readlines(): + line = line.strip().lower() + if line.startswith('#'): + continue + if 'activetcl' in line: + mentions_activetcl = True + if 'teapot' in line: + mentions_teapot = True + if mentions_activetcl and mentions_teapot: + break + + if mentions_activetcl and mentions_teapot: + logger.warning( + "You appear to be using an ActiveTcl build of Tcl/Tk, which PyInstaller has\n" + "difficulty freezing. To fix this, comment out all references to 'teapot' in\n" + f"{init_tcl!r}\n" + "See https://github.com/pyinstaller/pyinstaller/issues/621 for more information." + ) + + +tcltk_info = TclTkInfo() diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/misc.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/misc.py new file mode 100755 index 0000000..77a3e8e --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/misc.py @@ -0,0 +1,229 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +This module contains miscellaneous functions that do not fit anywhere else. +""" + +import glob +import os +import pprint +import codecs +import re +import tokenize +import io +import pathlib + +from PyInstaller import log as logging +from PyInstaller.compat import is_win + +logger = logging.getLogger(__name__) + + +def dlls_in_subdirs(directory): + """ + Returns a list *.dll, *.so, *.dylib in the given directory and its subdirectories. + """ + filelist = [] + for root, dirs, files in os.walk(directory): + filelist.extend(dlls_in_dir(root)) + return filelist + + +def dlls_in_dir(directory): + """ + Returns a list of *.dll, *.so, *.dylib in the given directory. + """ + return files_in_dir(directory, ["*.so", "*.dll", "*.dylib"]) + + +def files_in_dir(directory, file_patterns=None): + """ + Returns a list of files in the given directory that match the given pattern. + """ + + file_patterns = file_patterns or [] + + files = [] + for file_pattern in file_patterns: + files.extend(glob.glob(os.path.join(directory, file_pattern))) + return files + + +def get_path_to_toplevel_modules(filename): + """ + Return the path to top-level directory that contains Python modules. + + It will look in parent directories for __init__.py files. The first parent directory without __init__.py is the + top-level directory. + + Returned directory might be used to extend the PYTHONPATH. + """ + curr_dir = os.path.dirname(os.path.abspath(filename)) + pattern = '__init__.py' + + # Try max. 10 levels up. + try: + for i in range(10): + files = set(os.listdir(curr_dir)) + # 'curr_dir' is still not top-level; go to parent dir. + if pattern in files: + curr_dir = os.path.dirname(curr_dir) + # Top-level dir found; return it. + else: + return curr_dir + except IOError: + pass + # No top-level directory found, or error was encountered. + return None + + +def mtime(fnm): + try: + # TODO: explain why this does not use os.path.getmtime() ? + # - It is probably not used because it returns float and not int. + return os.stat(fnm)[8] + except Exception: + return 0 + + +def save_py_data_struct(filename, data): + """ + Save data into text file as Python data structure. + :param filename: + :param data: + :return: + """ + dirname = os.path.dirname(filename) + if not os.path.exists(dirname): + os.makedirs(dirname) + with open(filename, 'w', encoding='utf-8') as f: + pprint.pprint(data, f) + + +def load_py_data_struct(filename): + """ + Load data saved as python code and interpret that code. + :param filename: + :return: + """ + with open(filename, 'r', encoding='utf-8') as f: + if is_win: + # import versioninfo so that VSVersionInfo can parse correctly. + from PyInstaller.utils.win32 import versioninfo # noqa: F401 + + return eval(f.read()) + + +def absnormpath(apath): + return os.path.abspath(os.path.normpath(apath)) + + +def module_parent_packages(full_modname): + """ + Return list of parent package names. + 'aaa.bb.c.dddd' -> ['aaa', 'aaa.bb', 'aaa.bb.c'] + :param full_modname: Full name of a module. + :return: List of parent module names. + """ + prefix = '' + parents = [] + # Ignore the last component in module name and get really just parent, grandparent, great grandparent, etc. + for pkg in full_modname.split('.')[0:-1]: + # Ensure that first item does not start with dot '.' + prefix += '.' + pkg if prefix else pkg + parents.append(prefix) + return parents + + +def is_file_qt_plugin(filename): + """ + Check if the given file is a Qt plugin file. + :param filename: Full path to file to check. + :return: True if given file is a Qt plugin file, False if not. + """ + + # Check the file contents; scan for QTMETADATA string. The scan is based on the brute-force Windows codepath of + # findPatternUnloaded() from qtbase/src/corelib/plugin/qlibrary.cpp in Qt5. + with open(filename, 'rb') as fp: + fp.seek(0, os.SEEK_END) + end_pos = fp.tell() + + SEARCH_CHUNK_SIZE = 8192 + QTMETADATA_MAGIC = b'QTMETADATA ' + + magic_offset = -1 + while end_pos >= len(QTMETADATA_MAGIC): + start_pos = max(end_pos - SEARCH_CHUNK_SIZE, 0) + chunk_size = end_pos - start_pos + # Is the remaining chunk large enough to hold the pattern? + if chunk_size < len(QTMETADATA_MAGIC): + break + # Read and scan the chunk + fp.seek(start_pos, os.SEEK_SET) + buf = fp.read(chunk_size) + pos = buf.rfind(QTMETADATA_MAGIC) + if pos != -1: + magic_offset = start_pos + pos + break + # Adjust search location for next chunk; ensure proper overlap. + end_pos = start_pos + len(QTMETADATA_MAGIC) - 1 + if magic_offset == -1: + return False + + return True + + +BOM_MARKERS_TO_DECODERS = { + codecs.BOM_UTF32_LE: codecs.utf_32_le_decode, + codecs.BOM_UTF32_BE: codecs.utf_32_be_decode, + codecs.BOM_UTF32: codecs.utf_32_decode, + codecs.BOM_UTF16_LE: codecs.utf_16_le_decode, + codecs.BOM_UTF16_BE: codecs.utf_16_be_decode, + codecs.BOM_UTF16: codecs.utf_16_decode, + codecs.BOM_UTF8: codecs.utf_8_decode, +} +BOM_RE = re.compile(rb"\A(%s)?(.*)" % b"|".join(map(re.escape, BOM_MARKERS_TO_DECODERS)), re.DOTALL) + + +def decode(raw: bytes): + """ + Decode bytes to string, respecting and removing any byte-order marks if present, or respecting but not removing any + PEP263 encoding comments (# encoding: cp1252). + """ + bom, raw = BOM_RE.match(raw).groups() + if bom: + return BOM_MARKERS_TO_DECODERS[bom](raw)[0] + + encoding, _ = tokenize.detect_encoding(io.BytesIO(raw).readline) + return raw.decode(encoding) + + +def is_iterable(arg): + """ + Check if the passed argument is an iterable." + """ + try: + iter(arg) + except TypeError: + return False + return True + + +def path_to_parent_archive(filename): + """ + Check if the given file path points to a file inside an existing archive file. Returns first path from the set of + parent paths that points to an existing file, or `None` if no such path exists (i.e., file is an actual stand-alone + file). + """ + for parent in pathlib.Path(filename).parents: + if parent.is_file(): + return parent + return None diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/osx.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/osx.py new file mode 100755 index 0000000..4b26444 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/osx.py @@ -0,0 +1,735 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2014-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Utils for macOS platform. +""" + +import math +import os +import pathlib +import subprocess +import shutil +import tempfile + +from macholib.mach_o import ( + LC_BUILD_VERSION, + LC_CODE_SIGNATURE, + LC_ID_DYLIB, + LC_LOAD_DYLIB, + LC_LOAD_UPWARD_DYLIB, + LC_LOAD_WEAK_DYLIB, + LC_PREBOUND_DYLIB, + LC_REEXPORT_DYLIB, + LC_RPATH, + LC_SEGMENT_64, + LC_SYMTAB, + LC_UUID, + LC_VERSION_MIN_MACOSX, +) +from macholib.MachO import MachO +import macholib.util + +import PyInstaller.log as logging +from PyInstaller import compat + +logger = logging.getLogger(__name__) + + +def is_homebrew_env(): + """ + Check if Python interpreter was installed via Homebrew command 'brew'. + + :return: True if Homebrew else otherwise. + """ + # Python path prefix should start with Homebrew prefix. + env_prefix = get_homebrew_prefix() + if env_prefix and compat.base_prefix.startswith(env_prefix): + return True + return False + + +def is_macports_env(): + """ + Check if Python interpreter was installed via Macports command 'port'. + + :return: True if Macports else otherwise. + """ + # Python path prefix should start with Macports prefix. + env_prefix = get_macports_prefix() + if env_prefix and compat.base_prefix.startswith(env_prefix): + return True + return False + + +def get_homebrew_prefix(): + """ + :return: Root path of the Homebrew environment. + """ + prefix = shutil.which('brew') + # Conversion: /usr/local/bin/brew -> /usr/local + prefix = os.path.dirname(os.path.dirname(prefix)) + return prefix + + +def get_macports_prefix(): + """ + :return: Root path of the Macports environment. + """ + prefix = shutil.which('port') + # Conversion: /usr/local/bin/port -> /usr/local + prefix = os.path.dirname(os.path.dirname(prefix)) + return prefix + + +def _find_version_cmd(header): + """ + Helper that finds the version command in the given MachO header. + """ + # The SDK version is stored in LC_BUILD_VERSION command (used when targeting the latest versions of macOS) or in + # older LC_VERSION_MIN_MACOSX command. Check for presence of either. + version_cmd = [cmd for cmd in header.commands if cmd[0].cmd in {LC_BUILD_VERSION, LC_VERSION_MIN_MACOSX}] + assert len(version_cmd) == 1, \ + f"Expected exactly one LC_BUILD_VERSION or LC_VERSION_MIN_MACOSX command, found {len(version_cmd)}!" + return version_cmd[0] + + +def get_macos_sdk_version(filename): + """ + Obtain the version of macOS SDK against which the given binary was built. + + NOTE: currently, version is retrieved only from the first arch slice in the binary. + + :return: (major, minor, revision) tuple + """ + binary = MachO(filename) + header = binary.headers[0] + # Find version command using helper + version_cmd = _find_version_cmd(header) + return _hex_triplet(version_cmd[1].sdk) + + +def _hex_triplet(version): + # Parse SDK version number + major = (version & 0xFF0000) >> 16 + minor = (version & 0xFF00) >> 8 + revision = (version & 0xFF) + return major, minor, revision + + +def macosx_version_min(filename: str) -> tuple: + """ + Get the -macosx-version-min used to compile a macOS binary. + + For fat binaries, the minimum version is selected. + """ + versions = [] + for header in MachO(filename).headers: + cmd = _find_version_cmd(header) + if cmd[0].cmd == LC_VERSION_MIN_MACOSX: + versions.append(cmd[1].version) + else: + # macOS >= 10.14 uses LC_BUILD_VERSION instead. + versions.append(cmd[1].minos) + + return min(map(_hex_triplet, versions)) + + +def set_macos_sdk_version(filename, major, minor, revision): + """ + Overwrite the macOS SDK version declared in the given binary with the specified version. + + NOTE: currently, only version in the first arch slice is modified. + """ + # Validate values + assert 0 <= major <= 255, "Invalid major version value!" + assert 0 <= minor <= 255, "Invalid minor version value!" + assert 0 <= revision <= 255, "Invalid revision value!" + # Open binary + binary = MachO(filename) + header = binary.headers[0] + # Find version command using helper + version_cmd = _find_version_cmd(header) + # Write new SDK version number + version_cmd[1].sdk = major << 16 | minor << 8 | revision + # Write changes back. + with open(binary.filename, 'rb+') as fp: + binary.write(fp) + + +def fix_exe_for_code_signing(filename): + """ + Fixes the Mach-O headers to make code signing possible. + + Code signing on macOS does not work out of the box with embedding .pkg archive into the executable. + + The fix is done this way: + - Make the embedded .pkg archive part of the Mach-O 'String Table'. 'String Table' is at end of the macOS exe file, + so just change the size of the table to cover the end of the file. + - Fix the size of the __LINKEDIT segment. + + Note: the above fix works only if the single-arch thin executable or the last arch slice in a multi-arch fat + executable is not signed, because LC_CODE_SIGNATURE comes after LC_SYMTAB, and because modification of headers + invalidates the code signature. On modern arm64 macOS, code signature is mandatory, and therefore compilers + create a dummy signature when executable is built. In such cases, that signature needs to be removed before this + function is called. + + Mach-O format specification: http://developer.apple.com/documentation/Darwin/Reference/ManPages/man5/Mach-O.5.html + """ + # Estimate the file size after data was appended + file_size = os.path.getsize(filename) + + # Take the last available header. A single-arch thin binary contains a single slice, while a multi-arch fat binary + # contains multiple, and we need to modify the last one, which is adjacent to the appended data. + executable = MachO(filename) + header = executable.headers[-1] + + # Sanity check: ensure the executable slice is not signed (otherwise signature's section comes last in the + # __LINKEDIT segment). + sign_sec = [cmd for cmd in header.commands if cmd[0].cmd == LC_CODE_SIGNATURE] + assert len(sign_sec) == 0, "Executable contains code signature!" + + # Find __LINKEDIT segment by name (16-byte zero padded string) + __LINKEDIT_NAME = b'__LINKEDIT\x00\x00\x00\x00\x00\x00' + linkedit_seg = [cmd for cmd in header.commands if cmd[0].cmd == LC_SEGMENT_64 and cmd[1].segname == __LINKEDIT_NAME] + assert len(linkedit_seg) == 1, "Expected exactly one __LINKEDIT segment!" + linkedit_seg = linkedit_seg[0][1] # Take the segment command entry + # Find SYMTAB section + symtab_sec = [cmd for cmd in header.commands if cmd[0].cmd == LC_SYMTAB] + assert len(symtab_sec) == 1, "Expected exactly one SYMTAB section!" + symtab_sec = symtab_sec[0][1] # Take the symtab command entry + + # The string table is located at the end of the SYMTAB section, which in turn is the last section in the __LINKEDIT + # segment. Therefore, the end of SYMTAB section should be aligned with the end of __LINKEDIT segment, and in turn + # both should be aligned with the end of the file (as we are in the last or the only arch slice). + # + # However, when removing the signature from the executable using codesign under macOS 10.13, the codesign utility + # may produce an invalid file, with the declared length of the __LINKEDIT segment (linkedit_seg.filesize) pointing + # beyond the end of file, as reported in issue #6167. + # + # We can compensate for that by not using the declared sizes anywhere, and simply recompute them. In the final + # binary, the __LINKEDIT segment and the SYMTAB section MUST end at the end of the file (otherwise, we have bigger + # issues...). So simply recompute the declared sizes as difference between the final file length and the + # corresponding start offset (NOTE: the offset is relative to start of the slice, which is stored in header.offset. + # In thin binaries, header.offset is zero and start offset is relative to the start of file, but with fat binaries, + # header.offset is non-zero) + symtab_sec.strsize = file_size - (header.offset + symtab_sec.stroff) + linkedit_seg.filesize = file_size - (header.offset + linkedit_seg.fileoff) + + # Compute new vmsize by rounding filesize up to full page size. + page_size = (0x4000 if _get_arch_string(header.header).startswith('arm64') else 0x1000) + linkedit_seg.vmsize = math.ceil(linkedit_seg.filesize / page_size) * page_size + + # NOTE: according to spec, segments need to be aligned to page boundaries: 0x4000 (16 kB) for arm64, 0x1000 (4 kB) + # for other arches. But it seems we can get away without rounding and padding the segment file size - perhaps + # because it is the last one? + + # Write changes + with open(filename, 'rb+') as fp: + executable.write(fp) + + # In fat binaries, we also need to adjust the fat header. macholib as of version 1.14 does not support this, so we + # need to do it ourselves... + if executable.fat: + from macholib.mach_o import (FAT_MAGIC, FAT_MAGIC_64, fat_arch, fat_arch64, fat_header) + with open(filename, 'rb+') as fp: + # Taken from MachO.load_fat() implementation. The fat header's signature has already been validated when we + # loaded the file for the first time. + fat = fat_header.from_fileobj(fp) + if fat.magic == FAT_MAGIC: + archs = [fat_arch.from_fileobj(fp) for i in range(fat.nfat_arch)] + elif fat.magic == FAT_MAGIC_64: + archs = [fat_arch64.from_fileobj(fp) for i in range(fat.nfat_arch)] + # Adjust the size in the fat header for the last slice. + arch = archs[-1] + arch.size = file_size - arch.offset + # Now write the fat headers back to the file. + fp.seek(0) + fat.to_fileobj(fp) + for arch in archs: + arch.to_fileobj(fp) + + +def _get_arch_string(header): + """ + Converts cputype and cpusubtype from mach_o.mach_header_64 into arch string comparible with lipo/codesign. + The list of supported architectures can be found in man(1) arch. + """ + # NOTE: the constants below are taken from macholib.mach_o + cputype = header.cputype + cpusubtype = header.cpusubtype & 0x0FFFFFFF + if cputype == 0x01000000 | 7: + if cpusubtype == 8: + return 'x86_64h' # 64-bit intel (haswell) + else: + return 'x86_64' # 64-bit intel + elif cputype == 0x01000000 | 12: + if cpusubtype == 2: + return 'arm64e' + else: + return 'arm64' + elif cputype == 7: + return 'i386' # 32-bit intel + assert False, 'Unhandled architecture!' + + +def update_exe_identifier(filename, pkg_filename): + """ + Modifies the Mach-O image UUID stored in the LC_UUID command (if present) in order to ensure that different + frozen applications have different identifiers. See TN3178 for details on why this is required: + https://developer.apple.com/documentation/technotes/tn3178-checking-for-and-resolving-build-uuid-problems + """ + + # Compute hash of the PKG + import hashlib + pkg_hash = hashlib.sha1() + with open(pkg_filename, 'rb') as fp: + for chunk in iter(lambda: fp.read(8192), b""): + pkg_hash.update(chunk) + + # Modify UUID in all arch slices of the executable. + executable = MachO(filename) + for header in executable.headers: + # Find LC_UUID command + uuid_cmd = [cmd for cmd in header.commands if cmd[0].cmd == LC_UUID] + if not uuid_cmd: + continue + uuid_cmd = uuid_cmd[0] + + # Read the existing UUID (which is based on bootloader executable itself). + original_uuid = uuid_cmd[1].uuid + + # Add original UUID to the hash; this is similar to what UUID v3/v5 do with namespace + name, except + # that in our case, the prefix UUID (namespace) is added at the end, so that PKG hash needs to be + # (pre)computed only once. + combined_hash = pkg_hash.copy() + combined_hash.update(original_uuid) + + new_uuid = combined_hash.digest()[:16] # Same as uuid.uuid3() / uuid.uuid5(). + assert len(new_uuid) == 16 + + uuid_cmd[1].uuid = new_uuid + + # Write changes + with open(filename, 'rb+') as fp: + executable.write(fp) + + +class InvalidBinaryError(Exception): + """ + Exception raised by `get_binary_architectures` when it is passed an invalid binary. + """ + pass + + +class IncompatibleBinaryArchError(Exception): + """ + Exception raised by `binary_to_target_arch` when the passed binary fails the strict architecture check. + """ + def __init__(self, message): + url = "https://pyinstaller.org/en/stable/feature-notes.html#macos-multi-arch-support" + super().__init__(f"{message} For details about this error message, see: {url}") + + +def get_binary_architectures(filename): + """ + Inspects the given binary and returns tuple (is_fat, archs), where is_fat is boolean indicating fat/thin binary, + and arch is list of architectures with lipo/codesign compatible names. + """ + try: + executable = MachO(filename) + except ValueError as e: + raise InvalidBinaryError("Invalid Mach-O binary!") from e + return bool(executable.fat), [_get_arch_string(hdr.header) for hdr in executable.headers] + + +def convert_binary_to_thin_arch(filename, thin_arch, output_filename=None): + """ + Convert the given fat binary into thin one with the specified target architecture. + """ + output_filename = output_filename or filename + cmd_args = ['lipo', '-thin', thin_arch, filename, '-output', output_filename] + p = subprocess.run(cmd_args, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, encoding='utf-8') + if p.returncode: + raise SystemError(f"lipo command ({cmd_args}) failed with error code {p.returncode}!\noutput: {p.stdout}") + + +def merge_into_fat_binary(output_filename, *slice_filenames): + """ + Merge the given single-arch thin binary files into a fat binary. + """ + cmd_args = ['lipo', '-create', '-output', output_filename, *slice_filenames] + p = subprocess.run(cmd_args, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, encoding='utf-8') + if p.returncode: + raise SystemError(f"lipo command ({cmd_args}) failed with error code {p.returncode}!\noutput: {p.stdout}") + + +def binary_to_target_arch(filename, target_arch, display_name=None): + """ + Check that the given binary contains required architecture slice(s) and convert the fat binary into thin one, + if necessary. + """ + if not display_name: + display_name = filename # Same as input file + # Check the binary + is_fat, archs = get_binary_architectures(filename) + if target_arch == 'universal2': + if not is_fat: + raise IncompatibleBinaryArchError(f"{display_name} is not a fat binary!") + # Assume fat binary is universal2; nothing to do + else: + if is_fat: + if target_arch not in archs: + raise IncompatibleBinaryArchError(f"{display_name} does not contain slice for {target_arch}!") + # Convert to thin arch + logger.debug("Converting fat binary %s (%s) to thin binary (%s)", filename, display_name, target_arch) + convert_binary_to_thin_arch(filename, target_arch) + else: + if target_arch not in archs: + raise IncompatibleBinaryArchError( + f"{display_name} is incompatible with target arch {target_arch} (has arch: {archs[0]})!" + ) + # Binary has correct arch; nothing to do + + +def remove_signature_from_binary(filename): + """ + Remove the signature from all architecture slices of the given binary file using the codesign utility. + """ + logger.debug("Removing signature from file %r", filename) + cmd_args = ['/usr/bin/codesign', '--remove', '--all-architectures', filename] + p = subprocess.run(cmd_args, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, encoding='utf-8') + if p.returncode: + raise SystemError(f"codesign command ({cmd_args}) failed with error code {p.returncode}!\noutput: {p.stdout}") + + +def sign_binary(filename, identity=None, entitlements_file=None, deep=False): + """ + Sign the binary using codesign utility. If no identity is provided, ad-hoc signing is performed. + """ + extra_args = [] + if not identity: + identity = '-' # ad-hoc signing + else: + extra_args.append('--options=runtime') # hardened runtime + if entitlements_file: + extra_args.append('--entitlements') + extra_args.append(entitlements_file) + if deep: + extra_args.append('--deep') + + logger.debug("Signing file %r", filename) + cmd_args = [ + '/usr/bin/codesign', '-s', identity, '--force', '--all-architectures', '--timestamp', *extra_args, filename + ] + p = subprocess.run(cmd_args, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, encoding='utf-8') + if p.returncode: + raise SystemError(f"codesign command ({cmd_args}) failed with error code {p.returncode}!\noutput: {p.stdout}") + + +def set_dylib_dependency_paths(filename, target_rpath): + """ + Modify the given dylib's identity (in LC_ID_DYLIB command) and the paths to dependent dylibs (in LC_LOAD_DYLIB) + commands into `@rpath/` format, remove any existing rpaths (LC_RPATH commands), and add a new rpath + (LC_RPATH command) with the specified path. + + Uses `install-tool-name` utility to make the changes. + + The system libraries (e.g., the ones found in /usr/lib) are exempted from path rewrite. + + For multi-arch fat binaries, this function extracts each slice into temporary file, processes it separately, + and then merges all processed slices back into fat binary. This is necessary because `install-tool-name` cannot + modify rpaths in cases when an existing rpath is present only in one slice. + """ + + # Check if we are dealing with a fat binary; the `install-name-tool` seems to be unable to remove an rpath that is + # present only in one slice, so we need to extract each slice, process it separately, and then stich processed + # slices back into a fat binary. + is_fat, archs = get_binary_architectures(filename) + + if is_fat: + with tempfile.TemporaryDirectory() as tmpdir: + slice_filenames = [] + for arch in archs: + slice_filename = os.path.join(tmpdir, arch) + convert_binary_to_thin_arch(filename, arch, output_filename=slice_filename) + _set_dylib_dependency_paths(slice_filename, target_rpath) + slice_filenames.append(slice_filename) + merge_into_fat_binary(filename, *slice_filenames) + else: + # Thin binary - we can process it directly + _set_dylib_dependency_paths(filename, target_rpath) + + +def _set_dylib_dependency_paths(filename, target_rpath): + """ + The actual implementation of set_dylib_dependency_paths functionality. + + Implicitly assumes that a single-arch thin binary is given. + """ + + # Relocatable commands that we should overwrite - same list as used by `macholib`. + _RELOCATABLE = { + LC_LOAD_DYLIB, + LC_LOAD_UPWARD_DYLIB, + LC_LOAD_WEAK_DYLIB, + LC_PREBOUND_DYLIB, + LC_REEXPORT_DYLIB, + } + + # Parse dylib's header to extract the following commands: + # - LC_LOAD_DYLIB (or any member of _RELOCATABLE list): dylib load commands (dependent libraries) + # - LC_RPATH: rpath definitions + # - LC_ID_DYLIB: dylib's identity + binary = MachO(filename) + + dylib_id = None + rpaths = set() + linked_libs = set() + + for header in binary.headers: + for cmd in header.commands: + lc_type = cmd[0].cmd + if lc_type not in _RELOCATABLE and lc_type not in {LC_RPATH, LC_ID_DYLIB}: + continue + + # Decode path, strip trailing NULL characters + path = cmd[2].decode('utf-8').rstrip('\x00') + + if lc_type in _RELOCATABLE: + linked_libs.add(path) + elif lc_type == LC_RPATH: + rpaths.add(path) + elif lc_type == LC_ID_DYLIB: + dylib_id = path + + del binary + + # If dylib has identifier set, compute the normalized version, in form of `@rpath/basename`. + normalized_dylib_id = None + if dylib_id: + normalized_dylib_id = str(pathlib.PurePath('@rpath') / pathlib.PurePath(dylib_id).name) + + # Find dependent libraries that should have their prefix path changed to `@rpath`. If any dependent libraries + # end up using `@rpath` (originally or due to rewrite), set the `rpath_required` boolean to True, so we know + # that we need to add our rpath. + changed_lib_paths = [] + rpath_required = False + for linked_lib in linked_libs: + # Leave system dynamic libraries unchanged. + if macholib.util.in_system_path(linked_lib): + continue + + # The older python.org builds that use system Tcl/Tk framework have their _tkinter.cpython-*-darwin.so + # library linked against /Library/Frameworks/Tcl.framework/Versions/8.5/Tcl and + # /Library/Frameworks/Tk.framework/Versions/8.5/Tk, although the actual frameworks are located in + # /System/Library/Frameworks. Therefore, they slip through the above in_system_path() check, and we need to + # exempt them manually. + _exemptions = [ + '/Library/Frameworks/Tcl.framework/', + '/Library/Frameworks/Tk.framework/', + ] + if any([x in linked_lib for x in _exemptions]): + continue + + # This linked library will end up using `@rpath`, whether modified or not... + rpath_required = True + + new_path = str(pathlib.PurePath('@rpath') / pathlib.PurePath(linked_lib).name) + if linked_lib == new_path: + continue + + changed_lib_paths.append((linked_lib, new_path)) + + # Gather arguments for `install-name-tool` + install_name_tool_args = [] + + # Modify the dylib identifier if necessary + if normalized_dylib_id and normalized_dylib_id != dylib_id: + install_name_tool_args += ["-id", normalized_dylib_id] + + # Changed libs + for original_path, new_path in changed_lib_paths: + install_name_tool_args += ["-change", original_path, new_path] + + # Remove all existing rpaths except for the target rpath (if it already exists). `install_name_tool` disallows using + # `-delete_rpath` and `-add_rpath` with the same argument. + for rpath in rpaths: + if rpath == target_rpath: + continue + install_name_tool_args += [ + "-delete_rpath", + rpath, + ] + + # If any of linked libraries use @rpath now and our target rpath is not already added, add it. + # NOTE: @rpath in the dylib identifier does not actually require the rpath to be set on the binary... + if rpath_required and target_rpath not in rpaths: + install_name_tool_args += [ + "-add_rpath", + target_rpath, + ] + + # If we have no arguments, finish immediately. + if not install_name_tool_args: + return + + # Run `install_name_tool` + cmd_args = ["install_name_tool", *install_name_tool_args, filename] + p = subprocess.run(cmd_args, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, encoding='utf-8') + if p.returncode: + raise SystemError( + f"install_name_tool command ({cmd_args}) failed with error code {p.returncode}!\noutput: {p.stdout}" + ) + + +def is_framework_bundle_lib(lib_path): + """ + Check if the given shared library is part of a .framework bundle. + """ + + lib_path = pathlib.PurePath(lib_path) + + # For now, focus only on versioned layout, such as `QtCore.framework/Versions/5/QtCore` + if lib_path.parent.parent.name != "Versions": + return False + if lib_path.parent.parent.parent.name != lib_path.name + ".framework": + return False + + return True + + +def collect_files_from_framework_bundles(collected_files): + """ + Scan the given TOC list of collected files for shared libraries that are collected from macOS .framework bundles, + and collect the bundles' Info.plist files. Additionally, the following symbolic links: + - `Versions/Current` pointing to the `Versions/` directory containing the binary + - `` in the top-level .framework directory, pointing to `Versions/Current/` + - `Resources` in the top-level .framework directory, pointing to `Versions/Current/Resources` + - additional directories in top-level .framework directory, pointing to their counterparts in `Versions/Current` + directory. + + Returns TOC list for the discovered Info.plist files and generated symbolic links. The list does not contain + duplicated entries. + """ + invalid_framework_found = False + + framework_files = set() # Additional entries for collected files. Use set for de-duplication. + framework_paths = set() # Registered framework paths for 2nd pass. + + # 1st pass: discover binaries from .framework bundles, and for each such binary: + # - collect `Info.plist` + # - create `Current` -> `` symlink in `.framework/Versions` directory. + # - create `.framework/` -> `.framework/Versions/Current/` symlink. + # - create `.framework/Resources` -> `.framework/Versions/Current/Resources` symlink. + for dest_name, src_name, typecode in collected_files: + if typecode != 'BINARY': + continue + + src_path = pathlib.Path(src_name) # /src/path/to/.framework/Versions// + dest_path = pathlib.PurePath(dest_name) # /dest/path/to/.framework/Versions// + + # Check whether binary originates from a .framework bundle + if not is_framework_bundle_lib(src_path): + continue + + # Check whether binary is also collected into a .framework bundle (i.e., the original layout is preserved) + if not is_framework_bundle_lib(dest_path): + continue + + # Assuming versioned layout, Info.plist should exist in Resources directory located next to the binary. + info_plist_src = src_path.parent / "Resources" / "Info.plist" + if not info_plist_src.is_file(): + # Alas, the .framework bundles shipped with PySide/PyQt might have Info.plist available only in the + # top-level Resources directory. So accommodate this scenario as well, but collect the file into + # versioned directory to appease the code-signing gods... + info_plist_src_top = src_path.parent.parent.parent / "Resources" / "Info.plist" + if not info_plist_src_top.is_file(): + # Strictly speaking, a .framework bundle without Info.plist is invalid. However, that did not prevent + # PyQt from shipping such Qt .framework bundles up until v5.14.1. So by default, we just complain via + # a warning message; if such binaries work in unfrozen python, they should also work in frozen + # application. The codesign will refuse to sign the .app bundle (if we are generating one), but there + # is nothing we can do about that. + invalid_framework_found = True + framework_dir = src_path.parent.parent.parent + if compat.strict_collect_mode: + raise SystemError(f"Could not find Info.plist in {framework_dir}!") + else: + logger.warning("Could not find Info.plist in %s!", framework_dir) + continue + info_plist_src = info_plist_src_top + info_plist_dest = dest_path.parent / "Resources" / "Info.plist" + framework_files.add((str(info_plist_dest), str(info_plist_src), "DATA")) + + # Reconstruct the symlink Versions/Current -> Versions/. + # This one seems to be necessary for code signing, but might be absent from .framework bundles shipped with + # python packages. So we always create it ourselves. + framework_files.add((str(dest_path.parent.parent / "Current"), str(dest_path.parent.name), "SYMLINK")) + + dest_framework_path = dest_path.parent.parent.parent # Top-level .framework directory path. + + # Symlink the binary in the `Current` directory to the top-level .framework directory. + framework_files.add(( + str(dest_framework_path / dest_path.name), + str(pathlib.PurePath("Versions/Current") / dest_path.name), + "SYMLINK", + )) + + # Ditto for the `Resources` directory. + framework_files.add(( + str(dest_framework_path / "Resources"), + "Versions/Current/Resources", + "SYMLINK", + )) + + # Register the framework parent path to use in additional directories scan in subsequent pass. + framework_paths.add(dest_framework_path) + + # 2nd pass: scan for additional collected directories from .framework bundles, and create symlinks to the top-level + # application directory. Make the outer loop go over the registered framework paths, so it becomes no-op if no + # framework paths are registered. + VALID_SUBDIRS = {'Helpers', 'Resources'} + + for dest_framework_path in framework_paths: + for dest_name, src_name, typecode in collected_files: + dest_path = pathlib.PurePath(dest_name) + + # Try matching against framework path + try: + remaining_path = dest_path.relative_to(dest_framework_path) + except ValueError: # dest_path is not subpath of dest_framework_path + continue + + remaining_path_parts = remaining_path.parts + + # We are interested only in entries under Versions directory. + if remaining_path_parts[0] != 'Versions': + continue + + # If the entry name is among valid sub-directory names, create symlink. + dir_name = remaining_path_parts[2] + if dir_name not in VALID_SUBDIRS: + continue + + framework_files.add(( + str(dest_framework_path / dir_name), + str(pathlib.PurePath("Versions/Current") / dir_name), + "SYMLINK", + )) + + # If we encountered an invalid .framework bundle without Info.plist, warn the user that code-signing will most + # likely fail. + if invalid_framework_found: + logger.warning( + "One or more collected .framework bundles have missing Info.plist file. If you are building an .app " + "bundle, you will most likely not be able to code-sign it." + ) + + return sorted(framework_files) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/run_tests.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/run_tests.py new file mode 100755 index 0000000..c655c7a --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/run_tests.py @@ -0,0 +1,70 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +# ----------------------------------------------------------------------------- + +import argparse +import sys + +import pytest + +from PyInstaller.compat import importlib_metadata + + +def paths_to_test(include_only=None): + """ + If ``include_only`` is falsey, this functions returns paths from all entry points. Otherwise, this parameter + must be a string or sequence of strings. In this case, this function will return *only* paths from entry points + whose ``module_name`` begins with the provided string(s). + """ + # Convert a string to a list. + if isinstance(include_only, str): + include_only = [include_only] + + # Walk through all entry points. + test_path_list = [] + for entry_point in importlib_metadata.entry_points(group="pyinstaller40", name="tests"): + # Implement ``include_only``. + if ( + not include_only # If falsey, include everything, + # Otherwise, include only the specified modules. + or any(entry_point.module.startswith(name) for name in include_only) + ): + test_path_list += list(entry_point.load()()) + return test_path_list + + +# Run pytest on all tests registered by the PyInstaller setuptools testing entry point. If provided, +# the ``include_only`` argument is passed to ``path_to_test``. +def run_pytest(*args, **kwargs): + paths = paths_to_test(include_only=kwargs.pop("include_only", None)) + # Return an error code if no tests were discovered. + if not paths: + print("Error: no tests discovered.", file=sys.stderr) + # This indicates no tests were discovered; see + # https://docs.pytest.org/en/latest/usage.html#possible-exit-codes. + return 5 + else: + # See https://docs.pytest.org/en/latest/usage.html#calling-pytest-from-python-code. + # Omit ``args[0]``, which is the name of this script. + print("pytest " + " ".join([*paths, *args[1:]])) + return pytest.main([*paths, *args[1:]], **kwargs) + + +if __name__ == "__main__": + # Look only for the ``--include_only`` argument. + parser = argparse.ArgumentParser(description='Run PyInstaller packaging tests.') + parser.add_argument( + "--include_only", + action="append", + help="Only run tests from the specified package.", + ) + args, unknown = parser.parse_known_args(sys.argv) + # Convert the parsed args into a dict using ``vars(args)``. + sys.exit(run_pytest(*unknown, **vars(args))) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/tests.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/tests.py new file mode 100755 index 0000000..4a0b9c7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/tests.py @@ -0,0 +1,112 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Decorators for skipping PyInstaller tests when specific requirements are not met. +""" + +import inspect +import sys +import textwrap + +import pytest + +from PyInstaller.utils.hooks import check_requirement + +# Wrap some pytest decorators to be consistent in tests. +parametrize = pytest.mark.parametrize +skipif = pytest.mark.skipif +xfail = pytest.mark.xfail +skip = pytest.mark.skip + +# Use these decorators to use the `pyi_builder` fixture only in onedir or only in onefile mode instead of both. +onedir_only = pytest.mark.parametrize('pyi_builder', ['onedir'], indirect=True) +onefile_only = pytest.mark.parametrize('pyi_builder', ['onefile'], indirect=True) + + +def importorskip(package: str): + """ + Skip a decorated test if **package** is not importable. + + Arguments: + package: + The name of the module. May be anything that is allowed after the ``import`` keyword. e.g. 'numpy' or + 'PIL.Image'. + Returns: + A pytest marker which either skips the test or does nothing. + + This function intentionally does not import the module. Doing so can lead to `sys.path` and `PATH` being + polluted, which then breaks later builds. + """ + if not importable(package): + return pytest.mark.skip(f"Can't import '{package}'.") + return pytest.mark.skipif(False, reason=f"Don't skip: '{package}' is importable.") + + +def importable(package: str): + from importlib.util import find_spec + + # The find_spec() function is used by the importlib machinery to locate a module to import. Using it finds the + # module but does not run it. Unfortunately, it does import parent modules to check submodules. + if "." in package: + # Using subprocesses is slow. If the top level module doesn't exist then we can skip it. + if not importable(package.split(".")[0]): + return False + # This is a submodule, import it in isolation. + from subprocess import DEVNULL, run + return run([sys.executable, "-c", "import " + package], stdout=DEVNULL, stderr=DEVNULL).returncode == 0 + + return find_spec(package) is not None + + +def requires(requirement: str): + """ + Mark a test to be skipped if **requirement** is not satisfied. + + Args: + requirement: + A distribution name and optional version specifier(s). See :func:`PyInstaller.utils.hooks.check_requirement` + which this argument is forwarded to. + Returns: + Either a skip marker or a dummy marker. + + This function operates on distribution metadata, and does not import any modules. + """ + if check_requirement(requirement): + return pytest.mark.skipif(False, reason=f"Don't skip: '{requirement}' is satisfied.") + else: + return pytest.mark.skip(f"Requires {requirement}.") + + +def gen_sourcefile(tmp_path, source, test_id=None): + """ + Generate a source file for testing. + + The source will be written into a file named like the test-function. This file will then be passed to + `test_script`. If you need other related file, e.g. as `.toc`-file for testing the content, put it at at the + normal place. Just mind to take the basnename from the test-function's name. + + :param script: Source code to create executable from. This will be saved into a temporary file which is then + passed on to `test_script`. + + :param test_id: Test-id for parametrized tests. If given, it will be appended to the script filename, + separated by two underscores. + """ + testname = inspect.stack()[1][3] + if test_id: + # For parametrized test append the test-id. + testname = testname + '__' + test_id + + # Periods are not allowed in Python module names. + testname = testname.replace('.', '_') + scriptfile = tmp_path / (testname + '.py') + source = textwrap.dedent(source) + scriptfile.write_text(source, encoding='utf-8') + return scriptfile diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/__init__.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/__init__.py new file mode 100755 index 0000000..a7501ae --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/__init__.py @@ -0,0 +1 @@ +__author__ = 'martin' diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/icon.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/icon.py new file mode 100755 index 0000000..7b703f8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/icon.py @@ -0,0 +1,251 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +The code in this module supports the --icon parameter on Windows. +(For --icon support under macOS, see building/osx.py.) + +The only entry point, called from api.py, is CopyIcons(), below. All the elaborate structure of classes that follows +is used to support the operation of CopyIcons_FromIco(). None of these classes and globals are referenced outside +this module. +""" + +import os +import os.path +import struct + +import PyInstaller.log as logging +from PyInstaller import config +from PyInstaller.compat import pywintypes, win32api +from PyInstaller.building.icon import normalize_icon_type + +logger = logging.getLogger(__name__) + +RT_ICON = 3 +RT_GROUP_ICON = 14 +LOAD_LIBRARY_AS_DATAFILE = 2 + + +class Structure: + def __init__(self): + size = self._sizeInBytes = struct.calcsize(self._format_) + self._fields_ = list(struct.unpack(self._format_, b'\000' * size)) + indexes = self._indexes_ = {} + for i, nm in enumerate(self._names_): + indexes[nm] = i + + def dump(self): + logger.info("DUMP of %s", self) + for name in self._names_: + if not name.startswith('_'): + logger.info("%20s = %s", name, getattr(self, name)) + logger.info("") + + def __getattr__(self, name): + if name in self._names_: + index = self._indexes_[name] + return self._fields_[index] + try: + return self.__dict__[name] + except KeyError as e: + raise AttributeError(name) from e + + def __setattr__(self, name, value): + if name in self._names_: + index = self._indexes_[name] + self._fields_[index] = value + else: + self.__dict__[name] = value + + def tostring(self): + return struct.pack(self._format_, *self._fields_) + + def fromfile(self, file): + data = file.read(self._sizeInBytes) + self._fields_ = list(struct.unpack(self._format_, data)) + + +class ICONDIRHEADER(Structure): + _names_ = "idReserved", "idType", "idCount" + _format_ = "hhh" + + +class ICONDIRENTRY(Structure): + _names_ = ("bWidth", "bHeight", "bColorCount", "bReserved", "wPlanes", "wBitCount", "dwBytesInRes", "dwImageOffset") + _format_ = "bbbbhhii" + + +class GRPICONDIR(Structure): + _names_ = "idReserved", "idType", "idCount" + _format_ = "hhh" + + +class GRPICONDIRENTRY(Structure): + _names_ = ("bWidth", "bHeight", "bColorCount", "bReserved", "wPlanes", "wBitCount", "dwBytesInRes", "nID") + _format_ = "bbbbhhih" + + +# An IconFile instance is created for each .ico file given. +class IconFile: + def __init__(self, path): + self.path = path + try: + # The path is from the user parameter, don't trust it. + file = open(self.path, "rb") + except OSError: + # The icon file can't be opened for some reason. Stop the + # program with an informative message. + raise SystemExit(f'ERROR: Unable to open icon file {self.path}!') + with file: + self.entries = [] + self.images = [] + header = self.header = ICONDIRHEADER() + header.fromfile(file) + for i in range(header.idCount): + entry = ICONDIRENTRY() + entry.fromfile(file) + self.entries.append(entry) + for e in self.entries: + file.seek(e.dwImageOffset, 0) + self.images.append(file.read(e.dwBytesInRes)) + + def grp_icon_dir(self): + return self.header.tostring() + + def grp_icondir_entries(self, id=1): + data = b'' + for entry in self.entries: + e = GRPICONDIRENTRY() + for n in e._names_[:-1]: + setattr(e, n, getattr(entry, n)) + e.nID = id + id = id + 1 + data = data + e.tostring() + return data + + +def CopyIcons_FromIco(dstpath, srcpath, id=1): + """ + Use the Win API UpdateResource facility to apply the icon resource(s) to the .exe file. + + :param str dstpath: absolute path of the .exe file being built. + :param str srcpath: list of 1 or more .ico file paths + """ + icons = map(IconFile, srcpath) + logger.debug("Copying icons from %s", srcpath) + + hdst = win32api.BeginUpdateResource(dstpath, 0) + + iconid = 1 + # Each step in the following enumerate() will instantiate an IconFile object, as a result of deferred execution + # of the map() above. + for i, f in enumerate(icons): + data = f.grp_icon_dir() + data = data + f.grp_icondir_entries(iconid) + win32api.UpdateResource(hdst, RT_GROUP_ICON, i + 1, data) + logger.debug("Writing RT_GROUP_ICON %d resource with %d bytes", i + 1, len(data)) + for data in f.images: + win32api.UpdateResource(hdst, RT_ICON, iconid, data) + logger.debug("Writing RT_ICON %d resource with %d bytes", iconid, len(data)) + iconid = iconid + 1 + + win32api.EndUpdateResource(hdst, 0) + + +def CopyIcons(dstpath, srcpath): + """ + Called from building/api.py to handle icons. If the input was by --icon on the command line, srcpath is a single + string. However, it is possible to modify the spec file adding icon=['foo.ico','bar.ico'] to the EXE() statement. + In that case, srcpath is a list of strings. + + The string format is either path-to-.ico or path-to-.exe,n for n an integer resource index in the .exe. In either + case, the path can be relative or absolute. + """ + + if isinstance(srcpath, (str, os.PathLike)): + # Just a single string, make it a one-element list. + srcpath = [srcpath] + # Convert possible PathLike elements to strings to allow the splitter function to work. + srcpath = [str(path) for path in srcpath] + + def splitter(s): + """ + Convert "pathname" to tuple ("pathname", None) + Convert "pathname,n" to tuple ("pathname", n) + """ + try: + srcpath, index = s.split(',') + return srcpath.strip(), int(index) + except ValueError: + return s, None + + # split all the items in the list into tuples as above. + srcpath = list(map(splitter, srcpath)) + + if len(srcpath) > 1: + # More than one icon source given. We currently handle multiple icons by calling CopyIcons_FromIco(), which only + # allows .ico, but will convert to that format if needed. + # + # Note that a ",index" on a .ico is just ignored in the single or multiple case. + srcs = [] + for s in srcpath: + srcs.append(normalize_icon_type(s[0], ("ico",), "ico", config.CONF["workpath"])) + return CopyIcons_FromIco(dstpath, srcs) + + # Just one source given. + srcpath, index = srcpath[0] + + # Makes sure the icon exists and attempts to convert to the proper format if applicable + srcpath = normalize_icon_type(srcpath, ("exe", "ico"), "ico", config.CONF["workpath"]) + + srcext = os.path.splitext(srcpath)[1] + + # Handle the simple case of foo.ico, ignoring any index. + if srcext.lower() == '.ico': + return CopyIcons_FromIco(dstpath, [srcpath]) + + # Single source is not .ico, presumably it is .exe (and if not, some error will occur). + if index is not None: + logger.debug("Copying icon from %s, %d", srcpath, index) + else: + logger.debug("Copying icons from %s", srcpath) + + try: + # Attempt to load the .ico or .exe containing the icon into memory using the same mechanism as if it were a DLL. + # If this fails for any reason (for example if the file does not exist or is not a .ico/.exe) then LoadLibraryEx + # returns a null handle and win32api raises a unique exception with a win error code and a string. + hsrc = win32api.LoadLibraryEx(srcpath, 0, LOAD_LIBRARY_AS_DATAFILE) + except pywintypes.error as W32E: + # We could continue with no icon (i.e., just return), but it seems best to terminate the build with a message. + raise SystemExit( + "ERROR: Unable to load icon file {}\n {} (Error code {})".format(srcpath, W32E.strerror, W32E.winerror) + ) + hdst = win32api.BeginUpdateResource(dstpath, 0) + if index is None: + grpname = win32api.EnumResourceNames(hsrc, RT_GROUP_ICON)[0] + elif index >= 0: + grpname = win32api.EnumResourceNames(hsrc, RT_GROUP_ICON)[index] + else: + grpname = -index + data = win32api.LoadResource(hsrc, RT_GROUP_ICON, grpname) + win32api.UpdateResource(hdst, RT_GROUP_ICON, grpname, data) + for iconname in win32api.EnumResourceNames(hsrc, RT_ICON): + data = win32api.LoadResource(hsrc, RT_ICON, iconname) + win32api.UpdateResource(hdst, RT_ICON, iconname, data) + win32api.FreeLibrary(hsrc) + win32api.EndUpdateResource(hdst, 0) + + +if __name__ == "__main__": + import sys + + dstpath = sys.argv[1] + srcpath = sys.argv[2:] + CopyIcons(dstpath, srcpath) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/versioninfo.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/versioninfo.py new file mode 100755 index 0000000..b290644 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/versioninfo.py @@ -0,0 +1,604 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- + +import struct + +import pefile + +from PyInstaller.compat import win32api + + +def pefile_check_control_flow_guard(filename): + """ + Checks if the specified PE file has CFG (Control Flow Guard) enabled. + + Parameters + ---------- + filename : str + Path to the PE file to inspect. + + Returns + ---------- + bool + True if file is a PE file with CFG enabled. False if CFG is not enabled or if file could not be processed using + the pefile library. + """ + try: + pe = pefile.PE(filename, fast_load=True) + # https://docs.microsoft.com/en-us/windows/win32/debug/pe-format + # IMAGE_DLLCHARACTERISTICS_GUARD_CF = 0x4000 + return bool(pe.OPTIONAL_HEADER.DllCharacteristics & 0x4000) + except Exception: + return False + + +# Ensures no code from the executable is executed. +LOAD_LIBRARY_AS_DATAFILE = 2 + + +def getRaw(text): + """ + Encodes text as UTF-16LE (Microsoft 'Unicode') for use in structs. + """ + return text.encode('UTF-16LE') + + +def read_version_info_from_executable(exe_filename): + """ + Read the version information structure from the given executable's resources, and return it as an instance of + `VSVersionInfo` structure. + """ + h = win32api.LoadLibraryEx(exe_filename, 0, LOAD_LIBRARY_AS_DATAFILE) + res = win32api.EnumResourceNames(h, pefile.RESOURCE_TYPE['RT_VERSION']) + if not len(res): + return None + data = win32api.LoadResource(h, pefile.RESOURCE_TYPE['RT_VERSION'], res[0]) + info = VSVersionInfo() + info.fromRaw(data) + win32api.FreeLibrary(h) + return info + + +def nextDWord(offset): + """ + Align `offset` to the next 4-byte boundary. + """ + return ((offset + 3) >> 2) << 2 + + +class VSVersionInfo: + """ + WORD wLength; // length of the VS_VERSION_INFO structure + WORD wValueLength; // length of the Value member + WORD wType; // 1 means text, 0 means binary + WCHAR szKey[]; // Contains the Unicode string "VS_VERSION_INFO". + WORD Padding1[]; + VS_FIXEDFILEINFO Value; + WORD Padding2[]; + WORD Children[]; // zero or more StringFileInfo or VarFileInfo + // structures (or both) that are children of the + // current version structure. + """ + def __init__(self, ffi=None, kids=None): + self.ffi = ffi + self.kids = kids or [] + + def fromRaw(self, data): + i, (sublen, vallen, wType, nm) = parseCommon(data) + #vallen is length of the ffi, typ is 0, nm is 'VS_VERSION_INFO'. + i = nextDWord(i) + # Now a VS_FIXEDFILEINFO + self.ffi = FixedFileInfo() + j = self.ffi.fromRaw(data, i) + i = j + while i < sublen: + j = i + i, (csublen, cvallen, ctyp, nm) = parseCommon(data, i) + if nm.strip() == 'StringFileInfo': + sfi = StringFileInfo() + k = sfi.fromRaw(csublen, cvallen, nm, data, i, j + csublen) + self.kids.append(sfi) + i = k + else: + vfi = VarFileInfo() + k = vfi.fromRaw(csublen, cvallen, nm, data, i, j + csublen) + self.kids.append(vfi) + i = k + i = j + csublen + i = nextDWord(i) + return i + + def toRaw(self): + raw_name = getRaw('VS_VERSION_INFO') + rawffi = self.ffi.toRaw() + vallen = len(rawffi) + typ = 0 + sublen = 6 + len(raw_name) + 2 + pad = b'' + if sublen % 4: + pad = b'\000\000' + sublen = sublen + len(pad) + vallen + pad2 = b'' + if sublen % 4: + pad2 = b'\000\000' + tmp = b''.join([kid.toRaw() for kid in self.kids]) + sublen = sublen + len(pad2) + len(tmp) + return struct.pack('HHH', sublen, vallen, typ) + raw_name + b'\000\000' + pad + rawffi + pad2 + tmp + + def __eq__(self, other): + return self.toRaw() == other + + def __str__(self, indent=''): + indent = indent + ' ' + tmp = [kid.__str__(indent + ' ') for kid in self.kids] + tmp = ', \n'.join(tmp) + return '\n'.join([ + "# UTF-8", + "#", + "# For more details about fixed file info 'ffi' see:", + "# http://msdn.microsoft.com/en-us/library/ms646997.aspx", + "VSVersionInfo(", + indent + f"ffi={self.ffi.__str__(indent)},", + indent + "kids=[", + tmp, + indent + "]", + ")", + ]) + + def __repr__(self): + return "versioninfo.VSVersionInfo(ffi=%r, kids=%r)" % (self.ffi, self.kids) + + +def parseCommon(data, start=0): + i = start + 6 + (wLength, wValueLength, wType) = struct.unpack('3H', data[start:i]) + i, text = parseUString(data, i, i + wLength) + return i, (wLength, wValueLength, wType, text) + + +def parseUString(data, start, limit): + i = start + while i < limit: + if data[i:i + 2] == b'\000\000': + break + i += 2 + text = data[start:i].decode('UTF-16LE') + i += 2 + return i, text + + +class FixedFileInfo: + """ + DWORD dwSignature; //Contains the value 0xFEEFO4BD + DWORD dwStrucVersion; // binary version number of this structure. + // The high-order word of this member contains + // the major version number, and the low-order + // word contains the minor version number. + DWORD dwFileVersionMS; // most significant 32 bits of the file's binary + // version number + DWORD dwFileVersionLS; // + DWORD dwProductVersionMS; // most significant 32 bits of the binary version + // number of the product with which this file was + // distributed + DWORD dwProductVersionLS; // + DWORD dwFileFlagsMask; // bitmask that specifies the valid bits in + // dwFileFlags. A bit is valid only if it was + // defined when the file was created. + DWORD dwFileFlags; // VS_FF_DEBUG, VS_FF_PATCHED etc. + DWORD dwFileOS; // VOS_NT, VOS_WINDOWS32 etc. + DWORD dwFileType; // VFT_APP etc. + DWORD dwFileSubtype; // 0 unless VFT_DRV or VFT_FONT or VFT_VXD + DWORD dwFileDateMS; + DWORD dwFileDateLS; + """ + def __init__( + self, + filevers=(0, 0, 0, 0), + prodvers=(0, 0, 0, 0), + mask=0x3f, + flags=0x0, + OS=0x40004, + fileType=0x1, + subtype=0x0, + date=(0, 0) + ): + self.sig = 0xfeef04bd + self.strucVersion = 0x10000 + self.fileVersionMS = (filevers[0] << 16) | (filevers[1] & 0xffff) + self.fileVersionLS = (filevers[2] << 16) | (filevers[3] & 0xffff) + self.productVersionMS = (prodvers[0] << 16) | (prodvers[1] & 0xffff) + self.productVersionLS = (prodvers[2] << 16) | (prodvers[3] & 0xffff) + self.fileFlagsMask = mask + self.fileFlags = flags + self.fileOS = OS + self.fileType = fileType + self.fileSubtype = subtype + self.fileDateMS = date[0] + self.fileDateLS = date[1] + + def fromRaw(self, data, i): + ( + self.sig, + self.strucVersion, + self.fileVersionMS, + self.fileVersionLS, + self.productVersionMS, + self.productVersionLS, + self.fileFlagsMask, + self.fileFlags, + self.fileOS, + self.fileType, + self.fileSubtype, + self.fileDateMS, + self.fileDateLS, + ) = struct.unpack('13L', data[i:i + 52]) + return i + 52 + + def toRaw(self): + return struct.pack( + '13L', + self.sig, + self.strucVersion, + self.fileVersionMS, + self.fileVersionLS, + self.productVersionMS, + self.productVersionLS, + self.fileFlagsMask, + self.fileFlags, + self.fileOS, + self.fileType, + self.fileSubtype, + self.fileDateMS, + self.fileDateLS, + ) + + def __eq__(self, other): + return self.toRaw() == other + + def __str__(self, indent=''): + fv = ( + self.fileVersionMS >> 16, self.fileVersionMS & 0xffff, + self.fileVersionLS >> 16, self.fileVersionLS & 0xffff, + ) # yapf: disable + pv = ( + self.productVersionMS >> 16, self.productVersionMS & 0xffff, + self.productVersionLS >> 16, self.productVersionLS & 0xffff, + ) # yapf: disable + fd = (self.fileDateMS, self.fileDateLS) + tmp = [ + 'FixedFileInfo(', + '# filevers and prodvers should be always a tuple with four items: (1, 2, 3, 4)', + '# Set not needed items to zero 0.', + 'filevers=%s,' % (fv,), + 'prodvers=%s,' % (pv,), + "# Contains a bitmask that specifies the valid bits 'flags'r", + 'mask=%s,' % hex(self.fileFlagsMask), + '# Contains a bitmask that specifies the Boolean attributes of the file.', + 'flags=%s,' % hex(self.fileFlags), + '# The operating system for which this file was designed.', + '# 0x4 - NT and there is no need to change it.', + 'OS=%s,' % hex(self.fileOS), + '# The general type of file.', + '# 0x1 - the file is an application.', + 'fileType=%s,' % hex(self.fileType), + '# The function of the file.', + '# 0x0 - the function is not defined for this fileType', + 'subtype=%s,' % hex(self.fileSubtype), + '# Creation date and time stamp.', + 'date=%s' % (fd,), + ')', + ] + return f'\n{indent} '.join(tmp) + + def __repr__(self): + fv = ( + self.fileVersionMS >> 16, self.fileVersionMS & 0xffff, + self.fileVersionLS >> 16, self.fileVersionLS & 0xffff, + ) # yapf: disable + pv = ( + self.productVersionMS >> 16, self.productVersionMS & 0xffff, + self.productVersionLS >> 16, self.productVersionLS & 0xffff, + ) # yapf: disable + fd = (self.fileDateMS, self.fileDateLS) + return ( + 'versioninfo.FixedFileInfo(filevers=%r, prodvers=%r, ' + 'mask=0x%x, flags=0x%x, OS=0x%x, ' + 'fileType=%r, subtype=0x%x, date=%r)' % + (fv, pv, self.fileFlagsMask, self.fileFlags, self.fileOS, self.fileType, self.fileSubtype, fd) + ) + + +class StringFileInfo: + """ + WORD wLength; // length of the version resource + WORD wValueLength; // length of the Value member in the current + // VS_VERSION_INFO structure + WORD wType; // 1 means text, 0 means binary + WCHAR szKey[]; // Contains the Unicode string 'StringFileInfo'. + WORD Padding[]; + StringTable Children[]; // list of zero or more String structures + """ + def __init__(self, kids=None): + self.name = 'StringFileInfo' + self.kids = kids or [] + + def fromRaw(self, sublen, vallen, name, data, i, limit): + self.name = name + while i < limit: + st = StringTable() + j = st.fromRaw(data, i, limit) + self.kids.append(st) + i = j + return i + + def toRaw(self): + raw_name = getRaw(self.name) + vallen = 0 + typ = 1 + sublen = 6 + len(raw_name) + 2 + pad = b'' + if sublen % 4: + pad = b'\000\000' + tmp = b''.join([kid.toRaw() for kid in self.kids]) + sublen = sublen + len(pad) + len(tmp) + return struct.pack('HHH', sublen, vallen, typ) + raw_name + b'\000\000' + pad + tmp + + def __eq__(self, other): + return self.toRaw() == other + + def __str__(self, indent=''): + new_indent = indent + ' ' + tmp = ', \n'.join(kid.__str__(new_indent) for kid in self.kids) + return f'{indent}StringFileInfo(\n{new_indent}[\n{tmp}\n{new_indent}])' + + def __repr__(self): + return 'versioninfo.StringFileInfo(%r)' % self.kids + + +class StringTable: + """ + WORD wLength; + WORD wValueLength; + WORD wType; + WCHAR szKey[]; + String Children[]; // list of zero or more String structures. + """ + def __init__(self, name=None, kids=None): + self.name = name or '' + self.kids = kids or [] + + def fromRaw(self, data, i, limit): + i, (cpsublen, cpwValueLength, cpwType, self.name) = parseCodePage(data, i, limit) # should be code page junk + i = nextDWord(i) + while i < limit: + ss = StringStruct() + j = ss.fromRaw(data, i, limit) + i = j + self.kids.append(ss) + i = nextDWord(i) + return i + + def toRaw(self): + raw_name = getRaw(self.name) + vallen = 0 + typ = 1 + sublen = 6 + len(raw_name) + 2 + tmp = [] + for kid in self.kids: + raw = kid.toRaw() + if len(raw) % 4: + raw = raw + b'\000\000' + tmp.append(raw) + tmp = b''.join(tmp) + sublen += len(tmp) + return struct.pack('HHH', sublen, vallen, typ) + raw_name + b'\000\000' + tmp + + def __eq__(self, other): + return self.toRaw() == other + + def __str__(self, indent=''): + new_indent = indent + ' ' + tmp = (',\n' + new_indent).join(str(kid) for kid in self.kids) + return f"{indent}StringTable(\n{new_indent}'{self.name}',\n{new_indent}[{tmp}])" + + def __repr__(self): + return 'versioninfo.StringTable(%r, %r)' % (self.name, self.kids) + + +class StringStruct: + """ + WORD wLength; + WORD wValueLength; + WORD wType; + WCHAR szKey[]; + WORD Padding[]; + String Value[]; + """ + def __init__(self, name=None, val=None): + self.name = name or '' + self.val = val or '' + + def fromRaw(self, data, i, limit): + i, (sublen, vallen, typ, self.name) = parseCommon(data, i) + limit = i + sublen + i = nextDWord(i) + i, self.val = parseUString(data, i, limit) + return i + + def toRaw(self): + raw_name = getRaw(self.name) + raw_val = getRaw(self.val) + # TODO: document the size of vallen and sublen. + vallen = len(self.val) + 1 # Number of (wide-)characters, not bytes! + typ = 1 + sublen = 6 + len(raw_name) + 2 + pad = b'' + if sublen % 4: + pad = b'\000\000' + sublen = sublen + len(pad) + (vallen * 2) + return struct.pack('HHH', sublen, vallen, typ) + raw_name + b'\000\000' + pad + raw_val + b'\000\000' + + def __eq__(self, other): + return self.toRaw() == other + + def __str__(self, indent=''): + return "StringStruct(%r, %r)" % (self.name, self.val) + + def __repr__(self): + return 'versioninfo.StringStruct(%r, %r)' % (self.name, self.val) + + +def parseCodePage(data, i, limit): + i, (sublen, wValueLength, wType, nm) = parseCommon(data, i) + return i, (sublen, wValueLength, wType, nm) + + +class VarFileInfo: + """ + WORD wLength; // length of the version resource + WORD wValueLength; // length of the Value member in the current + // VS_VERSION_INFO structure + WORD wType; // 1 means text, 0 means binary + WCHAR szKey[]; // Contains the Unicode string 'VarFileInfo'. + WORD Padding[]; + Var Children[]; // list of zero or more Var structures + """ + def __init__(self, kids=None): + self.kids = kids or [] + + def fromRaw(self, sublen, vallen, name, data, i, limit): + self.sublen = sublen + self.vallen = vallen + self.name = name + i = nextDWord(i) + while i < limit: + vs = VarStruct() + j = vs.fromRaw(data, i, limit) + self.kids.append(vs) + i = j + return i + + def toRaw(self): + self.vallen = 0 + self.wType = 1 + self.name = 'VarFileInfo' + raw_name = getRaw(self.name) + sublen = 6 + len(raw_name) + 2 + pad = b'' + if sublen % 4: + pad = b'\000\000' + tmp = b''.join([kid.toRaw() for kid in self.kids]) + self.sublen = sublen + len(pad) + len(tmp) + return struct.pack('HHH', self.sublen, self.vallen, self.wType) + raw_name + b'\000\000' + pad + tmp + + def __eq__(self, other): + return self.toRaw() == other + + def __str__(self, indent=''): + return indent + "VarFileInfo([%s])" % ', '.join(str(kid) for kid in self.kids) + + def __repr__(self): + return 'versioninfo.VarFileInfo(%r)' % self.kids + + +class VarStruct: + """ + WORD wLength; // length of the version resource + WORD wValueLength; // length of the Value member in the current + // VS_VERSION_INFO structure + WORD wType; // 1 means text, 0 means binary + WCHAR szKey[]; // Contains the Unicode string 'Translation' + // or a user-defined key string value + WORD Padding[]; // + WORD Value[]; // list of one or more values that are language + // and code-page identifiers + """ + def __init__(self, name=None, kids=None): + self.name = name or '' + self.kids = kids or [] + + def fromRaw(self, data, i, limit): + i, (self.sublen, self.wValueLength, self.wType, self.name) = parseCommon(data, i) + i = nextDWord(i) + for j in range(0, self.wValueLength, 2): + kid = struct.unpack('H', data[i:i + 2])[0] + self.kids.append(kid) + i += 2 + return i + + def toRaw(self): + self.wValueLength = len(self.kids) * 2 + self.wType = 0 + raw_name = getRaw(self.name) + sublen = 6 + len(raw_name) + 2 + pad = b'' + if sublen % 4: + pad = b'\000\000' + self.sublen = sublen + len(pad) + self.wValueLength + tmp = b''.join([struct.pack('H', kid) for kid in self.kids]) + return struct.pack('HHH', self.sublen, self.wValueLength, self.wType) + raw_name + b'\000\000' + pad + tmp + + def __eq__(self, other): + return self.toRaw() == other + + def __str__(self, indent=''): + return "VarStruct('%s', %r)" % (self.name, self.kids) + + def __repr__(self): + return 'versioninfo.VarStruct(%r, %r)' % (self.name, self.kids) + + +def load_version_info_from_text_file(filename): + """ + Load the `VSVersionInfo` structure from its string-based (`VSVersionInfo.__str__`) serialization by reading the + text from the file and running it through `eval()`. + """ + + # Read and parse the version file. It may have a byte order marker or encoding cookie - respect it if it does. + import PyInstaller.utils.misc as miscutils + with open(filename, 'rb') as fp: + text = miscutils.decode(fp.read()) + + # Deserialize via eval() + try: + info = eval(text) + except Exception as e: + raise ValueError("Failed to deserialize VSVersionInfo from text-based representation!") from e + + # Sanity check + assert isinstance(info, VSVersionInfo), \ + f"Loaded incompatible structure type! Expected VSVersionInfo, got: {type(info)!r}" + + return info + + +def write_version_info_to_executable(exe_filename, info): + assert isinstance(info, VSVersionInfo) + + # Remember overlay + pe = pefile.PE(exe_filename, fast_load=True) + overlay_before = pe.get_overlay() + pe.close() + + hdst = win32api.BeginUpdateResource(exe_filename, 0) + win32api.UpdateResource(hdst, pefile.RESOURCE_TYPE['RT_VERSION'], 1, info.toRaw()) + win32api.EndUpdateResource(hdst, 0) + + if overlay_before: + # Check if the overlay is still present + pe = pefile.PE(exe_filename, fast_load=True) + overlay_after = pe.get_overlay() + pe.close() + + # If the update removed the overlay data, re-append it + if not overlay_after: + with open(exe_filename, 'ab') as exef: + exef.write(overlay_before) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/winmanifest.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/winmanifest.py new file mode 100755 index 0000000..1d338df --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/winmanifest.py @@ -0,0 +1,244 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +import xml.dom +import xml.dom.minidom + +#- Relevant constants from Windows headers +# Manifest resource code +RT_MANIFEST = 24 + +# Resource IDs (names) for manifest. +# See: https://www.gamedev.net/blogs/entry/2154553-manifest-embedding-and-activation +CREATEPROCESS_MANIFEST_RESOURCE_ID = 1 +ISOLATIONAWARE_MANIFEST_RESOURCE_ID = 2 + +LANG_NEUTRAL = 0 + +#- Default application manifest template, based on the one found in python executable. + +_DEFAULT_MANIFEST_XML = \ +b""" + + + + + + + + + + + + + + + + + + + + true + + + + + + + + +""" # noqa: E122,E501 + +#- DOM navigation helpers + + +def _find_elements_by_tag(root, tag): + """ + Find all elements with given tag under the given root element. + """ + return [node for node in root.childNodes if node.nodeType == xml.dom.Node.ELEMENT_NODE and node.tagName == tag] + + +def _find_element_by_tag(root, tag): + """ + Attempt to find a single element with given tag under the given root element, and return None if no such element + is found. Raises an error if multiple elements are found. + """ + elements = _find_elements_by_tag(root, tag) + if len(elements) > 1: + raise ValueError(f"Expected a single {tag!r} element, found {len(elements)} element(s)!") + if not elements: + return None + return elements[0] + + +#- Application manifest modification helpers + + +def _set_execution_level(manifest_dom, root_element, uac_admin=False, uac_uiaccess=False): + """ + Find -> -> element, and set its `level` and `uiAccess` + attributes based on supplied arguments. Create the XML elements if necessary, as they are optional. + """ + + # + trust_info_element = _find_element_by_tag(root_element, "trustInfo") + if not trust_info_element: + trust_info_element = manifest_dom.createElement("trustInfo") + trust_info_element.setAttribute("xmlns", "urn:schemas-microsoft-com:asm.v3") + root_element.appendChild(trust_info_element) + + # + security_element = _find_element_by_tag(trust_info_element, "security") + if not security_element: + security_element = manifest_dom.createElement("security") + trust_info_element.appendChild(security_element) + + # + requested_privileges_element = _find_element_by_tag(security_element, "requestedPrivileges") + if not requested_privileges_element: + requested_privileges_element = manifest_dom.createElement("requestedPrivileges") + security_element.appendChild(requested_privileges_element) + + # + requested_execution_level_element = _find_element_by_tag(requested_privileges_element, "requestedExecutionLevel") + if not requested_execution_level_element: + requested_execution_level_element = manifest_dom.createElement("requestedExecutionLevel") + requested_privileges_element.appendChild(requested_execution_level_element) + + requested_execution_level_element.setAttribute("level", "requireAdministrator" if uac_admin else "asInvoker") + requested_execution_level_element.setAttribute("uiAccess", "true" if uac_uiaccess else "false") + + +def _ensure_common_controls_dependency(manifest_dom, root_element): + """ + Scan elements for the one whose < -> corresponds to the + `Microsoft.Windows.Common-Controls`. If found, overwrite its properties. If not, create new + element with corresponding sub-elements and attributes. + """ + + # + dependency_elements = _find_elements_by_tag(root_element, "dependency") + for dependency_element in dependency_elements: + # + dependent_assembly_element = _find_element_by_tag(dependency_element, "dependentAssembly") + # + assembly_identity_element = _find_element_by_tag(dependent_assembly_element, "assemblyIdentity") + # Check the name attribute + if assembly_identity_element.attributes["name"].value == "Microsoft.Windows.Common-Controls": + common_controls_element = assembly_identity_element + break + else: + # Create + dependency_element = manifest_dom.createElement("dependency") + root_element.appendChild(dependency_element) + # Create + dependent_assembly_element = manifest_dom.createElement("dependentAssembly") + dependency_element.appendChild(dependent_assembly_element) + # Create + common_controls_element = manifest_dom.createElement("assemblyIdentity") + dependent_assembly_element.appendChild(common_controls_element) + + common_controls_element.setAttribute("type", "win32") + common_controls_element.setAttribute("name", "Microsoft.Windows.Common-Controls") + common_controls_element.setAttribute("version", "6.0.0.0") + common_controls_element.setAttribute("processorArchitecture", "*") + common_controls_element.setAttribute("publicKeyToken", "6595b64144ccf1df") + common_controls_element.setAttribute("language", "*") + + +def create_application_manifest(manifest_xml=None, uac_admin=False, uac_uiaccess=False): + """ + Create application manifest, from built-in or custom manifest XML template. If provided, `manifest_xml` must be + a string or byte string containing XML source. The returned manifest is a byte string, encoded in UTF-8. + + This function sets the attributes of `requestedExecutionLevel` based on provided `uac_admin` and `auc_uiacces` + arguments (creating the parent elements in the XML, if necessary). It also scans `dependency` elements for the + entry corresponding to `Microsoft.Windows.Common-Controls` and creates or modifies it as necessary. + """ + + if manifest_xml is None: + manifest_xml = _DEFAULT_MANIFEST_XML + + with xml.dom.minidom.parseString(manifest_xml) as manifest_dom: + root_element = manifest_dom.documentElement + + # Validate root element - must be + assert root_element.tagName == "assembly" + assert root_element.namespaceURI == "urn:schemas-microsoft-com:asm.v1" + assert root_element.attributes["manifestVersion"].value == "1.0" + + # Modify the manifest + _set_execution_level(manifest_dom, root_element, uac_admin, uac_uiaccess) + _ensure_common_controls_dependency(manifest_dom, root_element) + + # Create output XML + output = manifest_dom.toprettyxml(indent=" ", encoding="UTF-8") + + # Strip extra newlines + output = [line for line in output.splitlines() if line.strip()] + + # Replace: `` with ``. + # Support for `standalone` was added to `toprettyxml` in python 3.9, so do a manual work around. + output[0] = b"""""" + + output = b"\n".join(output) + + return output + + +def write_manifest_to_executable(filename, manifest_xml): + """ + Write the given manifest XML to the given executable's RT_MANIFEST resource. + """ + from PyInstaller.utils.win32 import winresource + + # CREATEPROCESS_MANIFEST_RESOURCE_ID is used for manifest resource in executables. + # ISOLATIONAWARE_MANIFEST_RESOURCE_ID is used for manifest resources in DLLs. + names = [CREATEPROCESS_MANIFEST_RESOURCE_ID] + + # Ensure LANG_NEUTRAL is updated, and also update any other present languages. + languages = [LANG_NEUTRAL, "*"] + + winresource.add_or_update_resource(filename, manifest_xml, RT_MANIFEST, names, languages) + + +def read_manifest_from_executable(filename): + """ + Read manifest from the given executable." + """ + from PyInstaller.utils.win32 import winresource + + resources = winresource.get_resources(filename, [RT_MANIFEST]) + + # `resources` is a three-level dictionary: + # - level 1: resource type (RT_MANIFEST) + # - level 2: resource name (CREATEPROCESS_MANIFEST_RESOURCE_ID) + # - level 3: resource language (LANG_NEUTRAL) + + # Level 1 + if RT_MANIFEST not in resources: + raise ValueError(f"No RT_MANIFEST resources found in {filename!r}.") + resources = resources[RT_MANIFEST] + + # Level 2 + if CREATEPROCESS_MANIFEST_RESOURCE_ID not in resources: + raise ValueError(f"No RT_MANIFEST resource named CREATEPROCESS_MANIFEST_RESOURCE_ID found in {filename!r}.") + resources = resources[CREATEPROCESS_MANIFEST_RESOURCE_ID] + + # Level 3 + # We prefer LANG_NEUTRAL, but allow fall back to the first available entry. + if LANG_NEUTRAL in resources: + resources = resources[LANG_NEUTRAL] + else: + resources = next(iter(resources.items())) + + manifest_xml = resources + return manifest_xml diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/winresource.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/winresource.py new file mode 100755 index 0000000..f21d66c --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/winresource.py @@ -0,0 +1,189 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Read and write resources from/to Win32 PE files. +""" + +import PyInstaller.log as logging +from PyInstaller.compat import pywintypes, win32api + +logger = logging.getLogger(__name__) + +LOAD_LIBRARY_AS_DATAFILE = 2 +ERROR_BAD_EXE_FORMAT = 193 +ERROR_RESOURCE_DATA_NOT_FOUND = 1812 +ERROR_RESOURCE_TYPE_NOT_FOUND = 1813 +ERROR_RESOURCE_NAME_NOT_FOUND = 1814 +ERROR_RESOURCE_LANG_NOT_FOUND = 1815 + + +def get_resources(filename, types=None, names=None, languages=None): + """ + Retrieve resources from the given PE file. + + filename: path to the PE file. + types: a list of resource types (integers or strings) to search for (None = all). + names: a list of resource names (integers or strings) to search for (None = all). + languages: a list of resource languages (integers) to search for (None = all). + + Returns a dictionary of the form {type: {name: {language: data}}}, which might also be empty if no matching + resources were found. + """ + types = set(types) if types is not None else {"*"} + names = set(names) if names is not None else {"*"} + languages = set(languages) if languages is not None else {"*"} + + output = {} + + # Errors codes for which we swallow exceptions + _IGNORE_EXCEPTIONS = { + ERROR_RESOURCE_DATA_NOT_FOUND, + ERROR_RESOURCE_TYPE_NOT_FOUND, + ERROR_RESOURCE_NAME_NOT_FOUND, + ERROR_RESOURCE_LANG_NOT_FOUND, + } + + # Open file + module_handle = win32api.LoadLibraryEx(filename, 0, LOAD_LIBRARY_AS_DATAFILE) + + # Enumerate available resource types + try: + available_types = win32api.EnumResourceTypes(module_handle) + except pywintypes.error as e: + if e.args[0] not in _IGNORE_EXCEPTIONS: + raise + available_types = [] + + if "*" not in types: + available_types = [res_type for res_type in available_types if res_type in types] + + for res_type in available_types: + # Enumerate available names for the resource type. + try: + available_names = win32api.EnumResourceNames(module_handle, res_type) + except pywintypes.error as e: + if e.args[0] not in _IGNORE_EXCEPTIONS: + raise + continue + + if "*" not in names: + available_names = [res_name for res_name in available_names if res_name in names] + + for res_name in available_names: + # Enumerate available languages for the resource type and name combination. + try: + available_languages = win32api.EnumResourceLanguages(module_handle, res_type, res_name) + except pywintypes.error as e: + if e.args[0] not in _IGNORE_EXCEPTIONS: + raise + continue + + if "*" not in languages: + available_languages = [res_lang for res_lang in available_languages if res_lang in languages] + + for res_lang in available_languages: + # Read data + try: + data = win32api.LoadResource(module_handle, res_type, res_name, res_lang) + except pywintypes.error as e: + if e.args[0] not in _IGNORE_EXCEPTIONS: + raise + continue + + if res_type not in output: + output[res_type] = {} + if res_name not in output[res_type]: + output[res_type][res_name] = {} + output[res_type][res_name][res_lang] = data + + # Close file + win32api.FreeLibrary(module_handle) + + return output + + +def add_or_update_resource(filename, data, res_type, names=None, languages=None): + """ + Update or add a single resource in the PE file with the given binary data. + + filename: path to the PE file. + data: binary data to write to the resource. + res_type: resource type to add/update (integer or string). + names: a list of resource names (integers or strings) to update (None = all). + languages: a list of resource languages (integers) to update (None = all). + """ + if res_type == "*": + raise ValueError("res_type cannot be a wildcard (*)!") + + names = set(names) if names is not None else {"*"} + languages = set(languages) if languages is not None else {"*"} + + # Retrieve existing resources, filtered by the given resource type and given resource names and languages. + resources = get_resources(filename, [res_type], names, languages) + + # Add res_type, name, language combinations that are not already present + resources = resources.get(res_type, {}) # This is now a {name: {language: data}} dictionary + + for res_name in names: + if res_name == "*": + continue + if res_name not in resources: + resources[res_name] = {} + + for res_lang in languages: + if res_lang == "*": + continue + if res_lang not in resources[res_name]: + resources[res_name][res_lang] = None # Just an indicator + + # Add resource to the target file, overwriting the existing resources with same type, name, language combinations. + module_handle = win32api.BeginUpdateResource(filename, 0) + for res_name in resources.keys(): + for res_lang in resources[res_name].keys(): + win32api.UpdateResource(module_handle, res_type, res_name, data, res_lang) + win32api.EndUpdateResource(module_handle, 0) + + +def copy_resources_from_pe_file(filename, src_filename, types=None, names=None, languages=None): + """ + Update or add resources in the given PE file by copying them over from the specified source PE file. + + filename: path to the PE file. + src_filename: path to the source PE file. + types: a list of resource types (integers or strings) to add/update via copy for (None = all). + names: a list of resource names (integers or strings) to add/update via copy (None = all). + languages: a list of resource languages (integers) to add/update via copy (None = all). + """ + types = set(types) if types is not None else {"*"} + names = set(names) if names is not None else {"*"} + languages = set(languages) if languages is not None else {"*"} + + # Retrieve existing resources, filtered by the given resource type and given resource names and languages. + resources = get_resources(src_filename, types, names, languages) + + for res_type, resources_for_type in resources.items(): + if "*" not in types and res_type not in types: + continue + for res_name, resources_for_type_name in resources_for_type.items(): + if "*" not in names and res_name not in names: + continue + for res_lang, data in resources_for_type_name.items(): + if "*" not in languages and res_lang not in languages: + continue + add_or_update_resource(filename, data, res_type, [res_name], [res_lang]) + + +def remove_all_resources(filename): + """ + Remove all resources from the given PE file: + """ + module_handle = win32api.BeginUpdateResource(filename, True) # bDeleteExistingResources=True + win32api.EndUpdateResource(module_handle, False) diff --git a/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/winutils.py b/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/winutils.py new file mode 100755 index 0000000..92cba77 --- /dev/null +++ b/venv/lib/python3.12/site-packages/PyInstaller/utils/win32/winutils.py @@ -0,0 +1,257 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2023, PyInstaller Development Team. +# +# Distributed under the terms of the GNU General Public License (version 2 +# or later) with exception for distributing the bootloader. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception) +#----------------------------------------------------------------------------- +""" +Utilities for Windows platform. +""" + +from PyInstaller import compat + + +def get_windows_dir(): + """ + Return the Windows directory, e.g., C:\\Windows. + """ + windir = compat.win32api.GetWindowsDirectory() + if not windir: + raise SystemExit("ERROR: Cannot determine Windows directory!") + return windir + + +def get_system_path(): + """ + Return the required Windows system paths. + """ + sys_dir = compat.win32api.GetSystemDirectory() + # Ensure C:\Windows\system32 and C:\Windows directories are always present in PATH variable. + # C:\Windows\system32 is valid even for 64-bit Windows. Access do DLLs are transparently redirected to + # C:\Windows\syswow64 for 64bit applactions. + # See http://msdn.microsoft.com/en-us/library/aa384187(v=vs.85).aspx + return [sys_dir, get_windows_dir()] + + +def get_pe_file_machine_type(filename): + """ + Return the machine type code from the header of the given PE file. + """ + import pefile + + with pefile.PE(filename, fast_load=True) as pe: + return pe.FILE_HEADER.Machine + + +def set_exe_build_timestamp(exe_path, timestamp): + """ + Modifies the executable's build timestamp by updating values in the corresponding PE headers. + """ + import pefile + + with pefile.PE(exe_path, fast_load=True) as pe: + # Manually perform a full load. We need it to load all headers, but specifying it in the constructor triggers + # byte statistics gathering that takes forever with large files. So we try to go around that... + pe.full_load() + + # Set build timestamp. + # See: https://0xc0decafe.com/malware-analyst-guide-to-pe-timestamps + timestamp = int(timestamp) + # Set timestamp field in FILE_HEADER + pe.FILE_HEADER.TimeDateStamp = timestamp + # MSVC-compiled executables contain (at least?) one DIRECTORY_ENTRY_DEBUG entry that also contains timestamp + # with same value as set in FILE_HEADER. So modify that as well, as long as it is set. + debug_entries = getattr(pe, 'DIRECTORY_ENTRY_DEBUG', []) + for debug_entry in debug_entries: + if debug_entry.struct.TimeDateStamp: + debug_entry.struct.TimeDateStamp = timestamp + + # Generate updated EXE data + data = pe.write() + + # Rewrite the exe + with open(exe_path, 'wb') as fp: + fp.write(data) + + +def update_exe_pe_checksum(exe_path): + """ + Compute the executable's PE checksum, and write it to PE headers. + + This optional checksum is supposed to protect the executable against corruption but some anti-viral software have + taken to flagging anything without it set correctly as malware. See issue #5579. + """ + import pefile + + # Compute checksum using our equivalent of the MapFileAndCheckSumW - for large files, it is significantly faster + # than pure-pyton pefile.PE.generate_checksum(). However, it requires the file to be on disk (i.e., cannot operate + # on a memory buffer). + try: + checksum = compute_exe_pe_checksum(exe_path) + except Exception as e: + raise RuntimeError("Failed to compute PE checksum!") from e + + # Update the checksum + with pefile.PE(exe_path, fast_load=True) as pe: + pe.OPTIONAL_HEADER.CheckSum = checksum + + # Generate updated EXE data + data = pe.write() + + # Rewrite the exe + with open(exe_path, 'wb') as fp: + fp.write(data) + + +def compute_exe_pe_checksum(exe_path): + """ + This is a replacement for the MapFileAndCheckSumW function. As noted in MSDN documentation, the Microsoft's + implementation of MapFileAndCheckSumW internally calls its ASCII variant (MapFileAndCheckSumA), and therefore + cannot handle paths that contain characters that are not representable in the current code page. + See: https://docs.microsoft.com/en-us/windows/win32/api/imagehlp/nf-imagehlp-mapfileandchecksumw + + This function is based on Wine's implementation of MapFileAndCheckSumW, and due to being based entirely on + the pure widechar-API functions, it is not limited by the current code page. + """ + # ctypes bindings for relevant win32 API functions + import ctypes + from ctypes import windll, wintypes + + INVALID_HANDLE = wintypes.HANDLE(-1).value + + GetLastError = ctypes.windll.kernel32.GetLastError + GetLastError.argtypes = () + GetLastError.restype = wintypes.DWORD + + CloseHandle = windll.kernel32.CloseHandle + CloseHandle.argtypes = ( + wintypes.HANDLE, # hObject + ) + CloseHandle.restype = wintypes.BOOL + + CreateFileW = windll.kernel32.CreateFileW + CreateFileW.argtypes = ( + wintypes.LPCWSTR, # lpFileName + wintypes.DWORD, # dwDesiredAccess + wintypes.DWORD, # dwShareMode + wintypes.LPVOID, # lpSecurityAttributes + wintypes.DWORD, # dwCreationDisposition + wintypes.DWORD, # dwFlagsAndAttributes + wintypes.HANDLE, # hTemplateFile + ) + CreateFileW.restype = wintypes.HANDLE + + CreateFileMappingW = windll.kernel32.CreateFileMappingW + CreateFileMappingW.argtypes = ( + wintypes.HANDLE, # hFile + wintypes.LPVOID, # lpSecurityAttributes + wintypes.DWORD, # flProtect + wintypes.DWORD, # dwMaximumSizeHigh + wintypes.DWORD, # dwMaximumSizeLow + wintypes.LPCWSTR, # lpName + ) + CreateFileMappingW.restype = wintypes.HANDLE + + MapViewOfFile = windll.kernel32.MapViewOfFile + MapViewOfFile.argtypes = ( + wintypes.HANDLE, # hFileMappingObject + wintypes.DWORD, # dwDesiredAccess + wintypes.DWORD, # dwFileOffsetHigh + wintypes.DWORD, # dwFileOffsetLow + wintypes.DWORD, # dwNumberOfBytesToMap + ) + MapViewOfFile.restype = wintypes.LPVOID + + UnmapViewOfFile = windll.kernel32.UnmapViewOfFile + UnmapViewOfFile.argtypes = ( + wintypes.LPCVOID, # lpBaseAddress + ) + UnmapViewOfFile.restype = wintypes.BOOL + + GetFileSizeEx = windll.kernel32.GetFileSizeEx + GetFileSizeEx.argtypes = ( + wintypes.HANDLE, # hFile + wintypes.PLARGE_INTEGER, # lpFileSize + ) + + CheckSumMappedFile = windll.imagehlp.CheckSumMappedFile + CheckSumMappedFile.argtypes = ( + wintypes.LPVOID, # BaseAddress + wintypes.DWORD, # FileLength + wintypes.PDWORD, # HeaderSum + wintypes.PDWORD, # CheckSum + ) + CheckSumMappedFile.restype = wintypes.LPVOID + + # Open file + hFile = CreateFileW( + ctypes.c_wchar_p(exe_path), + 0x80000000, # dwDesiredAccess = GENERIC_READ + 0x00000001 | 0x00000002, # dwShareMode = FILE_SHARE_READ | FILE_SHARE_WRITE, + None, # lpSecurityAttributes = NULL + 3, # dwCreationDisposition = OPEN_EXISTING + 0x80, # dwFlagsAndAttributes = FILE_ATTRIBUTE_NORMAL + None # hTemplateFile = NULL + ) + if hFile == INVALID_HANDLE: + err = GetLastError() + raise RuntimeError(f"Failed to open file {exe_path}! Error code: {err}") + + # Query file size + fileLength = wintypes.LARGE_INTEGER(0) + if GetFileSizeEx(hFile, fileLength) == 0: + err = GetLastError() + CloseHandle(hFile) + raise RuntimeError(f"Failed to query file size file! Error code: {err}") + fileLength = fileLength.value + if fileLength > (2**32 - 1): + raise RuntimeError("Executable size exceeds maximum allowed executable size on Windows (4 GiB)!") + + # Map the file + hMapping = CreateFileMappingW( + hFile, + None, # lpFileMappingAttributes = NULL + 0x02, # flProtect = PAGE_READONLY + 0, # dwMaximumSizeHigh = 0 + 0, # dwMaximumSizeLow = 0 + None # lpName = NULL + ) + if not hMapping: + err = GetLastError() + CloseHandle(hFile) + raise RuntimeError(f"Failed to map file! Error code: {err}") + + # Create map view + baseAddress = MapViewOfFile( + hMapping, + 4, # dwDesiredAccess = FILE_MAP_READ + 0, # dwFileOffsetHigh = 0 + 0, # dwFileOffsetLow = 0 + 0 # dwNumberOfBytesToMap = 0 + ) + if baseAddress == 0: + err = GetLastError() + CloseHandle(hMapping) + CloseHandle(hFile) + raise RuntimeError(f"Failed to create map view! Error code: {err}") + + # Finally, compute the checksum + headerSum = wintypes.DWORD(0) + checkSum = wintypes.DWORD(0) + ret = CheckSumMappedFile(baseAddress, fileLength, ctypes.byref(headerSum), ctypes.byref(checkSum)) + if ret is None: + err = GetLastError() + + # Cleanup + UnmapViewOfFile(baseAddress) + CloseHandle(hMapping) + CloseHandle(hFile) + + if ret is None: + raise RuntimeError(f"CheckSumMappedFile failed! Error code: {err}") + + return checkSum.value diff --git a/venv/lib/python3.12/site-packages/_distutils_hack/__init__.py b/venv/lib/python3.12/site-packages/_distutils_hack/__init__.py new file mode 100644 index 0000000..94f71b9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_distutils_hack/__init__.py @@ -0,0 +1,239 @@ +# don't import any costly modules +import os +import sys + +report_url = ( + "https://github.com/pypa/setuptools/issues/new?template=distutils-deprecation.yml" +) + + +def warn_distutils_present(): + if 'distutils' not in sys.modules: + return + import warnings + + warnings.warn( + "Distutils was imported before Setuptools, but importing Setuptools " + "also replaces the `distutils` module in `sys.modules`. This may lead " + "to undesirable behaviors or errors. To avoid these issues, avoid " + "using distutils directly, ensure that setuptools is installed in the " + "traditional way (e.g. not an editable install), and/or make sure " + "that setuptools is always imported before distutils." + ) + + +def clear_distutils(): + if 'distutils' not in sys.modules: + return + import warnings + + warnings.warn( + "Setuptools is replacing distutils. Support for replacing " + "an already imported distutils is deprecated. In the future, " + "this condition will fail. " + f"Register concerns at {report_url}" + ) + mods = [ + name + for name in sys.modules + if name == "distutils" or name.startswith("distutils.") + ] + for name in mods: + del sys.modules[name] + + +def enabled(): + """ + Allow selection of distutils by environment variable. + """ + which = os.environ.get('SETUPTOOLS_USE_DISTUTILS', 'local') + if which == 'stdlib': + import warnings + + warnings.warn( + "Reliance on distutils from stdlib is deprecated. Users " + "must rely on setuptools to provide the distutils module. " + "Avoid importing distutils or import setuptools first, " + "and avoid setting SETUPTOOLS_USE_DISTUTILS=stdlib. " + f"Register concerns at {report_url}" + ) + return which == 'local' + + +def ensure_local_distutils(): + import importlib + + clear_distutils() + + # With the DistutilsMetaFinder in place, + # perform an import to cause distutils to be + # loaded from setuptools._distutils. Ref #2906. + with shim(): + importlib.import_module('distutils') + + # check that submodules load as expected + core = importlib.import_module('distutils.core') + assert '_distutils' in core.__file__, core.__file__ + assert 'setuptools._distutils.log' not in sys.modules + + +def do_override(): + """ + Ensure that the local copy of distutils is preferred over stdlib. + + See https://github.com/pypa/setuptools/issues/417#issuecomment-392298401 + for more motivation. + """ + if enabled(): + warn_distutils_present() + ensure_local_distutils() + + +class _TrivialRe: + def __init__(self, *patterns) -> None: + self._patterns = patterns + + def match(self, string): + return all(pat in string for pat in self._patterns) + + +class DistutilsMetaFinder: + def find_spec(self, fullname, path, target=None): + # optimization: only consider top level modules and those + # found in the CPython test suite. + if path is not None and not fullname.startswith('test.'): + return None + + method_name = 'spec_for_{fullname}'.format(**locals()) + method = getattr(self, method_name, lambda: None) + return method() + + def spec_for_distutils(self): + if self.is_cpython(): + return None + + import importlib + import importlib.abc + import importlib.util + + try: + mod = importlib.import_module('setuptools._distutils') + except Exception: + # There are a couple of cases where setuptools._distutils + # may not be present: + # - An older Setuptools without a local distutils is + # taking precedence. Ref #2957. + # - Path manipulation during sitecustomize removes + # setuptools from the path but only after the hook + # has been loaded. Ref #2980. + # In either case, fall back to stdlib behavior. + return None + + class DistutilsLoader(importlib.abc.Loader): + def create_module(self, spec): + mod.__name__ = 'distutils' + return mod + + def exec_module(self, module): + pass + + return importlib.util.spec_from_loader( + 'distutils', DistutilsLoader(), origin=mod.__file__ + ) + + @staticmethod + def is_cpython(): + """ + Suppress supplying distutils for CPython (build and tests). + Ref #2965 and #3007. + """ + return os.path.isfile('pybuilddir.txt') + + def spec_for_pip(self): + """ + Ensure stdlib distutils when running under pip. + See pypa/pip#8761 for rationale. + """ + if sys.version_info >= (3, 12) or self.pip_imported_during_build(): + return + clear_distutils() + self.spec_for_distutils = lambda: None + + @classmethod + def pip_imported_during_build(cls): + """ + Detect if pip is being imported in a build script. Ref #2355. + """ + import traceback + + return any( + cls.frame_file_is_setup(frame) for frame, line in traceback.walk_stack(None) + ) + + @staticmethod + def frame_file_is_setup(frame): + """ + Return True if the indicated frame suggests a setup.py file. + """ + # some frames may not have __file__ (#2940) + return frame.f_globals.get('__file__', '').endswith('setup.py') + + def spec_for_sensitive_tests(self): + """ + Ensure stdlib distutils when running select tests under CPython. + + python/cpython#91169 + """ + clear_distutils() + self.spec_for_distutils = lambda: None + + sensitive_tests = ( + [ + 'test.test_distutils', + 'test.test_peg_generator', + 'test.test_importlib', + ] + if sys.version_info < (3, 10) + else [ + 'test.test_distutils', + ] + ) + + +for name in DistutilsMetaFinder.sensitive_tests: + setattr( + DistutilsMetaFinder, + f'spec_for_{name}', + DistutilsMetaFinder.spec_for_sensitive_tests, + ) + + +DISTUTILS_FINDER = DistutilsMetaFinder() + + +def add_shim(): + DISTUTILS_FINDER in sys.meta_path or insert_shim() + + +class shim: + def __enter__(self) -> None: + insert_shim() + + def __exit__(self, exc: object, value: object, tb: object) -> None: + _remove_shim() + + +def insert_shim(): + sys.meta_path.insert(0, DISTUTILS_FINDER) + + +def _remove_shim(): + try: + sys.meta_path.remove(DISTUTILS_FINDER) + except ValueError: + pass + + +if sys.version_info < (3, 12): + # DistutilsMetaFinder can only be disabled in Python < 3.12 (PEP 632) + remove_shim = _remove_shim diff --git a/venv/lib/python3.12/site-packages/_distutils_hack/override.py b/venv/lib/python3.12/site-packages/_distutils_hack/override.py new file mode 100644 index 0000000..2cc433a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_distutils_hack/override.py @@ -0,0 +1 @@ +__import__('_distutils_hack').do_override() diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/__init__.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/__init__.py new file mode 100644 index 0000000..02ab934 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/__init__.py @@ -0,0 +1,47 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import sys + +__version__ = '2025.10' +__maintainer__ = 'Legorooj, bwoodsend' +__uri__ = 'https://github.com/pyinstaller/pyinstaller-hooks-contrib' + + +def get_hook_dirs(): + import os + hooks_dir = os.path.dirname(__file__) + return [ + # Required because standard hooks are in sub-directory instead of the top-level hooks directory. + os.path.join(hooks_dir, 'stdhooks'), + # pre_* and run-time hooks + hooks_dir, + ] + + +# Several packages for which provide hooks are involved in deep dependency chains when various optional dependencies are +# installed in the environment, and their analysis typically requires recursion limit that exceeds the default 1000. +# Therefore, automatically raise the recursion limit to at least 5000. This alleviates the need to do so on per-hook +# basis. +if (sys.platform.startswith('win') or sys.platform == 'cygwin') and sys.version_info < (3, 11): + # The recursion limit test in PyInstaller main repository seems to push the recursion level to the limit; and if the + # limit is set to 5000, this crashes python 3.8 - 3.10 on Windows and 3.9 that is (at the time of writing) available + # under Cygwin. Further investigation revealed that Windows builds of python 3.8 and 3.10 handle recursion up to + # level ~2075, while the practical limit for 3.9 is between 1950 and 1975. Therefore, for affected combinations of + # platforms and python versions, use a conservative limit of 1900 - if only to avoid issues with the recursion limit + # test in the main PyInstaller repository... + new_recursion_limit = 1900 +else: + new_recursion_limit = 5000 + +if sys.getrecursionlimit() < new_recursion_limit: + sys.setrecursionlimit(new_recursion_limit) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/compat.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/compat.py new file mode 100644 index 0000000..4acba2f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/compat.py @@ -0,0 +1,42 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import sys + +from PyInstaller.utils.hooks import is_module_satisfies + + +if is_module_satisfies("PyInstaller >= 6.0"): + # PyInstaller >= 6.0 imports importlib_metadata in its compat module + from PyInstaller.compat import importlib_metadata +else: + # Older PyInstaller version - duplicate logic from PyInstaller 6.0 + class ImportlibMetadataError(SystemExit): + def __init__(self): + super().__init__( + "pyinstaller-hooks-contrib requires importlib.metadata from python >= 3.10 stdlib or " + "importlib_metadata from importlib-metadata >= 4.6" + ) + + if sys.version_info >= (3, 10): + import importlib.metadata as importlib_metadata + else: + try: + import importlib_metadata + except ImportError as e: + raise ImportlibMetadataError() from e + + import packaging.version # For importlib_metadata version check + + # Validate the version + if packaging.version.parse(importlib_metadata.version("importlib-metadata")) < packaging.version.parse("4.6"): + raise ImportlibMetadataError() diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/pre_find_module_path/__init__.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/pre_find_module_path/__init__.py new file mode 100644 index 0000000..89c0c0f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/pre_find_module_path/__init__.py @@ -0,0 +1,11 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/pre_safe_import_module/__init__.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/pre_safe_import_module/__init__.py new file mode 100644 index 0000000..89c0c0f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/pre_safe_import_module/__init__.py @@ -0,0 +1,11 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/pre_safe_import_module/hook-tensorflow.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/pre_safe_import_module/hook-tensorflow.py new file mode 100644 index 0000000..0d135b6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/pre_safe_import_module/hook-tensorflow.py @@ -0,0 +1,28 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2022, PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import is_module_satisfies + + +def pre_safe_import_module(api): + # As of tensorflow 2.8.0, the `tensorflow.keras` is entirely gone, replaced by a lazy-loaded alias for + # `keras.api._v2.keras`. Without us registering the alias here, a program that imports only from + # `tensorflow.keras` fails to collect `tensorflow`. + # See: https://github.com/pyinstaller/pyinstaller/discussions/6890 + # The alias was already present in earlier releases, but it does not seem to be causing problems there, + # so keep this specific to tensorflow >= 2.8.0 to avoid accidentally breaking something else. + # + # Starting with tensorflow 2.16.0, the alias points to `keras._tf_keras.keras`. + if is_module_satisfies("tensorflow >= 2.16.0"): + api.add_alias_module('keras._tf_keras.keras', 'tensorflow.keras') + elif is_module_satisfies("tensorflow >= 2.8.0"): + api.add_alias_module('keras.api._v2.keras', 'tensorflow.keras') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/pre_safe_import_module/hook-win32com.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/pre_safe_import_module/hook-win32com.py new file mode 100644 index 0000000..afb61f7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/pre_safe_import_module/hook-win32com.py @@ -0,0 +1,46 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2020, PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +#----------------------------------------------------------------------------- +""" +PyWin32 package 'win32com' extends it's __path__ attribute with win32comext +directory and thus PyInstaller is not able to find modules in it. For example +module 'win32com.shell' is in reality 'win32comext.shell'. + +>>> win32com.__path__ +['win32com', 'C:\\Python27\\Lib\\site-packages\\win32comext'] + +""" + +import os + +from PyInstaller.utils.hooks import logger, exec_statement +from PyInstaller.compat import is_win, is_cygwin + + +def pre_safe_import_module(api): + if not (is_win or is_cygwin): + return + win32com_file = exec_statement( + """ + try: + from win32com import __file__ + print(__file__) + except Exception: + pass + """).strip() + if not win32com_file: + logger.debug('win32com: module not available') + return # win32com unavailable + win32com_dir = os.path.dirname(win32com_file) + comext_dir = os.path.join(os.path.dirname(win32com_dir), 'win32comext') + logger.debug('win32com: extending __path__ with dir %r' % comext_dir) + # Append the __path__ where PyInstaller will look for 'win32com' modules.' + api.append_package_path(comext_dir) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks.dat b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks.dat new file mode 100644 index 0000000..f868f56 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks.dat @@ -0,0 +1,16 @@ +{ + 'cryptography': ['pyi_rth_cryptography_openssl.py'], + 'enchant': ['pyi_rth_enchant.py'], + 'findlibs': ['pyi_rth_findlibs.py'], + 'ffpyplayer': ['pyi_rth_ffpyplayer.py'], + 'osgeo': ['pyi_rth_osgeo.py'], + 'traitlets': ['pyi_rth_traitlets.py'], + 'usb': ['pyi_rth_usb.py'], + 'nltk': ['pyi_rth_nltk.py'], + 'pyproj': ['pyi_rth_pyproj.py'], + 'pygraphviz': ['pyi_rth_pygraphviz.py'], + 'pythoncom': ['pyi_rth_pythoncom.py'], + 'pyqtgraph': ['pyi_rth_pyqtgraph_multiprocess.py'], + 'pywintypes': ['pyi_rth_pywintypes.py'], + 'tensorflow': ['pyi_rth_tensorflow.py'], +} diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/__init__.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/__init__.py new file mode 100644 index 0000000..30d22ed --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/__init__.py @@ -0,0 +1,10 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +# ------------------------------------------------------------------ diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_cryptography_openssl.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_cryptography_openssl.py new file mode 100644 index 0000000..dbabe69 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_cryptography_openssl.py @@ -0,0 +1,20 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +import os +import sys + +# If we collected OpenSSL modules into `ossl-modules` directory, override the OpenSSL search path by setting the +# `OPENSSL_MODULES` environment variable. +_ossl_modules_dir = os.path.join(sys._MEIPASS, 'ossl-modules') +if os.path.isdir(_ossl_modules_dir): + os.environ['OPENSSL_MODULES'] = _ossl_modules_dir +del _ossl_modules_dir diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_enchant.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_enchant.py new file mode 100644 index 0000000..36c185d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_enchant.py @@ -0,0 +1,22 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2020, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +import os +import sys + +# On Mac OS X tell enchant library where to look for enchant backends (aspell, myspell, ...). +# Enchant is looking for backends in directory 'PREFIX/lib/enchant' +# Note: env. var. ENCHANT_PREFIX_DIR is implemented only in the development version: +# https://github.com/AbiWord/enchant +# https://github.com/AbiWord/enchant/pull/2 +# TODO Test this rthook. +if sys.platform.startswith('darwin'): + os.environ['ENCHANT_PREFIX_DIR'] = os.path.join(sys._MEIPASS, 'enchant') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_ffpyplayer.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_ffpyplayer.py new file mode 100644 index 0000000..6a024de --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_ffpyplayer.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2023, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# Starting with v4.3.5, the `ffpyplayer` package attempts to use `site.USER_BASE` in path manipulation functions. +# As frozen application runs with disabled `site`, the value of this variable is `None`, and causes path manipulation +# functions to raise an error. As a work-around, we set `site.USER_BASE` to an empty string, which is also what the +# fake `site` module available in PyInstaller prior to v5.5 did. +import site + +if site.USER_BASE is None: + site.USER_BASE = '' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_findlibs.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_findlibs.py new file mode 100644 index 0000000..48e4ddd --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_findlibs.py @@ -0,0 +1,58 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2024, PyInstaller Development Team. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# +# The full license is in the file COPYING.txt, distributed with this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# Override the findlibs.find() function to give precedence to sys._MEIPASS, followed by `ctypes.util.find_library`, +# and only then the hard-coded paths from the original implementation. The main aim here is to avoid loading libraries +# from Homebrew environment on macOS when it happens to be present at run-time and we have a bundled copy collected from +# the build system. This happens because we (try not to) modify `DYLD_LIBRARY_PATH`, and the original `findlibs.find()` +# implementation gives precedence to environment variables and several fixed/hard-coded locations, and uses +# `ctypes.util.find_library` as the final fallback... +def _pyi_rthook(): + import sys + import os + import ctypes.util + + # findlibs v0.1.0 broke compatibility with python < 3.10; due to incompatible typing annotation, attempting to + # import the package raises `TypeError: unsupported operand type(s) for |: 'type' and 'NoneType'`. Gracefully + # handle this situation by making this run-time hook no-op, in order to avoid crashing the frozen program even + # if it would never end up importing/using `findlibs`. + try: + import findlibs + except TypeError: + return + + _orig_find = getattr(findlibs, 'find', None) + + def _pyi_find(lib_name, *args, **kwargs): + extension = findlibs.EXTENSIONS.get(sys.platform, ".so") + + # First check sys._MEIPASS + fullname = os.path.join(sys._MEIPASS, "lib{}{}".format(lib_name, extension)) + if os.path.isfile(fullname): + return fullname + + # Fall back to `ctypes.util.find_library` (to give it precedence over hard-coded paths from original + # implementation). + lib = ctypes.util.find_library(lib_name) + if lib is not None: + return lib + + # Finally, fall back to original implementation + if _orig_find is not None: + return _orig_find(lib_name, *args, **kwargs) + + return None + + findlibs.find = _pyi_find + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_nltk.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_nltk.py new file mode 100644 index 0000000..feb9eb7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_nltk.py @@ -0,0 +1,17 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2020, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +import sys +import os +import nltk + +#add the path to nltk_data +nltk.data.path.insert(0, os.path.join(sys._MEIPASS, "nltk_data")) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_osgeo.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_osgeo.py new file mode 100644 index 0000000..7b31027 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_osgeo.py @@ -0,0 +1,32 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2020, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +import os +import sys + +# Installing `osgeo` Conda packages requires to set `GDAL_DATA` + +is_win = sys.platform.startswith('win') +if is_win: + + gdal_data = os.path.join(sys._MEIPASS, 'data', 'gdal') + if not os.path.exists(gdal_data): + + gdal_data = os.path.join(sys._MEIPASS, 'Library', 'share', 'gdal') + # last attempt, check if one of the required file is in the generic folder Library/data + if not os.path.exists(os.path.join(gdal_data, 'gcs.csv')): + gdal_data = os.path.join(sys._MEIPASS, 'Library', 'data') + +else: + gdal_data = os.path.join(sys._MEIPASS, 'share', 'gdal') + +if os.path.exists(gdal_data): + os.environ['GDAL_DATA'] = gdal_data diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pygraphviz.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pygraphviz.py new file mode 100644 index 0000000..cfae2b3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pygraphviz.py @@ -0,0 +1,32 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2021, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +import pygraphviz + +# Override pygraphviz.AGraph._which method to search for graphviz executables inside sys._MEIPASS +if hasattr(pygraphviz.AGraph, '_which'): + + def _pygraphviz_override_which(self, name): + import os + import sys + import platform + + program_name = name + if platform.system() == "Windows": + program_name += ".exe" + + program_path = os.path.join(sys._MEIPASS, program_name) + if not os.path.isfile(program_path): + raise ValueError(f"Prog {name} not found in the PyInstaller-frozen application bundle!") + + return program_path + + pygraphviz.AGraph._which = _pygraphviz_override_which diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pyproj.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pyproj.py new file mode 100644 index 0000000..b78b70b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pyproj.py @@ -0,0 +1,26 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2015-2020, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +import os +import sys + +# Installing `pyproj` Conda packages requires to set `PROJ_LIB` + +is_win = sys.platform.startswith('win') +if is_win: + + proj_data = os.path.join(sys._MEIPASS, 'Library', 'share', 'proj') + +else: + proj_data = os.path.join(sys._MEIPASS, 'share', 'proj') + +if os.path.exists(proj_data): + os.environ['PROJ_LIB'] = proj_data diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pyqtgraph_multiprocess.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pyqtgraph_multiprocess.py new file mode 100644 index 0000000..06a012b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pyqtgraph_multiprocess.py @@ -0,0 +1,52 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2022, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +import sys +import os + + +def _setup_pyqtgraph_multiprocess_hook(): + # NOTE: pyqtgraph.multiprocess spawns the sub-process using subprocess.Popen (or equivalent). This means that in + # onefile builds, the executable in subprocess will unpack itself again, into different sys._MEIPASS, because + # the _MEIPASS2 environment variable is not set (bootloader / bootstrap script cleans it up). This will make the + # argv[1] check below fail, due to different sys._MEIPASS value in the subprocess. + # + # To work around this, at the time of writing (PyInstaller 5.5), the user needs to set _MEIPASS2 environment + # variable to sys._MEIPASS before using `pyqtgraph.multiprocess` in onefile builds. And stlib's + # `multiprocessing.freeze_support` needs to be called in the entry-point program, due to `pyqtgraph.multiprocess` + # internally using stdlib's `multiprocessing` primitives. + if len(sys.argv) == 2 and sys.argv[1] == os.path.join(sys._MEIPASS, 'pyqtgraph', 'multiprocess', 'bootstrap.py'): + # Load as module; this requires --hiddenimport pyqtgraph.multiprocess.bootstrap + try: + import importlib.util + spec = importlib.util.find_spec("pyqtgraph.multiprocess.bootstrap") + bootstrap_co = spec.loader.get_code("pyqtgraph.multiprocess.bootstrap") + except Exception: + bootstrap_co = None + + if bootstrap_co: + exec(bootstrap_co) + sys.exit(0) + + # Load from file; requires pyqtgraph/multiprocess/bootstrap.py collected as data file + # This is obsolete for PyInstaller >= v6.10.0 + bootstrap_file = os.path.join(sys._MEIPASS, 'pyqtgraph', 'multiprocess', 'bootstrap.py') + if os.path.isfile(bootstrap_file): + with open(bootstrap_file, 'r') as fp: + bootstrap_code = fp.read() + exec(bootstrap_code) + sys.exit(0) + + raise RuntimeError("Could not find pyqtgraph.multiprocess bootstrap code or script!") + + +_setup_pyqtgraph_multiprocess_hook() +del _setup_pyqtgraph_multiprocess_hook diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pythoncom.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pythoncom.py new file mode 100644 index 0000000..4f11fb8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pythoncom.py @@ -0,0 +1,24 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2022, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# Unfortunately, __import_pywin32_system_module__ from pywintypes module assumes that in a frozen application, the +# pythoncom3X.dll and pywintypes3X.dll that are normally found in site-packages/pywin32_system32, are located +# directly in the sys.path, without bothering to check first if they are actually available in the standard location. +# This obviously runs afoul of our attempts at preserving the directory layout and placing them in the pywin32_system32 +# sub-directory instead of the top-level application directory. So as a work-around, add the sub-directory to sys.path +# to keep pywintypes happy... +import sys +import os + +pywin32_system32_path = os.path.join(sys._MEIPASS, 'pywin32_system32') +if os.path.isdir(pywin32_system32_path) and pywin32_system32_path not in sys.path: + sys.path.append(pywin32_system32_path) +del pywin32_system32_path diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pywintypes.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pywintypes.py new file mode 100644 index 0000000..4f11fb8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_pywintypes.py @@ -0,0 +1,24 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2022, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# Unfortunately, __import_pywin32_system_module__ from pywintypes module assumes that in a frozen application, the +# pythoncom3X.dll and pywintypes3X.dll that are normally found in site-packages/pywin32_system32, are located +# directly in the sys.path, without bothering to check first if they are actually available in the standard location. +# This obviously runs afoul of our attempts at preserving the directory layout and placing them in the pywin32_system32 +# sub-directory instead of the top-level application directory. So as a work-around, add the sub-directory to sys.path +# to keep pywintypes happy... +import sys +import os + +pywin32_system32_path = os.path.join(sys._MEIPASS, 'pywin32_system32') +if os.path.isdir(pywin32_system32_path) and pywin32_system32_path not in sys.path: + sys.path.append(pywin32_system32_path) +del pywin32_system32_path diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_tensorflow.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_tensorflow.py new file mode 100644 index 0000000..747ea45 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_tensorflow.py @@ -0,0 +1,53 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2023, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +def _pyi_rthook(): + import sys + + # `tensorflow` versions prior to 2.3.0 attempt to use `site.USER_SITE` in path/string manipulation functions. + # As frozen application runs with disabled `site`, the value of this variable is `None`, and causes path/string + # manipulation functions to raise an error. As a work-around, we set `site.USER_SITE` to an empty string, which is + # also what the fake `site` module available in PyInstaller prior to v5.5 did. + import site + + if site.USER_SITE is None: + site.USER_SITE = '' + + # The issue described about with site.USER_SITE being None has largely been resolved in contemporary `tensorflow` + # versions, which now check that `site.ENABLE_USER_SITE` is set and that `site.USER_SITE` is not None before + # trying to use it. + # + # However, `tensorflow` will attempt to search and load its plugins only if it believes that it is running from + # "a pip-based installation" - if the package's location is rooted in one of the "site-packages" directories. See + # https://github.com/tensorflow/tensorflow/blob/6887368d6d46223f460358323c4b76d61d1558a8/tensorflow/api_template.__init__.py#L110C76-L156 + # Unfortunately, they "cleverly" infer the module's location via `inspect.getfile(inspect.currentframe())`, which + # in the frozen application returns anonymized relative source file name (`tensorflow/__init__.py`) - so we need one + # of the "site directories" to be just "tensorflow" (to fool the `_running_from_pip_package()` check), and we also + # need `sys._MEIPASS` to be among them (to load the plugins from the actual `sys._MEIPASS/tensorflow-plugins`). + # Therefore, we monkey-patch `site.getsitepackages` to add those two entries to the list of "site directories". + + _orig_getsitepackages = getattr(site, 'getsitepackages', None) + + def _pyi_getsitepackages(): + return [ + sys._MEIPASS, + "tensorflow", + *(_orig_getsitepackages() if _orig_getsitepackages is not None else []), + ] + + site.getsitepackages = _pyi_getsitepackages + + # NOTE: instead of the above override, we could also set TF_PLUGGABLE_DEVICE_LIBRARY_PATH, but that works only + # for tensorflow >= 2.12. + + +_pyi_rthook() +del _pyi_rthook diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_traitlets.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_traitlets.py new file mode 100644 index 0000000..5ec3a9f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_traitlets.py @@ -0,0 +1,25 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2020, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + +# 'traitlets' uses module 'inspect' from default Python library to inspect +# source code of modules. However, frozen app does not contain source code +# of Python modules. +# +# hook-IPython depends on module 'traitlets'. + +import traitlets.traitlets + + +def _disabled_deprecation_warnings(method, cls, method_name, msg): + pass + + +traitlets.traitlets._deprecated_method = _disabled_deprecation_warnings diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_usb.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_usb.py new file mode 100644 index 0000000..b64624d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/rthooks/pyi_rth_usb.py @@ -0,0 +1,85 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2013-2020, PyInstaller Development Team. +# +# This file is distributed under the terms of the Apache License 2.0 +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: Apache-2.0 +#----------------------------------------------------------------------------- + + +import ctypes +import glob +import os +import sys +# Pyusb changed these libusb module names in commit 2082e7. +try: + import usb.backend.libusb10 as libusb10 +except ImportError: + import usb.backend.libusb1 as libusb10 +try: + import usb.backend.libusb01 as libusb01 +except ImportError: + import usb.backend.libusb0 as libusb01 +import usb.backend.openusb as openusb + + +def get_load_func(type, candidates): + + def _load_library(find_library=None): + exec_path = sys._MEIPASS + + library = None + for candidate in candidates: + + # Find a list of library files that match 'candidate'. + if find_library: + # Caller provides a function that lookup lib path by candidate name. + lib_path = find_library(candidate) + libs = [lib_path] if lib_path else [] + else: + # No find_library callback function, we look at the default location. + if os.name == 'posix' and sys.platform == 'darwin': + libs = glob.glob("%s/%s*.dylib*" % (exec_path, candidate)) + elif sys.platform == 'win32' or sys.platform == 'cygwin': + libs = glob.glob("%s\\%s*.dll" % (exec_path, candidate)) + else: + libs = glob.glob("%s/%s*.so*" % (exec_path, candidate)) + + # Do linker's path lookup work to force load bundled copy. + for libname in libs: + try: + # NOTE: libusb01 is using CDLL under win32. + # (see usb.backends.libusb01) + if sys.platform == 'win32' and type != 'libusb01': + library = ctypes.WinDLL(libname) + else: + library = ctypes.CDLL(libname) + if library is not None: + break + except OSError: + library = None + if library is not None: + break + else: + raise OSError('USB library could not be found') + + if type == 'libusb10': + if not hasattr(library, 'libusb_init'): + raise OSError('USB library could not be found') + return library + + return _load_library + + +# NOTE: Need to keep in sync with future PyUSB updates. +if sys.platform == 'cygwin': + libusb10._load_library = get_load_func('libusb10', ('cygusb-1.0', )) + libusb01._load_library = get_load_func('libusb01', ('cygusb0', )) + openusb._load_library = get_load_func('openusb', ('openusb', )) +else: + libusb10._load_library = get_load_func('libusb10', ('usb-1.0', 'libusb-1.0', 'usb')) + libusb01._load_library = get_load_func('libusb01', ('usb-0.1', 'usb', 'libusb0', 'libusb')) + openusb._load_library = get_load_func('openusb', ('openusb', )) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/__init__.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/__init__.py new file mode 100644 index 0000000..89c0c0f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/__init__.py @@ -0,0 +1,11 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-BTrees.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-BTrees.py new file mode 100644 index 0000000..1213dfd --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-BTrees.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for BTrees: https://pypi.org/project/BTrees/4.5.1/ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('BTrees') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-CTkMessagebox.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-CTkMessagebox.py new file mode 100644 index 0000000..dd43aad --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-CTkMessagebox.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# A fully customizable messagebox for customtkinter! +# (extension/add-on) +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("CTkMessagebox") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-Crypto.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-Crypto.py new file mode 100644 index 0000000..a52de53 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-Crypto.py @@ -0,0 +1,62 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for PyCryptodome library: https://pypi.python.org/pypi/pycryptodome + +PyCryptodome is an almost drop-in replacement for the now unmaintained +PyCrypto library. The two are mutually exclusive as they live under +the same package ("Crypto"). + +PyCryptodome distributes dynamic libraries and builds them as if they were +Python C extensions (even though they are not extensions - as they can't be +imported by Python). It might sound a bit weird, but this decision is rooted +in PyPy and its partial and slow support for C extensions. However, this also +invalidates several of the existing methods used by PyInstaller to decide the +right files to pull in. + +Even though this hook is meant to help with PyCryptodome only, it will be +triggered also when PyCrypto is installed, so it must be tested with both. + +Tested with PyCryptodome 3.5.1, PyCrypto 2.6.1, Python 2.7 & 3.6, Fedora & Windows +""" + +import os +import glob + +from PyInstaller.compat import EXTENSION_SUFFIXES +from PyInstaller.utils.hooks import get_module_file_attribute + +# Include the modules as binaries in a subfolder named like the package. +# Cryptodome's loader expects to find them inside the package directory for +# the main module. We cannot use hiddenimports because that would add the +# modules outside the package. + +binaries = [] +binary_module_names = [ + 'Crypto.Math', # First in the list + 'Crypto.Cipher', + 'Crypto.Util', + 'Crypto.Hash', + 'Crypto.Protocol', + 'Crypto.PublicKey', +] + +try: + for module_name in binary_module_names: + m_dir = os.path.dirname(get_module_file_attribute(module_name)) + for ext in EXTENSION_SUFFIXES: + module_bin = glob.glob(os.path.join(m_dir, '_*%s' % ext)) + for f in module_bin: + binaries.append((f, module_name.replace('.', os.sep))) +except ImportError: + # Do nothing for PyCrypto (Crypto.Math does not exist there) + pass diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-Cryptodome.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-Cryptodome.py new file mode 100644 index 0000000..3a88482 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-Cryptodome.py @@ -0,0 +1,44 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for Cryptodome module: https://pypi.python.org/pypi/pycryptodomex + +Tested with Cryptodomex 3.4.2, Python 2.7 & 3.5, Windows +""" + +import os +import glob + +from PyInstaller.compat import EXTENSION_SUFFIXES +from PyInstaller.utils.hooks import get_module_file_attribute + +# Include the modules as binaries in a subfolder named like the package. +# Cryptodome's loader expects to find them inside the package directory for +# the main module. We cannot use hiddenimports because that would add the +# modules outside the package. + +binaries = [] +binary_module_names = [ + 'Cryptodome.Cipher', + 'Cryptodome.Util', + 'Cryptodome.Hash', + 'Cryptodome.Protocol', + 'Cryptodome.Math', + 'Cryptodome.PublicKey', +] + +for module_name in binary_module_names: + m_dir = os.path.dirname(get_module_file_attribute(module_name)) + for ext in EXTENSION_SUFFIXES: + module_bin = glob.glob(os.path.join(m_dir, '_*%s' % ext)) + for f in module_bin: + binaries.append((f, module_name.replace('.', '/'))) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-HtmlTestRunner.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-HtmlTestRunner.py new file mode 100644 index 0000000..56abec9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-HtmlTestRunner.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for HtmlTestRunner: https://pypi.org/project/html-testRunner//1.2.1 + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('HtmlTestRunner') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-IPython.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-IPython.py new file mode 100644 index 0000000..8fec50b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-IPython.py @@ -0,0 +1,42 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Tested with IPython 4.0.0. + +from PyInstaller.compat import is_win, is_darwin +from PyInstaller.utils.hooks import collect_data_files + +# Ignore 'matplotlib'. IPython contains support for matplotlib. +# Ignore GUI libraries. IPython supports integration with GUI frameworks. +# Assume that it will be imported by any other module when the user really +# uses it. +excludedimports = [ + 'gtk', + 'matplotlib', + 'PySide', + 'PyQt4', + 'PySide2', + 'PyQt5', + 'PySide6', + 'PyQt6', +] + +# IPython uses 'tkinter' for clipboard access on Linux/Unix. Exclude it on Windows and OS X. +if is_win or is_darwin: + excludedimports.append('tkinter') + +datas = collect_data_files('IPython') + +# IPython imports extensions by changing to the extensions directory and using +# importlib.import_module, so we need to copy over the extensions as if they +# were data files. +datas += collect_data_files('IPython.extensions', include_py_files=True) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-OpenGL.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-OpenGL.py new file mode 100644 index 0000000..f959702 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-OpenGL.py @@ -0,0 +1,65 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for PyOpenGL 3.x versions from 3.0.0b6 up. Previous versions have a +plugin system based on pkg_resources which is problematic to handle correctly +under pyinstaller; 2.x versions used to run fine without hooks, so this one +shouldn't hurt. +""" + +from PyInstaller.compat import is_win, is_darwin +from PyInstaller.utils.hooks import collect_data_files, exec_statement +import os +import glob + + +def opengl_arrays_modules(): + """ + Return list of array modules for OpenGL module. + e.g. 'OpenGL.arrays.vbo' + """ + statement = 'import OpenGL; print(OpenGL.__path__[0])' + opengl_mod_path = exec_statement(statement) + arrays_mod_path = os.path.join(opengl_mod_path, 'arrays') + files = glob.glob(arrays_mod_path + '/*.py') + modules = [] + + for f in files: + mod = os.path.splitext(os.path.basename(f))[0] + # Skip __init__ module. + if mod == '__init__': + continue + modules.append('OpenGL.arrays.' + mod) + + return modules + + +# PlatformPlugin performs a conditional import based on os.name and +# sys.platform. PyInstaller misses this so let's add it ourselves... +if is_win: + hiddenimports = ['OpenGL.platform.win32'] +elif is_darwin: + hiddenimports = ['OpenGL.platform.darwin'] +# Use glx for other platforms (Linux, ...) +else: + hiddenimports = ['OpenGL.platform.glx'] + +# Arrays modules are needed too. +hiddenimports += opengl_arrays_modules() + +# PyOpenGL 3.x uses ctypes to load DLL libraries. PyOpenGL windows installer +# adds necessary dll files to +# DLL_DIRECTORY = os.path.join( os.path.dirname( OpenGL.__file__ ), 'DLLS') +# PyInstaller is not able to find these dlls. Just include them all as data +# files. +if is_win: + datas = collect_data_files('OpenGL') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-OpenGL_accelerate.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-OpenGL_accelerate.py new file mode 100644 index 0000000..5d6998b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-OpenGL_accelerate.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +OpenGL_accelerate contais modules written in cython. This module +should speed up some functions from OpenGL module. The following +hiddenimports are not resolved by PyInstaller because OpenGL_accelerate +is compiled to native Python modules. +""" + +hiddenimports = [ + 'OpenGL_accelerate.wrapper', + 'OpenGL_accelerate.formathandler', +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-PyTaskbar.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-PyTaskbar.py new file mode 100644 index 0000000..55a82a1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-PyTaskbar.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("PyTaskbar") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-Xlib.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-Xlib.py new file mode 100644 index 0000000..8ce588e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-Xlib.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('Xlib') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-_mssql.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-_mssql.py new file mode 100644 index 0000000..356a314 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-_mssql.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['uuid'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-_mysql.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-_mysql.py new file mode 100644 index 0000000..252fd2a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-_mysql.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for _mysql, required if higher-level pure python module is not imported +""" + +hiddenimports = ['_mysql_exceptions'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-accessible_output2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-accessible_output2.py new file mode 100644 index 0000000..8d69536 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-accessible_output2.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +accessible_output2: http://hg.q-continuum.net/accessible_output2 +""" + +from PyInstaller.utils.hooks import collect_dynamic_libs + +binaries = collect_dynamic_libs('accessible_output2') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-adbutils.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-adbutils.py new file mode 100644 index 0000000..302439e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-adbutils.py @@ -0,0 +1,23 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, is_module_satisfies + +# adb.exe is not automatically collected by collect_dynamic_libs() +datas = collect_data_files("adbutils", subdir="binaries", includes=["adb*"]) + +# adbutils v2.2.2 replaced `pkg_resources` with `importlib.resources`, and now uses the following code to determine the +# path to the `adbutils.binaries` sub-package directory: +# https://github.com/openatx/adbutils/blob/2.2.2/adbutils/_utils.py#L78-L87 +# As `adbutils.binaries` is not directly imported anywhere, we need a hidden import. +if is_module_satisfies('adbutils >= 2.2.2'): + hiddenimports = ['adbutils.binaries'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-adios.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-adios.py new file mode 100644 index 0000000..761de00 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-adios.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for http://pypi.python.org/pypi/adios/ +""" + +hiddenimports = ['adios._hl.selections'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-afmformats.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-afmformats.py new file mode 100644 index 0000000..79eafa6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-afmformats.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for afmformats: https://pypi.python.org/pypi/afmformats + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('afmformats') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-aliyunsdkcore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-aliyunsdkcore.py new file mode 100644 index 0000000..50b0d96 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-aliyunsdkcore.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("aliyunsdkcore") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-altair.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-altair.py new file mode 100644 index 0000000..126115b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-altair.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("altair") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-amazonproduct.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-amazonproduct.py new file mode 100644 index 0000000..46b8467 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-amazonproduct.py @@ -0,0 +1,26 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for Python bindings for Amazon's Product Advertising API. +https://bitbucket.org/basti/python-amazon-product-api +""" + +hiddenimports = ['amazonproduct.processors.__init__', + 'amazonproduct.processors._lxml', + 'amazonproduct.processors.objectify', + 'amazonproduct.processors.elementtree', + 'amazonproduct.processors.etree', + 'amazonproduct.processors.minidom', + 'amazonproduct.contrib.__init__', + 'amazonproduct.contrib.cart', + 'amazonproduct.contrib.caching', + 'amazonproduct.contrib.retry'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-anyio.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-anyio.py new file mode 100644 index 0000000..c19fb44 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-anyio.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +AnyIO contains a number of back-ends as dynamically imported modules. +This hook was tested against AnyIO v1.4.0. +""" + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('anyio._backends') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-apkutils.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-apkutils.py new file mode 100644 index 0000000..a8804bc --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-apkutils.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("apkutils") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-appdirs.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-appdirs.py new file mode 100644 index 0000000..d49d5ba --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-appdirs.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Import hook for appdirs. + +On Windows, appdirs tries 2 different methods to get well-known directories +from the system: First with win32com, then with ctypes. Excluding win32com here +avoids including all the win32com related DLLs in programs that don't include +them otherwise. +""" + +excludedimports = ['win32com'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-appy.pod.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-appy.pod.py new file mode 100644 index 0000000..056aea2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-appy.pod.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for appy.pod: https://pypi.python.org/pypi/appy/0.9.1 + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('appy.pod', True) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-apscheduler.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-apscheduler.py new file mode 100644 index 0000000..4ac1838 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-apscheduler.py @@ -0,0 +1,27 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +APScheduler uses entry points to dynamically load executors, job +stores and triggers. +This hook was tested against APScheduler 3.6.3. +""" + +from PyInstaller.utils.hooks import (collect_submodules, copy_metadata, + is_module_satisfies) + +if is_module_satisfies("apscheduler < 4"): + if is_module_satisfies("pyinstaller >= 4.4"): + datas = copy_metadata('APScheduler', recursive=True) + else: + datas = copy_metadata('APScheduler') + + hiddenimports = collect_submodules('apscheduler') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-argon2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-argon2.py new file mode 100644 index 0000000..505639a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-argon2.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ["_cffi_backend"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-astor.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-astor.py new file mode 100644 index 0000000..93452da --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-astor.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('astor') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-astroid.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-astroid.py new file mode 100644 index 0000000..22323cd --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-astroid.py @@ -0,0 +1,48 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# *************************************************** +# hook-astriod.py - PyInstaller hook file for astriod +# *************************************************** +# The astriod package, in __pkginfo__.py, is version 1.1.1. Looking at its +# source: +# +# From __init__.py, starting at line 111:: +# +# BRAIN_MODULES_DIR = join(dirname(__file__), 'brain') +# if BRAIN_MODULES_DIR not in sys.path: +# # add it to the end of the list so user path take precedence +# sys.path.append(BRAIN_MODULES_DIR) +# # load modules in this directory +# for module in listdir(BRAIN_MODULES_DIR): +# if module.endswith('.py'): +# __import__(module[:-3]) +# +# So, we need all the Python source in the ``brain/`` subdirectory, +# since this is run-time discovered and loaded. Therefore, these +# files are all data files. + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules, \ + is_module_or_submodule + +# Note that brain/ isn't a module (it lacks an __init__.py, so it can't be +# referred to as astroid.brain; instead, locate it as package astriod, +# subdirectory brain/. +datas = collect_data_files('astroid', True, 'brain') + +# Update: in astroid v 1.4.1, the brain/ module import parts of astroid. Since +# everything in brain/ is dynamically imported, these are hidden imports. For +# simplicity, include everything in astroid. Exclude all the test/ subpackage +# contents and the test_util module. +hiddenimports = ['six'] + collect_submodules('astroid', + lambda name: (not is_module_or_submodule(name, 'astroid.tests')) and + (not name == 'test_util')) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-astropy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-astropy.py new file mode 100644 index 0000000..925ca4d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-astropy.py @@ -0,0 +1,42 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules, \ + copy_metadata, is_module_satisfies + +# Astropy includes a number of non-Python files that need to be present +# at runtime, so we include these explicitly here. +datas = collect_data_files('astropy') + +# In a number of places, astropy imports other sub-modules in a way that is not +# always auto-discovered by pyinstaller, so we always include all submodules. +hiddenimports = collect_submodules('astropy') + +# We now need to include the *_parsetab.py and *_lextab.py files for unit and +# coordinate parsing, since these are loaded as files rather than imported as +# sub-modules. We leverage collect_data_files to get all files in astropy then +# filter these. +ply_files = [] +for path, target in collect_data_files('astropy', include_py_files=True): + if path.endswith(('_parsetab.py', '_lextab.py')): + ply_files.append((path, target)) + +datas += ply_files + +# Astropy version >= 5.0 queries metadata to get version information. +if is_module_satisfies('astropy >= 5.0'): + datas += copy_metadata('astropy') + datas += copy_metadata('numpy') + +# In the Cython code, Astropy imports numpy.lib.recfunctions which isn't +# automatically discovered by pyinstaller, so we add this as a hidden import. +hiddenimports += ['numpy.lib.recfunctions'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-astropy_iers_data.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-astropy_iers_data.py new file mode 100644 index 0000000..828dd45 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-astropy_iers_data.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for https://github.com/astropy/astropy-iers-data + +from PyInstaller.utils.hooks import collect_data_files +datas = collect_data_files("astropy_iers_data") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-av.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-av.py new file mode 100644 index 0000000..8770d6d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-av.py @@ -0,0 +1,44 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +import os + +from PyInstaller.compat import is_win +from PyInstaller.utils.hooks import collect_submodules, is_module_satisfies, get_package_paths + +hiddenimports = ['fractions'] + collect_submodules("av") + +# Starting with av 9.1.1, the DLLs shipped with Windows PyPI wheels are stored +# in site-packages/av.libs instead of directly in the site-packages/av. +if is_module_satisfies("av >= 9.1.1") and is_win: + pkg_base, pkg_dir = get_package_paths("av") + lib_dir = os.path.join(pkg_base, "av.libs") + if os.path.isdir(lib_dir): + # We collect DLLs as data files instead of binaries to suppress binary + # analysis, which would result in duplicates (because it collects a copy + # into the top-level directory instead of preserving the original layout). + # In addition to DLls, this also collects .load-order* file (required on + # python < 3.8), and ensures that Shapely.libs directory exists (required + # on python >= 3.8 due to os.add_dll_directory call). + datas = [ + (os.path.join(lib_dir, lib_file), 'av.libs') + for lib_file in os.listdir(lib_dir) + ] + +# With av 13.0.0, one of the cythonized modules (`av.audio.layout`) started using `dataclasses`. Add it to hidden +# imports to ensure it is collected in cases when it is not referenced from anywhere else. +if is_module_satisfies("av >= 13.0.0"): + hiddenimports += ['dataclasses'] + +# av 13.1.0 added a cythonized `av.opaque` module that uses `uuid`; add it to hidden imports to ensure it is collected +# in cases when it is not referenced from anywhere else. +if is_module_satisfies("av >= 13.1.0"): + hiddenimports += ['uuid'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-avro.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-avro.py new file mode 100644 index 0000000..178fa29 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-avro.py @@ -0,0 +1,27 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Avro is a serialization and RPC framework. +""" + +import os +from PyInstaller.utils.hooks import get_module_file_attribute + +res_loc = os.path.dirname(get_module_file_attribute("avro")) +# see https://github.com/apache/avro/blob/master/lang/py3/setup.py +datas = [ + # Include the version.txt file, used to set __version__ + (os.path.join(res_loc, "VERSION.txt"), "avro"), + # The handshake schema is needed for IPC communication + (os.path.join(res_loc, "HandshakeRequest.avsc"), "avro"), + (os.path.join(res_loc, "HandshakeResponse.avsc"), "avro"), +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-azurerm.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-azurerm.py new file mode 100644 index 0000000..52e9c51 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-azurerm.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# Azurerm is a lite api to microsoft azure. +# Azurerm is using pkg_resources internally which is not supported by py-installer. +# This hook will collect the module metadata. +# Tested with Azurerm 0.10.0 + +from PyInstaller.utils.hooks import copy_metadata, is_module_satisfies + +if is_module_satisfies("pyinstaller >= 4.4"): + datas = copy_metadata("azurerm", recursive=True) +else: + datas = copy_metadata("azurerm") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-backports.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-backports.py new file mode 100644 index 0000000..af9ead4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-backports.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Some of jaraco's backports packages (backports.functools-lru-cache, backports.tarfile) use pkgutil-style `backports` +# namespace package, with `__init__.py` file that contains: +# +# __path__ = __import__('pkgutil').extend_path(__path__, __name__) +# +# This import via `__import__` function slips past PyInstaller's modulegraph analysis; so add a hidden import, in case +# the user's program (and its dependencies) have no other direct imports of `pkgutil`. +hiddenimports = ['pkgutil'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-backports.zoneinfo.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-backports.zoneinfo.py new file mode 100644 index 0000000..03a5e41 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-backports.zoneinfo.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.compat import is_win + +# On Windows, timezone data is provided by the tzdata package that is +# not directly loaded. +if is_win: + hiddenimports = ['tzdata'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bacon.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bacon.py new file mode 100644 index 0000000..febf11b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bacon.py @@ -0,0 +1,50 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for Bacon (https://github.com/aholkner/bacon) +# Bacon requires its native DLLs to be copied alongside frozen executable. + +import os +import ctypes + +from PyInstaller.compat import is_win, is_darwin +from PyInstaller.utils.hooks import get_package_paths + + +def collect_native_files(package, files): + pkg_base, pkg_dir = get_package_paths(package) + return [(os.path.join(pkg_dir, file), '.') for file in files] + + +if is_win: + files = ['Bacon.dll', + 'd3dcompiler_46.dll', + 'libEGL.dll', + 'libGLESv2.dll', + 'msvcp110.dll', + 'msvcr110.dll', + 'vccorllib110.dll'] + if ctypes.sizeof(ctypes.c_void_p) == 4: + hiddenimports = ["bacon.windows32"] + datas = collect_native_files('bacon.windows32', files) + else: + hiddenimports = ["bacon.windows64"] + datas = collect_native_files('bacon.windows64', files) +elif is_darwin: + if ctypes.sizeof(ctypes.c_void_p) == 4: + hiddenimports = ["bacon.darwin32"] + files = ['Bacon.dylib'] + datas = collect_native_files('bacon.darwin32', files) + else: + hiddenimports = ["bacon.darwin64"] + files = ['Bacon64.dylib'] + datas = collect_native_files('bacon.darwin64', files) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bcrypt.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bcrypt.py new file mode 100644 index 0000000..adbb592 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bcrypt.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for https://pypi.org/project/bcrypt/ +""" + +hiddenimports = ['_cffi_backend'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bitsandbytes.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bitsandbytes.py new file mode 100644 index 0000000..7897cf3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bitsandbytes.py @@ -0,0 +1,23 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# --------------------------------------------------- + +from PyInstaller.utils.hooks import collect_dynamic_libs + +# bitsandbytes contains several extensions for CPU and different CUDA versions: libbitsandbytes_cpu.so, +# libbitsandbytes_cuda110_nocublaslt.so, libbitsandbytes_cuda110.so, etc. At build-time, we could query the +# `bitsandbytes.cextension.setup` and its `binary_name` attribute for the extension that is in use. However, if the +# build system does not have CUDA available, this would automatically mean that we will not collect any of the CUDA +# libs. So for now, we collect them all. +binaries = collect_dynamic_libs("bitsandbytes") + +# bitsandbytes uses triton's JIT module, which requires access to source .py files. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-black.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-black.py new file mode 100644 index 0000000..25ba19c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-black.py @@ -0,0 +1,29 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import collect_submodules, collect_data_files + +# These are all imported from cythonized extensions. +hiddenimports = [ + 'json', + 'platform', + 'click', + 'mypy_extensions', + 'pathspec', + '_black_version', + 'platformdirs', + *collect_submodules('black'), + # blib2to3.pytree, blib2to3.pygen, various submodules from blib2to3.pgen2; best to just collect all submodules. + *collect_submodules('blib2to3'), +] + +# Ensure that `black/resources/black.schema.json` is collected, in case someone tries to call `black.schema.get_schema`. +datas = collect_data_files('black') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bleak.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bleak.py new file mode 100644 index 0000000..9fa261e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bleak.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# hook for https://github.com/hbldh/bleak + +from PyInstaller.utils.hooks import collect_data_files, collect_dynamic_libs +from PyInstaller.compat import is_win + +if is_win: + datas = collect_data_files('bleak', subdir=r'backends\dotnet') + binaries = collect_dynamic_libs('bleak') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-blib2to3.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-blib2to3.py new file mode 100644 index 0000000..3176fa4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-blib2to3.py @@ -0,0 +1,35 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import collect_submodules, collect_data_files +from _pyinstaller_hooks_contrib.compat import importlib_metadata + + +# Find the mypyc extension module for `black`, which is called something like `30fcd23745efe32ce681__mypyc`. The prefix +# changes with each `black` version, so we need to obtain the name by looking at distribution's list of files. +def _find_mypyc_module(): + try: + dist = importlib_metadata.distribution("black") + except importlib_metadata.PackageNotFoundError: + return [] + return [entry.name.split('.')[0] for entry in (dist.files or []) if '__mypyc' in entry.name] + + +hiddenimports = [ + *_find_mypyc_module(), + 'dataclasses', + 'pkgutil', + 'tempfile', + *collect_submodules('blib2to3') +] + +# Ensure that data files, such as `PatternGrammar.txt` and `Grammar.txt`, are collected. +datas = collect_data_files('blib2to3') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-blspy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-blspy.py new file mode 100644 index 0000000..18cbca2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-blspy.py @@ -0,0 +1,35 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os +import glob + +from PyInstaller.utils.hooks import get_module_file_attribute +from PyInstaller.compat import is_win + +# blspy comes as a stand-alone extension module that's placed directly +# in site-packages. +# +# On macOS and Linux, it is linked against the GMP library, whose shared +# library is stored in blspy.libs and .dylibsblspy, respectively. As this +# is a linked dependency, it is collected properly by PyInstaller and +# no further work is needed. +# +# On Windows, however, the blspy extension is linked against MPIR library, +# whose DLLs are placed directly into site-packages. The mpir.dll is +# linked dependency and is picked up automatically, but it in turn +# dynamically loads CPU-specific backends that are named mpir_*.dll. +# We need to colllect these manually. +if is_win: + blspy_dir = os.path.dirname(get_module_file_attribute('blspy')) + mpir_dlls = glob.glob(os.path.join(blspy_dir, 'mpir_*.dll')) + binaries = [(mpir_dll, '.') for mpir_dll in mpir_dlls] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bokeh.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bokeh.py new file mode 100644 index 0000000..8c42be6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-bokeh.py @@ -0,0 +1,27 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, copy_metadata, is_module_satisfies + +# core/_templates/* +# server/static/**/* +# subcommands/*.py +# bokeh/_sri.json + +datas = collect_data_files('bokeh.core') + \ + collect_data_files('bokeh.server') + \ + collect_data_files('bokeh.command.subcommands', include_py_files=True) + \ + collect_data_files('bokeh') + +# bokeh >= 3.0.0 sets its __version__ from metadata +if is_module_satisfies('bokeh >= 3.0.0'): + datas += copy_metadata('bokeh') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-boto.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-boto.py new file mode 100644 index 0000000..4ee2144 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-boto.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# Boto3, the next version of Boto, is now stable and recommended for general +# use. +# +# Boto is an integrated interface to current and future infrastructural +# services offered by Amazon Web Services. +# +# http://boto.readthedocs.org/en/latest/ +# +# Tested with boto 2.38.0 + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('boto') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-boto3.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-boto3.py new file mode 100644 index 0000000..579463c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-boto3.py @@ -0,0 +1,29 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# Boto is the Amazon Web Services (AWS) SDK for Python, which allows Python +# developers to write software that makes use of Amazon services like S3 and +# EC2. Boto provides an easy to use, object-oriented API as well as low-level +# direct service access. +# +# http://boto3.readthedocs.org/en/latest/ +# +# Tested with boto3 1.2.1 + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +hiddenimports = ( + collect_submodules('boto3.dynamodb') + + collect_submodules('boto3.ec2') + + collect_submodules('boto3.s3') +) +datas = collect_data_files('boto3') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-botocore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-botocore.py new file mode 100644 index 0000000..47ab1a0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-botocore.py @@ -0,0 +1,30 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# Botocore is a low-level interface to a growing number of Amazon Web Services. +# Botocore serves as the foundation for the AWS-CLI command line utilities. It +# will also play an important role in the boto3.x project. +# +# The botocore package is compatible with Python versions 2.6.5, Python 2.7.x, +# and Python 3.3.x and higher. +# +# https://botocore.readthedocs.org/en/latest/ +# +# Tested with botocore 1.4.36 + +from PyInstaller.utils.hooks import collect_data_files +from PyInstaller.utils.hooks import is_module_satisfies + +if is_module_satisfies('botocore >= 1.4.36'): + hiddenimports = ['html.parser'] + +datas = collect_data_files('botocore') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-branca.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-branca.py new file mode 100644 index 0000000..9cb01f9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-branca.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("branca") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cairocffi.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cairocffi.py new file mode 100644 index 0000000..c7db979 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cairocffi.py @@ -0,0 +1,45 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +import ctypes.util +import os + +from PyInstaller.depend.utils import _resolveCtypesImports +from PyInstaller.utils.hooks import collect_data_files, is_module_satisfies, logger + +datas = collect_data_files("cairocffi") + +binaries = [] + +# NOTE: Update this if cairocffi requires more libraries +libs = ["cairo-2", "cairo", "libcairo-2"] + +try: + lib_basenames = [] + for lib in libs: + libname = ctypes.util.find_library(lib) + if libname is not None: + lib_basenames += [os.path.basename(libname)] + + if lib_basenames: + resolved_libs = _resolveCtypesImports(lib_basenames) + for resolved_lib in resolved_libs: + binaries.append((resolved_lib[1], '.')) +except Exception as e: + logger.warning("Error while trying to find system-installed Cairo library: %s", e) + +if not binaries: + logger.warning("Cairo library not found - cairocffi will likely fail to work!") + +# cairocffi 1.6.0 requires cairocffi/constants.py source file, so make sure it is collected. +# The module collection mode setting requires PyInstaller >= 5.3. +if is_module_satisfies('cairocffi >= 1.6.0'): + module_collection_mode = {'cairocffi.constants': 'pyz+py'} diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cairosvg.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cairosvg.py new file mode 100644 index 0000000..6098bf2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cairosvg.py @@ -0,0 +1,40 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +import ctypes.util +import os + +from PyInstaller.depend.utils import _resolveCtypesImports +from PyInstaller.utils.hooks import collect_data_files, logger + +datas = collect_data_files("cairosvg") + +binaries = [] + +# NOTE: Update this if cairosvg requires more libraries +libs = ["cairo-2", "cairo", "libcairo-2"] + +try: + lib_basenames = [] + for lib in libs: + libname = ctypes.util.find_library(lib) + if libname is not None: + lib_basenames += [os.path.basename(libname)] + + if lib_basenames: + resolved_libs = _resolveCtypesImports(lib_basenames) + for resolved_lib in resolved_libs: + binaries.append((resolved_lib[1], '.')) +except Exception as e: + logger.warning("Error while trying to find system-installed Cairo library: %s", e) + +if not binaries: + logger.warning("Cairo library not found - cairosvg will likely fail to work!") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-capstone.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-capstone.py new file mode 100644 index 0000000..3f18043 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-capstone.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import collect_dynamic_libs + +# Collect needed libraries for capstone +binaries = collect_dynamic_libs('capstone') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cassandra.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cassandra.py new file mode 100644 index 0000000..1ebd1dd --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cassandra.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# A modern, feature-rich and highly-tunable Python client library for Apache Cassandra (2.1+) and +# DataStax Enterprise (4.7+) using exclusively Cassandra's binary protocol and Cassandra Query Language v3. +# +# http://datastax.github.io/python-driver/api/index.html +# +# Tested with cassandra-driver 3.25.0 + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('cassandra') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-celpy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-celpy.py new file mode 100644 index 0000000..6d66a0e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-celpy.py @@ -0,0 +1,24 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# cel-python is Pure Python implementation of Google Common Expression Language, +# https://opensource.google/projects/cel +# This implementation has minimal dependencies, runs quickly, and can be embedded into Python-based applications. +# Specifically, the intent is to be part of Cloud Custodian, C7N, as part of the security policy filter. +# https://github.com/cloud-custodian/cel-python +# +# Tested with cel-python 0.1.5 + +from PyInstaller.utils.hooks import collect_data_files + +# Collect *.lark file(s) from the package +datas = collect_data_files('celpy') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-certifi.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-certifi.py new file mode 100644 index 0000000..22c3d0b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-certifi.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Certifi is a carefully curated collection of Root Certificates for +# validating the trustworthiness of SSL certificates while verifying +# the identity of TLS hosts. + +# It has been extracted from the Requests project. + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('certifi') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cf_units.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cf_units.py new file mode 100644 index 0000000..e8c1f3f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cf_units.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# Include data files from cf_units/etc sub-directory. +datas = collect_data_files('cf_units', includes=['etc/**']) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cftime.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cftime.py new file mode 100644 index 0000000..20cfc82 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cftime.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# The cftime._cftime is a cython exension with following hidden imports: +hiddenimports = [ + 're', + 'time', + 'datetime', + 'warnings', + 'numpy', + 'cftime._strptime', +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-charset_normalizer.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-charset_normalizer.py new file mode 100644 index 0000000..17618ac --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-charset_normalizer.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies + +if is_module_satisfies("charset_normalizer >= 3.0.1"): + hiddenimports = ["charset_normalizer.md__mypyc"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cloudpickle.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cloudpickle.py new file mode 100644 index 0000000..bfaff37 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cloudpickle.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies + +# cloudpickle to 3.0.0 keeps `cloudpickle_fast` module around for backward compatibility with existing pickled data, +# but does not import it directly anymore. Ensure it is collected nevertheless. +if is_module_satisfies("cloudpickle >= 3.0.0"): + hiddenimports = ["cloudpickle.cloudpickle_fast"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cloudscraper.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cloudscraper.py new file mode 100644 index 0000000..3656f24 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cloudscraper.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('cloudscraper') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-clr.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-clr.py new file mode 100644 index 0000000..e0afb86 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-clr.py @@ -0,0 +1,55 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# There is a name clash between pythonnet's clr module/extension (which this hooks is for) and clr package that provides +# the terminal styling library (https://pypi.org/project/clr/). Therefore, we must first check if pythonnet is actually +# available... +from PyInstaller.utils.hooks import is_module_satisfies +from PyInstaller.compat import is_win + +if is_module_satisfies("pythonnet"): + # pythonnet requires both clr.pyd and Python.Runtime.dll, but the latter isn't found by PyInstaller. + import ctypes.util + from PyInstaller.log import logger + from _pyinstaller_hooks_contrib.compat import importlib_metadata + + collected_runtime_files = [] + + # Try finding Python.Runtime.dll via distribution's file list + dist_files = importlib_metadata.files('pythonnet') or [] + runtime_dll_files = [f for f in dist_files if f.match('Python.Runtime.dll')] + if len(runtime_dll_files) == 1: + runtime_dll_file = runtime_dll_files[0] + collected_runtime_files = [(runtime_dll_file.locate(), runtime_dll_file.parent.as_posix())] + logger.debug("hook-clr: Python.Runtime.dll discovered via metadata.") + elif len(runtime_dll_files) > 1: + logger.warning("hook-clr: multiple instances of Python.Runtime.dll listed in metadata - cannot resolve.") + + # Fall back to the legacy way + if not collected_runtime_files: + runtime_dll_file = ctypes.util.find_library('Python.Runtime') + if runtime_dll_file: + collected_runtime_files = [(runtime_dll_file, '.')] + logger.debug('hook-clr: Python.Runtime.dll discovered via legacy method.') + + if not collected_runtime_files: + raise Exception('Python.Runtime.dll not found') + + # On Windows, collect runtime DLL file(s) as binaries; on other OSes, collect them as data files, to prevent fatal + # errors in binary dependency analysis. + if is_win: + binaries = collected_runtime_files + else: + datas = collected_runtime_files + + # These modules are imported inside Python.Runtime.dll + hiddenimports = ["platform", "warnings"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-clr_loader.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-clr_loader.py new file mode 100644 index 0000000..e997c41 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-clr_loader.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.compat import is_win, is_cygwin +from PyInstaller.utils.hooks import collect_dynamic_libs + +# The clr-loader is used by pythonnet 3.x to load CLR (.NET) runtime. +# On Windows, the default runtime is the .NET Framework, and its corresponding +# loader requires DLLs from clr_loader\ffi\dlls to be collected. This runtime +# is supported only on Windows, so we do not have to worry about it on other +# OSes (where Mono or .NET Core are supported). +if is_win or is_cygwin: + binaries = collect_dynamic_libs("clr_loader") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cmocean.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cmocean.py new file mode 100644 index 0000000..d7201b5 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cmocean.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("cmocean", subdir="rgb") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-compliance_checker.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-compliance_checker.py new file mode 100644 index 0000000..d8fb4be --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-compliance_checker.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules, copy_metadata, collect_data_files + +# Collect submodules to ensure that checker plugins are collected. but avoid collecting tests sub-package. +hiddenimports = collect_submodules('compliance_checker', filter=lambda name: name != 'compliance_checker.tests') + +# Copy metadata, because checker plugins are discovered via entry-points +datas = copy_metadata('compliance_checker') + +# Include data files from compliance_checker/data sub-directory. +datas += collect_data_files('compliance_checker', includes=['data/**']) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-comtypes.client.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-comtypes.client.py new file mode 100644 index 0000000..a96e16d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-comtypes.client.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# https://github.com/enthought/comtypes/blob/1.4.5/comtypes/client/_generate.py#L271-L280 +hiddenimports = [ + "comtypes.persist", + "comtypes.typeinfo", + "comtypes.automation", + "comtypes.stream", + "comtypes", + "ctypes.wintypes", + "ctypes", +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-countrycode.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-countrycode.py new file mode 100644 index 0000000..535105d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-countrycode.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('countrycode') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-countryinfo.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-countryinfo.py new file mode 100644 index 0000000..aa05a06 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-countryinfo.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata, collect_data_files + +datas = copy_metadata("countryinfo") + collect_data_files("countryinfo") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cryptography.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cryptography.py new file mode 100644 index 0000000..4e55d49 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cryptography.py @@ -0,0 +1,132 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for cryptography module from the Python Cryptography Authority. +""" + +import os +import glob +import pathlib + +from PyInstaller import compat +from PyInstaller import isolated +from PyInstaller.utils.hooks import ( + collect_submodules, + copy_metadata, + get_module_file_attribute, + is_module_satisfies, + logger, +) + +# get the package data so we can load the backends +datas = copy_metadata('cryptography') + +# Add the backends as hidden imports +hiddenimports = collect_submodules('cryptography.hazmat.backends') + +# Add the OpenSSL FFI binding modules as hidden imports +hiddenimports += collect_submodules('cryptography.hazmat.bindings.openssl') + ['_cffi_backend'] + + +# Include the cffi extensions as binaries in a subfolder named like the package. +# The cffi verifier expects to find them inside the package directory for +# the main module. We cannot use hiddenimports because that would add the modules +# outside the package. +# NOTE: this is not true anymore with PyInstaller >= 6.0, but we keep it like this for compatibility with 5.x series. +binaries = [] +cryptography_dir = os.path.dirname(get_module_file_attribute('cryptography')) +for ext in compat.EXTENSION_SUFFIXES: + ffimods = glob.glob(os.path.join(cryptography_dir, '*_cffi_*%s*' % ext)) + for f in ffimods: + binaries.append((f, 'cryptography')) + + +# Check if `cryptography` is dynamically linked against OpenSSL >= 3.0.0. In that case, we might need to collect +# external OpenSSL modules, if OpenSSL was built with modules support. It seems the best indication of this is the +# presence of `ossl-modules` directory next to the OpenSSL shared library. +# +# NOTE: PyPI wheels ship with extensions statically linked against OpenSSL, so this is mostly catering alternative +# installation methods (Anaconda on all OSes, Homebrew on macOS, various linux distributions). +try: + @isolated.decorate + def _check_cryptography_openssl3(): + # Check if OpenSSL 3 is used. + from cryptography.hazmat.backends.openssl.backend import backend + openssl_version = backend.openssl_version_number() + if openssl_version < 0x30000000: + return False, None + + # Obtain path to the bindings module for binary dependency analysis. Under older versions of cryptography, + # this was a separate `_openssl` module; in contemporary versions, it is `_rust` module. + try: + import cryptography.hazmat.bindings._openssl as bindings_module + except ImportError: + import cryptography.hazmat.bindings._rust as bindings_module + + return True, str(bindings_module.__file__) + + uses_openssl3, bindings_module = _check_cryptography_openssl3() +except Exception: + logger.warning( + "hook-cryptography: failed to determine whether cryptography is using OpenSSL >= 3.0.0", exc_info=True + ) + uses_openssl3, bindings_module = False, None + +if uses_openssl3: + # Determine location of OpenSSL shared library, provided that extension module is dynamically linked against it. + # This requires the new PyInstaller.bindepend API from PyInstaller >= 6.0. + openssl_lib = None + if is_module_satisfies("PyInstaller >= 6.0"): + from PyInstaller.depend import bindepend + + if compat.is_win: + SSL_LIB_NAME = 'libssl-3-x64.dll' if compat.is_64bits else 'libssl-3.dll' + elif compat.is_darwin: + SSL_LIB_NAME = 'libssl.3.dylib' + else: + SSL_LIB_NAME = 'libssl.so.3' + + linked_libs = bindepend.get_imports(bindings_module) + openssl_lib = [ + # Compare the basename of lib_name, because lib_fullpath is None if we fail to resolve the library. + lib_fullpath for lib_name, lib_fullpath in linked_libs if os.path.basename(lib_name) == SSL_LIB_NAME + ] + openssl_lib = openssl_lib[0] if openssl_lib else None + else: + logger.warning( + "hook-cryptography: full support for cryptography + OpenSSL >= 3.0.0 requires PyInstaller >= 6.0" + ) + + # Check for presence of ossl-modules directory next to the OpenSSL shared library. + if openssl_lib: + logger.info("hook-cryptography: cryptography uses dynamically-linked OpenSSL: %r", openssl_lib) + + openssl_lib_dir = pathlib.Path(openssl_lib).parent + + # Collect whole ossl-modules directory, if it exists. + ossl_modules_dir = openssl_lib_dir / 'ossl-modules' + + # Msys2/MinGW installations on Windows put the shared library into `bin` directory, but the modules are + # located in `lib` directory. Account for that possibility. + if not ossl_modules_dir.is_dir() and openssl_lib_dir.name == 'bin': + ossl_modules_dir = openssl_lib_dir.parent / 'lib' / 'ossl-modules' + + # On Alpine linux, the true location of shared library is /lib directory, but the modules' directory is located + # in /usr/lib instead. Account for that possibility. + if not ossl_modules_dir.is_dir() and openssl_lib_dir == pathlib.Path('/lib'): + ossl_modules_dir = pathlib.Path('/usr/lib/ossl-modules') + + if ossl_modules_dir.is_dir(): + logger.debug("hook-cryptography: collecting OpenSSL modules directory: %r", str(ossl_modules_dir)) + binaries.append((str(ossl_modules_dir), 'ossl-modules')) + else: + logger.info("hook-cryptography: cryptography does not seem to be using dynamically linked OpenSSL.") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cumm.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cumm.py new file mode 100644 index 0000000..1193a7f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cumm.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later + +from PyInstaller.utils.hooks import collect_data_files + +# Collect files from cumm/include directory - at import, the package asserts the existence of this directory. +datas = collect_data_files('cumm') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-customtkinter.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-customtkinter.py new file mode 100644 index 0000000..0247ad6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-customtkinter.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("customtkinter") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cv2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cv2.py new file mode 100644 index 0000000..d6573c1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cv2.py @@ -0,0 +1,168 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import sys +import os +import glob +import pathlib + +import PyInstaller.utils.hooks as hookutils +from PyInstaller import compat + +hiddenimports = ['numpy'] + +# On Windows, make sure that opencv_videoio_ffmpeg*.dll is bundled +binaries = [] +if compat.is_win: + # If conda is active, look for the DLL in its library path + if compat.is_conda: + libdir = os.path.join(compat.base_prefix, 'Library', 'bin') + pattern = os.path.join(libdir, 'opencv_videoio_ffmpeg*.dll') + for f in glob.glob(pattern): + + binaries.append((f, '.')) + + # Include any DLLs from site-packages/cv2 (opencv_videoio_ffmpeg*.dll + # can be found there in the PyPI version) + binaries += hookutils.collect_dynamic_libs('cv2') + +# Collect auxiliary sub-packages, such as `cv2.gapi`, `cv2.mat_wrapper`, `cv2.misc`, and `cv2.utils`. This also +# picks up submodules with valid module names, such as `cv2.config`, `cv2.load_config_py2`, and `cv2.load_config_py3`. +# Therefore, filter out `cv2.load_config_py2`. +hiddenimports += hookutils.collect_submodules('cv2', filter=lambda name: name != 'cv2.load_config_py2') + +# We also need to explicitly exclude `cv2.load_config_py2` due to it being imported in `cv2.__init__`. +excludedimports = ['cv2.load_config_py2'] + +# OpenCV loader from 4.5.4.60 requires extra config files and modules. +# We need to collect `config.py` and `load_config_py3`; to improve compatibility with PyInstaller < 5.2, where +# `module_collection_mode` (see below) is not implemented. +# We also need to collect `config-3.py` or `config-3.X.py`, whichever is available (the former is usually +# provided by PyPI wheels, while the latter seems to be used when user builds OpenCV from source). +datas = hookutils.collect_data_files( + 'cv2', + include_py_files=True, + includes=[ + 'config.py', + f'config-{sys.version_info[0]}.{sys.version_info[1]}.py', + 'config-3.py', + 'load_config_py3.py', + ], +) + + +# The OpenCV versions that attempt to perform module substitution via sys.path manipulation (== 4.5.4.58, >= 4.6.0.66) +# do not directly import the cv2.cv2 extension anymore, so in order to ensure it is collected, we would need to add it +# to hidden imports. However, when OpenCV is built by user from source, the extension is not located in the package's +# root directory, but in python-3.X sub-directory, which precludes referencing via module name due to sub-directory +# not being a valid subpackage name. Hence, emulate the OpenCV's loader and execute `config-3.py` or `config-3.X.py` +# to obtain the search path. +def find_cv2_extension(config_file): + # Prepare environment + PYTHON_EXTENSIONS_PATHS = [] + LOADER_DIR = os.path.dirname(os.path.abspath(os.path.realpath(config_file))) + + global_vars = globals().copy() + local_vars = locals().copy() + + # Exec the config file + with open(config_file) as fp: + code = compile(fp.read(), os.path.basename(config_file), 'exec') + exec(code, global_vars, local_vars) + + # Read the modified PYTHON_EXTENSIONS_PATHS + PYTHON_EXTENSIONS_PATHS = local_vars['PYTHON_EXTENSIONS_PATHS'] + if not PYTHON_EXTENSIONS_PATHS: + return None + + # Search for extension file + for extension_path in PYTHON_EXTENSIONS_PATHS: + extension_path = pathlib.Path(extension_path) + if compat.is_win: + extension_files = list(extension_path.glob('cv2*.pyd')) + else: + extension_files = list(extension_path.glob('cv2*.so')) + if extension_files: + if len(extension_files) > 1: + hookutils.logger.warning("Found multiple cv2 extension candidates: %s", extension_files) + extension_file = extension_files[0] # Take first (or hopefully the only one) + + hookutils.logger.debug("Found cv2 extension module: %s", extension_file) + + # Compute path relative to parent of config file (which should be the package's root) + dest_dir = pathlib.Path("cv2") / extension_file.parent.relative_to(LOADER_DIR) + return str(extension_file), str(dest_dir) + + hookutils.logger.warning( + "Could not find cv2 extension module! Config file: %s, search paths: %s", + config_file, PYTHON_EXTENSIONS_PATHS) + + return None + + +config_file = [ + src_path for src_path, _ in datas + if os.path.basename(src_path) in (f'config-{sys.version_info[0]}.{sys.version_info[1]}.py', 'config-3.py') +] + +if config_file: + try: + extension_info = find_cv2_extension(config_file[0]) + if extension_info: + ext_src, ext_dst = extension_info + # Due to bug in PyInstaller's TOC structure implementation (affecting PyInstaller up to latest version at + # the time of writing, 5.9), we fail to properly resolve `cv2.cv2` EXTENSION entry's destination name if + # we already have a BINARY entry with the same destination name. This results in verbatim `cv2.cv2` file + # created in application directory in addition to the proper copy in the `cv2` sub-directoy. + # Therefoe, if destination directory of the cv2 extension module is the top-level package directory, fall + # back to using hiddenimports instead. + if ext_dst == 'cv2': + # Extension found in top-level package directory; likely a PyPI wheel. + hiddenimports += ['cv2.cv2'] + else: + # Extension found in sub-directory; use BINARY entry + binaries += [extension_info] + except Exception: + hookutils.logger.warning("Failed to determine location of cv2 extension module!", exc_info=True) + + +# Mark the cv2 package to be collected in source form, bypassing PyInstaller's PYZ archive and FrozenImporter. This is +# necessary because recent versions of cv2 package attempt to perform module substritution via sys.path manipulation, +# which is incompatible with the way that FrozenImporter works. This requires pyinstaller/pyinstaller#6945, i.e., +# PyInstaller >= 5.3. On earlier versions, the following statement does nothing, and problematic cv2 versions +# (== 4.5.4.58, >= 4.6.0.66) will not work. +# +# Note that the collect_data_files() above is still necessary, because some of the cv2 loader's config scripts are not +# valid module names (e.g., config-3.py). So the two collection approaches are complementary, and any overlap in files +# (e.g., __init__.py) is handled gracefully due to PyInstaller's uniqueness constraints on collected files. +module_collection_mode = 'py' + +# In linux PyPI opencv-python wheels, the cv2 extension is linked against Qt, and the wheel bundles a basic subset of Qt +# shared libraries, plugins, and font files. This is not the case on other OSes (presumably native UI APIs are used by +# OpenCV HighGUI module), nor in the headless PyPI wheels (opencv-python-headless). +# The bundled Qt shared libraries should be picked up automatically due to binary dependency analysis, but we need to +# collect plugins and font files from the `qt` subdirectory. +if compat.is_linux: + pkg_path = pathlib.Path(hookutils.get_module_file_attribute('cv2')).parent + # Collect .ttf files fron fonts directory. + # NOTE: since we are using glob, we can skip checks for (sub)directories' existence. + qt_fonts_dir = pkg_path / 'qt' / 'fonts' + datas += [ + (str(font_file), str(font_file.parent.relative_to(pkg_path.parent))) + for font_file in qt_fonts_dir.rglob('*.ttf') + ] + # Collect .so files from plugins directory. + qt_plugins_dir = pkg_path / 'qt' / 'plugins' + binaries += [ + (str(plugin_file), str(plugin_file.parent.relative_to(pkg_path.parent))) + for plugin_file in qt_plugins_dir.rglob('*.so') + ] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cx_Oracle.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cx_Oracle.py new file mode 100644 index 0000000..ae5daa8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cx_Oracle.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['decimal'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cytoolz.itertoolz.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cytoolz.itertoolz.py new file mode 100644 index 0000000..fcba975 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-cytoolz.itertoolz.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for the cytoolz package: https://pypi.python.org/pypi/cytoolz +# Tested with cytoolz 0.9.0 and Python 3.5.2, on Ubuntu Linux x64 + +hiddenimports = ['cytoolz.utils', 'cytoolz._signatures'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash.py new file mode 100644 index 0000000..07a3fe8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('dash') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_bootstrap_components.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_bootstrap_components.py new file mode 100644 index 0000000..8028d14 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_bootstrap_components.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('dash_bootstrap_components') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_core_components.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_core_components.py new file mode 100644 index 0000000..a41fe5a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_core_components.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('dash_core_components') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_html_components.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_html_components.py new file mode 100644 index 0000000..077d8a5 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_html_components.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('dash_html_components') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_renderer.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_renderer.py new file mode 100644 index 0000000..854f87e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_renderer.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('dash_renderer') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_table.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_table.py new file mode 100644 index 0000000..b7bb600 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_table.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('dash_table') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_uploader.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_uploader.py new file mode 100644 index 0000000..f9bf99b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dash_uploader.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('dash_uploader') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dask.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dask.py new file mode 100644 index 0000000..a11f7b7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dask.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2020, PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files + +# Collect data files: +# - dask.yaml +# - dask-schema.yaml +# - widgets/templates/*.html.j2 (but avoid collecting files from `widgets/tests/templates`!) +datas = collect_data_files('dask', includes=['*.yml', '*.yaml', 'widgets/templates/*.html.j2']) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-datasets.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-datasets.py new file mode 100644 index 0000000..1ff1a61 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-datasets.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dateparser.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dateparser.py new file mode 100644 index 0000000..ed97292 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dateparser.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# Ensure that `dateparser/data/dateparser_tz_cache.pkl` data file is collected. Applicable to dateparser >= v1.2.2; +# earlier releases have no data files, so this call returns empty list. +datas = collect_data_files('dateparser') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dateparser.utils.strptime.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dateparser.utils.strptime.py new file mode 100644 index 0000000..35e6c92 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dateparser.utils.strptime.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for dateparser: https://pypi.org/project/dateparser/ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = ["_strptime"] + collect_submodules('dateparser.data') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dateutil.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dateutil.py new file mode 100644 index 0000000..54abddf --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dateutil.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("dateutil") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dbus_fast.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dbus_fast.py new file mode 100644 index 0000000..4e2eb72 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dbus_fast.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +# Collect all submodules to handle imports made from cythonized extensions. +hiddenimports = collect_submodules('dbus_fast') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dclab.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dclab.py new file mode 100644 index 0000000..3179a16 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dclab.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for dclab: https://pypi.python.org/pypi/dclab + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('dclab') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-detectron2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-detectron2.py new file mode 100644 index 0000000..1ff1a61 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-detectron2.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-discid.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-discid.py new file mode 100644 index 0000000..37cba62 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-discid.py @@ -0,0 +1,40 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os + +from PyInstaller.utils.hooks import get_module_attribute, logger +from PyInstaller.depend.utils import _resolveCtypesImports + +binaries = [] + +# Use the _LIB_NAME attribute of discid.libdiscid to resolve the shared library name. This saves us from having to +# duplicate the name guessing logic from discid.libdiscid. +# On error, PyInstaller >= 5.0 raises exception, earlier versions return an empty string. +try: + lib_name = get_module_attribute("discid.libdiscid", "_LIB_NAME") +except Exception: + lib_name = None + +if lib_name: + lib_name = os.path.basename(lib_name) + try: + resolved_binary = _resolveCtypesImports([lib_name]) + lib_file = resolved_binary[0][1] + except Exception as e: + lib_file = None + logger.warning("Error while trying to resolve %s: %s", lib_name, e) + + if lib_file: + binaries += [(lib_file, '.')] +else: + logger.warning("Failed to determine name of libdiscid shared library from _LIB_NAME attribute of discid.libdiscid!") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-distorm3.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-distorm3.py new file mode 100644 index 0000000..b2fb731 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-distorm3.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for the diStorm3 module: https://pypi.python.org/pypi/distorm3 +# Tested with distorm3 3.3.0, Python 2.7, Windows + +from PyInstaller.utils.hooks import collect_dynamic_libs + +# distorm3 dynamic library should be in the path with other dynamic libraries. +binaries = collect_dynamic_libs('distorm3', destdir='.') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-distributed.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-distributed.py new file mode 100644 index 0000000..d1072d9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-distributed.py @@ -0,0 +1,29 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2025, PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +# Collect submodules of distributed.http, many of which are imported indirectly. +hiddenimports = collect_submodules("distributed.http") + +# Collect data files (distributed.yaml, distributed-schema.yaml, templates). +datas = collect_data_files("distributed") + +# `distributed.dashboard.components.scheduler` attempts to refer to data files relative to its parent directory, but +# with non-normalized '..' elements in the path (e.g., `_MEIPASS/distributed/dashboard/components/../theme.yaml`). On +# POSIX systems, such paths are treated as non-existent if a component does not exist, even if the file exists at the +# normalized location (i.e., if `_MEIPASS/distributed/dashboard/theme.yaml` file exists but +# `_MEIPASS/distributed/dashboard/components` directory does not). As a work around, collect source .py files from +# `distributed.dashboard.components` to ensure existence of the `components` directory. +module_collection_mode = { + 'distributed.dashboard.components': 'pyz+py', +} diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dns.rdata.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dns.rdata.py new file mode 100644 index 0000000..a185ad9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dns.rdata.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This is hook for DNS python package dnspython. + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('dns.rdtypes') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-docutils.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-docutils.py new file mode 100644 index 0000000..9d4ee79 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-docutils.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules, collect_data_files + +hiddenimports = (collect_submodules('docutils.languages') + + collect_submodules('docutils.writers') + + collect_submodules('docutils.parsers.rst.languages') + + collect_submodules('docutils.parsers.rst.directives')) +datas = collect_data_files('docutils') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-docx.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-docx.py new file mode 100644 index 0000000..aefe64e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-docx.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("docx") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-docx2pdf.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-docx2pdf.py new file mode 100644 index 0000000..c746417 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-docx2pdf.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later. +# ------------------------------------------------------------------ + +# Hook for docx2pdf: https://pypi.org/project/docx2pdf/ + +from PyInstaller.utils.hooks import copy_metadata, collect_data_files + +datas = copy_metadata('docx2pdf') +datas += collect_data_files('docx2pdf') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-duckdb.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-duckdb.py new file mode 100644 index 0000000..0d24af0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-duckdb.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata, is_module_satisfies + +# duckdb requires stdlib `inspect` module. On newer python versions (>= 3.10), it is collected as a dependency of other +# stdlib modules, while on older python versions this is not the case. Therefore, we add it to hidden imports regardless +# of python version. +hiddenimports = ['inspect'] + +# Starting with v1.4.0, `duckdb` uses `importlib.metadata.version()` to determine its version. +if is_module_satisfies("duckdb >= 1.4.0"): + datas = copy_metadata('duckdb') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dynaconf.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dynaconf.py new file mode 100644 index 0000000..08c809a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-dynaconf.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['dynaconf.loaders.env_loader', + 'dynaconf.loaders.redis_loader', + 'dynaconf.loaders.vault.loader'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-easyocr.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-easyocr.py new file mode 100644 index 0000000..a868875 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-easyocr.py @@ -0,0 +1,18 @@ +from PyInstaller.utils.hooks import collect_data_files, get_hook_config + +# Recognition backends are imported with `importlib.import_module()`. +hiddenimports = ['easyocr.model.vgg_model', 'easyocr.model.model'] + + +def hook(hook_api): + lang_codes = get_hook_config(hook_api, 'easyocr', 'lang_codes') + if not lang_codes: + lang_codes = ['*'] + + extra_datas = list() + extra_datas += collect_data_files('easyocr', include_py_files=False, subdir='character', + includes=[f'{lang_code}_char.txt' for lang_code in lang_codes]) + extra_datas += collect_data_files('easyocr', include_py_files=False, subdir='dict', + includes=[f'{lang_code}.txt' for lang_code in lang_codes]) + + hook_api.add_datas(extra_datas) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eccodeslib.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eccodeslib.py new file mode 100644 index 0000000..b04e500 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eccodeslib.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_dynamic_libs + +# Collect bundled dynamic libraries. +binaries = collect_dynamic_libs('eccodeslib') + +# `eccodeslib` depends on `eckitlib` and `fckitlib`, and when libraries are being imported at run-time by +# `findlibs.find()` user warnings are emitted if these packages cannot be imported. +hiddenimports = ['eckitlib', 'fckitlib'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eckitlib.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eckitlib.py new file mode 100644 index 0000000..99a8786 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eckitlib.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_dynamic_libs + +# Collect bundled dynamic libraries. +binaries = collect_dynamic_libs('eckitlib') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eel.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eel.py new file mode 100644 index 0000000..ceeb974 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eel.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('eel') +hiddenimports = ['bottle_websocket'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-emoji.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-emoji.py new file mode 100644 index 0000000..ecdf1fd --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-emoji.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('emoji') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-enchant.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-enchant.py new file mode 100644 index 0000000..ef1aa8a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-enchant.py @@ -0,0 +1,65 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Import hook for PyEnchant. + +Tested with PyEnchant 1.6.6. +""" + +import os + +from PyInstaller.compat import is_darwin +from PyInstaller.utils.hooks import exec_statement, collect_data_files, \ + collect_dynamic_libs, get_installer + +# TODO Add Linux support +# Collect first all files that were installed directly into pyenchant +# package directory and this includes: +# - Windows: libenchat-1.dll, libenchat_ispell.dll, libenchant_myspell.dll, other +# dependent dlls and dictionaries for several languages (de, en, fr) +# - Mac OS X: usually libenchant.dylib and several dictionaries when installed via pip. +binaries = collect_dynamic_libs('enchant') +datas = collect_data_files('enchant') +excludedimports = ['enchant.tests'] + +# On OS X try to find files from Homebrew or Macports environments. +if is_darwin: + # Note: env. var. ENCHANT_PREFIX_DIR is implemented only in the development version: + # https://github.com/AbiWord/enchant + # https://github.com/AbiWord/enchant/pull/2 + # TODO Test this hook with development version of enchant. + libenchant = exec_statement(""" + from enchant._enchant import e + print(e._name) + """).strip() + + installer = get_installer('enchant') + if installer != 'pip': + # Note: Name of detected enchant library is 'libenchant.dylib'. However, it + # is just symlink to 'libenchant.1.dylib'. + binaries.append((libenchant, '.')) + + # Collect enchant backends from Macports. Using same file structure as on Windows. + backends = exec_statement(""" + from enchant import Broker + for provider in Broker().describe(): + print(provider.file)""").strip().split() + binaries.extend([(b, 'enchant/lib/enchant') for b in backends]) + + # Collect all available dictionaries from Macports. Using same file structure as on Windows. + # In Macports are available mostly hunspell (myspell) and aspell dictionaries. + libdir = os.path.dirname(libenchant) # e.g. /opt/local/lib + sharedir = os.path.join(os.path.dirname(libdir), 'share') # e.g. /opt/local/share + if os.path.exists(os.path.join(sharedir, 'enchant')): + datas.append((os.path.join(sharedir, 'enchant'), 'enchant/share/enchant')) + if os.path.exists(os.path.join(sharedir, 'enchant-2')): + datas.append((os.path.join(sharedir, 'enchant-2'), 'enchant/share/enchant-2')) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eng_to_ipa.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eng_to_ipa.py new file mode 100644 index 0000000..5a78114 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eng_to_ipa.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('eng_to_ipa') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ens.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ens.py new file mode 100644 index 0000000..89e496e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ens.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("ens") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-enzyme.parsers.ebml.core.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-enzyme.parsers.ebml.core.py new file mode 100644 index 0000000..047274c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-enzyme.parsers.ebml.core.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +enzyme: +https://github.com/Diaoul/enzyme +""" + +import os +from PyInstaller.utils.hooks import get_package_paths + +# get path of enzyme +ep = get_package_paths('enzyme') + +# add the data +data = os.path.join(ep[1], 'parsers', 'ebml', 'specs', 'matroska.xml') +datas = [(data, "enzyme/parsers/ebml/specs")] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_abi.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_abi.py new file mode 100644 index 0000000..75c26f0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_abi.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata("eth_abi") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_account.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_account.py new file mode 100644 index 0000000..1a9c8f5 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_account.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata("eth_account") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_hash.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_hash.py new file mode 100644 index 0000000..0c9d50e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_hash.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules, copy_metadata, is_module_satisfies + +# The ``eth_hash.utils.load_backend`` function does a dynamic import. +hiddenimports = collect_submodules('eth_hash.backends') + +# As of eth-hash 0.6.0, it uses importlib.metadata.version() set its __version__ attribute +if is_module_satisfies("eth-hash >= 0.6.0"): + datas = copy_metadata("eth-hash") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_keyfile.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_keyfile.py new file mode 100644 index 0000000..2d9453a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_keyfile.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata("eth_keyfile") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_keys.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_keys.py new file mode 100644 index 0000000..d96535e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_keys.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata, is_module_satisfies + +# As of eth-keys 0.5.0, it uses importlib.metadata.version() set its __version__ attribute +if is_module_satisfies("eth-keys >= 0.5.0"): + datas = copy_metadata("eth-keys") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_rlp.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_rlp.py new file mode 100644 index 0000000..01943a6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_rlp.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, copy_metadata + +# Starting with v1.0.0, `eth_rlp` queries its version from metadata. +if is_module_satisfies("eth-rlp >= 1.0.0"): + datas = copy_metadata('eth-rlp') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_typing.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_typing.py new file mode 100644 index 0000000..f31e4ca --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_typing.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +# eth-typing queries it's own version using importlib.metadata/pkg_resources. +datas = copy_metadata("eth-typing") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_utils.network.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_utils.network.py new file mode 100644 index 0000000..3bd88f9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_utils.network.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("eth_utils") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_utils.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_utils.py new file mode 100644 index 0000000..a87ec3c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-eth_utils.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata("eth_utils") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-exchangelib.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-exchangelib.py new file mode 100644 index 0000000..0c46bcc --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-exchangelib.py @@ -0,0 +1,12 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +hiddenimports = ['tzdata'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fabric.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fabric.py new file mode 100644 index 0000000..3367c0c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fabric.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# Fabric is a high level Python (2.7, 3.4+) library designed to execute shell commands remotely over SSH, +# yielding useful Python objects in return +# +# https://docs.fabfile.org/en/latest +# +# Tested with fabric 2.6.0 + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('fabric') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fairscale.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fairscale.py new file mode 100644 index 0000000..8b5d53d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fairscale.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-faker.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-faker.py new file mode 100644 index 0000000..1d5b039 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-faker.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules, collect_data_files + +hiddenimports = collect_submodules('faker.providers') +datas = ( + collect_data_files('text_unidecode') + # noqa: W504 + collect_data_files('faker.providers', include_py_files=True) +) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-falcon.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-falcon.py new file mode 100644 index 0000000..1c1d2b1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-falcon.py @@ -0,0 +1,41 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.compat import is_py311 +from PyInstaller.utils.hooks import is_module_satisfies + +hiddenimports = [ + 'cgi', + 'falcon.app_helpers', + 'falcon.forwarded', + 'falcon.media', + 'falcon.request_helpers', + 'falcon.responders', + 'falcon.response_helpers', + 'falcon.routing', + 'falcon.vendor.mimeparse', + 'falcon.vendor', + 'uuid', + 'xml.etree.ElementTree', + 'xml.etree' +] + +# falcon v4.0.0 added couple of more cythonized modules that depend on the following stdlib modules. +if is_module_satisfies('falcon >= 4.0.0'): + hiddenimports += [ + 'dataclasses', + 'json', + ] + + # `wsgiref.types` is available (and thus referenced) only under python >= 3.11. + if is_py311: + hiddenimports += ['wsgiref.types'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fastai.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fastai.py new file mode 100644 index 0000000..1ff1a61 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fastai.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fastparquet.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fastparquet.py new file mode 100644 index 0000000..b43bbb4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fastparquet.py @@ -0,0 +1,32 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +import os + +from PyInstaller.compat import is_win +from PyInstaller.utils.hooks import get_package_paths + +# In all versions for which fastparquet provides Windows wheels (>= 0.7.0), delvewheel is used, +# so we need to collect the external site-packages/fastparquet.libs directory. +if is_win: + pkg_base, pkg_dir = get_package_paths("fastparquet") + lib_dir = os.path.join(pkg_base, "fastparquet.libs") + if os.path.isdir(lib_dir): + # We collect DLLs as data files instead of binaries to suppress binary + # analysis, which would result in duplicates (because it collects a copy + # into the top-level directory instead of preserving the original layout). + # In addition to DLls, this also collects .load-order* file (required on + # python < 3.8), and ensures that fastparquet.libs directory exists (required + # on python >= 3.8 due to os.add_dll_directory call). + datas = [ + (os.path.join(lib_dir, lib_file), 'fastparquet.libs') + for lib_file in os.listdir(lib_dir) + ] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fckitlib.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fckitlib.py new file mode 100644 index 0000000..22fe17f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fckitlib.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_dynamic_libs + +# Collect bundled dynamic libraries. +binaries = collect_dynamic_libs('fckitlib') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ffpyplayer.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ffpyplayer.py new file mode 100644 index 0000000..993d8b2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ffpyplayer.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import eval_statement, collect_submodules + +hiddenimports = collect_submodules("ffpyplayer") +binaries = [] +# ffpyplayer has an internal variable tells us where the libraries it was using +for bin in eval_statement("import ffpyplayer; print(ffpyplayer.dep_bins)"): + binaries += [(bin, '.')] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fiona.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fiona.py new file mode 100644 index 0000000..1e6d3fa --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fiona.py @@ -0,0 +1,26 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, is_module_satisfies + +hiddenimports = [ + "fiona._shim", + "fiona.schema", + "json", +] + +# As of fiona 1.9.0, `fiona.enums` is also a hidden import, made in cythonized `fiona.crs`. +if is_module_satisfies("fiona >= 1.9.0"): + hiddenimports.append("fiona.enums") + +# Collect data files that are part of the package (e.g., projections database) +datas = collect_data_files("fiona") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-flask_compress.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-flask_compress.py new file mode 100644 index 0000000..9e04195 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-flask_compress.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('flask_compress') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-flask_restx.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-flask_restx.py new file mode 100644 index 0000000..c83b5b3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-flask_restx.py @@ -0,0 +1,14 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2005-2020, PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ----------------------------------------------------------------------------- +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('flask_restx') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-flex.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-flex.py new file mode 100644 index 0000000..3faaa82 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-flex.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# hook for https://github.com/pipermerriam/flex + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('flex') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-flirpy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-flirpy.py new file mode 100644 index 0000000..4c51397 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-flirpy.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for flirpy, a library to interact with FLIR thermal imaging cameras and images. +https://github.com/LJMUAstroEcology/flirpy +""" + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('flirpy') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fmpy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fmpy.py new file mode 100644 index 0000000..daeb3c6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fmpy.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for FMPy, a library to simulate Functional Mockup Units (FMUs) +https://github.com/CATIA-Systems/FMPy + +Adds the data files that are required at runtime: + +- XSD schema files +- dynamic libraries for the CVode solver +- source and header files for the compilation of c-code FMUs +""" + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('fmpy') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-folium.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-folium.py new file mode 100644 index 0000000..a6af178 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-folium.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# Collect data files (templates) +datas = collect_data_files("folium") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-freetype.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-freetype.py new file mode 100644 index 0000000..0ae5c04 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-freetype.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_dynamic_libs + +# Collect the bundled freetype shared library, if available. +binaries = collect_dynamic_libs('freetype') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-frictionless.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-frictionless.py new file mode 100644 index 0000000..fc0ff20 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-frictionless.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +# Collect data files in frictionless/assets +datas = collect_data_files('frictionless') + +# Collect modules from `frictionless.plugins` (programmatic imports). +hiddenimports = collect_submodules('frictionless.plugins') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fsspec.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fsspec.py new file mode 100644 index 0000000..e57a32d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fsspec.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('fsspec') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fvcore.nn.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fvcore.nn.py new file mode 100644 index 0000000..1ff1a61 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-fvcore.nn.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gadfly.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gadfly.py new file mode 100644 index 0000000..1bf2314 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gadfly.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ["sql_mar"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gbulb.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gbulb.py new file mode 100644 index 0000000..68116a1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gbulb.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Prevent this package from pulling `setuptools_scm` into frozen application, as it makes no sense in that context. +excludedimports = ["setuptools_scm"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gcloud.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gcloud.py new file mode 100644 index 0000000..051d61c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gcloud.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +# This hook was written for `gcloud` - https://pypi.org/project/gcloud +# Suppress package-not-found errors when the hook is triggered by `gcloud` namespace package from `gcloud-aio-*` and +# `gcloud-rest-*` dists (https://github.com/talkiq/gcloud-aio). +try: + datas = copy_metadata('gcloud') +except Exception: + pass diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-geopandas.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-geopandas.py new file mode 100644 index 0000000..44d9001 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-geopandas.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("geopandas", subdir="datasets") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gitlab.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gitlab.py new file mode 100644 index 0000000..8adf54b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gitlab.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# python-gitlab is a Python package providing access to the GitLab server API. +# It supports the v4 API of GitLab, and provides a CLI tool (gitlab). +# +# https://python-gitlab.readthedocs.io +# +# Tested with gitlab 3.2.0 + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('gitlab') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-globus_sdk.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-globus_sdk.py new file mode 100644 index 0000000..49fb06f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-globus_sdk.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules, copy_metadata + +datas = copy_metadata("globus_sdk") +datas += collect_data_files("globus_sdk") +hiddenimports = collect_submodules("globus_sdk") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gmplot.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gmplot.py new file mode 100644 index 0000000..ce2d5ce --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gmplot.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2005-2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('gmplot') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gmsh.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gmsh.py new file mode 100644 index 0000000..d9755d0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gmsh.py @@ -0,0 +1,28 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os + +from PyInstaller.utils.hooks import logger, get_module_attribute + +# Query the `libpath` attribute of the `gmsh` module to obtain the path to shared library. This way, we do not need to +# duplicate the discovery logic. +try: + lib_file = get_module_attribute('gmsh', 'libpath') +except Exception: + logger.warning("Failed to query gmsh.libpath!", exc_info=True) + lib_file = None + +if lib_file and os.path.isfile(lib_file): + binaries = [(lib_file, '.')] +else: + logger.warning("Could not find gmsh shared library - gmsh will likely fail to load at run-time!") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gooey.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gooey.py new file mode 100644 index 0000000..8861b47 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gooey.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Gooey GUI carries some language and images for it's UI to function. +""" + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('gooey') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.api_core.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.api_core.py new file mode 100644 index 0000000..641bdf0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.api_core.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('google-api-core') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.bigquery.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.bigquery.py new file mode 100644 index 0000000..1bbfa4a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.bigquery.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata +datas = (copy_metadata('google-cloud-bigquery') + + # the pakcage queries meta-data about ``request`` + copy_metadata('requests')) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.core.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.core.py new file mode 100644 index 0000000..db7c20e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.core.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('google-cloud-core') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.kms_v1.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.kms_v1.py new file mode 100644 index 0000000..116d7f4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.kms_v1.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Client library URL: https://googleapis.dev/python/cloudkms/latest/ +# Import Example for client library: +# https://cloud.google.com/kms/docs/reference/libraries#client-libraries-install-python + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('google-cloud-kms') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.pubsub_v1.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.pubsub_v1.py new file mode 100644 index 0000000..d022668 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.pubsub_v1.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('google-cloud-pubsub') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.speech.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.speech.py new file mode 100644 index 0000000..7fed599 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.speech.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('google-cloud-speech') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.storage.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.storage.py new file mode 100644 index 0000000..29866bc --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.storage.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('google-cloud-storage') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.translate.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.translate.py new file mode 100644 index 0000000..465b8e9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.translate.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('google-cloud-translate') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-googleapiclient.model.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-googleapiclient.model.py new file mode 100644 index 0000000..d1a2293 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-googleapiclient.model.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata +from PyInstaller.utils.hooks import collect_data_files + +# googleapiclient.model queries the library version via +# pkg_resources.get_distribution("google-api-python-client").version, +# so we need to collect that package's metadata +datas = copy_metadata('google_api_python_client') +datas += collect_data_files('googleapiclient.discovery_cache', excludes=['*.txt', '**/__pycache__']) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-grapheme.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-grapheme.py new file mode 100644 index 0000000..fbe2a4b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-grapheme.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('grapheme') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-graphql_query.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-graphql_query.py new file mode 100644 index 0000000..f5a0f80 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-graphql_query.py @@ -0,0 +1,18 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2023, PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +#----------------------------------------------------------------------------- +""" +PyInstaller hook file for graphql_query. Tested with version 1.0.3. +""" + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('graphql_query') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-great_expectations.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-great_expectations.py new file mode 100644 index 0000000..a19b7c4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-great_expectations.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('great_expectations') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gribapi.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gribapi.py new file mode 100644 index 0000000..984a989 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gribapi.py @@ -0,0 +1,89 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os +import pathlib + +from PyInstaller import isolated +from PyInstaller.utils.hooks import collect_data_files, logger + +# Collect the headers (eccodes.h, gribapi.h) that are bundled with the package. +datas = collect_data_files('gribapi') + +# Collect the eccodes shared library. Starting with eccodes 2.37.0, binary wheels with bundled shared library are +# provided for linux and macOS, and since 2.39.0, also for Windows. + + +# NOTE: custom isolated function is used here instead of `get_module_attribute('gribapi.bindings', 'library_path')` +# hook utility function because with eccodes 2.37.0, `eccodes` needs to be imported before `gribapi` to avoid circular +# imports... Also, this way, we can obtain the root directory of eccodes package at the same time. +@isolated.decorate +def get_eccodes_library_path(): + import eccodes + import gribapi.bindings + + return ( + # Path to eccodes shared library used by the gribapi bindings. + str(gribapi.bindings.library_path), + # Path to eccodes package (implicitly assumed to be next to the gribapi package, since they are part of the + # same eccodes dist). + str(eccodes.__path__[0]), + ) + + +binaries = [] +hiddenimports = [] + +try: + library_path, package_path = get_eccodes_library_path() +except Exception: + logger.warning("hook-gribapi: failed to query gribapi.bindings.library_path!", exc_info=True) + library_path = None + +if library_path: + if not os.path.isabs(library_path): + from PyInstaller.depend.utils import _resolveCtypesImports + resolved_binary = _resolveCtypesImports([os.path.basename(library_path)]) + if resolved_binary: + library_path = resolved_binary[0][1] + else: + logger.warning("hook-gribapi: failed to resolve shared library name %r!", library_path) + library_path = None +else: + logger.warning("hook-gribapi: could not determine path to eccodes shared library!") + +if library_path: + # If we are collecting eccodes shared library that is bundled with eccodes >= 2.37.0 binary wheel, attempt to + # preserve its parent directory layout. This ensures that the library is found at run-time, but implicitly requires + # PyInstaller 6.x, whose binary dependency analysis (that might also pick up this shared library) also preserves the + # parent directory layout of discovered shared libraries. With PyInstaller 5.x, this will result in duplication + # because binary dependency analysis collects into top-level application directory, but that copy will not be + # discovered at run-time, so duplication is unavoidable. + library_parent_path = pathlib.PurePath(library_path).parent + package_parent_path = pathlib.PurePath(package_path).parent + + if package_parent_path in library_parent_path.parents: + # Should end up being `eccodes.libs` on Linux, `eccodes/.dylib` on macOS, and `eccodes` on Windows. + dest_dir = str(library_parent_path.relative_to(package_parent_path)) + else: + # External copy; collect into top-level application directory. + dest_dir = '.' + + logger.info( + "hook-gribapi: collecting eccodes shared library %r to destination directory %r", library_path, dest_dir + ) + binaries.append((library_path, dest_dir)) + + # If the shared library is available in the stand-alone `eccodeslib` package, add this package to to hidden imports, + # so that `findlibs.find()` can import it and query its `__file__` attribute. + if 'eccodeslib' in library_parent_path.parts: + hiddenimports += ['eccodeslib'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-grpc.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-grpc.py new file mode 100644 index 0000000..a592be2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-grpc.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('grpc') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gst._gst.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gst._gst.py new file mode 100644 index 0000000..5b4f109 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gst._gst.py @@ -0,0 +1,45 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# GStreamer contains a lot of plugins. We need to collect them and bundle +# them wih the exe file. +# We also need to resolve binary dependencies of these GStreamer plugins. + +import glob +import os +from PyInstaller.compat import is_win +from PyInstaller.utils.hooks import exec_statement + +hiddenimports = ['gmodule', 'gobject'] + +statement = """ +import os +import gst +reg = gst.registry_get_default() +plug = reg.find_plugin('coreelements') +path = plug.get_filename() +print(os.path.dirname(path)) +""" + +plugin_path = exec_statement(statement) + +if is_win: + # TODO Verify that on Windows gst plugins really end with .dll. + pattern = os.path.join(plugin_path, '*.dll') +else: + # Even on OSX plugins end with '.so'. + pattern = os.path.join(plugin_path, '*.so') + +binaries = [ + (os.path.join('gst_plugins', os.path.basename(f)), f) + # 'f' contains the absolute path + for f in glob.glob(pattern)] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gtk.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gtk.py new file mode 100644 index 0000000..64b3a4b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-gtk.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['gtkglext', 'gdkgl', 'gdkglext', 'gdk', 'gtk.gdk', 'gtk.gtkgl', + 'gtk.gtkgl._gtkgl', 'gtkgl', 'pangocairo', 'pango', 'atk', + 'gobject', 'gtk.glade', 'cairo', 'gio', + 'gtk.keysyms'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-h3.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-h3.py new file mode 100644 index 0000000..89f112b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-h3.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, copy_metadata + +# Starting with v4.0.0, h3 determines its version from its metadata. +if is_module_satisfies("h3 >= 4.0.0"): + datas = copy_metadata("h3") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-h5py.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-h5py.py new file mode 100644 index 0000000..fcc002f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-h5py.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for http://pypi.python.org/pypi/h5py/ +""" + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules("h5py", lambda x: "tests" not in x) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-hdf5plugin.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-hdf5plugin.py new file mode 100644 index 0000000..b3ef44d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-hdf5plugin.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for hdf5plugin: https://pypi.org/project/hdf5plugin/ + +from PyInstaller.utils.hooks import collect_dynamic_libs + +datas = collect_dynamic_libs("hdf5plugin") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-hexbytes.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-hexbytes.py new file mode 100644 index 0000000..8e29e8c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-hexbytes.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, copy_metadata + +# Starting with v1.1.0, `hexbytes` queries its version from metadata. +if is_module_satisfies("hexbytes >= 1.1.0"): + datas = copy_metadata('hexbytes') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-httplib2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-httplib2.py new file mode 100644 index 0000000..7789c1f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-httplib2.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This is needed to bundle cacerts.txt that comes with httplib2 module + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('httplib2') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-humanize.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-humanize.py new file mode 100644 index 0000000..598dac7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-humanize.py @@ -0,0 +1,23 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +This modest package contains various common humanization utilities, like turning a number into a fuzzy human +readable duration ("3 minutes ago") or into a human readable size or throughput. + +https://pypi.org/project/humanize + +This hook was tested against humanize 3.5.0. +""" + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('humanize') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-hydra.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-hydra.py new file mode 100644 index 0000000..0c61977 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-hydra.py @@ -0,0 +1,36 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.compat import is_py310 +from PyInstaller.utils.hooks import collect_submodules, collect_data_files, is_module_satisfies + +# Collect core plugins. +hiddenimports = collect_submodules('hydra._internal.core_plugins') + +# Hydra's plugin manager (`hydra.core.plugins.Plugins`) uses PEP-302 `find_module` / `load_module`, which has been +# deprecated since python 3.4, and has been removed from PyInstaller's frozen importer in PyInstaller 5.8. For python +# 3.10 and newer, they implemented new codepath that uses `find_spec`, but for earlier python versions, they opted to +# keep using the old codepath. +# +# See: https://github.com/facebookresearch/hydra/pull/2531 +# +# To work around the incompatibility with PyInstaller >= 5.8 when using python < 3.10, force collection of plugins as +# source .py files. This way, they end up handled by python's built-in finder/importer instead of PyInstaller's +# frozen importer. +if not is_py310 and is_module_satisfies("PyInstaller >= 5.8"): + module_collection_mode = { + 'hydra._internal.core_plugins': 'py', + 'hydra_plugins': 'py', + } + +# Collect package's data files, such as default configuration files. +datas = collect_data_files('hydra') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ijson.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ijson.py new file mode 100644 index 0000000..60fa40c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ijson.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules("ijson.backends") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-imageio.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-imageio.py new file mode 100644 index 0000000..1cf0e6e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-imageio.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for imageio: http://imageio.github.io/ + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +datas = collect_data_files('imageio', subdir="resources") + +# imageio plugins are imported lazily since ImageIO version 2.11.0. +# They are very light-weight, so we can safely include all of them. +hiddenimports = collect_submodules('imageio.plugins') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-imageio_ffmpeg.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-imageio_ffmpeg.py new file mode 100644 index 0000000..4fd469b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-imageio_ffmpeg.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for imageio: http://imageio.github.io/ + +from PyInstaller.utils.hooks import collect_data_files, is_module_satisfies + +datas = collect_data_files('imageio_ffmpeg', subdir="binaries") + +# Starting with imageio_ffmpeg 0.5.0, `imageio_ffmpeg.binaries` is a package accessed via `importlib.resources`. Since +# it is not directly imported anywhere, we need to add it to hidden imports. +if is_module_satisfies('imageio_ffmpeg >= 0.5.0'): + hiddenimports = ['imageio_ffmpeg.binaries'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-iminuit.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-iminuit.py new file mode 100644 index 0000000..4cbb6cb --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-iminuit.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# add hooks for iminuit: https://github.com/scikit-hep/iminuit + +# iminuit imports subpackages through a cython module which aren't +# found by default + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = [] + +# the iminuit package contains tests which aren't needed when distributing +for mod in collect_submodules('iminuit'): + if not mod.startswith('iminuit.tests'): + hiddenimports.append(mod) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-intake.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-intake.py new file mode 100644 index 0000000..84a52a8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-intake.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_entry_point + +datas, hiddenimports = collect_entry_point('intake.drivers') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-iso639.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-iso639.py new file mode 100644 index 0000000..974e73e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-iso639.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# Collect data files for iso639 +datas = collect_data_files("iso639") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-itk.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-itk.py new file mode 100644 index 0000000..54bf624 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-itk.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules("itk.Configuration") + +# `itk` requires `itk/Configuration` directory to exist on filesystem; collect source .py files from `itk.Configuration` +# as a work-around that ensures the existence of this directory. +module_collection_mode = { + "itk.Configuration": "pyz+py", +} diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jaraco.text.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jaraco.text.py new file mode 100644 index 0000000..7126079 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jaraco.text.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for jaraco: https://pypi.python.org/pypi/jaraco.text/3.2.0 + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('jaraco.text') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jedi.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jedi.py new file mode 100644 index 0000000..9601dbe --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jedi.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for Jedi, a static analysis tool https://pypi.org/project/jedi/ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('jedi') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jieba.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jieba.py new file mode 100644 index 0000000..cc53edf --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jieba.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('jieba') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jinja2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jinja2.py new file mode 100644 index 0000000..f017894 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jinja2.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['jinja2.ext'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jinxed.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jinxed.py new file mode 100644 index 0000000..28e7f36 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jinxed.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = [ + 'jinxed.terminfo.ansicon', 'jinxed.terminfo.vtwin10' +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jira.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jira.py new file mode 100644 index 0000000..dd64b1e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jira.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for https://pypi.python.org/pypi/jira/ +""" + +from PyInstaller.utils.hooks import copy_metadata, collect_submodules + +datas = copy_metadata('jira') +hiddenimports = collect_submodules('jira') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jsonpath_rw_ext.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jsonpath_rw_ext.py new file mode 100644 index 0000000..1914af4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jsonpath_rw_ext.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('jsonpath_rw_ext') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jsonrpcserver.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jsonrpcserver.py new file mode 100644 index 0000000..71947a1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jsonrpcserver.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This is needed to bundle request-schema.json file needed by +# jsonrpcserver package + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('jsonrpcserver') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jsonschema.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jsonschema.py new file mode 100644 index 0000000..ca1289c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jsonschema.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This is needed to bundle draft3.json and draft4.json files that come with jsonschema module. +# NOTE: with jsonschema >= 4.18.0, the specification files are part of jsonschema_specifications package, and are +# handled by the corresponding hook-jsonschema. + +from PyInstaller.utils.hooks import collect_data_files, copy_metadata + +datas = collect_data_files('jsonschema') +datas += copy_metadata('jsonschema') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jsonschema_specifications.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jsonschema_specifications.py new file mode 100644 index 0000000..bbbdafb --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jsonschema_specifications.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files +datas = collect_data_files('jsonschema_specifications') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jupyterlab.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jupyterlab.py new file mode 100644 index 0000000..ba77523 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-jupyterlab.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('jupyterlab') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-kaleido.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-kaleido.py new file mode 100644 index 0000000..e21c5eb --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-kaleido.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('kaleido') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-khmernltk.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-khmernltk.py new file mode 100644 index 0000000..021d23c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-khmernltk.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('khmernltk') +hiddenimports = ['sklearn_crfsuite'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-kinterbasdb.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-kinterbasdb.py new file mode 100644 index 0000000..dff9f4b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-kinterbasdb.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# kinterbasdb +hiddenimports = ['k_exceptions', 'services', 'typeconv_naked', + 'typeconv_backcompat', 'typeconv_23plus', + 'typeconv_datetime_stdlib', 'typeconv_datetime_mx', + 'typeconv_datetime_naked', 'typeconv_fixed_fixedpoint', + 'typeconv_fixed_stdlib', 'typeconv_text_unicode', + 'typeconv_util_isinstance', '_kinterbasdb', '_kiservices'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-langchain.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-langchain.py new file mode 100644 index 0000000..e85a392 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-langchain.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# This was required with langchain < 1.0.0; in contemporary versions, the package does not contain any data files, +# so this should be effectively a no-op. +datas = collect_data_files('langchain') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-langchain_classic.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-langchain_classic.py new file mode 100644 index 0000000..0a7d5bc --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-langchain_classic.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('langchain_classic') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-langcodes.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-langcodes.py new file mode 100644 index 0000000..65c4723 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-langcodes.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('langcodes') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-langdetect.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-langdetect.py new file mode 100644 index 0000000..2bfe9ac --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-langdetect.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("langdetect") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-laonlp.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-laonlp.py new file mode 100644 index 0000000..2c8b577 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-laonlp.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('laonlp') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lark.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lark.py new file mode 100644 index 0000000..653f810 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lark.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("lark") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ldfparser.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ldfparser.py new file mode 100644 index 0000000..42e9033 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ldfparser.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +#----------------------------------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('ldfparser') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lensfunpy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lensfunpy.py new file mode 100644 index 0000000..a44d5e4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lensfunpy.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files +# bundle xml DB files, skip other files (like DLL files on Windows) +datas = list(filter(lambda p: p[0].endswith('.xml'), collect_data_files('lensfunpy'))) +hiddenimports = ['numpy', 'enum'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-libaudioverse.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-libaudioverse.py new file mode 100644 index 0000000..9d28d60 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-libaudioverse.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Libaudioverse: https://github.com/libaudioverse/libaudioverse +""" + +from PyInstaller.utils.hooks import collect_dynamic_libs + +binaries = collect_dynamic_libs('libaudioverse') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-librosa.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-librosa.py new file mode 100644 index 0000000..2767038 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-librosa.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +# Collect all data files from the package. These include: +# - package's and subpackages' .pyi files for `lazy_loader` +# - example data in librosa/util, required by `librosa.util.files` +# - librosa/core/intervals.msgpack, required by `librosa.core.intervals` +# +# We explicitly exclude `__pycache__` because it might contain .nbi and .nbc files from `numba` cache, which are not +# re-used by `numba` codepaths in the frozen application and are instead re-compiled in user-global cache directory. +datas = collect_data_files("librosa", excludes=['**/__pycache__']) + +# And because modules are lazily loaded, we need to collect them all. +hiddenimports = collect_submodules("librosa") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lightgbm.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lightgbm.py new file mode 100644 index 0000000..3718cc4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lightgbm.py @@ -0,0 +1,27 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# A fast, distributed, high performance gradient boosting +# (GBT, GBDT, GBRT, GBM or MART) framework based on decision +# tree algorithms, used for ranking, classification and +# many other machine learning tasks. +# +# https://github.com/microsoft/LightGBM +# +# Tested with: +# Tested on Windows 10 & macOS 10.14 with Python 3.7.5 + +from PyInstaller.utils.hooks import collect_dynamic_libs + +binaries = collect_dynamic_libs('lightgbm') +binaries += collect_dynamic_libs('sklearn') +binaries += collect_dynamic_libs('scipy') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lightning.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lightning.py new file mode 100644 index 0000000..840bdb9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lightning.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# Collect version.info (which is read during package import at run-time). Avoid collecting data from `lightning.app`, +# which likely does not work with PyInstaller without additional tricks (if we need to collect that data, it should +# be done in separate `lightning.app` hook). +datas = collect_data_files( + 'lightning', + includes=['version.info'], +) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-limits.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-limits.py new file mode 100644 index 0000000..3bd9810 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-limits.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("limits") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-linear_operator.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-linear_operator.py new file mode 100644 index 0000000..73c8621 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-linear_operator.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# --------------------------------------------------- + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lingua.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lingua.py new file mode 100644 index 0000000..2d6fbb5 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lingua.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('lingua') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-litestar.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-litestar.py new file mode 100644 index 0000000..ca35e5a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-litestar.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules +hiddenimports = collect_submodules('litestar.logging') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-llvmlite.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-llvmlite.py new file mode 100644 index 0000000..108f521 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-llvmlite.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# A lightweight LLVM python binding for writing JIT compilers +# https://github.com/numba/llvmlite +# +# Tested with: +# llvmlite 0.11 (Anaconda 4.1.1, Windows), llvmlite 0.13 (Linux) + +from PyInstaller.utils.hooks import collect_dynamic_libs + +binaries = collect_dynamic_libs("llvmlite") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-logilab.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-logilab.py new file mode 100644 index 0000000..074fc40 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-logilab.py @@ -0,0 +1,26 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# *************************************************** +# hook-logilab.py - PyInstaller hook file for logilab +# *************************************************** +# The following was written about logilab, version 1.1.0, based on executing +# ``pip show logilab-common``. +# +# In logilab.common, line 33:: +# +# __version__ = pkg_resources.get_distribution('logilab-common').version +# +# Therefore, we need metadata for logilab. +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('logilab-common') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lxml.etree.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lxml.etree.py new file mode 100644 index 0000000..b53e89e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lxml.etree.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['lxml._elementpath', 'gzip', 'contextlib'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lxml.isoschematron.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lxml.isoschematron.py new file mode 100644 index 0000000..8ed7659 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lxml.isoschematron.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files +import os + +# Auxiliary data for isoschematron +datas = collect_data_files('lxml', subdir=os.path.join('isoschematron', 'resources')) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lxml.objectify.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lxml.objectify.py new file mode 100644 index 0000000..e8cb2bf --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lxml.objectify.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['lxml.etree'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lxml.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lxml.py new file mode 100644 index 0000000..4a70af6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lxml.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# lxml is not fully embedded when using standard hiddenimports +# see https://github.com/pyinstaller/pyinstaller/issues/5306 +# +# Tested with lxml 4.6.1 + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('lxml') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lz4.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lz4.py new file mode 100644 index 0000000..1b01cd4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-lz4.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# hook for https://github.com/python-lz4/python-lz4 + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('lz4') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-magic.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-magic.py new file mode 100644 index 0000000..e5efe63 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-magic.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# hook for https://pypi.org/project/python-magic-bin + +from PyInstaller.utils.hooks import collect_data_files, collect_dynamic_libs + +datas = collect_data_files('magic') +binaries = collect_dynamic_libs('magic') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mako.codegen.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mako.codegen.py new file mode 100644 index 0000000..dcaefa3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mako.codegen.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +codegen generates Python code that is then executed through exec(). +This Python code imports the following modules. +""" + +hiddenimports = ['mako.cache', 'mako.runtime', 'mako.filters'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mariadb.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mariadb.py new file mode 100644 index 0000000..6466ba1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mariadb.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_submodules + +# The MariaDB uses a .pyd file that imports ``decimal`` module within its +# module initialization function. On recent python versions (> 3.8), the decimal +# module seems to be picked up nevertheless (presumably due to import in some +# other module), but it is better not to rely on that, and ensure it is always +# collected as a hidden import. +hiddenimports = ['decimal'] + +# mariadb >= 1.1.0 requires several hidden imports from mariadb.constants. +# Collect them all, just to be on the safe side... +if is_module_satisfies("mariadb >= 1.1.0"): + hiddenimports += collect_submodules("mariadb.constants") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-markdown.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-markdown.py new file mode 100644 index 0000000..9918feb --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-markdown.py @@ -0,0 +1,28 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import ( + collect_submodules, + copy_metadata, + is_module_satisfies, +) + +hiddenimports = collect_submodules('markdown.extensions') + +# Markdown 3.3 introduced markdown.htmlparser submodule with hidden +# dependency on html.parser +if is_module_satisfies("markdown >= 3.3"): + hiddenimports += ['html.parser'] + +# Extensions can be referenced by short names, e.g. "extra", through a mechanism +# using entry-points. Thus we need to collect the package metadata as well. +datas = copy_metadata("markdown") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mecab.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mecab.py new file mode 100644 index 0000000..2b30f86 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mecab.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('mecab') +datas += collect_data_files('mecab_ko_dic') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-metpy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-metpy.py new file mode 100644 index 0000000..be84bb9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-metpy.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata, collect_data_files + +# MetPy requires metadata, because it queries its version via +# pkg_resources.get_distribution(__package__).version or, in newer +# versions, importlib.metadata.version(__package__) +datas = copy_metadata('metpy') + +# Collect data files +datas += collect_data_files('metpy') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-migrate.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-migrate.py new file mode 100644 index 0000000..b1ec0c9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-migrate.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# hook for https://github.com/openstack/sqlalchemy-migrate +# Since v0.12.0 importing migrate requires metadata to resolve __version__ +# attribute + +from PyInstaller.utils.hooks import copy_metadata, is_module_satisfies + +if is_module_satisfies('sqlalchemy-migrate >= 0.12.0'): + datas = copy_metadata('sqlalchemy-migrate') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mimesis.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mimesis.py new file mode 100644 index 0000000..5accde1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mimesis.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# The bundled 'data/' directory containing locale .json files needs to be collected (as data file). + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('mimesis') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-minecraft_launcher_lib.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-minecraft_launcher_lib.py new file mode 100644 index 0000000..e06a0a9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-minecraft_launcher_lib.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("minecraft_launcher_lib") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mistune.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mistune.py new file mode 100644 index 0000000..ea9a804 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mistune.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for nanite: https://pypi.python.org/pypi/nanite + +from PyInstaller.utils.hooks import is_module_satisfies, collect_submodules + +# As of version 3.0.0, mistune loads its plugins indirectly (but does so during package import nevertheless). +if is_module_satisfies("mistune >= 3.0.0"): + hiddenimports = collect_submodules("mistune.plugins") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mnemonic.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mnemonic.py new file mode 100644 index 0000000..68c56e5 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mnemonic.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('mnemonic') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-monai.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-monai.py new file mode 100644 index 0000000..82676db --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-monai.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = "pyz+py" diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-moviepy.audio.fx.all.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-moviepy.audio.fx.all.py new file mode 100644 index 0000000..4bb9c78 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-moviepy.audio.fx.all.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# `moviepy.audio.fx.all` programmatically imports and forwards all submodules of `moviepy.audio.fx`, so we need to +# collect those as hidden imports. +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('moviepy.audio.fx') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-moviepy.video.fx.all.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-moviepy.video.fx.all.py new file mode 100644 index 0000000..cc0b924 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-moviepy.video.fx.all.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# `moviepy.video.fx.all` programmatically imports and forwards all submodules of `moviepy.video.fx`, so we need to +# collect those as hidden imports. +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('moviepy.video.fx') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mpl_toolkits.basemap.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mpl_toolkits.basemap.py new file mode 100644 index 0000000..839b072 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-mpl_toolkits.basemap.py @@ -0,0 +1,36 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files +from PyInstaller.compat import is_win, base_prefix + +import os + +# mpl_toolkits.basemap (tested with v.1.0.7) is shipped with auxiliary data, +# usually stored in mpl_toolkits\basemap\data and used to plot maps +datas = collect_data_files('mpl_toolkits.basemap', subdir='data') + +# check if the data has been effectively found +if len(datas) == 0: + + # - conda-specific + + if is_win: + tgt_basemap_data = os.path.join('Library', 'share', 'basemap') + src_basemap_data = os.path.join(base_prefix, 'Library', 'share', 'basemap') + + else: # both linux and darwin + tgt_basemap_data = os.path.join('share', 'basemap') + src_basemap_data = os.path.join(base_prefix, 'share', 'basemap') + + if os.path.exists(src_basemap_data): + datas.append((src_basemap_data, tgt_basemap_data)) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-msoffcrypto.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-msoffcrypto.py new file mode 100644 index 0000000..74f75e0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-msoffcrypto.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +msoffcrypto contains hidden metadata as of v4.12.0 +""" + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('msoffcrypto-tool') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nacl.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nacl.py new file mode 100644 index 0000000..9694133 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nacl.py @@ -0,0 +1,30 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Tested with PyNaCl 0.3.0 on Mac OS X. + +import os.path +import glob + +from PyInstaller.compat import EXTENSION_SUFFIXES +from PyInstaller.utils.hooks import collect_data_files, get_module_file_attribute + +datas = collect_data_files('nacl') + +# Include the cffi extensions as binaries in a subfolder named like the package. +binaries = [] +nacl_dir = os.path.dirname(get_module_file_attribute('nacl')) +for ext in EXTENSION_SUFFIXES: + ffimods = glob.glob(os.path.join(nacl_dir, '_lib', '*_cffi_*%s*' % ext)) + dest_dir = os.path.join('nacl', '_lib') + for f in ffimods: + binaries.append((f, dest_dir)) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-names.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-names.py new file mode 100644 index 0000000..ff33b59 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-names.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# names: generate random names +# Module PyPI Homepage: https://pypi.python.org/pypi/names/0.3.0 + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('names') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nanite.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nanite.py new file mode 100644 index 0000000..9d37ecc --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nanite.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for nanite: https://pypi.python.org/pypi/nanite + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('nanite') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-narwhals.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-narwhals.py new file mode 100644 index 0000000..0c8109f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-narwhals.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import sys +from PyInstaller.utils.hooks import can_import_module, copy_metadata, is_module_satisfies + +# Starting with narwhals 1.35.0, we need to collect metadata for `typing_extensions` if the module is available. +# The codepath that checks metadata for `typing_extensions` is not executed under python >= 3.13, so we can avoid +# collection there. +datas = [] +if sys.version_info < (3, 13): # PyInstaller.compat.is_py313 is available only in PyInstaller >= 6.10.0. + if is_module_satisfies("narwhals >= 1.35.0") and can_import_module("typing_extensions"): + datas += copy_metadata("typing_extensions") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nbconvert.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nbconvert.py new file mode 100644 index 0000000..fefb5ae --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nbconvert.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, copy_metadata + +datas = collect_data_files('nbconvert') + +# nbconvert uses entrypoints to read nbconvert.exporters from metadata file entry_points.txt. +datas += copy_metadata('nbconvert') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nbdime.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nbdime.py new file mode 100644 index 0000000..38452ca --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nbdime.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('nbdime') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nbformat.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nbformat.py new file mode 100644 index 0000000..d193864 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nbformat.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('nbformat') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nbt.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nbt.py new file mode 100644 index 0000000..676ee32 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nbt.py @@ -0,0 +1,12 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +hiddenimports = ["nbt.nbt", "nbt.world", "nbt.region", "nbt.chunk"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ncclient.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ncclient.py new file mode 100644 index 0000000..d41c061 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ncclient.py @@ -0,0 +1,23 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for ncclient. ncclient is a Python library that facilitates client-side +scripting and application development around the NETCONF protocol. +https://pypi.python.org/pypi/ncclient + +This hook was tested with ncclient 0.4.3. +""" +from PyInstaller.utils.hooks import collect_submodules + +# Modules 'ncclient.devices.*' are dynamically loaded and PyInstaller +# is not able to find them. +hiddenimports = collect_submodules('ncclient.devices') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-netCDF4.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-netCDF4.py new file mode 100644 index 0000000..259d71c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-netCDF4.py @@ -0,0 +1,37 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.compat import is_win +from PyInstaller.utils.hooks import is_module_satisfies + +# netCDF4 (tested with v.1.1.9) has some hidden imports +hiddenimports = ['netCDF4.utils'] + +# Around netCDF4 1.4.0, netcdftime changed name to cftime +if is_module_satisfies("netCDF4 < 1.4.0"): + hiddenimports += ['netcdftime'] +else: + hiddenimports += ['cftime'] + +# Starting with netCDF 1.6.4, certifi is a hidden import made in +# netCDF4/_netCDF4.pyx. +if is_module_satisfies("netCDF4 >= 1.6.4"): + hiddenimports += ['certifi'] + +# netCDF 1.6.2 is the first version that uses `delvewheel` for bundling DLLs in Windows PyPI wheels. While contemporary +# PyInstaller versions automatically pick up DLLs from external `netCDF4.libs` directory, this does not work on Anaconda +# python 3.8 and 3.9 due to defunct `os.add_dll_directory`, which forces `delvewheel` to use the old load-order file +# approach. So we need to explicitly ensure that load-order file as well as DLLs are collected. +if is_win and is_module_satisfies("netCDF4 >= 1.6.2"): + if is_module_satisfies("PyInstaller >= 5.6"): + from PyInstaller.utils.hooks import collect_delvewheel_libs_directory + datas, binaries = collect_delvewheel_libs_directory("netCDF4") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nicegui.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nicegui.py new file mode 100644 index 0000000..539dfe0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nicegui.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('nicegui') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-niquests.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-niquests.py new file mode 100644 index 0000000..b9ec1d0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-niquests.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules("niquests") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nltk.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nltk.py new file mode 100644 index 0000000..fa1cf2b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nltk.py @@ -0,0 +1,27 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# hook for nltk +import nltk +import os +from PyInstaller.utils.hooks import collect_data_files + +# add datas for nltk +datas = collect_data_files('nltk', False) + +# loop through the data directories and add them +for p in nltk.data.path: + if os.path.exists(p): + datas.append((p, "nltk_data")) + +# nltk.chunk.named_entity should be included +hiddenimports = ["nltk.chunk.named_entity"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nnpy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nnpy.py new file mode 100644 index 0000000..e4d3951 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nnpy.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for https://pypi.org/project/nnpy/ +""" + +hiddenimports = ['_cffi_backend'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-notebook.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-notebook.py new file mode 100644 index 0000000..ea91dec --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-notebook.py @@ -0,0 +1,27 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os +from PyInstaller.utils.hooks import collect_data_files, collect_submodules +from jupyter_core.paths import jupyter_config_path, jupyter_path + +# collect modules for handlers +hiddenimports = collect_submodules('notebook', filter=lambda name: name.endswith('.handles')) +hiddenimports.append('notebook.services.shutdown') + +datas = collect_data_files('notebook') + +# Collect share and etc folder for pre-installed extensions +datas += [(path, 'share/jupyter') + for path in jupyter_path() if os.path.exists(path)] +datas += [(path, 'etc/jupyter') + for path in jupyter_config_path() if os.path.exists(path)] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-numba.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-numba.py new file mode 100644 index 0000000..9f69d34 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-numba.py @@ -0,0 +1,55 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# NumPy aware dynamic Python compiler using LLVM +# https://github.com/numba/numba +# +# Tested with: +# numba 0.26 (Anaconda 4.1.1, Windows), numba 0.28 (Linux) + +from PyInstaller.utils.hooks import is_module_satisfies + +excludedimports = ["IPython", "scipy"] +hiddenimports = ["llvmlite"] + +# numba 0.59.0 updated its vendored version of cloudpickle to 3.0.0; this version keeps `cloudpickle_fast` module +# around for backward compatibility with existing pickled data, but does not import it directly anymore. +if is_module_satisfies("numba >= 0.59.0"): + hiddenimports += ["numba.cloudpickle.cloudpickle_fast"] + +# numba 0.61 introduced new type system with several dynamic redirects using `numba.core.utils._RedirectSubpackage`; +# depending on the run-time value of `numba.config.USE_LEGACY_TYPE_SYSTEM`, either "old" or "new" module variant is +# loaded. All of these seem to be loaded when `numba` is imported, so there is no need for finer granularity. Also, +# as the config value might be manipulated at run-time (e.g., via environment variable), we need to collect both old +# and new module variants. +# numba 0.62 reverted the change, removing the new type system. +if is_module_satisfies("numba >= 0.61.0rc1, < 0.62.0rc1"): + # NOTE: `numba.core.typing` is also referenced indirectly via `_RedirectSubpackage`, but we do not need a + # hidden import entry for it, because we have entries for its submodules. + modules_old = [ + 'numba.core.datamodel.old_models', + 'numba.core.old_boxing', + 'numba.core.types.old_scalars', + 'numba.core.typing.old_builtins', + 'numba.core.typing.old_cmathdecl', + 'numba.core.typing.old_mathdecl', + 'numba.cpython.old_builtins', + 'numba.cpython.old_hashing', + 'numba.cpython.old_mathimpl', + 'numba.cpython.old_numbers', + 'numba.cpython.old_tupleobj', + 'numba.np.old_arraymath', + 'numba.np.random.old_distributions', + 'numba.np.random.old_random_methods', + ] + modules_new = [name.replace('.old_', '.new_') for name in modules_old] + hiddenimports += modules_old + modules_new diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-numbers_parser.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-numbers_parser.py new file mode 100644 index 0000000..d6fd535 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-numbers_parser.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# Ensure that `numbers_parser/data/empty.numbers` is collected. +datas = collect_data_files('numbers_parser') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-numcodecs.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-numcodecs.py new file mode 100644 index 0000000..7a6f6fd --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-numcodecs.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies + +# compat_ext is only imported from pyx files, so it is missed +hiddenimports = ['numcodecs.compat_ext'] + +# numcodecs v0.15.0 added an import of `deprecated` (from `Deprecated` dist) in one of its cythonized extension. +if is_module_satisfies('numcodecs >= 0.15.0'): + hiddenimports += ['deprecated'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cublas.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cublas.py new file mode 100644 index 0000000..3404162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cublas.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +binaries = collect_nvidia_cuda_binaries(__file__) +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_cupti.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_cupti.py new file mode 100644 index 0000000..3404162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_cupti.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +binaries = collect_nvidia_cuda_binaries(__file__) +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_nvcc.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_nvcc.py new file mode 100644 index 0000000..13172ae --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_nvcc.py @@ -0,0 +1,30 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +# Ensures that versioned .so files are collected +binaries = collect_nvidia_cuda_binaries(__file__) + +# Prevent binary dependency analysis from creating symlinks to top-level application directory for shared libraries +# from this package. Requires PyInstaller >= 6.11.0; no-op in earlier versions. +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) + +# Collect additional resources: +# - ptxas executable (which strictly speaking, should be collected as a binary) +# - nvvm/libdevice/libdevice.10.bc file +# - C headers; assuming ptxas requires them - if that is not the case, we could filter them out. +datas = collect_data_files('nvidia.cuda_nvcc') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_nvrtc.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_nvrtc.py new file mode 100644 index 0000000..3404162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_nvrtc.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +binaries = collect_nvidia_cuda_binaries(__file__) +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_runtime.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_runtime.py new file mode 100644 index 0000000..3404162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_runtime.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +binaries = collect_nvidia_cuda_binaries(__file__) +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cudnn.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cudnn.py new file mode 100644 index 0000000..3404162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cudnn.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +binaries = collect_nvidia_cuda_binaries(__file__) +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cufft.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cufft.py new file mode 100644 index 0000000..3404162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cufft.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +binaries = collect_nvidia_cuda_binaries(__file__) +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.curand.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.curand.py new file mode 100644 index 0000000..3404162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.curand.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +binaries = collect_nvidia_cuda_binaries(__file__) +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cusolver.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cusolver.py new file mode 100644 index 0000000..3404162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cusolver.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +binaries = collect_nvidia_cuda_binaries(__file__) +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cusparse.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cusparse.py new file mode 100644 index 0000000..3404162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cusparse.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +binaries = collect_nvidia_cuda_binaries(__file__) +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.nccl.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.nccl.py new file mode 100644 index 0000000..3404162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.nccl.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +binaries = collect_nvidia_cuda_binaries(__file__) +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.nvjitlink.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.nvjitlink.py new file mode 100644 index 0000000..3404162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.nvjitlink.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +binaries = collect_nvidia_cuda_binaries(__file__) +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.nvtx.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.nvtx.py new file mode 100644 index 0000000..3404162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.nvtx.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.nvidia_cuda import ( + collect_nvidia_cuda_binaries, + create_symlink_suppression_patterns, +) + +binaries = collect_nvidia_cuda_binaries(__file__) +bindepend_symlink_suppression = create_symlink_suppression_patterns(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-office365.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-office365.py new file mode 100644 index 0000000..37a007f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-office365.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Office365-REST-Python-Client contains xml templates that are needed by some methods +This hook ensures that all of the data used by the package is bundled +""" + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("office365") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-onnxruntime.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-onnxruntime.py new file mode 100644 index 0000000..9c7e807 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-onnxruntime.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_dynamic_libs + +# Collect provider plugins from onnxruntime/capi. +binaries = collect_dynamic_libs("onnxruntime") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-opencc.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-opencc.py new file mode 100644 index 0000000..9204053 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-opencc.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('opencc') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-openpyxl.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-openpyxl.py new file mode 100644 index 0000000..299a1be --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-openpyxl.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for the openpyxl module: https://pypi.python.org/pypi/openpyxl +# Tested with openpyxl 2.3.4, Python 2.7, Windows + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('openpyxl') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-opentelemetry.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-opentelemetry.py new file mode 100644 index 0000000..d8e3e9e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-opentelemetry.py @@ -0,0 +1,41 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_entry_point + +# All known `opentelementry_` entry-point groups +ENTRY_POINT_GROUPS = ( + 'opentelemetry_context', + 'opentelemetry_environment_variables', + 'opentelemetry_id_generator', + 'opentelemetry_logger_provider', + 'opentelemetry_logs_exporter', + 'opentelemetry_meter_provider', + 'opentelemetry_metrics_exporter', + 'opentelemetry_propagator', + 'opentelemetry_resource_detector', + 'opentelemetry_tracer_provider', + 'opentelemetry_traces_exporter', + 'opentelemetry_traces_sampler', +) + +# Collect entry points +datas = set() +hiddenimports = set() + +for entry_point_group in ENTRY_POINT_GROUPS: + ep_datas, ep_hiddenimports = collect_entry_point(entry_point_group) + datas.update(ep_datas) + hiddenimports.update(ep_hiddenimports) + +datas = list(datas) +hiddenimports = list(hiddenimports) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-orjson.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-orjson.py new file mode 100644 index 0000000..04092dc --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-orjson.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Forced import of these modules happens on first orjson import +# and orjson is a compiled extension module. +hiddenimports = [ + 'uuid', + 'zoneinfo', + 'enum', + 'json', + 'dataclasses', +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-osgeo.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-osgeo.py new file mode 100644 index 0000000..dbc0b4a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-osgeo.py @@ -0,0 +1,81 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files +from PyInstaller.compat import is_win, is_darwin + +import os +import sys + +# The osgeo libraries require auxiliary data and may have hidden dependencies. +# There are several possible configurations on how these libraries can be +# deployed. +# This hook evaluates the cases when: +# - the `data` folder is present "in-source" (sharing the same namespace folder +# as the code libraries) +# - the `data` folder is present "out-source" (for instance, on Anaconda for +# Windows, in PYTHONHOME/Library/data) +# In this latter case, the hook also checks for the presence of `proj` library +# (e.g., on Windows in PYTHONHOME) for being added to the bundle. +# +# This hook has been tested with gdal (v.1.11.2 and 1.11.3) on: +# - Win 7 and 10 64bit +# - Ubuntu 15.04 64bit +# - Mac OS X Yosemite 10.10 +# +# TODO: Fix for gdal>=2.0.0, <2.0.3: 'NameError: global name 'help' is not defined' + +# flag used to identify an Anaconda environment +is_conda = False + +# Auxiliary data: +# +# - general case (data in 'osgeo/data'): +datas = collect_data_files('osgeo', subdir='data') + +# check if the data has been effectively found in 'osgeo/data/gdal' +if len(datas) == 0: + + if hasattr(sys, 'real_prefix'): # check if in a virtual environment + root_path = sys.real_prefix + else: + root_path = sys.prefix + + # - conda-specific + if is_win: + tgt_gdal_data = os.path.join('Library', 'share', 'gdal') + src_gdal_data = os.path.join(root_path, 'Library', 'share', 'gdal') + if not os.path.exists(src_gdal_data): + tgt_gdal_data = os.path.join('Library', 'data') + src_gdal_data = os.path.join(root_path, 'Library', 'data') + + else: # both linux and darwin + tgt_gdal_data = os.path.join('share', 'gdal') + src_gdal_data = os.path.join(root_path, 'share', 'gdal') + + if os.path.exists(src_gdal_data): + is_conda = True + datas.append((src_gdal_data, tgt_gdal_data)) + # a real-time hook takes case to define the path for `GDAL_DATA` + +# Hidden dependencies +if is_conda: + # if `proj.4` is present, it provides additional functionalities + if is_win: + proj4_lib = os.path.join(root_path, 'proj.dll') + elif is_darwin: + proj4_lib = os.path.join(root_path, 'lib', 'libproj.dylib') + else: # assumed linux-like settings + proj4_lib = os.path.join(root_path, 'lib', 'libproj.so') + + if os.path.exists(proj4_lib): + binaries = [(proj4_lib, ".")] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pandas_flavor.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pandas_flavor.py new file mode 100644 index 0000000..a41c36a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pandas_flavor.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies + +# As of version 0.3.0, pandas_flavor uses lazy loader to import `register` and `xarray` sub-modules. In earlier +# versions, these used to be imported directly. This was removed in 0.7.0. +if is_module_satisfies("pandas_flavor >= 0.3.0, < 0.7.0"): + hiddenimports = ['pandas_flavor.register', 'pandas_flavor.xarray'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-panel.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-panel.py new file mode 100644 index 0000000..51c411f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-panel.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +datas = collect_data_files("panel") + +# Some models are lazy-loaded on runtime, so we need to collect them +hiddenimports = collect_submodules("panel.models") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-parsedatetime.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-parsedatetime.py new file mode 100644 index 0000000..5392a72 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-parsedatetime.py @@ -0,0 +1,29 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2005-2020, PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +#----------------------------------------------------------------------------- +""" +Fixes https://github.com/pyinstaller/pyinstaller/issues/4995 + +Modules under parsedatetime.pdt_locales.* are lazily loaded using __import__. +But they are conviniently listed in parsedatetime.pdt_locales.locales. + +Tested on versions: + +- 1.1.1 +- 1.5 +- 2.0 +- 2.6 (latest) + +""" + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules("parsedatetime.pdt_locales") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-parso.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-parso.py new file mode 100644 index 0000000..c00caf1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-parso.py @@ -0,0 +1,17 @@ +# ----------------------------------------------------------------------------- +# Copyright (c) 2013-2018, PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ----------------------------------------------------------------------------- + +# Hook for Parso, a static analysis tool https://pypi.org/project/jedi/ (IPython dependency) + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('parso') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-passlib.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-passlib.py new file mode 100644 index 0000000..9189b8e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-passlib.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Handlers are imported by a lazy-load proxy, based on a +# name-to-package mapping. Collect all handlers to ease packaging. +# If you want to reduce the size of your application, used +# `--exclude-module` to remove unused ones. +hiddenimports = [ + "passlib.handlers", + "passlib.handlers.digests", + "configparser", +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-paste.exceptions.reporter.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-paste.exceptions.reporter.py new file mode 100644 index 0000000..9b80044 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-paste.exceptions.reporter.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Some modules use the old-style import: explicitly include +the new module when the old one is referenced. +""" + +hiddenimports = ["email.mime.text", "email.mime.multipart"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-patoolib.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-patoolib.py new file mode 100644 index 0000000..57d1aa6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-patoolib.py @@ -0,0 +1,19 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2017-2024, PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +#----------------------------------------------------------------------------- + + +""" +patoolib uses importlib and pyinstaller doesn't find it and add it to the list of needed modules +""" + +from PyInstaller.utils.hooks import collect_submodules +hiddenimports = collect_submodules('patoolib.programs') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-patsy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-patsy.py new file mode 100644 index 0000000..39dbf7b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-patsy.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['patsy.builtins'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pdfminer.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pdfminer.py new file mode 100644 index 0000000..e4da9a7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pdfminer.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('pdfminer') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pendulum.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pendulum.py new file mode 100644 index 0000000..5649b4a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pendulum.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +# Pendulum checks for locale modules via os.path.exists before import. +# If the include_py_files option is turned off, this check fails, pendulum +# will raise a ValueError. +datas = collect_data_files("pendulum.locales", include_py_files=True) +hiddenimports = collect_submodules("pendulum.locales") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-phonenumbers.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-phonenumbers.py new file mode 100644 index 0000000..1494a21 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-phonenumbers.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# Hook for the phonenumbers package: https://pypi.org/project/phonenumbers/ +# +# Tested with phonenumbers 8.9.7 and Python 3.6.1, on Ubuntu 16.04 64bit. + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('phonenumbers') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pingouin.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pingouin.py new file mode 100644 index 0000000..dd9989b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pingouin.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('pingouin') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pint.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pint.py new file mode 100644 index 0000000..49d2dee --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pint.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, copy_metadata + +datas = collect_data_files('pint') +datas += copy_metadata('pint') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pinyin.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pinyin.py new file mode 100644 index 0000000..ad8c547 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pinyin.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for the pinyin package: https://pypi.python.org/pypi/pinyin +# Tested with pinyin 0.4.0 and Python 3.6.2, on Windows 10 x64. + +from PyInstaller.utils.hooks import collect_data_files + +# pinyin relies on 'Mandarin.dat' and 'cedict.txt.gz' +# for character and word translation. +datas = collect_data_files('pinyin') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-platformdirs.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-platformdirs.py new file mode 100644 index 0000000..4d6b250 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-platformdirs.py @@ -0,0 +1,27 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.compat import is_darwin, is_win + +modules = ["platformdirs"] + +# platfromdirs contains dynamically loaded per-platform submodules. +if is_darwin: + modules.append("platformdirs.macos") +elif is_win: + modules.append("platformdirs.windows") +else: + # default to unix for all other platforms + # this includes unix, cygwin, and msys2 + modules.append("platformdirs.unix") + +hiddenimports = modules diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-plotly.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-plotly.py new file mode 100644 index 0000000..be8714e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-plotly.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files +from PyInstaller.utils.hooks import collect_submodules + +datas = collect_data_files('plotly', includes=['package_data/**/*.*', 'validators/**/*.*']) +hiddenimports = collect_submodules('plotly.validators') + ['pandas', 'cmath'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pointcept.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pointcept.py new file mode 100644 index 0000000..5d36ef1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pointcept.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Collect source .py files for JIT/torchscript. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pptx.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pptx.py new file mode 100644 index 0000000..fae9505 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pptx.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('pptx.templates') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-prettytable.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-prettytable.py new file mode 100644 index 0000000..d049b3a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-prettytable.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata, is_module_satisfies + +# Starting with v3.12.0, `prettytable` does not query its version from metadata. +if is_module_satisfies('prettytable < 3.12.0'): + datas = copy_metadata('prettytable') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-psutil.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-psutil.py new file mode 100644 index 0000000..a886d96 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-psutil.py @@ -0,0 +1,50 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +import os +import sys + +# see https://github.com/giampaolo/psutil/blob/release-5.9.5/psutil/_common.py#L82 +WINDOWS = os.name == "nt" +LINUX = sys.platform.startswith("linux") +MACOS = sys.platform.startswith("darwin") +FREEBSD = sys.platform.startswith(("freebsd", "midnightbsd")) +OPENBSD = sys.platform.startswith("openbsd") +NETBSD = sys.platform.startswith("netbsd") +BSD = FREEBSD or OPENBSD or NETBSD +SUNOS = sys.platform.startswith(("sunos", "solaris")) +AIX = sys.platform.startswith("aix") + +excludedimports = [ + "psutil._pslinux", + "psutil._pswindows", + "psutil._psosx", + "psutil._psbsd", + "psutil._pssunos", + "psutil._psaix", +] + +# see https://github.com/giampaolo/psutil/blob/release-5.9.5/psutil/__init__.py#L97 +if LINUX: + excludedimports.remove("psutil._pslinux") +elif WINDOWS: + excludedimports.remove("psutil._pswindows") + # see https://github.com/giampaolo/psutil/blob/release-5.9.5/psutil/_common.py#L856 + # This will exclude `curses` for windows + excludedimports.append("curses") +elif MACOS: + excludedimports.remove("psutil._psosx") +elif BSD: + excludedimports.remove("psutil._psbsd") +elif SUNOS: + excludedimports.remove("psutil._pssunos") +elif AIX: + excludedimports.remove("psutil._psaix") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-psychopy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-psychopy.py new file mode 100644 index 0000000..4bee8d6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-psychopy.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Tested on Windows 7 64bit with python 2.7.6 and PsychoPy 1.81.03 + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('psychopy') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-psycopg2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-psycopg2.py new file mode 100644 index 0000000..7698bbb --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-psycopg2.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['mx.DateTime'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-psycopg_binary.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-psycopg_binary.py new file mode 100644 index 0000000..77494c3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-psycopg_binary.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# The `pyscopg_binary._uuid` module is imported from the `psycopg_binary._psycopg` binary extension when working with +# data of UUID data type. +hiddenimports = ['psycopg_binary._uuid'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-publicsuffix2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-publicsuffix2.py new file mode 100644 index 0000000..01a5ec2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-publicsuffix2.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('publicsuffix2') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pubsub.core.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pubsub.core.py new file mode 100644 index 0000000..dea0737 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pubsub.core.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('pubsub.core', include_py_files=True, excludes=['*.txt', '**/__pycache__']) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-puremagic.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-puremagic.py new file mode 100644 index 0000000..8aa599f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-puremagic.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("puremagic") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-py.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-py.py new file mode 100644 index 0000000..b3bd685 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-py.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules("py._path") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyarrow.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyarrow.py new file mode 100644 index 0000000..ef98062 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyarrow.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for https://pypi.org/project/pyarrow/ + +from PyInstaller.utils.hooks import collect_submodules, collect_data_files, collect_dynamic_libs + +hiddenimports = collect_submodules('pyarrow', filter=lambda x: "tests" not in x) +datas = collect_data_files('pyarrow') +binaries = collect_dynamic_libs('pyarrow') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pycountry.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pycountry.py new file mode 100644 index 0000000..9dd4f9a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pycountry.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, copy_metadata + +# pycountry requires the ISO databases for country data. +# Tested v1.15 on Linux/Ubuntu. +# https://pypi.python.org/pypi/pycountry +datas = copy_metadata('pycountry') + collect_data_files('pycountry') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pycparser.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pycparser.py new file mode 100644 index 0000000..1f2e968 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pycparser.py @@ -0,0 +1,23 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# pycparser needs two modules -- lextab.py and yacctab.py -- which it +# generates at runtime if they cannot be imported. +# +# Those modules are written to the current working directory for which +# the running process may not have write permissions, leading to a runtime +# exception. +# +# This hook tells pyinstaller about those hidden imports, avoiding the +# possibility of such runtime failures. + +hiddenimports = ['pycparser.lextab', 'pycparser.yacctab'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pycrfsuite.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pycrfsuite.py new file mode 100644 index 0000000..8b64162 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pycrfsuite.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['pycrfsuite._dumpparser', 'pycrfsuite._logparser', 'tempfile'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pydantic.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pydantic.py new file mode 100644 index 0000000..2e2d288 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pydantic.py @@ -0,0 +1,49 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import get_module_attribute, collect_submodules +from PyInstaller.utils.hooks import is_module_satisfies + +# By default, PyPi wheels for pydantic < 2.0.0 come with all modules compiled as cython extensions, which prevents +# PyInstaller from automatically picking up the submodules. +if is_module_satisfies('pydantic >= 2.0.0'): + # The `pydantic.compiled` attribute was removed in v2. + is_compiled = False +else: + # NOTE: in PyInstaller 4.x and earlier, get_module_attribute() returns the string representation of the value + # ('True'), while in PyInstaller 5.x and later, the actual value is returned (True). + is_compiled = get_module_attribute('pydantic', 'compiled') in {'True', True} + +# Collect submodules from pydantic; even if the package is not compiled, contemporary versions (2.11.1 at the time +# of writing) contain redirections and programmatic imports. +hiddenimports = collect_submodules('pydantic') + +if is_compiled: + # In compiled version, we need to collect the following modules from the standard library. + hiddenimports += [ + 'colorsys', + 'dataclasses', + 'decimal', + 'json', + 'ipaddress', + 'pathlib', + 'uuid', + # Optional dependencies. + 'dotenv', + 'email_validator' + ] + # Older releases (prior 1.4) also import distutils.version + if not is_module_satisfies('pydantic >= 1.4'): + hiddenimports += ['distutils.version'] + # Version 1.8.0 introduced additional dependency on typing_extensions + if is_module_satisfies('pydantic >= 1.8'): + hiddenimports += ['typing_extensions'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pydicom.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pydicom.py new file mode 100644 index 0000000..8b3d497 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pydicom.py @@ -0,0 +1,69 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files + +hiddenimports = [] +datas = [] + +# In pydicom 3.0.0, the `pydicom.encoders` plugins were renamed to `pydicom.pixels.encoders`, and +# `pydicom.pixels.decoders` were also added. We need to collect them all, because they are loaded during +# `pydicom` module initialization. We intentionally avoid using `collect_submodules` here, because that causes +# import of `pydicom` with logging framework initialized, which results in error tracebacks being logged for all plugins +# with missing libraries (see https://github.com/pydicom/pydicom/issues/2128). +if is_module_satisfies('pydicom >= 3.0.0'): + hiddenimports += [ + "pydicom.pixels.decoders.gdcm", + "pydicom.pixels.decoders.pylibjpeg", + "pydicom.pixels.decoders.pillow", + "pydicom.pixels.decoders.pyjpegls", + "pydicom.pixels.decoders.rle", + "pydicom.pixels.encoders.gdcm", + "pydicom.pixels.encoders.pylibjpeg", + "pydicom.pixels.encoders.native", + "pydicom.pixels.encoders.pyjpegls", + ] + + # With pydicom 3.0.0, initialization of `pydicom` (unnecessarily) imports `pydicom.examples`, which attempts to set + # up several test datasets: https://github.com/pydicom/pydicom/blob/v3.0.0/src/pydicom/examples/__init__.py#L10-L24 + # Some of those are bundled with the package itself, some are downloaded (into `.pydicom/data` directory in user's + # home directory) on he first `pydicom.examples` import. + # + # The download code requires `pydicom/data/urls.json` and `pydicom/data/hashes.json`; the lack of former results in + # run-time error, while the lack of latter results in warnings about dataset download failure. + # + # The test data files that are bundled with the package are not listed in `urls.json`, so if they are missing, there + # is not attempt to download them. Therefore, try to get away without collecting them here - if anyone actually + # requires them in the frozen application, let them explicitly collect them. + additional_data_patterns = [ + 'urls.json', + 'hashes.json', + ] +else: + hiddenimports += [ + "pydicom.encoders.gdcm", + "pydicom.encoders.pylibjpeg", + "pydicom.encoders.native", + ] + additional_data_patterns = [] + +# Collect data files from `pydicom.data`; charset files and palettes might be needed during processing, so always +# collect them. Some other data files became required in v3.0.0 - the corresponding patterns are set accordingly in +# `additional_data_patterns` in the above if/else block. +datas += collect_data_files( + 'pydicom.data', + includes=[ + 'charset_files/*', + 'palettes/*', + *additional_data_patterns, + ], +) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pydivert.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pydivert.py new file mode 100644 index 0000000..dab32b8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pydivert.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('pydivert.windivert_dll') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyecharts.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyecharts.py new file mode 100644 index 0000000..69f2e40 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyecharts.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('pyecharts') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-io.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-io.py new file mode 100644 index 0000000..55fd56a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-io.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-io 0.5.18: +# https://github.com/pyexcel/pyexcel-io + +hiddenimports = ['pyexcel_io'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-ods.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-ods.py new file mode 100644 index 0000000..160e1b2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-ods.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-ods 0.5.6: +# https://github.com/pyexcel/pyexcel-ods + +hiddenimports = ['pyexcel_ods'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-ods3.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-ods3.py new file mode 100644 index 0000000..a01beed --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-ods3.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-ods3 0.5.3: +# https://github.com/pyexcel/pyexcel-ods3 + +hiddenimports = ['pyexcel_ods3'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-odsr.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-odsr.py new file mode 100644 index 0000000..0d10d71 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-odsr.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-io 0.5.2: +# https://github.com/pyexcel/pyexcel-io + +hiddenimports = ['pyexcel_odsr'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-xls.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-xls.py new file mode 100644 index 0000000..60acc3f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-xls.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-xls 0.5.8: +# https://github.com/pyexcel/pyexcel-xls + +hiddenimports = ['pyexcel_xls'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-xlsx.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-xlsx.py new file mode 100644 index 0000000..1f12497 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-xlsx.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-xlsx 0.4.2: +# https://github.com/pyexcel/pyexcel-xlsx + +hiddenimports = ['pyexcel_xlsx'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-xlsxw.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-xlsxw.py new file mode 100644 index 0000000..c0b6778 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-xlsxw.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-xlsxw 0.4.2: +# https://github.com/pyexcel/pyexcel-xlsxw + +hiddenimports = ['pyexcel_xlsxw'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel.py new file mode 100644 index 0000000..f000b2d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel.py @@ -0,0 +1,29 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel 0.5.13: +# https://github.com/pyexcel/pyexcel + +hiddenimports = [ + 'pyexcel.plugins.renderers.sqlalchemy', 'pyexcel.plugins.renderers.django', + 'pyexcel.plugins.renderers.excel', 'pyexcel.plugins.renderers._texttable', + 'pyexcel.plugins.parsers.excel', 'pyexcel.plugins.parsers.sqlalchemy', + 'pyexcel.plugins.sources.http', 'pyexcel.plugins.sources.file_input', + 'pyexcel.plugins.sources.memory_input', + 'pyexcel.plugins.sources.file_output', + 'pyexcel.plugins.sources.output_to_memory', + 'pyexcel.plugins.sources.pydata.bookdict', + 'pyexcel.plugins.sources.pydata.dictsource', + 'pyexcel.plugins.sources.pydata.arraysource', + 'pyexcel.plugins.sources.pydata.records', 'pyexcel.plugins.sources.django', + 'pyexcel.plugins.sources.sqlalchemy', 'pyexcel.plugins.sources.querysets' +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_io.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_io.py new file mode 100644 index 0000000..2096a74 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_io.py @@ -0,0 +1,26 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-io 0.5.18: +# https://github.com/pyexcel/pyexcel-io + +hiddenimports = [ + 'pyexcel_io.readers.csvr', 'pyexcel_io.readers.csvz', + 'pyexcel_io.readers.tsv', 'pyexcel_io.readers.tsvz', + 'pyexcel_io.writers.csvw', 'pyexcel_io.writers.csvz', + 'pyexcel_io.writers.tsv', 'pyexcel_io.writers.tsvz', + 'pyexcel_io.readers.csvz', 'pyexcel_io.readers.tsv', + 'pyexcel_io.readers.tsvz', 'pyexcel_io.database.importers.django', + 'pyexcel_io.database.importers.sqlalchemy', + 'pyexcel_io.database.exporters.django', + 'pyexcel_io.database.exporters.sqlalchemy' +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_ods.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_ods.py new file mode 100644 index 0000000..f856a0e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_ods.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-ods 0.5.6: +# https://github.com/pyexcel/pyexcel-ods + +hiddenimports = ['pyexcel_ods', 'pyexcel_ods.odsr', 'pyexcel_ods.odsw', "pyexcel_io.writers"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_ods3.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_ods3.py new file mode 100644 index 0000000..c4f54eb --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_ods3.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-ods3 0.5.3: +# https://github.com/pyexcel/pyexcel-ods3 + +hiddenimports = ['pyexcel_ods3', 'pyexcel_ods3.odsr', 'pyexcel_ods3.odsw'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_odsr.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_odsr.py new file mode 100644 index 0000000..d895ed1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_odsr.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-io 0.5.2: +# https://github.com/pyexcel/pyexcel-io + +hiddenimports = ['pyexcel_odsr', 'pyexcel_odsr.odsr'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_xls.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_xls.py new file mode 100644 index 0000000..4875412 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_xls.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-xls 0.5.8: +# https://github.com/pyexcel/pyexcel-xls + +hiddenimports = ['pyexcel_xls', 'pyexcel_xls.xlsr', 'pyexcel_xls.xlsw'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_xlsx.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_xlsx.py new file mode 100644 index 0000000..438aab6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_xlsx.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-xlsx 0.4.2: +# https://github.com/pyexcel/pyexcel-xlsx + +hiddenimports = ['pyexcel_xlsx', 'pyexcel_xlsx.xlsxr', 'pyexcel_xlsx.xlsxw'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_xlsxw.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_xlsxw.py new file mode 100644 index 0000000..72f7593 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_xlsxw.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with pyexcel-xlsxw 0.4.2: +# https://github.com/pyexcel/pyexcel-xlsxw + +hiddenimports = ['pyexcel_xlsxw', 'pyexcel_xlsxw.xlsxw'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcelerate.Writer.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcelerate.Writer.py new file mode 100644 index 0000000..ff9dbc8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyexcelerate.Writer.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('pyexcelerate') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pygraphviz.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pygraphviz.py new file mode 100644 index 0000000..7a6028f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pygraphviz.py @@ -0,0 +1,145 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +import os +import pathlib +import shutil + +from PyInstaller import compat +from PyInstaller.depend import bindepend +from PyInstaller.utils.hooks import logger + + +def _collect_graphviz_files(): + binaries = [] + datas = [] + + # A working `pygraphviz` installation requires graphviz programs in PATH. Attempt to resolve the `dot` executable to + # see if this is the case. + dot_binary = shutil.which('dot') + if not dot_binary: + logger.warning( + "hook-pygraphviz: 'dot' program not found in PATH!" + ) + return binaries, datas + logger.info("hook-pygraphviz: found 'dot' program: %r", dot_binary) + bin_dir = pathlib.Path(dot_binary).parent + + # Collect graphviz programs that might be called from `pygaphviz.agraph.AGraph`: + # https://github.com/pygraphviz/pygraphviz/blob/pygraphviz-1.14/pygraphviz/agraph.py#L1330-L1348 + # On macOS and on Linux, several of these are symbolic links to a single executable. + progs = ( + "neato", + "dot", + "twopi", + "circo", + "fdp", + "nop", + "osage", + "patchwork", + "gc", + "acyclic", + "gvpr", + "gvcolor", + "ccomps", + "sccmap", + "tred", + "sfdp", + "unflatten", + ) + + logger.debug("hook-pygraphviz: collecting graphviz program executables...") + for program_name in progs: + program_binary = shutil.which(program_name) + if not program_binary: + logger.debug("hook-pygaphviz: graphviz program %r not found!", program_name) + continue + + # Ensure that the program executable was found in the same directory as the `dot` executable. This should + # prevent us from falling back to other graphviz installations that happen to be in PATH. + if pathlib.Path(program_binary).parent != bin_dir: + logger.debug( + "hook-pygraphviz: found program %r (%r) outside of directory %r - ignoring!", + program_name, program_binary, str(bin_dir) + ) + continue + + logger.debug("hook-pygraphviz: collecting graphviz program %r: %r", program_name, program_binary) + binaries += [(program_binary, '.')] + + # Graphviz shared libraries should be automatically collected when PyInstaller performs binary dependency + # analysis of the collected program executables as part of the main build process. However, we need to manually + # collect plugins and their accompanying config file. + logger.debug("hook-pygraphviz: looking for graphviz plugin directory...") + if compat.is_win: + # Under Windows, we have several installation variants: + # - official installers and builds from https://gitlab.com/graphviz/graphviz/-/releases + # - chocolatey + # - msys2 + # - Anaconda + # In all variants, the plugins and the config file are located in the `bin` directory, next to the program + # executables. + plugin_dir = bin_dir + plugin_dest_dir = '.' # Collect into top-level application directory. + # Official builds and Anaconda use unversioned `gvplugin-{name}.dll` plugin names, while msys2 uses + # versioned `libgvplugin-{name}-{version}.dll` plugin names (with "lib" prefix). + plugin_pattern = '*gvplugin*.dll' + else: + # Perform binary dependency analysis on the `dot` executable to obtain the path to graphiz shared libraries. + # These need to be in the library search path for the programs to work, or discoverable via run-paths + # (e.g., Anaconda on Linux and macOS, Homebrew on macOS). + graphviz_lib_candidates = ['cdt', 'gvc', 'cgraph'] + + if hasattr(bindepend, 'get_imports'): + # PyInstaller >= 6.0 + dot_imports = [path for name, path in bindepend.get_imports(dot_binary) if path is not None] + else: + # PyInstaller < 6.0 + dot_imports = bindepend.getImports(dot_binary) + + graphviz_lib_paths = [ + path for path in dot_imports + if any(candidate in os.path.basename(path) for candidate in graphviz_lib_candidates) + ] + + if not graphviz_lib_paths: + logger.warning("hook-pygraphviz: could not determine location of graphviz shared libraries!") + return binaries, datas + + graphviz_lib_dir = pathlib.Path(graphviz_lib_paths[0]).parent + logger.debug("hook-pygraphviz: location of graphviz shared libraries: %r", str(graphviz_lib_dir)) + + # Plugins should be located in `graphviz` directory next to shared libraries. + plugin_dir = graphviz_lib_dir / 'graphviz' + plugin_dest_dir = 'graphviz' # Collect into graphviz sub-directory. + + if compat.is_darwin: + plugin_pattern = '*gvplugin*.dylib' + else: + # Collect only versioned .so library files (for example, `/lib64/graphviz/libgvplugin_core.so.6` and + # `/lib64/graphviz/libgvplugin_core.so.6.0.0`; the former usually being a symbolic link to the latter). + # The unversioned .so library files (such as `lib64/graphviz/libgvplugin_core.so`), if available, are + # meant for linking (and are usually installed as part of development package). + plugin_pattern = '*gvplugin*.so.*' + + if not plugin_dir.is_dir(): + logger.warning("hook-pygraphviz: could not determine location of graphviz plugins!") + return binaries, datas + + logger.info("hook-pygraphviz: collecting graphviz plugins from directory: %r", str(plugin_dir)) + + binaries += [(str(file), plugin_dest_dir) for file in plugin_dir.glob(plugin_pattern)] + datas += [(str(file), plugin_dest_dir) for file in plugin_dir.glob("config*")] # e.g., `config6` + + return binaries, datas + + +binaries, datas = _collect_graphviz_files() diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pygwalker.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pygwalker.py new file mode 100644 index 0000000..9e78db1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pygwalker.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('pygwalker') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pylibmagic.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pylibmagic.py new file mode 100644 index 0000000..5fb8024 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pylibmagic.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Pylibmagic contains data files (libmagic compiled and configurations) required to use the python-magic package. +""" + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("pylibmagic") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pylint.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pylint.py new file mode 100644 index 0000000..3e2e804 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pylint.py @@ -0,0 +1,75 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# ************************************************* +# hook-pylint.py - PyInstaller hook file for pylint +# ************************************************* +# The pylint package, in __pkginfo__.py, is version 1.4.3. Looking at its +# source: +# +# From checkers/__init__.py, starting at line 122:: +# +# def initialize(linter): +# """initialize linter with checkers in this package """ +# register_plugins(linter, __path__[0]) +# +# From reporters/__init__.py, starting at line 131:: +# +# def initialize(linter): +# """initialize linter with reporters in this package """ +# utils.register_plugins(linter, __path__[0]) +# +# From utils.py, starting at line 881:: +# +# def register_plugins(linter, directory): +# """load all module and package in the given directory, looking for a +# 'register' function in each one, used to register pylint checkers +# """ +# imported = {} +# for filename in os.listdir(directory): +# base, extension = splitext(filename) +# if base in imported or base == '__pycache__': +# continue +# if extension in PY_EXTS and base != '__init__' or ( +# not extension and isdir(join(directory, base))): +# try: +# module = load_module_from_file(join(directory, filename)) +# +# +# So, we need all the Python source in the ``checkers/`` and ``reporters/`` +# subdirectories, since these are run-time discovered and loaded. Therefore, +# these files are all data files. In addition, since this is a module, the +# pylint/__init__.py file must be included, since submodules must be children of +# a module. + +from PyInstaller.utils.hooks import ( + collect_data_files, collect_submodules, is_module_or_submodule, get_module_file_attribute +) + +datas = ( + [(get_module_file_attribute('pylint.__init__'), 'pylint')] + + collect_data_files('pylint.checkers', True) + + collect_data_files('pylint.reporters', True) +) + + +# Add imports from dynamically loaded modules, excluding pylint.test +# subpackage (pylint <= 2.3) and pylint.testutils submodule (pylint < 2.7) +# or subpackage (pylint >= 2.7) +def _filter_func(name): + return ( + not is_module_or_submodule(name, 'pylint.test') and + not is_module_or_submodule(name, 'pylint.testutils') + ) + + +hiddenimports = collect_submodules('pylint', _filter_func) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pylsl.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pylsl.py new file mode 100644 index 0000000..f3c7960 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pylsl.py @@ -0,0 +1,42 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os +from PyInstaller.utils.hooks import logger, isolated + + +def find_library(): + # Try importing pylsl - this will fail if the shared library is unavailable. + try: + import pylsl # noqa: F401 + except Exception: + return None + + # Return the path to shared library that is used by pylsl. + try: + from pylsl.lib import lib as cdll # pylsl >= 0.17.0 + except ImportError: + from pylsl.pylsl import lib as cdll # older versions + + return cdll._name + + +# whenever a hook needs to load a 3rd party library, it needs to be done in an isolated subprocess +libfile = isolated.call(find_library) + +if libfile: + # add the liblsl library to the binaries + # it gets packaged in pylsl/lib, which is where pylsl will look first + binaries = [(libfile, os.path.join('pylsl', 'lib'))] +else: + logger.warning("liblsl shared library not found - pylsl will likely fail to work!") + binaries = [] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pymediainfo.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pymediainfo.py new file mode 100644 index 0000000..6b39abc --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pymediainfo.py @@ -0,0 +1,44 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.compat import is_win, is_darwin +from PyInstaller.utils.hooks import collect_dynamic_libs, logger + +# Collect bundled mediainfo shared library (available in Windows and macOS wheels on PyPI). +binaries = collect_dynamic_libs("pymediainfo") + +# On linux, no wheels are available, and pymediainfo uses system shared library. +if not binaries and not (is_win or is_darwin): + + def _find_system_mediainfo_library(): + import os + import ctypes.util + from PyInstaller.depend.utils import _resolveCtypesImports + + libname = ctypes.util.find_library("mediainfo") + if libname is not None: + resolved_binary = _resolveCtypesImports([os.path.basename(libname)]) + if resolved_binary: + return resolved_binary[0][1] + + try: + mediainfo_lib = _find_system_mediainfo_library() + except Exception as e: + logger.warning("Error while trying to find system-installed MediaInfo library: %s", e) + mediainfo_lib = None + + if mediainfo_lib: + # Put the library into pymediainfo sub-directory, to keep layout consistent with that of wheels. + binaries += [(mediainfo_lib, 'pymediainfo')] + +if not binaries: + logger.warning("MediaInfo shared library not found - pymediainfo will likely fail to work!") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pymorphy3.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pymorphy3.py new file mode 100644 index 0000000..7282272 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pymorphy3.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import can_import_module, copy_metadata, collect_data_files + +datas = copy_metadata('pymorphy3_dicts_ru') +datas += collect_data_files('pymorphy3_dicts_ru') + +hiddenimports = ['pymorphy3_dicts_ru'] + +# Check if the Ukrainian model is installed +if can_import_module('pymorphy3_dicts_uk'): + datas += copy_metadata('pymorphy3_dicts_uk') + datas += collect_data_files('pymorphy3_dicts_uk') + + hiddenimports += ['pymorphy3_dicts_uk'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pymssql.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pymssql.py new file mode 100644 index 0000000..f3a3c96 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pymssql.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020-2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies + +hiddenimports = ["decimal"] +# In newer versions of pymssql, the _mssql was under pymssql +if is_module_satisfies("pymssql > 2.1.5"): + hiddenimports += ["pymssql._mssql", "uuid"] +else: + hiddenimports += ["_mssql"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pynng.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pynng.py new file mode 100644 index 0000000..f3b7499 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pynng.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for https://pypi.org/project/pynng/ +""" + +hiddenimports = ['_cffi_backend'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pynput.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pynput.py new file mode 100644 index 0000000..0776e1d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pynput.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules("pynput") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyodbc.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyodbc.py new file mode 100644 index 0000000..bfa2f42 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyodbc.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import get_pyextension_imports + +# It's hard to detect imports of binary Python module without importing it. +# Let's try importing that module in a subprocess. +# TODO function get_pyextension_imports() is experimental and we need +# to evaluate its usage here and its suitability for other hooks. +hiddenimports = get_pyextension_imports('pyodbc') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyopencl.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyopencl.py new file mode 100644 index 0000000..9646426 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyopencl.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for the pyopencl module: https://github.com/pyopencl/pyopencl + +from PyInstaller.utils.hooks import copy_metadata, collect_data_files + +datas = copy_metadata('pyopencl') +datas += collect_data_files('pyopencl') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypdfium2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypdfium2.py new file mode 100644 index 0000000..1005a8b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypdfium2.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# Collect `version.json`. +datas = collect_data_files("pypdfium2") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypdfium2_raw.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypdfium2_raw.py new file mode 100644 index 0000000..01a349d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypdfium2_raw.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_dynamic_libs, collect_data_files + +# Collect the bundled pdfium shared library. +binaries = collect_dynamic_libs('pypdfium2_raw') + +# Collect `version.json`. +datas = collect_data_files("pypdfium2_raw") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypemicro.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypemicro.py new file mode 100644 index 0000000..7a6e873 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypemicro.py @@ -0,0 +1,43 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for the pypemicro module: https://github.com/nxpmicro/pypemicro + +import os +from PyInstaller.utils.hooks import get_package_paths, is_module_satisfies +from PyInstaller.log import logger +from PyInstaller.compat import is_darwin + +binaries = list() +if is_module_satisfies('pyinstaller >= 5.0'): + from PyInstaller import isolated + + @isolated.decorate + def get_safe_libs(): + from pypemicro import PyPemicro + libs = PyPemicro.get_pemicro_lib_list() + return libs + + pkg_base, pkg_dir = get_package_paths("pypemicro") + for lib in get_safe_libs(): + source_path = lib['path'] + source_name = lib['name'] + dest = os.path.relpath(source_path, pkg_base) + binaries.append((os.path.join(source_path, source_name), dest)) + if is_darwin: + libusb = os.path.join(source_path, 'libusb.dylib') + if os.path.exists(libusb): + binaries.append((libusb, dest)) + else: + logger.warning("libusb.dylib was not found for Mac OS, ignored") +else: + logger.warning("hook-pypemicro requires pyinstaller >= 5.0") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyphen.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyphen.py new file mode 100644 index 0000000..9f0be6f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyphen.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('pyphen') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyppeteer.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyppeteer.py new file mode 100644 index 0000000..8c15c18 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyppeteer.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +# pyppeteer uses importlib.metadata to query its own version. +datas = copy_metadata("pyppeteer") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyproj.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyproj.py new file mode 100644 index 0000000..83390ef --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyproj.py @@ -0,0 +1,72 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os +import sys +from PyInstaller.utils.hooks import collect_data_files, is_module_satisfies, copy_metadata +from PyInstaller.compat import is_win + +hiddenimports = [ + "pyproj.datadir" +] + +binaries = [] + +# Versions prior to 2.3.0 also require pyproj._datadir +if not is_module_satisfies("pyproj >= 2.3.0"): + hiddenimports += ["pyproj._datadir"] + +# Starting with version 3.0.0, pyproj._compat is needed +if is_module_satisfies("pyproj >= 3.0.0"): + hiddenimports += ["pyproj._compat"] + # Linux and macOS also require distutils. + if not is_win: + hiddenimports += ["distutils.util"] + +# Data collection +datas = collect_data_files('pyproj') + +# Repackagers may de-vendor the proj data directory (Conda, Debian) +if not any(dest.startswith("pyproj/proj_dir") for (_, dest) in datas): + if hasattr(sys, 'real_prefix'): # check if in a virtual environment + root_path = sys.real_prefix + else: + root_path = sys.prefix + + if is_win: + tgt_proj_data = os.path.join('Library', 'share', 'proj') + src_proj_data = os.path.join(root_path, 'Library', 'share', 'proj') + + else: # both linux and darwin + tgt_proj_data = os.path.join('share', 'proj') + src_proj_data = os.path.join(root_path, 'share', 'proj') + + if os.path.exists(src_proj_data): + datas.append((src_proj_data, tgt_proj_data)) + # A runtime hook defines the path for `PROJ_LIB` + else: + from PyInstaller.utils.hooks import logger + logger.warning("Datas for pyproj not found at:\n{}".format(src_proj_data)) + +# With pyproj 3.4.0, we need to collect package's metadata due to `importlib.metadata.version(__package__)` call in +# `__init__.py`. This change was reverted in subsequent releases of pyproj, so we collect metadata only for 3.4.0. +if is_module_satisfies("pyproj == 3.4.0"): + datas += copy_metadata("pyproj") + +# pyproj 3.4.0 was also the first release that used `delvewheel` for its Windows PyPI wheels. While contemporary +# PyInstaller versions automatically pick up DLLs from external `pyproj.libs` directory, this does not work on Anaconda +# python 3.8 and 3.9 due to defunct `os.add_dll_directory`, which forces `delvewheel` to use the old load-order file +# approach. So we need to explicitly ensure that load-order file as well as DLLs are collected. +if is_win and is_module_satisfies("pyproj >= 3.4.0"): + if is_module_satisfies("PyInstaller >= 5.6"): + from PyInstaller.utils.hooks import collect_delvewheel_libs_directory + datas, binaries = collect_delvewheel_libs_directory("pyproj", datas=datas, binaries=binaries) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypsexec.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypsexec.py new file mode 100644 index 0000000..c96a56e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypsexec.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# The bundled paexec.exe file needs to be collected (as data file; on any platform) +# because it is deployed to the remote side during execution. + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('pypsexec') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypylon.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypylon.py new file mode 100644 index 0000000..395aaf9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pypylon.py @@ -0,0 +1,48 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# PyPylon is a tricky library to bundle. It encapsulates the pylon C++ SDK inside +# it with modified library references to make the module relocatable. +# PyInstaller is able to find those libraries and preserve the linkage for almost +# all of them. However - there is an additional linking step happening at runtime, +# when the library is creating the transport layer for the camera. This linking +# will fail with the library files modified by pyinstaller. +# As the module is already relocatable, we circumvent this issue by bundling +# pypylon as-is - for pyinstaller we treat the shared library files as just data. + +import os + +from PyInstaller.utils.hooks import ( + collect_data_files, + collect_dynamic_libs, + is_module_satisfies +) + +# Collect dynamic libs as data (to prevent pyinstaller from modifying them). +# NOTE: under PyInstaller 6.x, these files end up re-classified as binaries anyway. +datas = collect_dynamic_libs('pypylon') + +# Collect data files, looking for pypylon/pylonCXP/bin/ProducerCXP.cti, but other files may also be needed +datas += collect_data_files('pypylon') + +# NOTE: the part below is incompatible with PyInstaller 6.x, because `collect_data_files(..., include_py_files=True)` +# does not include binary extensions anymore. In addition, `pyinstaller/pyinstaller@ecc218c` in PyInstaller 6.2 fixed +# the module exclusion for relative imports, so the modules listed below actually end up excluded. Presumably this +# part was necessary with older PyInstaller versions, so we keep it around, but disable it for PyInstaller >= 6.0. +if is_module_satisfies('PyInstaller < 6.0'): + # Exclude the C++-extensions from automatic search, add them manually as data files + # their dependencies were already handled with collect_dynamic_libs + excludedimports = ['pypylon._pylon', 'pypylon._genicam'] + for filename, module in collect_data_files('pypylon', include_py_files=True): + if (os.path.basename(filename).startswith('_pylon.') + or os.path.basename(filename).startswith('_genicam.')): + datas += [(filename, module)] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyqtgraph.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyqtgraph.py new file mode 100644 index 0000000..0d8bf9c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyqtgraph.py @@ -0,0 +1,56 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +# Collect all data files, excluding the examples' data +datas = collect_data_files('pyqtgraph', excludes=['**/examples/*']) + +# pyqtgraph uses Qt-version-specific templates for the UI elements. +# There are templates for different versions of PySide and PyQt, e.g. +# +# - pyqtgraph.graphicsItems.ViewBox.axisCtrlTemplate_pyqt5 +# - pyqtgraph.graphicsItems.ViewBox.axisCtrlTemplate_pyqt6 +# - pyqtgraph.graphicsItems.ViewBox.axisCtrlTemplate_pyside2 +# - pyqtgraph.graphicsItems.ViewBox.axisCtrlTemplate_pyside6 +# - pyqtgraph.graphicsItems.PlotItem.plotConfigTemplate_pyqt5 +# - pyqtgraph.graphicsItems.PlotItem.plotConfigTemplate_pyqt6 +# - pyqtgraph.graphicsItems.PlotItem.plotConfigTemplate_pyside2 +# - pyqtgraph.graphicsItems.PlotItem.plotConfigTemplate_pyside6 +# +# To be future-proof, we collect all modules by +# using collect-submodules, and filtering the modules +# which appear to be templates. +# We need to avoid recursing into `pyqtgraph.examples`, because that +# triggers instantiation of `QApplication` (which requires X/Wayland +# session on linux). +# Tested with pyqtgraph master branch (commit c1900aa). +all_imports = collect_submodules("pyqtgraph", filter=lambda name: name != "pyqtgraph.examples") +hiddenimports = [name for name in all_imports if "Template" in name] + +# Collect the pyqtgraph/multiprocess/bootstrap.py as a module; this is required by our pyqtgraph.multiprocess runtime +# hook to handle the pyqtgraph's multiprocessing implementation. The pyqtgraph.multiprocess seems to be imported +# automatically on the import of pyqtgraph itself, so there is no point in creating a separate hook for this. +hiddenimports += ['pyqtgraph.multiprocess.bootstrap'] + +# Attempt to auto-select applicable Qt bindings and exclude extraneous Qt bindings. +# Available in PyInstaller >= 6.5, which has `PyInstaller.utils.hooks.qt.exclude_extraneous_qt_bindings` helper. +try: + from PyInstaller.utils.hooks.qt import exclude_extraneous_qt_bindings +except ImportError: + pass +else: + # Use the helper's default preference order, to keep it consistent across multiple hooks that use the same helper. + excludedimports = exclude_extraneous_qt_bindings( + hook_name="hook-pyqtgraph", + qt_bindings_order=None, + ) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyshark.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyshark.py new file mode 100644 index 0000000..46aae20 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyshark.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Python wrapper for pyshark(https://pypi.org/project/pyshark/) +# Tested with version 0.4.5 + +from PyInstaller.utils.hooks import collect_data_files, is_module_satisfies + +hiddenimports = ['pyshark.config'] + +if is_module_satisfies("pyshark < 0.6"): + hiddenimports += ['py._path.local', 'py._vendored_packages.iniconfig'] + if is_module_satisfies("pyshark >= 0.5"): + hiddenimports += ["py._io.terminalwriter", "py._builtin"] + +datas = collect_data_files('pyshark') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pysnmp.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pysnmp.py new file mode 100644 index 0000000..5824b58 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pysnmp.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules, collect_data_files + +hiddenimports = collect_submodules('pysnmp.smi.mibs') +datas = collect_data_files('pysnmp.smi.mibs', include_py_files=True) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pystray.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pystray.py new file mode 100644 index 0000000..835b0be --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pystray.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules +# https://github.com/moses-palmer/pystray/tree/feature-explicit-backends +# if this get merged then we don't need this hook +hiddenimports = collect_submodules("pystray") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pytest.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pytest.py new file mode 100644 index 0000000..080d2e7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pytest.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for http://pypi.python.org/pypi/pytest/ +""" + +import pytest + +hiddenimports = pytest.freeze_includes() diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pythainlp.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pythainlp.py new file mode 100644 index 0000000..d5bdcc5 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pythainlp.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('pythainlp') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pythoncom.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pythoncom.py new file mode 100644 index 0000000..05b0c1d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pythoncom.py @@ -0,0 +1,31 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# pywin32 supports frozen mode; in that mode, it is looking at sys.path for pythoncomXY.dll. However, as of +# PyInstaller 5.4, we may collect that DLL into its original pywin32_system32 sub-directory as part of the +# binary dependency analysis (and add it to sys.path by means of a runtime hook). + +import pathlib + +from PyInstaller.utils.hooks import is_module_satisfies, get_pywin32_module_file_attribute + +dll_filename = get_pywin32_module_file_attribute('pythoncom') +dst_dir = '.' # Top-level application directory + +if is_module_satisfies('PyInstaller >= 5.4'): + # Try preserving the original pywin32_system directory, if applicable (it is not applicable in Anaconda, + # where the DLL is located in Library/bin). + dll_path = pathlib.Path(dll_filename) + if dll_path.parent.name == 'pywin32_system32': + dst_dir = 'pywin32_system32' + +binaries = [(dll_filename, dst_dir)] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyttsx.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyttsx.py new file mode 100644 index 0000000..36fceb2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyttsx.py @@ -0,0 +1,23 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +pyttsx imports drivers module based on specific platform. +Found at http://mrmekon.tumblr.com/post/5272210442/pyinstaller-and-pyttsx +""" + +hiddenimports = [ + 'drivers', + 'drivers.dummy', + 'drivers.espeak', + 'drivers.nsss', + 'drivers.sapi5', +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyttsx3.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyttsx3.py new file mode 100644 index 0000000..ac3edf8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyttsx3.py @@ -0,0 +1,30 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# pyttsx3 conditionally imports drivers module based on specific platform. +# https://github.com/nateshmbhat/pyttsx3/blob/5a19376a94fdef6bfaef8795539e755b1f363fbf/pyttsx3/driver.py#L40-L50 + +import sys + +hiddenimports = ["pyttsx3.drivers", "pyttsx3.drivers.dummy"] + +# Take directly from the link above. +if sys.platform == 'darwin': + driverName = 'nsss' +elif sys.platform == 'win32': + driverName = 'sapi5' +else: + driverName = 'espeak' +# import driver module +name = 'pyttsx3.drivers.%s' % driverName + +hiddenimports.append(name) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyviz_comms.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyviz_comms.py new file mode 100644 index 0000000..5a882c9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyviz_comms.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("pyviz_comms") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyvjoy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyvjoy.py new file mode 100644 index 0000000..d72e13e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pyvjoy.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import collect_dynamic_libs + +binaries = collect_dynamic_libs("pyvjoy") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pywintypes.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pywintypes.py new file mode 100644 index 0000000..b452e93 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pywintypes.py @@ -0,0 +1,31 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# pywin32 supports frozen mode; in that mode, it is looking at sys.path for pywintypesXY.dll. However, as of +# PyInstaller 5.4, we may collect that DLL into its original pywin32_system32 sub-directory as part of the +# binary dependency analysis (and add it to sys.path by means of a runtime hook). + +import pathlib + +from PyInstaller.utils.hooks import is_module_satisfies, get_pywin32_module_file_attribute + +dll_filename = get_pywin32_module_file_attribute('pywintypes') +dst_dir = '.' # Top-level application directory + +if is_module_satisfies('PyInstaller >= 5.4'): + # Try preserving the original pywin32_system directory, if applicable (it is not applicable in Anaconda, + # where the DLL is located in Library/bin). + dll_path = pathlib.Path(dll_filename) + if dll_path.parent.name == 'pywin32_system32': + dst_dir = 'pywin32_system32' + +binaries = [(dll_filename, dst_dir)] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pywt.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pywt.py new file mode 100644 index 0000000..e1b5f36 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-pywt.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for https://github.com/PyWavelets/pywt + +hiddenimports = ['pywt._extensions._cwt'] + +# NOTE: There is another project `https://github.com/Knapstad/pywt installing +# a packagre `pywt`, too. This name clash is not much of a problem, even if +# this hook is picked up for the other package, since PyInstaller will simply +# skip any module added by this hook but acutally missing. If the other project +# requires a hook, too, simply add it to this file. diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-qtmodern.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-qtmodern.py new file mode 100644 index 0000000..2adb2b7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-qtmodern.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("qtmodern", includes=["**/*.qss"]) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-radicale.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-radicale.py new file mode 100644 index 0000000..56b487a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-radicale.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata, collect_data_files + +datas = copy_metadata('radicale') +datas += collect_data_files('radicale') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-raven.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-raven.py new file mode 100644 index 0000000..fe6f8e6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-raven.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['raven.events', 'raven.processors'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rawpy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rawpy.py new file mode 100644 index 0000000..7daf325 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rawpy.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Python wrapper for LibRaw (https://pypi.python.org/pypi/rawpy) +# Tested with version 0.3.5 + +hiddenimports = ['numpy', 'enum'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rdflib.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rdflib.py new file mode 100644 index 0000000..7fc6631 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rdflib.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('rdflib.plugins') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-redmine.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-redmine.py new file mode 100644 index 0000000..1291095 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-redmine.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['redmine.resources'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-regex.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-regex.py new file mode 100644 index 0000000..e55764e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-regex.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['warnings'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-reportlab.lib.utils.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-reportlab.lib.utils.py new file mode 100644 index 0000000..eb3ce68 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-reportlab.lib.utils.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Needed for ReportLab 3 +hiddenimports = [ + 'reportlab.rl_settings', +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-reportlab.pdfbase._fontdata.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-reportlab.pdfbase._fontdata.py new file mode 100644 index 0000000..e4e8e9a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-reportlab.pdfbase._fontdata.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +# Tested on Windows 7 x64 with Python 2.7.6 x32 using ReportLab 3.0 +# This has been observed to *not* work on ReportLab 2.7 +hiddenimports = collect_submodules('reportlab.pdfbase', + lambda name: name.startswith('reportlab.pdfbase._fontdata_')) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-resampy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-resampy.py new file mode 100644 index 0000000..8b45d2c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-resampy.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for resampy +from PyInstaller.utils.hooks import collect_data_files + +# resampy has two data files that need to be included. +datas = collect_data_files('resampy', False) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rlp.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rlp.py new file mode 100644 index 0000000..c59c1b6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rlp.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, copy_metadata + +# Starting with v4.0.0, `rlp` queries its version from metadata. +if is_module_satisfies("rlp >= 4.0.0"): + datas = copy_metadata('rlp') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rpy2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rpy2.py new file mode 100644 index 0000000..f37c2b6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rpy2.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = [ + "rpy2", + "rpy2.robjects", + "rpy2.robjects.packages", + "rpy2.situation", +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rtree.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rtree.py new file mode 100644 index 0000000..67899d3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rtree.py @@ -0,0 +1,46 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import pathlib + +from PyInstaller import compat +from PyInstaller.utils.hooks import collect_dynamic_libs, get_installer, get_package_paths + + +# Query the installer of the `rtree` package; in PyInstaller prior to 6.0, this might raise an exception, whereas in +# later versions, None is returned. +try: + package_installer = get_installer('rtree') +except Exception: + package_installer = None + +if package_installer == 'conda': + from PyInstaller.utils.hooks import conda + + # In Anaconda-packaged `rtree`, `libspatialindex` and `libspatialindex_c` shared libs are packaged in a separate + # `libspatialindex` package. Collect the libraries into `rtree/lib` sub-directory to simulate PyPI wheel layout. + binaries = conda.collect_dynamic_libs('libspatialindex', dest='rtree/lib', dependencies=False) +else: + # pip-installed package. The shared libs are usually placed in `rtree/lib` directory. + binaries = collect_dynamic_libs('rtree') + + # With rtree >= 1.1.0, Linux PyPI wheels place the shared library in a `Rtree.libs` top-level directory. + # In rtree 1.4.0, the directory was renamed to `rtree.libs` + if compat.is_linux: + _, rtree_dir = get_package_paths('rtree') + for candidate_dir_name in ('rtree.libs', 'Rtree.libs'): + rtree_libs_dir = pathlib.Path(rtree_dir).parent / candidate_dir_name + if not rtree_libs_dir.is_dir(): + continue + binaries += [ + (str(lib_file), candidate_dir_name) for lib_file in rtree_libs_dir.glob("libspatialindex*.so*") + ] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ruamel.yaml.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ruamel.yaml.py new file mode 100644 index 0000000..23339e9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ruamel.yaml.py @@ -0,0 +1,39 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# `ruamel.yaml` offers several optional plugins that can be installed via additional packages +# (e.g., `runamel.yaml.string`). Unfortunately, the discovery of these plugins is predicated on their `__plug_in__.py` +# files being visible on filesystem. +# See: https://sourceforge.net/p/ruamel-yaml/code/ci/0bef9fa8b3c43637cd90ce3f2e299e81c2122128/tree/main.py#l757 + +import pathlib + +from PyInstaller.utils.hooks import get_module_file_attribute, logger + +ruamel_path = pathlib.Path(get_module_file_attribute('ruamel.yaml')).parent + +plugin_files = ruamel_path.glob('*/__plug_in__.py') +plugin_names = [plugin_file.parent.name for plugin_file in plugin_files] +logger.debug("hook-ruamel.yaml: found plugins: %r", plugin_names) + +# Add `__plug_in__` modules to hiddenimports to ensure they are collected and scanned for imports. This also implicitly +# collects the plugin's `__init__` module. +plugin_modules = [f"ruamel.yaml.{plugin_name}.__plug_in__" for plugin_name in plugin_names] + +hiddenimports = plugin_modules + +# Collect the plugins' `__plug_in__` modules both as byte-compiled .pyc in PYZ archive (to be actually loaded) and +# source .py file (which allows plugin to be discovered). +module_collection_mode = { + plugin_module: "pyz+py" + for plugin_module in plugin_modules +} diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rubicon.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rubicon.py new file mode 100644 index 0000000..68116a1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-rubicon.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Prevent this package from pulling `setuptools_scm` into frozen application, as it makes no sense in that context. +excludedimports = ["setuptools_scm"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sacremoses.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sacremoses.py new file mode 100644 index 0000000..23b00db --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sacremoses.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('sacremoses') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sam2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sam2.py new file mode 100644 index 0000000..321da39 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sam2.py @@ -0,0 +1,30 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for Segment Anything Model 2 (SAM 2): https://pypi.org/project/sam2 + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +# Collect config .yaml files. +datas = collect_data_files('sam2') + +# Ensure that all indirectly-imported modules are collected (e.g., `sam2.modeling.backbones`). +hiddenimports = collect_submodules('sam2') + +# Due to use of `torch.script`, we need to collect source .py files for `sam2`. The `sam2/__init__.py` also seems to be +# required by `hydra`. Furthermore, the source-based introspection attempts to load the source of stdlib `enum` module. +# The module collection mode support and run-time discovery of source .py files for modules that are collected into +# `base_library.zip` archive was added in pyinstaller/pyinstaller#8971 (i.e., PyInstaller > 6.11.1). +module_collection_mode = { + 'sam2': 'pyz+py', + 'enum': 'pyz+py', # requires PyInstaller > 6.11.1; no-op in earlier versions +} diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-saml2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-saml2.py new file mode 100644 index 0000000..244944a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-saml2.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for https://github.com/IdentityPython/pysaml2 +from PyInstaller.utils.hooks import collect_data_files, copy_metadata, collect_submodules + +datas = copy_metadata("pysaml2") + +# The library contains a bunch of XSD schemas that are loaded by the code: +# https://github.com/IdentityPython/pysaml2/blob/7cb4f09dce87a7e8098b9c7552ebab8bc77bc896/src/saml2/xml/schema/__init__.py#L23 +# On the other hand, runtime tools are not needed. +datas += collect_data_files("saml2", excludes=["**/tools"]) + +# Submodules are loaded dynamically by: +# https://github.com/IdentityPython/pysaml2/blob/7cb4f09dce87a7e8098b9c7552ebab8bc77bc896/src/saml2/attribute_converter.py#L52 +hiddenimports = collect_submodules("saml2.attributemaps") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-schwifty.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-schwifty.py new file mode 100644 index 0000000..a8b30ca --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-schwifty.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata, collect_data_files + +datas = copy_metadata('schwifty') +datas += collect_data_files('schwifty') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-seedir.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-seedir.py new file mode 100644 index 0000000..28ed6b5 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-seedir.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('seedir') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-selectolax.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-selectolax.py new file mode 100644 index 0000000..53b3086 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-selectolax.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("selectolax") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-selenium.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-selenium.py new file mode 100644 index 0000000..13a312a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-selenium.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('selenium') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sentry_sdk.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sentry_sdk.py new file mode 100644 index 0000000..b7ee95c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sentry_sdk.py @@ -0,0 +1,40 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +import json +from PyInstaller.utils.hooks import exec_statement + +hiddenimports = ["sentry_sdk.integrations.stdlib", + "sentry_sdk.integrations.excepthook", + "sentry_sdk.integrations.dedupe", + "sentry_sdk.integrations.atexit", + "sentry_sdk.integrations.modules", + "sentry_sdk.integrations.argv", + "sentry_sdk.integrations.logging", + "sentry_sdk.integrations.threading"] + +statement = """ +import json +import sentry_sdk.integrations as si + +integrations = [] +if hasattr(si, '_AUTO_ENABLING_INTEGRATIONS'): + # _AUTO_ENABLING_INTEGRATIONS is a list of strings with default enabled integrations + # https://github.com/getsentry/sentry-python/blob/c6b6f2086b58ffc674df5c25a600b8a615079fb5/sentry_sdk/integrations/__init__.py#L54-L66 + + def make_integration_name(integration_name: str): + return integration_name.rsplit(".", maxsplit=1)[0] + + integrations.extend(map(make_integration_name, si._AUTO_ENABLING_INTEGRATIONS)) +print(json.dumps(integrations)) +""" + +hiddenimports.extend(json.loads(exec_statement(statement))) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-setuptools_scm.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-setuptools_scm.py new file mode 100644 index 0000000..8e22d91 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-setuptools_scm.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +# Ensure `metadata of setuptools` dist is collected, to avoid run-time warning about unknown/incompatible `setuptools` +# version. +datas = copy_metadata('setuptools') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-shapely.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-shapely.py new file mode 100644 index 0000000..6899367 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-shapely.py @@ -0,0 +1,105 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os +from ctypes.util import find_library + +from PyInstaller.utils.hooks import get_package_paths +from PyInstaller.utils.hooks import is_module_satisfies +from PyInstaller import compat + +# Necessary when using the vectorized subpackage +hiddenimports = ['shapely.prepared'] + +if is_module_satisfies('shapely >= 2.0.0'): + # An import made in the `shapely.geometry_helpers` extension; both `shapely.geometry_helpers` and `shapely._geos` + # extensions were introduced in v2.0.0. + hiddenimports += ['shapely._geos'] + +pkg_base, pkg_dir = get_package_paths('shapely') + +binaries = [] +datas = [] +if compat.is_win: + geos_c_dll_found = False + + # Search conda directory if conda is active, then search standard + # directory. This is the same order of precidence used in shapely. + standard_path = os.path.join(pkg_dir, 'DLLs') + lib_paths = [standard_path, os.environ['PATH']] + if compat.is_conda: + conda_path = os.path.join(compat.base_prefix, 'Library', 'bin') + lib_paths.insert(0, conda_path) + original_path = os.environ['PATH'] + try: + os.environ['PATH'] = os.pathsep.join(lib_paths) + dll_path = find_library('geos_c') or find_library('libgeos_c') + finally: + os.environ['PATH'] = original_path + if dll_path is not None: + binaries += [(dll_path, '.')] + geos_c_dll_found = True + + # Starting with shapely 1.8.1, the DLLs shipped with PyPI wheels are stored in + # site-packages/Shapely.libs instead of sub-directory in site-packages/shapely. + if is_module_satisfies("shapely >= 1.8.1"): + lib_dir = os.path.join(pkg_base, "Shapely.libs") + if os.path.isdir(lib_dir): + # We collect DLLs as data files instead of binaries to suppress binary + # analysis, which would result in duplicates (because it collects a copy + # into the top-level directory instead of preserving the original layout). + # In addition to DLls, this also collects .load-order* file (required on + # python < 3.8), and ensures that Shapely.libs directory exists (required + # on python >= 3.8 due to os.add_dll_directory call). + datas += [ + (os.path.join(lib_dir, lib_file), 'Shapely.libs') + for lib_file in os.listdir(lib_dir) + ] + + geos_c_dll_found |= any([ + os.path.basename(lib_file).startswith("geos_c") + for lib_file, _ in datas + ]) + + if not geos_c_dll_found: + raise SystemExit( + "Error: geos_c.dll not found, required by hook-shapely.py.\n" + "Please check your installation or provide a pull request to " + "PyInstaller to update hook-shapely.py.") +elif compat.is_linux and is_module_satisfies('shapely < 1.7'): + # This duplicates the libgeos*.so* files in the build. PyInstaller will + # copy them into the root of the build by default, but shapely cannot load + # them from there in linux IF shapely was installed via a whl file. The + # whl bundles its own libgeos with a different name, something like + # libgeos_c-*.so.* but shapely tries to load libgeos_c.so if there isn't a + # ./libs directory under its package. + # + # The fix for this (https://github.com/Toblerity/Shapely/pull/485) has + # been available in shapely since version 1.7. + lib_dir = os.path.join(pkg_dir, '.libs') + dest_dir = os.path.join('shapely', '.libs') + + binaries += [(os.path.join(lib_dir, f), dest_dir) for f in os.listdir(lib_dir)] +elif compat.is_darwin and is_module_satisfies('shapely >= 1.8.1'): + # In shapely 1.8.1, the libgeos_c library bundled in macOS PyPI wheels is not + # called libgeos.1.dylib anymore, but rather has a fullly-versioned name + # (e.g., libgeos_c.1.16.0.dylib). + # Shapely fails to find such a library unless it is located in the .dylibs + # directory. So we need to ensure that the libraries are collected into + # .dylibs directory; however, this will result in duplication due to binary + # analysis of the python extensions that are linked against these libraries + # as well (as that will copy the libraries to top-level directory). + lib_dir = os.path.join(pkg_dir, '.dylibs') + dest_dir = os.path.join('shapely', '.dylibs') + + if os.path.isdir(lib_dir): + binaries += [(os.path.join(lib_dir, f), dest_dir) for f in os.listdir(lib_dir)] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-shotgun_api3.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-shotgun_api3.py new file mode 100644 index 0000000..3ccf68a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-shotgun_api3.py @@ -0,0 +1,23 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# Shotgun is using "six" to import these and +# PyInstaller does not seem to catch them correctly. +hiddenimports = ["xmlrpc", "xmlrpc.client"] + +# Collect the following files: +# /shotgun_api3/lib/httplib2/python2/cacerts.txt +# /shotgun_api3/lib/httplib2/python3/cacerts.txt +# /shotgun_api3/lib/certifi/cacert.pem +datas = collect_data_files("shotgun_api3") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-simplemma.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-simplemma.py new file mode 100644 index 0000000..a233c66 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-simplemma.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('simplemma') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.color.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.color.py new file mode 100644 index 0000000..d79f3fd --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.color.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +# As of scikit-image 0.21.0, we need to collect the __init__.pyi file for `lazy_loader`, as well as collect submodules +# due to lazy loading. +if is_module_satisfies("scikit-image >= 0.21.0"): + datas = collect_data_files("skimage.color", includes=["*.pyi"]) + hiddenimports = collect_submodules('skimage.color', filter=lambda name: name != 'skimage.color.tests') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.data.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.data.py new file mode 100644 index 0000000..8f59def --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.data.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +# As of scikit-image 0.20.0, we need to collect the __init__.pyi file for `lazy_loader`, as well as collect submodules +# due to lazy loading. +if is_module_satisfies('scikit-image >= 0.20.0'): + datas = collect_data_files("skimage.data", includes=["*.pyi"]) + hiddenimports = collect_submodules('skimage.data', filter=lambda name: name != 'skimage.data.tests') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.draw.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.draw.py new file mode 100644 index 0000000..e52d351 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.draw.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +# As of scikit-image 0.21.0, we need to collect the __init__.pyi file for `lazy_loader`, as well as collect submodules +# due to lazy loading. +if is_module_satisfies("scikit-image >= 0.21.0"): + datas = collect_data_files("skimage.draw", includes=["*.pyi"]) + hiddenimports = collect_submodules('skimage.draw', filter=lambda name: name != 'skimage.draw.tests') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.exposure.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.exposure.py new file mode 100644 index 0000000..e737efb --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.exposure.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +# As of scikit-image 0.21.0, we need to collect the __init__.pyi file for `lazy_loader`, as well as collect submodules +# due to lazy loading. +if is_module_satisfies("scikit-image >= 0.21.0"): + datas = collect_data_files("skimage.exposure", includes=["*.pyi"]) + hiddenimports = collect_submodules('skimage.exposure', filter=lambda name: name != 'skimage.exposure.tests') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.feature.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.feature.py new file mode 100644 index 0000000..29d376d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.feature.py @@ -0,0 +1,26 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +# The following missing module prevents import of skimage.feature with skimage 0.17.x. +hiddenimports = ['skimage.feature._orb_descriptor_positions', ] + +# Collect the data file with ORB descriptor positions. In earlier versions of scikit-image, this file was in +# `skimage/data` directory, and it was moved to `skimage/feature` in v0.17.0. Collect if from wherever it is. +datas = collect_data_files('skimage', includes=['**/orb_descriptor_positions.txt']) + +# As of scikit-image 0.22.0, we need to collect the __init__.pyi file for `lazy_loader`, as well as collect submodules +# due to lazy loading. +if is_module_satisfies("scikit-image >= 0.22.0"): + datas += collect_data_files("skimage.feature", includes=["*.pyi"]) + hiddenimports = collect_submodules('skimage.feature', filter=lambda name: name != 'skimage.feature.tests') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.filters.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.filters.py new file mode 100644 index 0000000..e88726c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.filters.py @@ -0,0 +1,24 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +if is_module_satisfies("scikit-image >= 0.19.0"): + # In scikit-image 0.19.x, `skimage.filters` switched to lazy module loading, so we need to collect all submodules. + hiddenimports = collect_submodules('skimage.filters', filter=lambda name: name != 'skimage.filters.tests') + + # In scikit-image 0.20.0, `lazy_loader` is used, so we need to collect `__init__.pyi` file. + if is_module_satisfies("scikit-image >= 0.20.0"): + datas = collect_data_files("skimage.filters", includes=["*.pyi"]) +elif is_module_satisfies("scikit-image >= 0.18.0"): + # The following missing module prevents import of skimage.feature with skimage 0.18.x. + hiddenimports = ['skimage.filters.rank.core_cy_3d', ] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.future.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.future.py new file mode 100644 index 0000000..41905d4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.future.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +# As of scikit-image 0.21.0, we need to collect the __init__.pyi file for `lazy_loader`, as well as collect submodules +# due to lazy loading. +if is_module_satisfies("scikit-image >= 0.21.0"): + datas = collect_data_files("skimage.future", includes=["*.pyi"]) + hiddenimports = collect_submodules('skimage.future', filter=lambda name: name != 'skimage.future.tests') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.graph.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.graph.py new file mode 100644 index 0000000..2caffd4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.graph.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +# The following missing module prevents import of skimage.graph with skimage 0.17.x. +hiddenimports = ['skimage.graph.heap', ] + +# As of scikit-image 0.22.0, we need to collect the __init__.pyi file for `lazy_loader`, as well as collect submodules +# due to lazy loading. +if is_module_satisfies("scikit-image >= 0.22.0"): + datas = collect_data_files("skimage.graph", includes=["*.pyi"]) + hiddenimports = collect_submodules('skimage.graph', filter=lambda name: name != 'skimage.graph.tests') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.io.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.io.py new file mode 100644 index 0000000..45d6663 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.io.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# This hook was tested with scikit-image (skimage) 0.14.1: +# https://scikit-image.org + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +datas = collect_data_files("skimage.io._plugins") +hiddenimports = collect_submodules('skimage.io._plugins') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.measure.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.measure.py new file mode 100644 index 0000000..1cdaa2c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.measure.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +# As of scikit-image 0.22.0, we need to collect the __init__.pyi file for `lazy_loader`, as well as collect submodules +# due to lazy loading. +if is_module_satisfies("scikit-image >= 0.22.0"): + datas = collect_data_files("skimage.measure", includes=["*.pyi"]) + hiddenimports = collect_submodules('skimage.measure', filter=lambda name: name != 'skimage.measure.tests') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.metrics.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.metrics.py new file mode 100644 index 0000000..7d575f5 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.metrics.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +# As of scikit-image 0.23.0, we need to collect the __init__.pyi file for `lazy_loader`, as well as collect submodules +# due to lazy loading. +if is_module_satisfies("scikit-image >= 0.23.0"): + datas = collect_data_files("skimage.metrics", includes=["*.pyi"]) + hiddenimports = collect_submodules('skimage.metrics', filter=lambda name: name != 'skimage.metrics.tests') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.morphology.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.morphology.py new file mode 100644 index 0000000..dc5c6c2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.morphology.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, is_module_satisfies + +# As of scikit-image 0.20.0, we need to collect .npy data files for `skimage.morphology` +if is_module_satisfies('scikit-image >= 0.20'): + datas = collect_data_files("skimage.morphology", includes=["*.npy"]) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.py new file mode 100644 index 0000000..03e3ec0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, is_module_satisfies + +# As of scikit-image 0.20.0, we need to collect the __init__.pyi file for `lazy_loader`. +if is_module_satisfies('scikit-image >= 0.20.0'): + datas = collect_data_files("skimage", includes=["*.pyi"]) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.registration.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.registration.py new file mode 100644 index 0000000..0ffeee8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.registration.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +# As of scikit-image 0.22.0, we need to collect the __init__.pyi file for `lazy_loader`, as well as collect submodules +# due to lazy loading. +if is_module_satisfies("scikit-image >= 0.22.0"): + datas = collect_data_files("skimage.registration", includes=["*.pyi"]) + hiddenimports = collect_submodules('skimage.registration', filter=lambda name: name != 'skimage.registration.tests') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.restoration.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.restoration.py new file mode 100644 index 0000000..a048738 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.restoration.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +# As of scikit-image 0.22.0, we need to collect the __init__.pyi file for `lazy_loader`, as well as collect submodules +# due to lazy loading. +if is_module_satisfies("scikit-image >= 0.22.0"): + datas = collect_data_files("skimage.restoration", includes=["*.pyi"]) + hiddenimports = collect_submodules('skimage.restoration', filter=lambda name: name != 'skimage.restoration.tests') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.transform.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.transform.py new file mode 100644 index 0000000..3841a4e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skimage.transform.py @@ -0,0 +1,24 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import is_module_satisfies, collect_data_files, collect_submodules + +# Hook tested with scikit-image (skimage) 0.9.3 on Mac OS 10.9 and Windows 7 64-bit +hiddenimports = ['skimage.draw.draw', + 'skimage._shared.geometry', + 'skimage._shared.transform', + 'skimage.filters.rank.core_cy'] + +# As of scikit-image 0.22.0, we need to collect the __init__.pyi file for `lazy_loader`, as well as collect submodules +# due to lazy loading. +if is_module_satisfies("scikit-image >= 0.22.0"): + datas = collect_data_files("skimage.transform", includes=["*.pyi"]) + hiddenimports += collect_submodules('skimage.transform', filter=lambda name: name != 'skimage.transform.tests') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.cluster.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.cluster.py new file mode 100644 index 0000000..a855309 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.cluster.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies + +# sklearn.cluster in scikit-learn 0.23.x has a hidden import of +# threadpoolctl +if is_module_satisfies("scikit_learn >= 0.23"): + hiddenimports = ['threadpoolctl', ] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.cupy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.cupy.py new file mode 100644 index 0000000..4c2275a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.cupy.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# These hidden imports are required due to the following statements found in the package's `__init__.py`: +# ``` +# __import__(__package__ + '.linalg') +# __import__(__package__ + '.fft') +# ``` +hiddenimports = [ + 'sklearn.externals.array_api_compat.cupy.fft', + 'sklearn.externals.array_api_compat.cupy.linalg', +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.dask.array.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.dask.array.py new file mode 100644 index 0000000..7779374 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.dask.array.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# These hidden imports are required due to the following statements found in the package's `__init__.py`: +# ``` +# __import__(__package__ + '.linalg') +# __import__(__package__ + '.fft') +# ``` +hiddenimports = [ + 'sklearn.externals.array_api_compat.dask.array.fft', + 'sklearn.externals.array_api_compat.dask.array.linalg', +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.numpy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.numpy.py new file mode 100644 index 0000000..042a73a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.numpy.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# These hidden imports are required due to the following statements found in the package's `__init__.py`: +# ``` +# __import__(__package__ + '.linalg') +# __import__(__package__ + '.fft') +# ``` +hiddenimports = [ + 'sklearn.externals.array_api_compat.numpy.fft', + 'sklearn.externals.array_api_compat.numpy.linalg', +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.torch.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.torch.py new file mode 100644 index 0000000..207bb3d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.torch.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# These hidden imports are required due to the following statements found in the package's `__init__.py`: +# ``` +# __import__(__package__ + '.linalg') +# __import__(__package__ + '.fft') +# ``` +hiddenimports = [ + 'sklearn.externals.array_api_compat.torch.fft', + 'sklearn.externals.array_api_compat.torch.linalg', +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.linear_model.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.linear_model.py new file mode 100644 index 0000000..ce5a884 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.linear_model.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies + +# sklearn.linear_model in scikit-learn 0.24.x has a hidden import of +# sklearn.utils._weight_vector +if is_module_satisfies("scikit_learn >= 0.24"): + hiddenimports = ['sklearn.utils._weight_vector', ] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.metrics.cluster.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.metrics.cluster.py new file mode 100644 index 0000000..3cbeb64 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.metrics.cluster.py @@ -0,0 +1,27 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Required by scikit-learn 0.21 +from PyInstaller.utils.hooks import is_module_satisfies + +if is_module_satisfies("scikit-learn < 0.22"): + hiddenimports = [ + 'sklearn.utils.lgamma', + 'sklearn.utils.weight_vector' + ] +else: + # lgamma was removed and weight_vector privatised in 0.22. + # https://github.com/scikit-learn/scikit-learn/commit/58be9a671b0b8fcb4b75f4ae99f4469ca33a2158#diff-dbca16040fd2b85a499ba59833b37f1785c58e52d2e89ce5cdfc7fff164bd5f3 + # https://github.com/scikit-learn/scikit-learn/commit/150e82b52bf28c88c5a8b1a10f9777d0452b3ef2 + hiddenimports = [ + 'sklearn.utils._weight_vector' + ] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.metrics.pairwise.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.metrics.pairwise.py new file mode 100644 index 0000000..188c1af --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.metrics.pairwise.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Required by scikit-learn 1.1.0 +from PyInstaller.utils.hooks import is_module_satisfies + +if is_module_satisfies("scikit-learn >= 1.1.0"): + hiddenimports = [ + 'sklearn.utils._heap', + 'sklearn.utils._sorting', + 'sklearn.utils._vector_sentinel', + ] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.metrics.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.metrics.py new file mode 100644 index 0000000..8bdea5f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.metrics.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, collect_submodules + +hiddenimports = [] + +# Required by scikit-learn 1.0.0 +if is_module_satisfies("scikit-learn >= 1.0.0"): + hiddenimports += [ + 'sklearn.utils._typedefs', + ] + +# Required by scikit-learn 1.2.0 +if is_module_satisfies("scikit-learn >= 1.2.0"): + hiddenimports += collect_submodules("sklearn.metrics._pairwise_distances_reduction") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.neighbors.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.neighbors.py new file mode 100644 index 0000000..937fe75 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.neighbors.py @@ -0,0 +1,41 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies + +hiddenimports = [] + +if is_module_satisfies("scikit_learn > 1.0.1"): + # 1.0.2 and later + hiddenimports += [ + 'sklearn.neighbors._quad_tree', + ] +elif is_module_satisfies("scikit_learn < 0.22 "): + # 0.21 and below + hiddenimports += [ + 'sklearn.neighbors.typedefs', + 'sklearn.neighbors.quad_tree', + ] +else: + # between and including 0.22 and 1.0.1 + hiddenimports += [ + 'sklearn.neighbors._typedefs', + 'sklearn.neighbors._quad_tree', + ] + +# The following hidden import must be added here +# (as opposed to sklearn.tree) +hiddenimports += ['sklearn.tree._criterion'] + +# Additional hidden imports introduced in v1.0.0 +if is_module_satisfies("scikit_learn >= 1.0.0"): + hiddenimports += ["sklearn.neighbors._partition_nodes"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.py new file mode 100644 index 0000000..25724f3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Tested on Windows 10 64bit with python 3.7.1 + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('sklearn') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.tree.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.tree.py new file mode 100644 index 0000000..7a222e2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.tree.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies + +hiddenimports = ['sklearn.tree._utils'] + +if is_module_satisfies('scikit-learn >= 1.6.0'): + hiddenimports += ['sklearn.tree._partitioner'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.utils.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.utils.py new file mode 100644 index 0000000..10f44d7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.utils.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies + +hiddenimports = ['sklearn.utils._cython_blas'] + +# As of scikit-learn 1.7.1, the `sklearn.utils._isfinite` extension started to depend on newly-introduced +# `sklearn._cyutility`. +if is_module_satisfies('scikit-learn >= 1.7.1'): + hiddenimports += ['sklearn._cyutility'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skyfield.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skyfield.py new file mode 100644 index 0000000..8394b34 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-skyfield.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files +datas = collect_data_files('skyfield') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-slixmpp.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-slixmpp.py new file mode 100644 index 0000000..93bd8a1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-slixmpp.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules("slixmpp.features") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sound_lib.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sound_lib.py new file mode 100644 index 0000000..ed290ea --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sound_lib.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +sound_lib: http://hg.q-continuum.net/sound_lib +""" + +from PyInstaller.utils.hooks import collect_dynamic_libs + +binaries = collect_dynamic_libs('sound_lib') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sounddevice.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sounddevice.py new file mode 100644 index 0000000..6316b03 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sounddevice.py @@ -0,0 +1,62 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +sounddevice: +https://github.com/spatialaudio/python-sounddevice/ +""" + +import pathlib + +from PyInstaller.utils.hooks import get_module_file_attribute, logger + +binaries = [] +datas = [] + +# PyPI wheels for Windows and macOS ship the sndfile shared library in _sounddevice_data directory, +# located next to the sounddevice.py module file (i.e., in the site-packages directory). +module_dir = pathlib.Path(get_module_file_attribute('sounddevice')).parent +data_dir = module_dir / '_sounddevice_data' / 'portaudio-binaries' +if data_dir.is_dir(): + destdir = str(data_dir.relative_to(module_dir)) + + # Collect the shared library (known variants: libportaudio64bit.dll, libportaudio32bit.dll, libportaudio.dylib) + for lib_file in data_dir.glob("libportaudio*.*"): + binaries += [(str(lib_file), destdir)] + + # Collect the README.md file + readme_file = data_dir / "README.md" + if readme_file.is_file(): + datas += [(str(readme_file), destdir)] +else: + # On linux and in Anaconda in all OSes, the system-installed portaudio library needs to be collected. + def _find_system_portaudio_library(): + import os + import ctypes.util + from PyInstaller.depend.utils import _resolveCtypesImports + + libname = ctypes.util.find_library("portaudio") + if libname is not None: + resolved_binary = _resolveCtypesImports([os.path.basename(libname)]) + if resolved_binary: + return resolved_binary[0][1] + + try: + lib_file = _find_system_portaudio_library() + except Exception as e: + logger.warning("Error while trying to find system-installed portaudio library: %s", e) + lib_file = None + + if lib_file: + binaries += [(lib_file, '.')] + +if not binaries: + logger.warning("portaudio shared library not found - sounddevice will likely fail to work!") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-soundfile.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-soundfile.py new file mode 100644 index 0000000..f788c38 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-soundfile.py @@ -0,0 +1,62 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +pysoundfile: +https://github.com/bastibe/SoundFile +""" + +import pathlib + +from PyInstaller.utils.hooks import get_module_file_attribute, logger + +binaries = [] +datas = [] + +# PyPI wheels for Windows and macOS ship the sndfile shared library in _soundfile_data directory, +# located next to the soundfile.py module file (i.e., in the site-packages directory). +module_dir = pathlib.Path(get_module_file_attribute('soundfile')).parent +data_dir = module_dir / '_soundfile_data' +if data_dir.is_dir(): + destdir = str(data_dir.relative_to(module_dir)) + + # Collect the shared library (known variants: libsndfile64bit.dll, libsndfile32bit.dll, libsndfile.dylib) + for lib_file in data_dir.glob("libsndfile*.*"): + binaries += [(str(lib_file), destdir)] + + # Collect the COPYING file + copying_file = data_dir / "COPYING" + if copying_file.is_file(): + datas += [(str(copying_file), destdir)] +else: + # On linux and in Anaconda in all OSes, the system-installed sndfile library needs to be collected. + def _find_system_sndfile_library(): + import os + import ctypes.util + from PyInstaller.depend.utils import _resolveCtypesImports + + libname = ctypes.util.find_library("sndfile") + if libname is not None: + resolved_binary = _resolveCtypesImports([os.path.basename(libname)]) + if resolved_binary: + return resolved_binary[0][1] + + try: + lib_file = _find_system_sndfile_library() + except Exception as e: + logger.warning("Error while trying to find system-installed sndfile library: %s", e) + lib_file = None + + if lib_file: + binaries += [(lib_file, '.')] + +if not binaries: + logger.warning("sndfile shared library not found - soundfile will likely fail to work!") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-spacy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-spacy.py new file mode 100644 index 0000000..25ee44e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-spacy.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Spacy contains hidden imports and data files which are needed to import it +""" + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +datas = collect_data_files("spacy") +hiddenimports = collect_submodules("spacy") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-speech_recognition.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-speech_recognition.py new file mode 100644 index 0000000..fb7d179 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-speech_recognition.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for speech_recognition: https://pypi.python.org/pypi/SpeechRecognition/ +# Tested on Windows 8.1 x64 with SpeechRecognition 1.5 + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("speech_recognition") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-spiceypy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-spiceypy.py new file mode 100644 index 0000000..3444d93 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-spiceypy.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for spiceypy: https://pypi.org/project/spiceypy/ +# Tested on Ubuntu 20.04 with spiceypy 5.1.1 + +from PyInstaller.utils.hooks import collect_dynamic_libs + +binaries = collect_dynamic_libs("spiceypy") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-spnego.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-spnego.py new file mode 100644 index 0000000..b038573 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-spnego.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('spnego') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-srsly.msgpack._packer.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-srsly.msgpack._packer.py new file mode 100644 index 0000000..519cd0b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-srsly.msgpack._packer.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +srsly.msgpack._packer contains hidden imports which are needed to import it +This hook was created to make spacy work correctly. +""" + +hiddenimports = ['srsly.msgpack.util'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sspilib.raw.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sspilib.raw.py new file mode 100644 index 0000000..7fbd239 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sspilib.raw.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +# This seems to be required in python <= 3.9; in later versions, the `dataclasses` module ends up included via a +# different import chain. But for the sake of consistency, keep the hiddenimport for all python versions. +hiddenimports = ['dataclasses'] + +# Collect submodules of `sspilib.raw` - most of which are cythonized extensions. +hiddenimports += collect_submodules('sspilib.raw') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-statsmodels.tsa.statespace.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-statsmodels.tsa.statespace.py new file mode 100644 index 0000000..547d706 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-statsmodels.tsa.statespace.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('statsmodels.tsa.statespace._filters') \ + + collect_submodules('statsmodels.tsa.statespace._smoothers') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-stdnum.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-stdnum.py new file mode 100644 index 0000000..068e960 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-stdnum.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2022 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Collect data files that are required by some of the stdnum's sub-modules +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("stdnum") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-storm.database.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-storm.database.py new file mode 100644 index 0000000..1cde580 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-storm.database.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for storm ORM. +""" + +hiddenimports = [ + 'storm.databases.sqlite', + 'storm.databases.postgres', + 'storm.databases.mysql' +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sudachipy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sudachipy.py new file mode 100644 index 0000000..1abb48e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sudachipy.py @@ -0,0 +1,30 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import can_import_module, collect_data_files, is_module_satisfies + +datas = collect_data_files('sudachipy') +hiddenimports = [] + +# In v0.6.8, `sudachipy.config` and `sudachipy.errors` modules were added, and are referenced from binary extension. +if is_module_satisfies('sudachipy >= 0.6.8'): + hiddenimports += [ + 'sudachipy.config', + 'sudachipy.errors', + ] + +# Check which types of dictionary are installed +for sudachi_dict in ['sudachidict_small', 'sudachidict_core', 'sudachidict_full']: + if can_import_module(sudachi_dict): + datas += collect_data_files(sudachi_dict) + + hiddenimports += [sudachi_dict] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sunpy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sunpy.py new file mode 100644 index 0000000..4a069e4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sunpy.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules, copy_metadata + +hiddenimports = collect_submodules("sunpy", filter=lambda x: "tests" not in x.split(".")) +datas = collect_data_files("sunpy", excludes=['**/tests/', '**/test/']) +datas += collect_data_files("drms") +datas += copy_metadata("sunpy") + +# Note : sunpy > 3.1.0 comes with it's own hook for running tests. diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sv_ttk.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sv_ttk.py new file mode 100644 index 0000000..0f37e32 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-sv_ttk.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# Collect all files in the sv_ttk package +datas = collect_data_files(package="sv_ttk") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-swagger_spec_validator.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-swagger_spec_validator.py new file mode 100644 index 0000000..bb4b4d1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-swagger_spec_validator.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("swagger_spec_validator") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tableauhyperapi.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tableauhyperapi.py new file mode 100644 index 0000000..210daef --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tableauhyperapi.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_dynamic_libs + +binaries = collect_dynamic_libs("tableauhyperapi") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tables.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tables.py new file mode 100644 index 0000000..440c6a1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tables.py @@ -0,0 +1,30 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.compat import is_win +from PyInstaller.utils.hooks import collect_dynamic_libs, is_module_satisfies + +# PyTables is a package for managing hierarchical datasets +hiddenimports = ["tables._comp_lzo", "tables._comp_bzip2"] + +# Collect the bundled copy of blosc2 shared library. +binaries = collect_dynamic_libs('tables') +datas = [] + +# tables 3.7.0 started using `delvewheel` for its Windows PyPI wheels. While contemporary PyInstaller versions +# automatically pick up DLLs from external `pyproj.libs` directory, this does not work on Anaconda python 3.8 and 3.9 +# due to defunct `os.add_dll_directory`, which forces `delvewheel` to use the old load-order file approach. So we need +# to explicitly ensure that load-order file as well as DLLs are collected. +if is_win and is_module_satisfies("tables >= 3.7.0"): + if is_module_satisfies("PyInstaller >= 5.6"): + from PyInstaller.utils.hooks import collect_delvewheel_libs_directory + datas, binaries = collect_delvewheel_libs_directory("tables", datas=datas, binaries=binaries) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tcod.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tcod.py new file mode 100644 index 0000000..d5b076e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tcod.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for https://github.com/libtcod/python-tcod +""" +from PyInstaller.utils.hooks import collect_dynamic_libs + +hiddenimports = ['_cffi_backend'] + +# Install shared libraries to the working directory. +binaries = collect_dynamic_libs('tcod', destdir='.') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tensorflow.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tensorflow.py new file mode 100644 index 0000000..6a7a50a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tensorflow.py @@ -0,0 +1,188 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.compat import importlib_metadata +from packaging.version import Version + +from PyInstaller.compat import is_linux +from PyInstaller.utils.hooks import ( + collect_data_files, + collect_dynamic_libs, + collect_submodules, + get_module_attribute, + is_module_satisfies, + logger, +) + +# Determine the name of `tensorflow` dist; this is available under different names (releases vs. nightly, plus build +# variants). We need to determine the dist that we are dealing with, so we can query its version and metadata. +_CANDIDATE_DIST_NAMES = ( + "tensorflow", + "tensorflow-cpu", + "tensorflow-gpu", + "tensorflow-intel", + "tensorflow-rocm", + "tensorflow-macos", + "tensorflow-aarch64", + "tensorflow-cpu-aws", + "tf-nightly", + "tf-nightly-cpu", + "tf-nightly-gpu", + "tf-nightly-rocm", + "intel-tensorflow", + "intel-tensorflow-avx512", +) +dist = None +for candidate_dist_name in _CANDIDATE_DIST_NAMES: + try: + dist = importlib_metadata.distribution(candidate_dist_name) + break + except importlib_metadata.PackageNotFoundError: + continue + +version = None +if dist is None: + logger.warning( + "hook-tensorflow: failed to determine tensorflow dist name! Reading version from tensorflow.__version__!" + ) + try: + version = get_module_attribute("tensorflow", "__version__") + except Exception as e: + raise Exception("Failed to read tensorflow.__version__") from e +else: + logger.info("hook-tensorflow: tensorflow dist name: %s", dist.name) + version = dist.version + +# Parse version +logger.info("hook-tensorflow: tensorflow version: %s", version) +try: + version = Version(version) +except Exception as e: + raise Exception("Failed to parse tensorflow version!") from e + +# Exclude from data collection: +# - development headers in include subdirectory +# - XLA AOT runtime sources +# - libtensorflow_framework and libtensorflow_cc (since TF 2.12) shared libraries (to avoid duplication) +# - import library (.lib) files (Windows-only) +data_excludes = [ + "include", + "xla_aot_runtime_src", + "libtensorflow_framework.*", + "libtensorflow_cc.*", + "**/*.lib", +] + +# Under tensorflow 2.3.0 (the most recent version at the time of writing), _pywrap_tensorflow_internal extension module +# ends up duplicated; once as an extension, and once as a shared library. In addition to increasing program size, this +# also causes problems on macOS, so we try to prevent the extension module "variant" from being picked up. +# +# See pyinstaller/pyinstaller-hooks-contrib#49 for details. +# +# With PyInstaller >= 6.0, this issue is alleviated, because the binary dependency analysis (which picks up the +# extension in question as a shared library that other extensions are linked against) now preserves the parent directory +# layout, and creates a symbolic link to the top-level application directory. +if is_module_satisfies('PyInstaller >= 6.0'): + excluded_submodules = [] +else: + excluded_submodules = ['tensorflow.python._pywrap_tensorflow_internal'] + + +def _submodules_filter(x): + return x not in excluded_submodules + + +if version < Version("1.15.0a0"): + # 1.14.x and earlier: collect everything from tensorflow + hiddenimports = collect_submodules('tensorflow', filter=_submodules_filter) + datas = collect_data_files('tensorflow', excludes=data_excludes) +elif version >= Version("1.15.0a0") and version < Version("2.2.0a0"): + # 1.15.x - 2.1.x: collect everything from tensorflow_core + hiddenimports = collect_submodules('tensorflow_core', filter=_submodules_filter) + datas = collect_data_files('tensorflow_core', excludes=data_excludes) + + # Under 1.15.x, we seem to fail collecting a specific submodule, and need to add it manually... + if version < Version("2.0.0a0"): + hiddenimports += ['tensorflow_core._api.v1.compat.v2.summary.experimental'] +else: + # 2.2.0 and newer: collect everything from tensorflow again + hiddenimports = collect_submodules('tensorflow', filter=_submodules_filter) + datas = collect_data_files('tensorflow', excludes=data_excludes) + + # From 2.6.0 on, we also need to explicitly collect keras (due to lazy mapping of tensorflow.keras.xyz -> keras.xyz) + if version >= Version("2.6.0a0"): + hiddenimports += collect_submodules('keras') + + # Starting with 2.14.0, we need `ml_dtypes` among hidden imports. + if version >= Version("2.14.0"): + hiddenimports += ['ml_dtypes'] + +binaries = [] +excludedimports = excluded_submodules + +# Suppress warnings for missing hidden imports generated by this hook. +# Requires PyInstaller > 5.1 (with pyinstaller/pyinstaller#6914 merged); no-op otherwise. +warn_on_missing_hiddenimports = False + +# Collect the AutoGraph part of `tensorflow` code, to avoid a run-time warning about AutoGraph being unavailable: +# `WARNING:tensorflow:AutoGraph is not available in this environment: functions lack code information. ...` +# The warning is emitted if source for `log` function from `tensorflow.python.autograph.utils.ag_logging` cannot be +# looked up. Not sure if we need sources for other parts of `tesnorflow`, though. +# Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = { + 'tensorflow.python.autograph': 'py+pyz', +} + +# Linux builds of tensorflow can optionally use CUDA from nvidia-* packages. If we managed to obtain dist, query the +# requirements from metadata (the `and-cuda` extra marker), and convert them to module names. +# +# NOTE: while the installation of nvidia-* packages via `and-cuda` extra marker is not gated by the OS version check, +# it is effectively available only on Linux (last Windows-native build that supported GPU is v2.10.0, and assumed that +# CUDA is externally available). +if is_linux and dist is not None: + def _infer_nvidia_hiddenimports(): + import packaging.requirements + from _pyinstaller_hooks_contrib.utils import nvidia_cuda as cudautils + + requirements = [packaging.requirements.Requirement(req) for req in dist.requires or []] + env = {'extra': 'and-cuda'} + requirements = [req.name for req in requirements if req.marker is None or req.marker.evaluate(env)] + + return cudautils.infer_hiddenimports_from_requirements(requirements) + + try: + nvidia_hiddenimports = _infer_nvidia_hiddenimports() + except Exception: + # Log the exception, but make it non-fatal + logger.warning("hook-tensorflow: failed to infer NVIDIA CUDA hidden imports!", exc_info=True) + nvidia_hiddenimports = [] + logger.info("hook-tensorflow: inferred hidden imports for CUDA libraries: %r", nvidia_hiddenimports) + hiddenimports += nvidia_hiddenimports + + +# Collect the tensorflow-plugins (pluggable device plugins) +hiddenimports += ['tensorflow-plugins'] +binaries += collect_dynamic_libs('tensorflow-plugins') + +# On Linux, prevent binary dependency analysis from generating symbolic links for libtensorflow_cc.so.2, +# libtensorflow_framework.so.2, and _pywrap_tensorflow_internal.so to the top-level application directory. These +# symbolic links seem to confuse tensorflow about its location (likely because code in one of the libraries looks up the +# library file's location, but does not fully resolve it), which in turn prevents it from finding the collected CUDA +# libraries in the nvidia/cu* package directories. +# +# The `bindepend_symlink_suppression` hook attribute requires PyInstaller >= 6.11, and is no-op in earlier versions. +if is_linux: + bindepend_symlink_suppression = [ + '**/libtensorflow_cc.so*', + '**/libtensorflow_framework.so*', + '**/_pywrap_tensorflow_internal.so', + ] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-text_unidecode.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-text_unidecode.py new file mode 100644 index 0000000..68902ca --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-text_unidecode.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# ----------------------------------------------------------------------------- +""" +text-unidecode: +https://github.com/kmike/text-unidecode/ +""" + +import os +from PyInstaller.utils.hooks import get_package_paths + +package_path = get_package_paths("text_unidecode") +data_bin_path = os.path.join(package_path[1], "data.bin") + +if os.path.exists(data_bin_path): + datas = [(data_bin_path, 'text_unidecode')] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-textdistance.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-textdistance.py new file mode 100644 index 0000000..4859014 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-textdistance.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for textdistance: https://pypi.org/project/textdistance/4.1.3/ + +from PyInstaller.utils.hooks import collect_all + +datas, binaries, hiddenimports = collect_all('textdistance') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-thinc.backends.numpy_ops.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-thinc.backends.numpy_ops.py new file mode 100644 index 0000000..fcb3e88 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-thinc.backends.numpy_ops.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +thinc.banckends.numpy_ops contains hidden imports which are needed to import it +This hook was created to make spacy work correctly. +""" + +hiddenimports = ['cymem.cymem', 'preshed.maps', 'blis.py'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-thinc.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-thinc.py new file mode 100644 index 0000000..7623253 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-thinc.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Thinc contains data files and hidden imports. This hook was created to make spacy work correctly. +""" +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +datas = collect_data_files("thinc") +hiddenimports = collect_submodules("thinc") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-timezonefinder.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-timezonefinder.py new file mode 100644 index 0000000..e5cd309 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-timezonefinder.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('timezonefinder') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-timm.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-timm.py new file mode 100644 index 0000000..1ff1a61 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-timm.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tinycss2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tinycss2.py new file mode 100644 index 0000000..d06ab79 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tinycss2.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for tinycss2. tinycss2 is a low-level CSS parser and generator. +https://github.com/Kozea/tinycss2 +""" +from PyInstaller.utils.hooks import collect_data_files + + +# Hook no longer required for tinycss2 >= 1.0.0 +def hook(hook_api): + hook_api.add_datas(collect_data_files(hook_api.__name__)) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tkinterdnd2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tkinterdnd2.py new file mode 100644 index 0000000..4b07d33 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tkinterdnd2.py @@ -0,0 +1,90 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os +import pathlib +import platform + +from PyInstaller.utils.hooks import get_package_paths, logger + + +# tkinterdnd2 contains a tkdnd sub-directory which contains platform-specific directories with shared library and .tcl +# files. Collect only the relevant directory, by matching the decision logic from: +# https://github.com/Eliav2/tkinterdnd2/blob/9a55907e430234bf8ab72ea614f84af9cc89598c/tkinterdnd2/TkinterDnD.py#L33-L51 +def _collect_platform_subdir(system, machine): + datas = [] + binaries = [] + + # Under Windows, `platform.machine()` returns the identifier of the *host* architecture, which does not necessarily + # match the architecture of the running process (for example, when running x86 process under x64 Windows, or when + # running either x86 or x64 process under arm64 Windows). The architecture of the running process can be obtained + # from the `PROCESSOR_ARCHITECTURE` environment variable, which is automatically set by Windows / WOW64 subsystem. + # + # NOTE: at the time of writing (tkinterdnd2 v0.4.2), tkinterdnd2 does not account for this, and attempts to load + # the shared library from incorrect directory; as this fails due to architecture mismatch, there is no point in + # us trying to collect that (incorrect) directory. + if system == "Windows": + machine = os.environ.get("PROCESSOR_ARCHITECTURE", machine) + + # Resolve the platform-specific sub-directory name and shared library suffix. + DIR_NAMES = { + "Darwin": { + "arm64": "osx-arm64", + "x86_64": "osx-x64", + }, + "Linux": { + "aarch64": "linux-arm64", + "x86_64": "linux-x64", + }, + "Windows": { + "ARM64": "win-arm64", + "AMD64": "win-x64", + "x86": "win-x86", + } + } + dir_name = DIR_NAMES.get(system, {}).get(machine, None) + + LIB_SUFFICES = { + "Darwin": "*.dylib", + "Linux": "*.so", + "Windows": "*.dll", + } + lib_suffix = LIB_SUFFICES.get(system, None) + + if dir_name is None or lib_suffix is None: + logger.warning( + "hook-tkinterdnd2: unsupported platform (%s, %s)! Platform-specific directory will not be collected!", + system, machine + ) + return datas, binaries + + pkg_base, pkg_dir = get_package_paths("tkinterdnd2") + + dest_dir = os.path.join("tkinterdnd2", "tkdnd", dir_name) + src_path = pathlib.Path(pkg_dir) / "tkdnd" / dir_name + + if not src_path.is_dir(): + logger.warning("hook-tkinterdnd2: platform-specific sub-directory %r does not exist!", str(src_path)) + return datas, binaries + + # Collect the shared library. + for entry in src_path.glob(lib_suffix): + binaries.append((str(entry), dest_dir)) + + # Collect the .tcl files. + for entry in src_path.glob("*.tcl"): + datas.append((str(entry), dest_dir)) + + return datas, binaries + + +datas, binaries = _collect_platform_subdir(platform.system(), platform.machine()) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tkinterweb.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tkinterweb.py new file mode 100644 index 0000000..bb02c6c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tkinterweb.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# Collect files from 'resources' +datas = collect_data_files('tkinterweb') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tkinterweb_tkhtml.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tkinterweb_tkhtml.py new file mode 100644 index 0000000..33c6374 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tkinterweb_tkhtml.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, collect_dynamic_libs + +# Collect files from 'tkhtml' +datas = collect_data_files('tkinterweb_tkhtml') + +# Collect binaries from 'tkhtml' +binaries = collect_dynamic_libs('tkinterweb_tkhtml') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-toga.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-toga.py new file mode 100644 index 0000000..be80488 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-toga.py @@ -0,0 +1,44 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller import compat +from PyInstaller.utils.hooks import collect_data_files, collect_submodules, copy_metadata, is_module_satisfies + +hiddenimports = [] + +# Select the platform-specific backend. +if compat.is_darwin: + backend = 'cocoa' +elif compat.is_linux: + backend = 'gtk' +elif compat.is_win: + backend = 'winforms' +else: + backend = None + +if backend is not None: + hiddenimports += [f'toga_{backend}', f'toga_{backend}.factory'] + +# Collect metadata for toga-core dist, which is used by toga module to determine its version. +datas = copy_metadata("toga-core") + +# Prevent `toga` from pulling `setuptools_scm` into frozen application, as it makes no sense in that context. +excludedimports = ["setuptools_scm"] + +# `toga` 0.5.0 refactored its `__init__.py` to lazy-load its core modules. Therefore, we now need to collect +# submodules via `collect_submodules`... +if is_module_satisfies("toga >= 0.5.0"): + hiddenimports += collect_submodules("toga") + +# Starting with `toga` 0.5.2, we need to collect .pyi files. +if is_module_satisfies("toga >= 0.5.2"): + datas += collect_data_files("toga") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-toga_cocoa.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-toga_cocoa.py new file mode 100644 index 0000000..c6142f4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-toga_cocoa.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, copy_metadata + +# Collect icons from `resources`. +datas = collect_data_files('toga_cocoa') + +# Collect metadata so that the backend can be discovered via `toga.backends` entry-point. +datas += copy_metadata("toga-cocoa") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-toga_gtk.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-toga_gtk.py new file mode 100644 index 0000000..2e0353e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-toga_gtk.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, copy_metadata + +# Collect default icon from `resources`. +datas = collect_data_files('toga_gtk') + +# Collect metadata so that the backend can be discovered via `toga.backends` entry-point. +datas += copy_metadata("toga-gtk") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-toga_winforms.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-toga_winforms.py new file mode 100644 index 0000000..adebb9a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-toga_winforms.py @@ -0,0 +1,40 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os + +from PyInstaller.utils.hooks import collect_data_files, copy_metadata + +# Collect default icon from `resources`, and license/readme file from `toga_winforms/libs/WebView2`. Use the same call +# to also collect bundled WebView2 DLLs from `toga_winforms/libs/WebView2`. +include_patterns = [ + 'resources/*', + 'libs/WebView2/*.md', + 'libs/WebView2/*.dll', +] + +# The package seems to bundle WebView2 runtimes for x86, x64, and arm64. We need to collect only the one for the +# running platform, which can be reliably identified by `PROCESSOR_ARCHITECTURE` environment variable, which properly +# reflects the processor architecture of running process (even if running x86 python on x64 machine, or x64 python on +# arm64 machine). +machine = os.environ["PROCESSOR_ARCHITECTURE"].lower() +if machine == 'x86': + include_patterns += ['libs/WebView2/runtimes/win-x86/*'] +elif machine == 'amd64': + include_patterns += ['libs/WebView2/runtimes/win-x64/*'] +elif machine == 'arm64': + include_patterns += ['libs/WebView2/runtimes/win-arm64/*'] + +datas = collect_data_files('toga_winforms', includes=include_patterns) + +# Collect metadata so that the backend can be discovered via `toga.backends` entry-point. +datas += copy_metadata("toga-winforms") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torch.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torch.py new file mode 100644 index 0000000..85e75cf --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torch.py @@ -0,0 +1,179 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os + +from PyInstaller.utils.hooks import ( + logger, + collect_data_files, + is_module_satisfies, + collect_dynamic_libs, + collect_submodules, + get_package_paths, +) + +if is_module_satisfies("PyInstaller >= 6.0"): + from PyInstaller import compat + from PyInstaller.utils.hooks import PY_DYLIB_PATTERNS + + module_collection_mode = "pyz+py" + warn_on_missing_hiddenimports = False + + datas = collect_data_files( + "torch", + excludes=[ + "**/*.h", + "**/*.hpp", + "**/*.cuh", + "**/*.lib", + "**/*.cpp", + "**/*.pyi", + "**/*.cmake", + ], + ) + hiddenimports = collect_submodules("torch") + binaries = collect_dynamic_libs( + "torch", + # Ensure we pick up fully-versioned .so files as well + search_patterns=PY_DYLIB_PATTERNS + ['*.so.*'], + ) + + # On Linux, torch wheels built with non-default CUDA version bundle CUDA libraries themselves (and should be handled + # by the above `collect_dynamic_libs`). Wheels built with default CUDA version (which are available on PyPI), on the + # other hand, use CUDA libraries provided by nvidia-* packages. Due to all possible combinations (CUDA libs from + # nvidia-* packages, torch-bundled CUDA libs, CPU-only CUDA libs) we do not add hidden imports directly, but instead + # attempt to infer them from requirements listed in the `torch` metadata. + if compat.is_linux: + def _infer_nvidia_hiddenimports(): + import packaging.requirements + from _pyinstaller_hooks_contrib.compat import importlib_metadata + from _pyinstaller_hooks_contrib.utils import nvidia_cuda as cudautils + + dist = importlib_metadata.distribution("torch") + requirements = [packaging.requirements.Requirement(req) for req in dist.requires or []] + requirements = [req.name for req in requirements if req.marker is None or req.marker.evaluate()] + + return cudautils.infer_hiddenimports_from_requirements(requirements) + + try: + nvidia_hiddenimports = _infer_nvidia_hiddenimports() + except Exception: + # Log the exception, but make it non-fatal + logger.warning("hook-torch: failed to infer NVIDIA CUDA hidden imports!", exc_info=True) + nvidia_hiddenimports = [] + logger.info("hook-torch: inferred hidden imports for CUDA libraries: %r", nvidia_hiddenimports) + hiddenimports += nvidia_hiddenimports + + # On Linux, prevent binary dependency analysis from generating symbolic links for libraries from `torch/lib` to + # the top-level application directory. These symbolic links seem to confuse `torch` about location of its shared + # libraries (likely because code in one of the libraries looks up the library file's location, but does not + # fully resolve it), and prevent it from finding dynamically-loaded libraries in `torch/lib` directory, such as + # `torch/lib/libtorch_cuda_linalg.so`. The issue was observed with earlier versions of `torch` builds provided + # by https://download.pytorch.org/whl/torch, specifically 1.13.1+cu117, 2.0.1+cu117, and 2.1.2+cu118; later + # versions do not seem to be affected. The wheels provided on PyPI do not seem to be affected, either, even + # for torch 1.13.1, 2.01, and 2.1.2. However, these symlinks should be not necessary on linux in general, so + # there should be no harm in suppressing them for all versions. + # + # The `bindepend_symlink_suppression` hook attribute requires PyInstaller >= 6.11, and is no-op in earlier + # versions. + bindepend_symlink_suppression = ['**/torch/lib/*.so*'] + + # The Windows nightly build for torch 2.3.0 added dependency on MKL. The `mkl` distribution does not provide an + # importable package, but rather installs the DLLs in /Library/bin directory. Therefore, we cannot write a + # separate hook for it, and must collect the DLLs here. (Most of these DLLs are missed by PyInstaller's binary + # dependency analysis due to being dynamically loaded at run-time). + if compat.is_win: + def _collect_mkl_dlls(): + # Determine if torch is packaged by Anaconda or not. Ideally, we would use our `get_installer()` hook + # utility function to check if installer is `conda`. However, it seems that some builds (e.g., those from + # `pytorch` and `nvidia` channels) provide legacy metadata in form of .egg-info directory, which does not + # include an INSTALLER file. So instead, search the conda metadata for a conda distribution/package that + # provides a `torch` importable package, if any. + conda_torch_dist = None + if compat.is_conda: + from PyInstaller.utils.hooks import conda_support + try: + conda_torch_dist = conda_support.package_distribution('torch') + except ModuleNotFoundError: + conda_torch_dist = None + + if conda_torch_dist: + # Anaconda-packaged torch + if 'mkl' not in conda_torch_dist.dependencies: + logger.info('hook-torch: this torch build (Anaconda package) does not depend on MKL...') + return [] + + logger.info('hook-torch: collecting DLLs from MKL and its dependencies (Anaconda packages)') + mkl_binaries = conda_support.collect_dynamic_libs('mkl', dependencies=True) + else: + # Non-Anaconda torch (e.g., PyPI wheel) + import packaging.requirements + from _pyinstaller_hooks_contrib.compat import importlib_metadata + + # Check if torch depends on `mkl` + dist = importlib_metadata.distribution("torch") + requirements = [packaging.requirements.Requirement(req) for req in dist.requires or []] + requirements = [req.name for req in requirements if req.marker is None or req.marker.evaluate()] + if 'mkl' not in requirements: + logger.info('hook-torch: this torch build does not depend on MKL...') + return [] + + # Find requirements of mkl - this should yield `intel-openmp` and `tbb`, which install DLLs in the same + # way as `mkl`. + try: + dist = importlib_metadata.distribution("mkl") + except importlib_metadata.PackageNotFoundError: + return [] # For some reason, `mkl` distribution is unavailable. + requirements = [packaging.requirements.Requirement(req) for req in dist.requires or []] + requirements = [req.name for req in requirements if req.marker is None or req.marker.evaluate()] + + requirements = ['mkl'] + requirements + + mkl_binaries = [] + logger.info('hook-torch: collecting DLLs from MKL and its dependencies: %r', requirements) + for requirement in requirements: + try: + dist = importlib_metadata.distribution(requirement) + except importlib_metadata.PackageNotFoundError: + continue + + # Go over files, and match DLLs in /Library/bin directory + for dist_file in (dist.files or []): + # NOTE: `importlib_metadata.PackagePath.match()` does not seem to properly normalize the + # separator, and on Windows, RECORD can apparently end up with entries that use either Windows + # or POSIX-style separators (see pyinstaller/pyinstaller-hooks-contrib#879). This is why we + # first resolve the file's location (which yields a `pathlib.Path` instance), and perform + # matching on resolved path. + dll_file = dist.locate_file(dist_file).resolve() + if not dll_file.match('**/Library/bin/*.dll'): + continue + mkl_binaries.append((str(dll_file), '.')) + + if mkl_binaries: + logger.info( + 'hook-torch: found MKL DLLs: %r', + sorted([os.path.basename(src_name) for src_name, dest_name in mkl_binaries]) + ) + else: + logger.info('hook-torch: no MKL DLLs found.') + + return mkl_binaries + + try: + mkl_binaries = _collect_mkl_dlls() + except Exception: + # Log the exception, but make it non-fatal + logger.warning("hook-torch: failed to collect MKL DLLs!", exc_info=True) + mkl_binaries = [] + binaries += mkl_binaries +else: + datas = [(get_package_paths("torch")[1], "torch")] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchao.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchao.py new file mode 100644 index 0000000..5d36ef1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchao.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Collect source .py files for JIT/torchscript. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchaudio.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchaudio.py new file mode 100644 index 0000000..57e570e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchaudio.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_dynamic_libs, collect_submodules + +# Collect dynamic extensions from torchaudio/lib - some of them are loaded dynamically, and are thus not automatically +# collected. +binaries = collect_dynamic_libs('torchaudio') +hiddenimports = collect_submodules('torchaudio.lib') + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchtext.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchtext.py new file mode 100644 index 0000000..5ada443 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchtext.py @@ -0,0 +1,21 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_dynamic_libs, collect_submodules + +# Collect dynamic extensions from torchtext/lib - some of them are loaded dynamically, and are thus not automatically +# collected. +binaries = collect_dynamic_libs('torchtext') +hiddenimports = collect_submodules('torchtext.lib') + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchvision.io.image.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchvision.io.image.py new file mode 100644 index 0000000..ba4a894 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchvision.io.image.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# torchivison.io.image attempts to dynamically load the torchvision.image extension. +hiddenimports = ['torchvision.image'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchvision.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchvision.py new file mode 100644 index 0000000..f0ce8e4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-torchvision.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Functions from torchvision.ops.* modules require torchvision._C extension module, which PyInstaller fails to pick up +# automatically due to indirect load. +hiddenimports = ['torchvision._C'] + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame.py new file mode 100644 index 0000000..404221a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ["pkgutil"] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_client.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_client.py new file mode 100644 index 0000000..c134034 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_client.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_client", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_code.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_code.py new file mode 100644 index 0000000..333020b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_code.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = [*collect_data_files("trame_code", subdir="module")] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_components.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_components.py new file mode 100644 index 0000000..d49cfb4 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_components.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_components", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_datagrid.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_datagrid.py new file mode 100644 index 0000000..601481c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_datagrid.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_datagrid", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_deckgl.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_deckgl.py new file mode 100644 index 0000000..091566e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_deckgl.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_deckgl", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_formkit.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_formkit.py new file mode 100644 index 0000000..f677965 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_formkit.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = [*collect_data_files("trame_formkit", subdir="module")] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_grid.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_grid.py new file mode 100644 index 0000000..0373131 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_grid.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = [*collect_data_files("trame_grid", subdir="module")] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_iframe.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_iframe.py new file mode 100644 index 0000000..5ee77f7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_iframe.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_iframe", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_keycloak.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_keycloak.py new file mode 100644 index 0000000..89413a6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_keycloak.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_keycloak", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_leaflet.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_leaflet.py new file mode 100644 index 0000000..9e2f295 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_leaflet.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = [*collect_data_files("trame_leaflet", subdir="module")] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_markdown.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_markdown.py new file mode 100644 index 0000000..7107379 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_markdown.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = [*collect_data_files("trame_markdown", subdir="module")] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_matplotlib.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_matplotlib.py new file mode 100644 index 0000000..63e6e66 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_matplotlib.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = [*collect_data_files("trame_matplotlib", subdir="module")] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_mesh_streamer.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_mesh_streamer.py new file mode 100644 index 0000000..b782f7a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_mesh_streamer.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +hiddenimports = ["vtk"] +datas = collect_data_files("trame_mesh_streamer", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_plotly.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_plotly.py new file mode 100644 index 0000000..eaa2ecd --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_plotly.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_plotly", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_pvui.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_pvui.py new file mode 100644 index 0000000..209cd63 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_pvui.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_pvui", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_quasar.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_quasar.py new file mode 100644 index 0000000..3dc1c26 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_quasar.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = [*collect_data_files("trame_quasar", subdir="module")] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_rca.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_rca.py new file mode 100644 index 0000000..b9e5da9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_rca.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_rca", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_router.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_router.py new file mode 100644 index 0000000..a756569 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_router.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_router", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_simput.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_simput.py new file mode 100644 index 0000000..d80a7ec --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_simput.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_simput", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_tauri.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_tauri.py new file mode 100644 index 0000000..af47491 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_tauri.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_tauri", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_tweakpane.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_tweakpane.py new file mode 100644 index 0000000..81c9190 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_tweakpane.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = [*collect_data_files("trame_tweakpane", subdir="module")] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vega.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vega.py new file mode 100644 index 0000000..fe157d2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vega.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_vega", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vtk.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vtk.py new file mode 100644 index 0000000..865cbd9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vtk.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = [ + *collect_data_files("trame_vtk", subdir="modules"), + *collect_data_files("trame_vtk", subdir="tools"), +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vtk3d.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vtk3d.py new file mode 100644 index 0000000..1c85729 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vtk3d.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_vtk3d", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vtklocal.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vtklocal.py new file mode 100644 index 0000000..288e1e8 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vtklocal.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +hiddenimports = ["vtk"] +datas = collect_data_files("trame_vtklocal", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vuetify.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vuetify.py new file mode 100644 index 0000000..4ea24fc --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_vuetify.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_vuetify", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_xterm.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_xterm.py new file mode 100644 index 0000000..39c3a72 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trame_xterm.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("trame_xterm", subdir="module") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-transformers.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-transformers.py new file mode 100644 index 0000000..6fd7a35 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-transformers.py @@ -0,0 +1,37 @@ +from PyInstaller.utils.hooks import ( + copy_metadata, + get_module_attribute, + is_module_satisfies, + logger, +) + +datas = [] + +# At run-time, `transformers` queries the metadata of several packages to check for their presence. The list of required +# (core) packages is stored as `transformers.dependency_versions_check.pkgs_to_check_at_runtime`. However, there is more +# comprehensive list of dependencies and their versions available in `transformers.dependency_versions_table.deps`, +# which includes non-core dependencies. Unfortunately, we cannot foresee which of those the user will actually require, +# so we collect metadata for all listed dists that are available in the build environment, in order to make them visible +# to `transformers` at run-time. +try: + dependencies = get_module_attribute( + 'transformers.dependency_versions_table', + 'deps', + ) +except Exception: + logger.warning( + "hook-transformers: failed to query dependency table (transformers.dependency_versions_table.deps)!", + exc_info=True, + ) + dependencies = {} + +for dependency_name, dependency_req in dependencies.items(): + if not is_module_satisfies(dependency_req): + continue + try: + datas += copy_metadata(dependency_name) + except Exception: + pass + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-travertino.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-travertino.py new file mode 100644 index 0000000..6afc577 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-travertino.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +# Prevent this package from pulling `setuptools_scm` into frozen application, as it makes no sense in that context. +excludedimports = ["setuptools_scm"] + +# Collect metadata to allow package to infer its version at run-time. +datas = copy_metadata("travertino") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trimesh.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trimesh.py new file mode 100644 index 0000000..90ebfda --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-trimesh.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# Collect the *.json resource file. +# This issue is reported in here: https://github.com/mikedh/trimesh/issues/412 +datas = collect_data_files('trimesh') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-triton.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-triton.py new file mode 100644 index 0000000..a1e006c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-triton.py @@ -0,0 +1,47 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# --------------------------------------------------- + +from PyInstaller.utils.hooks import collect_data_files, collect_dynamic_libs, collect_submodules, is_module_satisfies + +hiddenimports = [] +datas = [] + +# Ensure that triton/_C/libtriton.so is collected +binaries = collect_dynamic_libs('triton') + +# triton has a JIT module that requires its source .py files. For some god-forsaken reason, this JIT module +# (`triton.runtime.jit` attempts to directly read the contents of file pointed to by its `__file__` attribute (assuming +# it is a source file). Therefore, `triton.runtime.jit` must not be collected into PYZ. Same goes for `compiler` and +# `language` sub-packages. +module_collection_mode = { + 'triton': 'pyz+py', + 'triton.runtime.jit': 'py', + 'triton.compiler': 'py', + 'triton.language': 'py', +} + +# triton 3.0.0 introduced `triton.backends` sub-package with backend-specific files. +if is_module_satisfies('triton >= 3.0.0'): + # Collect backend sub-modules/packages. + hiddenimports += collect_submodules('triton.backends') + + # At the time of writing (triton v3.1.0), `triton.backends.amd` is a namespace package, and is not captured by the + # above `collect_submodules` call. + hiddenimports += collect_submodules('triton.backends.amd') + + # Collect ptxas compiler files from `triton/backends/nvidia`, and the HIP/ROCm files from `triton/backends/amd`. + datas += collect_data_files('triton.backends') +else: + # Collect ptxas compiler files from triton/third_party/cuda directory. Strictly speaking, the ptxas executable from + # bin directory should be collected as a binary, but in this case, it makes no difference (plus, PyInstaller >= 6.0 + # has automatic binary-vs-data reclassification). + datas += collect_data_files('triton.third_party.cuda') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ttkthemes.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ttkthemes.py new file mode 100644 index 0000000..87c731b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ttkthemes.py @@ -0,0 +1,56 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for use with the ttkthemes package + +ttkthemes depends on a large set of image and Tcl-code files contained +within its package directory. These are not imported, and thus this hook +is required so they are copied. + +The file structure of the ttkthemes package folder is: +ttkthemes +├───advanced +| └───*.tcl +├───themes +| ├───theme1 +| | ├───theme1 +| | | └───*.gif +| | └───theme1.tcl +| ├───theme2 +| ├───... +| └───pkgIndex.tcl +├───png +└───gif + +The ``themes`` directory contains themes which only have a universal +image version (either base64 encoded in the theme files or GIF), while +``png`` and ``gif`` contain the PNG and GIF versions of the themes which +support both respectively. + +All of this must be copied, as the package expects all the data to be +present and only checks what themes to load at runtime. + +Tested hook on Linux (Ubuntu 18.04, Python 3.6 minimal venv) and on +Windows 7 (Python 3.7, minimal system-wide installation). + +>>> from tkinter import ttk +>>> from ttkthemes import ThemedTk +>>> +>>> +>>> if __name__ == '__main__': +>>> window = ThemedTk(theme="plastik") +>>> ttk.Button(window, text="Quit", command=window.destroy).pack() +>>> window.mainloop() +""" +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("ttkthemes") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ttkwidgets.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ttkwidgets.py new file mode 100644 index 0000000..94c65e3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ttkwidgets.py @@ -0,0 +1,38 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for use with the ttkwidgets package + +ttkwidgets provides a set of cross-platform widgets for Tkinter/ttk, +some of which depend on image files in order to function properly. + +These images files are all provided in the `ttkwidgets/assets` folder, +which has to be copied by PyInstaller. + +This hook has been tested on Ubuntu 18.04 (Python 3.6.8 venv) and +Windows 7 (Python 3.5.4 system-wide). + +>>> import tkinter as tk +>>> from ttkwidgets import CheckboxTreeview +>>> +>>> window = tk.Tk() +>>> tree = CheckboxTreeview(window) +>>> tree.insert("", tk.END, "test", text="Hello World!") +>>> tree.insert("test", tk.END, "test2", text="Hello World again!") +>>> tree.insert("test", tk.END, "test3", text="Hello World again again!") +>>> tree.pack() +>>> window.mainloop() +""" + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files("ttkwidgets") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tzdata.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tzdata.py new file mode 100644 index 0000000..2f540db --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tzdata.py @@ -0,0 +1,22 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files, collect_submodules + +# Collect timezone data files +datas = collect_data_files("tzdata") + +# Collect submodules; each data subdirectory is in fact a package +# (e.g., zoneinfo.Europe), so we need its __init__.py for data files +# (e.g., zoneinfo/Europe/Ljubljana) to be discoverable via +# importlib.resources +hiddenimports = collect_submodules("tzdata") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tzwhere.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tzwhere.py new file mode 100644 index 0000000..5c583af --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-tzwhere.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('tzwhere') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-u1db.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-u1db.py new file mode 100644 index 0000000..ddd32c9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-u1db.py @@ -0,0 +1,31 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Pyinstaller hook for u1db module + +This hook was tested with: +- u1db 0.1.4 : https://launchpad.net/u1db +- Python 2.7.10 +- Linux Debian GNU/Linux unstable (sid) + +Test script used for testing: + + import u1db + db = u1db.open("mydb1.u1db", create=True) + doc = db.create_doc({"key": "value"}, doc_id="testdoc") + print doc.content + print doc.doc_id +""" + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('u1db') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ultralytics.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ultralytics.py new file mode 100644 index 0000000..c49eac3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-ultralytics.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# Collect config .yaml files from ultralytics/cfg directory. +datas = collect_data_files('ultralytics') + +# Collect source .py files for JIT/torchscript. Requires PyInstaller >= 5.3, no-op in older versions. +module_collection_mode = 'pyz+py' diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-umap.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-umap.py new file mode 100644 index 0000000..5ae0d4d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-umap.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('umap-learn') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-unidecode.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-unidecode.py new file mode 100644 index 0000000..a51d89d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-unidecode.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for the unidecode package: https://pypi.python.org/pypi/unidecode +# Tested with Unidecode 0.4.21 and Python 3.6.2, on Windows 10 x64. + +from PyInstaller.utils.hooks import collect_submodules + +# Unidecode dynamically imports modules with relevant character mappings. +# Non-ASCII characters are ignored if the mapping files are not found. +hiddenimports = collect_submodules('unidecode') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-uniseg.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-uniseg.py new file mode 100644 index 0000000..af28f0f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-uniseg.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for the uniseg module: https://pypi.python.org/pypi/uniseg + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('uniseg') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-urllib3.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-urllib3.py new file mode 100644 index 0000000..cafd1b0 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-urllib3.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules, is_module_satisfies + +# If this is `urllib3` from `urllib3-future`, collect submodules in order to avoid missing modules due to indirect +# imports. With `urllib3` from "classic" `urllib3`, this does not seem to be necessary. +if is_module_satisfies("urllib3-future"): + hiddenimports = collect_submodules("urllib3") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-urllib3_future.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-urllib3_future.py new file mode 100644 index 0000000..0baa1d7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-urllib3_future.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +# Collect submodules in order to avoid missing modules due to indirect imports. +hiddenimports = collect_submodules("urllib3_future") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-usb.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-usb.py new file mode 100644 index 0000000..5721eaa --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-usb.py @@ -0,0 +1,91 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import ctypes.util +import os + +from PyInstaller.depend.utils import _resolveCtypesImports +from PyInstaller.compat import is_cygwin, getenv +from PyInstaller.utils.hooks import logger + +# Include glob for library lookup in run-time hook. +hiddenimports = ['glob'] + +# https://github.com/walac/pyusb/blob/master/docs/faq.rst +# https://github.com/walac/pyusb/blob/master/docs/tutorial.rst + +binaries = [] + +# Running usb.core.find() in this script crashes Ubuntu 14.04LTS, +# let users circumvent pyusb discovery with an environment variable. +skip_pyusb_discovery = \ + bool(getenv('PYINSTALLER_USB_HOOK_SKIP_PYUSB_DISCOVERY')) + +# Try to use pyusb's library locator. +if not skip_pyusb_discovery: + import usb.core + import usb.backend + try: + # get the backend symbols before find + backend_contents_before_discovery = set(dir(usb.backend)) + # perform find, which will load a usb library if found + usb.core.find() + # get the backend symbols which have been added (loaded) + backends = set(dir(usb.backend)) - backend_contents_before_discovery + for usblib in [getattr(usb.backend, be)._lib for be in backends]: + if usblib is not None: + if os.path.isabs(usblib._name): + binaries.append((os.path.basename(usblib._name), usblib._name, "BINARY")) + else: + # OSX returns the full path, Linux only the filename. + # try to resolve the library names to absolute paths. + backend_lib_full_paths = _resolveCtypesImports([os.path.basename(usblib._name)]) + if backend_lib_full_paths: + binaries.append(backend_lib_full_paths[0]) + except (ValueError, usb.core.USBError) as exc: + logger.warning("%s", exc) + +# If pyusb didn't find a backend, manually search for usb libraries. +if not binaries: + # NOTE: Update these lists when adding further libs. + if is_cygwin: + libusb_candidates = ['cygusb-1.0-0.dll', 'cygusb0.dll'] + else: + libusb_candidates = [ + # libusb10 + 'usb-1.0', + 'usb', + 'libusb-1.0', + # libusb01 + 'usb-0.1', + 'libusb0', + # openusb + 'openusb', + ] + + backend_library_basenames = [] + for candidate in libusb_candidates: + libname = ctypes.util.find_library(candidate) + if libname is not None: + if os.path.isabs(libname): + binaries.append((os.path.basename(libname), libname, "BINARY")) + else: + backend_lib_full_paths = _resolveCtypesImports([os.path.basename(libname)]) + if backend_lib_full_paths: + binaries.append(backend_lib_full_paths[0]) + +# Validate and normalize the first found usb library. +if binaries: + # `_resolveCtypesImports` returns a 3-tuple, but `binaries` are only + # 2-tuples, so remove the last element: + assert len(binaries[0]) == 3 + binaries = [(binaries[0][1], '.')] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-uuid6.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-uuid6.py new file mode 100644 index 0000000..8a85018 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-uuid6.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import is_module_satisfies, copy_metadata + +# Starting with version 2025.0.1, uuid6 queries its metadata for version information. +if is_module_satisfies('uuid6 >= 2025.0.1'): + datas = copy_metadata('uuid6') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-uvicorn.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-uvicorn.py new file mode 100644 index 0000000..0acdd3c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-uvicorn.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('uvicorn') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-uvloop.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-uvloop.py new file mode 100644 index 0000000..4c4280c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-uvloop.py @@ -0,0 +1,19 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# +# Hook for the uvloop package: https://pypi.python.org/pypi/uvloop +# +# Tested with uvloop 0.8.1 and Python 3.6.2, on Ubuntu 16.04.1 64bit. + +from PyInstaller.utils.hooks import collect_submodules + +hiddenimports = collect_submodules('uvloop') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vaderSentiment.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vaderSentiment.py new file mode 100644 index 0000000..0879fff --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vaderSentiment.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('vaderSentiment') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkAcceleratorsVTKmCore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkAcceleratorsVTKmCore.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkAcceleratorsVTKmCore.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkAcceleratorsVTKmDataModel.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkAcceleratorsVTKmDataModel.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkAcceleratorsVTKmDataModel.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkAcceleratorsVTKmFilters.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkAcceleratorsVTKmFilters.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkAcceleratorsVTKmFilters.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkChartsCore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkChartsCore.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkChartsCore.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonColor.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonColor.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonColor.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonComputationalGeometry.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonComputationalGeometry.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonComputationalGeometry.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonDataModel.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonDataModel.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonDataModel.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonExecutionModel.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonExecutionModel.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonExecutionModel.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonMath.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonMath.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonMath.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonMisc.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonMisc.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonMisc.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonPython.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonPython.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonPython.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonSystem.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonSystem.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonSystem.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonTransforms.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonTransforms.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonTransforms.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkDomainsChemistry.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkDomainsChemistry.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkDomainsChemistry.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkDomainsChemistryOpenGL2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkDomainsChemistryOpenGL2.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkDomainsChemistryOpenGL2.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersAMR.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersAMR.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersAMR.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersCellGrid.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersCellGrid.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersCellGrid.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersCore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersCore.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersCore.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersExtraction.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersExtraction.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersExtraction.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersFlowPaths.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersFlowPaths.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersFlowPaths.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeneral.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeneral.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeneral.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeneric.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeneric.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeneric.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeometry.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeometry.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeometry.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeometryPreview.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeometryPreview.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeometryPreview.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersHybrid.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersHybrid.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersHybrid.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersHyperTree.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersHyperTree.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersHyperTree.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersImaging.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersImaging.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersImaging.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersModeling.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersModeling.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersModeling.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallel.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallel.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallel.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallelDIY2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallelDIY2.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallelDIY2.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallelImaging.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallelImaging.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallelImaging.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallelStatistics.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallelStatistics.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallelStatistics.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersPoints.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersPoints.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersPoints.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersProgrammable.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersProgrammable.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersProgrammable.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersPython.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersPython.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersPython.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersReduction.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersReduction.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersReduction.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersSMP.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersSMP.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersSMP.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersSelection.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersSelection.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersSelection.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersSources.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersSources.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersSources.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersStatistics.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersStatistics.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersStatistics.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTemporal.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTemporal.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTemporal.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTensor.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTensor.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTensor.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTexture.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTexture.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTexture.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTopology.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTopology.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTopology.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersVerdict.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersVerdict.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersVerdict.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkGeovisCore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkGeovisCore.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkGeovisCore.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOAMR.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOAMR.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOAMR.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOAsynchronous.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOAsynchronous.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOAsynchronous.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOAvmesh.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOAvmesh.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOAvmesh.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCGNSReader.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCGNSReader.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCGNSReader.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCONVERGECFD.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCONVERGECFD.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCONVERGECFD.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCellGrid.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCellGrid.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCellGrid.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCesium3DTiles.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCesium3DTiles.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCesium3DTiles.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOChemistry.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOChemistry.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOChemistry.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCityGML.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCityGML.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCityGML.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCore.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCore.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOERF.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOERF.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOERF.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOEnSight.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOEnSight.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOEnSight.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOEngys.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOEngys.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOEngys.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExodus.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExodus.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExodus.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExport.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExport.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExport.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExportGL2PS.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExportGL2PS.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExportGL2PS.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExportPDF.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExportPDF.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExportPDF.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOFDS.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOFDS.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOFDS.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOFLUENTCFF.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOFLUENTCFF.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOFLUENTCFF.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOGeoJSON.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOGeoJSON.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOGeoJSON.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOGeometry.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOGeometry.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOGeometry.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOH5Rage.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOH5Rage.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOH5Rage.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOH5part.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOH5part.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOH5part.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOHDF.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOHDF.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOHDF.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOIOSS.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOIOSS.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOIOSS.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOImage.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOImage.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOImage.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOImport.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOImport.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOImport.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOInfovis.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOInfovis.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOInfovis.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOLANLX3D.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOLANLX3D.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOLANLX3D.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOLSDyna.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOLSDyna.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOLSDyna.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOLegacy.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOLegacy.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOLegacy.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOMINC.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOMINC.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOMINC.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOMotionFX.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOMotionFX.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOMotionFX.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOMovie.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOMovie.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOMovie.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIONetCDF.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIONetCDF.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIONetCDF.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOOMF.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOOMF.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOOMF.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOOggTheora.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOOggTheora.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOOggTheora.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOPIO.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOPIO.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOPIO.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOPLY.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOPLY.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOPLY.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallel.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallel.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallel.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallelExodus.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallelExodus.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallelExodus.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallelLSDyna.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallelLSDyna.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallelLSDyna.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallelXML.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallelXML.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallelXML.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOSQL.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOSQL.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOSQL.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOSegY.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOSegY.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOSegY.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOTRUCHAS.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOTRUCHAS.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOTRUCHAS.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOTecplotTable.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOTecplotTable.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOTecplotTable.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOVPIC.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOVPIC.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOVPIC.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOVeraOut.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOVeraOut.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOVeraOut.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOVideo.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOVideo.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOVideo.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOXML.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOXML.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOXML.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOXMLParser.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOXMLParser.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOXMLParser.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOXdmf2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOXdmf2.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOXdmf2.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingColor.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingColor.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingColor.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingCore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingCore.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingCore.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingFourier.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingFourier.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingFourier.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingGeneral.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingGeneral.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingGeneral.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingHybrid.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingHybrid.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingHybrid.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingMath.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingMath.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingMath.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingMorphological.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingMorphological.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingMorphological.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingOpenGL2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingOpenGL2.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingOpenGL2.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingSources.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingSources.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingSources.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingStatistics.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingStatistics.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingStatistics.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingStencil.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingStencil.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingStencil.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInfovisCore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInfovisCore.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInfovisCore.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInfovisLayout.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInfovisLayout.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInfovisLayout.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInteractionImage.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInteractionImage.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInteractionImage.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInteractionStyle.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInteractionStyle.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInteractionStyle.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInteractionWidgets.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInteractionWidgets.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInteractionWidgets.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkParallelCore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkParallelCore.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkParallelCore.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkPythonContext2D.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkPythonContext2D.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkPythonContext2D.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingAnnotation.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingAnnotation.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingAnnotation.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingCellGrid.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingCellGrid.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingCellGrid.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingContext2D.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingContext2D.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingContext2D.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingContextOpenGL2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingContextOpenGL2.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingContextOpenGL2.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingCore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingCore.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingCore.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingExternal.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingExternal.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingExternal.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingFreeType.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingFreeType.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingFreeType.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingGL2PSOpenGL2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingGL2PSOpenGL2.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingGL2PSOpenGL2.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingGridAxes.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingGridAxes.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingGridAxes.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingHyperTreeGrid.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingHyperTreeGrid.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingHyperTreeGrid.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingImage.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingImage.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingImage.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingLICOpenGL2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingLICOpenGL2.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingLICOpenGL2.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingLOD.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingLOD.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingLOD.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingLabel.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingLabel.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingLabel.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingMatplotlib.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingMatplotlib.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingMatplotlib.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingOpenGL2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingOpenGL2.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingOpenGL2.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingParallel.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingParallel.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingParallel.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingSceneGraph.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingSceneGraph.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingSceneGraph.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingUI.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingUI.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingUI.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVR.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVR.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVR.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVRModels.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVRModels.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVRModels.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVolume.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVolume.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVolume.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVolumeAMR.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVolumeAMR.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVolumeAMR.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVolumeOpenGL2.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVolumeOpenGL2.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVolumeOpenGL2.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVtkJS.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVtkJS.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVtkJS.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkSerializationManager.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkSerializationManager.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkSerializationManager.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkTestingRendering.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkTestingRendering.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkTestingRendering.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkTestingSerialization.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkTestingSerialization.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkTestingSerialization.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkViewsContext2D.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkViewsContext2D.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkViewsContext2D.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkViewsCore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkViewsCore.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkViewsCore.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkViewsInfovis.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkViewsInfovis.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkViewsInfovis.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkWebCore.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkWebCore.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkWebCore.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkWebGLExporter.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkWebGLExporter.py new file mode 100644 index 0000000..960187b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkWebGLExporter.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from _pyinstaller_hooks_contrib.utils.vtkmodules import add_vtkmodules_dependencies + +hiddenimports = add_vtkmodules_dependencies(__file__) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkpython.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkpython.py new file mode 100644 index 0000000..76c1e60 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-vtkpython.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os +if os.name == 'posix': + hiddenimports = [ + 'libvtkCommonPython', 'libvtkFilteringPython', 'libvtkIOPython', + 'libvtkImagingPython', 'libvtkGraphicsPython', 'libvtkRenderingPython', + 'libvtkHybridPython', 'libvtkParallelPython', 'libvtkPatentedPython' + ] +else: + hiddenimports = [ + 'vtkCommonPython', 'vtkFilteringPython', 'vtkIOPython', + 'vtkImagingPython', 'vtkGraphicsPython', 'vtkRenderingPython', + 'vtkHybridPython', 'vtkParallelPython', 'vtkPatentedPython' + ] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wavefile.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wavefile.py new file mode 100644 index 0000000..11dc973 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wavefile.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +python-wavefile: https://github.com/vokimon/python-wavefile +""" + +from PyInstaller.utils.hooks import collect_dynamic_libs + +binaries = collect_dynamic_libs('wavefile') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-weasyprint.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-weasyprint.py new file mode 100644 index 0000000..e0814ea --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-weasyprint.py @@ -0,0 +1,85 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for weasyprint: https://pypi.python.org/pypi/WeasyPrint +# Tested on version weasyprint 54.0 using Windows 10 and python 3.8 +# Note that weasyprint < 54.0 does not work on python 3.8 due to https://github.com/Kozea/WeasyPrint/issues/1435 +# For weasyprint < 53.0 the required libs are +# libs = [ +# 'gobject-2.0', 'libgobject-2.0-0', 'libgobject-2.0.so.0', 'libgobject-2.0.dylib', +# 'pango-1.0', 'libpango-1.0-0', 'libpango-1.0.so.0', 'libpango-1.0.dylib', +# 'pangocairo-1.0', 'libpangocairo-1.0-0', 'libpangocairo-1.0.so.0', 'libpangocairo-1.0.dylib', +# 'fontconfig', 'libfontconfig', 'libfontconfig-1.dll', 'libfontconfig.so.1', 'libfontconfig-1.dylib', +# 'pangoft2-1.0', 'libpangoft2-1.0-0', 'libpangoft2-1.0.so.0', 'libpangoft2-1.0.dylib' +# ] + +import ctypes.util +import os +from pathlib import Path + +from PyInstaller.compat import is_win +from PyInstaller.depend.utils import _resolveCtypesImports +from PyInstaller.utils.hooks import collect_data_files, logger + +datas = collect_data_files('weasyprint') +binaries = [] +fontconfig_config_dir_found = False + +# On Windows, a GTK3-installation provides fontconfig and the corresponding fontconfig conf files. We have to add these +# for weasyprint to correctly use fonts. +# NOTE: Update these lists if weasyprint requires more libraries +fontconfig_libs = [ + 'fontconfig-1', 'fontconfig', 'libfontconfig', 'libfontconfig-1.dll', 'libfontconfig.so.1', 'libfontconfig-1.dylib' +] +libs = [ + 'gobject-2.0-0', 'gobject-2.0', 'libgobject-2.0-0', 'libgobject-2.0.so.0', 'libgobject-2.0.dylib', + 'pango-1.0-0', 'pango-1.0', 'libpango-1.0-0', 'libpango-1.0.so.0', 'libpango-1.0.dylib', + 'harfbuzz', 'harfbuzz-0.0', 'libharfbuzz-0', 'libharfbuzz.so.0', 'libharfbuzz.so.0', 'libharfbuzz.0.dylib', + 'pangoft2-1.0-0', 'pangoft2-1.0', 'libpangoft2-1.0-0', 'libpangoft2-1.0.so.0', 'libpangoft2-1.0.dylib' +] + +try: + lib_basenames = [] + for lib in libs: + libname = ctypes.util.find_library(lib) + if libname is not None: + lib_basenames += [os.path.basename(libname)] + for lib in fontconfig_libs: + libname = ctypes.util.find_library(lib) + if libname is not None: + lib_basenames += [os.path.basename(libname)] + # Try to load fontconfig config files on Windows from a GTK-installation + if is_win: + fontconfig_config_dir = Path(libname).parent.parent / 'etc/fonts' + if fontconfig_config_dir.exists() and fontconfig_config_dir.is_dir(): + datas += [(str(fontconfig_config_dir), 'etc/fonts')] + fontconfig_config_dir_found = True + if lib_basenames: + resolved_libs = _resolveCtypesImports(lib_basenames) + for resolved_lib in resolved_libs: + binaries.append((resolved_lib[1], '.')) + # Try to load fontconfig config files on other OS + fontconfig_config_dir = Path('/etc/fonts') + if fontconfig_config_dir.exists() and fontconfig_config_dir.is_dir(): + datas += [(str(fontconfig_config_dir), 'etc/fonts')] + fontconfig_config_dir_found = True + +except Exception as e: + logger.warning('Error while trying to find system-installed depending libraries: %s', e) + +if not binaries: + logger.warning('Depending libraries not found - weasyprint will likely fail to work!') + +if not fontconfig_config_dir_found: + logger.warning( + 'Fontconfig configuration files not found - weasyprint will likely throw warnings and use default fonts!' + ) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-web3.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-web3.py new file mode 100644 index 0000000..bc5c97e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-web3.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata("web3") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-webassets.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-webassets.py new file mode 100644 index 0000000..8a4b983 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-webassets.py @@ -0,0 +1,14 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('webassets', include_py_files=True) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-webrtcvad.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-webrtcvad.py new file mode 100644 index 0000000..853ead1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-webrtcvad.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('webrtcvad') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-websockets.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-websockets.py new file mode 100644 index 0000000..84e0ec2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-websockets.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_submodules + +# Websockets lazily loads its submodules. +hiddenimports = collect_submodules("websockets") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-webview.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-webview.py new file mode 100644 index 0000000..e465a66 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-webview.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# hook for https://github.com/r0x0r/pywebview + +from PyInstaller.utils.hooks import collect_data_files, collect_dynamic_libs +from PyInstaller.compat import is_win + +if is_win: + datas = collect_data_files('webview', subdir='lib') + binaries = collect_dynamic_libs('webview') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-win32com.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-win32com.py new file mode 100644 index 0000000..346d133 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-win32com.py @@ -0,0 +1,20 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = [ + # win32com client and server util + # modules could be hidden imports + # of some modules using win32com. + # Included for completeness. + 'win32com.client.util', + 'win32com.server.util', +] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wordcloud.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wordcloud.py new file mode 100644 index 0000000..831a3f6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wordcloud.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('wordcloud') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-workflow.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-workflow.py new file mode 100644 index 0000000..43de8d7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-workflow.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('workflow') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wx.lib.activex.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wx.lib.activex.py new file mode 100644 index 0000000..1ca9cf9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wx.lib.activex.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import exec_statement + +# This needed because comtypes wx.lib.activex generates some stuff. +exec_statement("import wx.lib.activex") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wx.lib.pubsub.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wx.lib.pubsub.py new file mode 100644 index 0000000..c95f591 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wx.lib.pubsub.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('wx.lib.pubsub', include_py_files=True, excludes=['*.txt', '**/__pycache__']) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wx.xrc.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wx.xrc.py new file mode 100644 index 0000000..10c86a3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-wx.xrc.py @@ -0,0 +1,13 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +hiddenimports = ['wx._xml', 'wx'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xarray.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xarray.py new file mode 100644 index 0000000..79a1da5 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xarray.py @@ -0,0 +1,30 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata, collect_entry_point + +datas = [] +hiddenimports = [] + +# Collect additional backend plugins that are registered via `xarray.backends` entry-point. +ep_datas, ep_hiddenimports = collect_entry_point('xarray.backends') +datas += ep_datas +hiddenimports += ep_hiddenimports + +# Similarly, collect chunk manager entry-points. +ep_datas, ep_hiddenimports = collect_entry_point('xarray.chunkmanagers') +datas += ep_datas +hiddenimports += ep_hiddenimports + +# `xarray` requires `numpy` metadata due to several calls to its `xarray.core.utils.module_available` with specified +# `minversion` argument, which end up calling `importlib.metadata.version`. +datas += copy_metadata('numpy') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xml.dom.html.HTMLDocument.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xml.dom.html.HTMLDocument.py new file mode 100644 index 0000000..97c7f4d --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xml.dom.html.HTMLDocument.py @@ -0,0 +1,67 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# xml.dom.html.HTMLDocument +hiddenimports = ['xml.dom.html.HTMLAnchorElement', + 'xml.dom.html.HTMLAppletElement', + 'xml.dom.html.HTMLAreaElement', + 'xml.dom.html.HTMLBaseElement', + 'xml.dom.html.HTMLBaseFontElement', + 'xml.dom.html.HTMLBodyElement', + 'xml.dom.html.HTMLBRElement', + 'xml.dom.html.HTMLButtonElement', + 'xml.dom.html.HTMLDirectoryElement', + 'xml.dom.html.HTMLDivElement', + 'xml.dom.html.HTMLDListElement', + 'xml.dom.html.HTMLElement', + 'xml.dom.html.HTMLFieldSetElement', + 'xml.dom.html.HTMLFontElement', + 'xml.dom.html.HTMLFormElement', + 'xml.dom.html.HTMLFrameElement', + 'xml.dom.html.HTMLFrameSetElement', + 'xml.dom.html.HTMLHeadElement', + 'xml.dom.html.HTMLHeadingElement', + 'xml.dom.html.HTMLHRElement', + 'xml.dom.html.HTMLHtmlElement', + 'xml.dom.html.HTMLIFrameElement', + 'xml.dom.html.HTMLImageElement', + 'xml.dom.html.HTMLInputElement', + 'xml.dom.html.HTMLIsIndexElement', + 'xml.dom.html.HTMLLabelElement', + 'xml.dom.html.HTMLLegendElement', + 'xml.dom.html.HTMLLIElement', + 'xml.dom.html.HTMLLinkElement', + 'xml.dom.html.HTMLMapElement', + 'xml.dom.html.HTMLMenuElement', + 'xml.dom.html.HTMLMetaElement', + 'xml.dom.html.HTMLModElement', + 'xml.dom.html.HTMLObjectElement', + 'xml.dom.html.HTMLOListElement', + 'xml.dom.html.HTMLOptGroupElement', + 'xml.dom.html.HTMLOptionElement', + 'xml.dom.html.HTMLParagraphElement', + 'xml.dom.html.HTMLParamElement', + 'xml.dom.html.HTMLPreElement', + 'xml.dom.html.HTMLQuoteElement', + 'xml.dom.html.HTMLScriptElement', + 'xml.dom.html.HTMLSelectElement', + 'xml.dom.html.HTMLStyleElement', + 'xml.dom.html.HTMLTableCaptionElement', + 'xml.dom.html.HTMLTableCellElement', + 'xml.dom.html.HTMLTableColElement', + 'xml.dom.html.HTMLTableElement', + 'xml.dom.html.HTMLTableRowElement', + 'xml.dom.html.HTMLTableSectionElement', + 'xml.dom.html.HTMLTextAreaElement', + 'xml.dom.html.HTMLTitleElement', + 'xml.dom.html.HTMLUListElement', + ] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xml.sax.saxexts.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xml.sax.saxexts.py new file mode 100644 index 0000000..5be293b --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xml.sax.saxexts.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# xml.sax.saxexts +hiddenimports = ["xml.sax.drivers2.drv_pyexpat", + "xml.sax.drivers.drv_xmltok", + 'xml.sax.drivers2.drv_xmlproc', + "xml.sax.drivers.drv_xmltoolkit", + "xml.sax.drivers.drv_xmllib", + "xml.sax.drivers.drv_xmldc", + 'xml.sax.drivers.drv_pyexpat', + 'xml.sax.drivers.drv_xmlproc_val', + 'xml.sax.drivers.drv_htmllib', + 'xml.sax.drivers.drv_sgmlop', + "xml.sax.drivers.drv_sgmllib", + ] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xmldiff.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xmldiff.py new file mode 100644 index 0000000..eb2b966 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xmldiff.py @@ -0,0 +1,16 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +# Hook for https://github.com/Shoobx/xmldiff + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('xmldiff') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xmlschema.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xmlschema.py new file mode 100644 index 0000000..05a777c --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xmlschema.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# hook for https://github.com/sissaschool/xmlschema +from PyInstaller.utils.hooks import collect_data_files + +# the library contains a bunch of XSD schemas which are loaded in run time +datas = collect_data_files("xmlschema") diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xsge_gui.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xsge_gui.py new file mode 100644 index 0000000..068781e --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xsge_gui.py @@ -0,0 +1,17 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for the xsge_gui module: https://pypi.python.org/pypi/xsge_gui + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('xsge_gui') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xyzservices.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xyzservices.py new file mode 100644 index 0000000..d7b0ecf --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-xyzservices.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('xyzservices') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-yapf_third_party.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-yapf_third_party.py new file mode 100644 index 0000000..d138c53 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-yapf_third_party.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2024 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +datas = collect_data_files('yapf_third_party') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-z3c.rml.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-z3c.rml.py new file mode 100644 index 0000000..658e44f --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-z3c.rml.py @@ -0,0 +1,25 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import collect_data_files + +# `z3c.rml` uses Bitstream Vera TTF fonts from the `reportlab` package. As that package can be used without the bundled +# fonts and as some of the bundled fonts have restrictive license (e.g., DarkGarden), we collect the required subset +# of fonts here, instead of collecting them all in a hook for `reportlab`. +datas = collect_data_files( + "reportlab", + includes=[ + "fonts/00readme.txt", + "fonts/bitstream-vera-license.txt", + "fonts/Vera*.ttf", + ], +) diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-zarr.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-zarr.py new file mode 100644 index 0000000..0aefa8a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-zarr.py @@ -0,0 +1,15 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2025 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('zarr') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-zeep.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-zeep.py new file mode 100644 index 0000000..002e106 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-zeep.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +# Hook for the zeep module: https://pypi.python.org/pypi/zeep +# Tested with zeep 0.13.0, Python 2.7, Windows + +from PyInstaller.utils.hooks import copy_metadata + +datas = copy_metadata('zeep') diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-zmq.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-zmq.py new file mode 100644 index 0000000..5a9f833 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-zmq.py @@ -0,0 +1,63 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2020 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ +""" +Hook for PyZMQ. Cython based Python bindings for messaging library ZeroMQ. +http://www.zeromq.org/ +""" +import os +import glob +from PyInstaller.utils.hooks import collect_submodules +from PyInstaller.utils.hooks import is_module_satisfies, get_module_file_attribute +from PyInstaller.compat import is_win + +binaries = [] +datas = [] +hiddenimports = ['zmq.utils.garbage'] + +# PyZMQ comes with two backends, cython and cffi. Calling collect_submodules() +# on zmq.backend seems to trigger attempt at compilation of C extension +# module for cffi backend, which will fail if ZeroMQ development files +# are not installed on the system. On non-English locales, the resulting +# localized error messages may cause UnicodeDecodeError. Collecting each +# backend individually, however, does not seem to cause any problems. +hiddenimports += ['zmq.backend'] + +# cython backend +hiddenimports += collect_submodules('zmq.backend.cython') + +# cffi backend: contains extra data that needs to be collected +# (e.g., _cdefs.h) +# +# NOTE: the cffi backend requires compilation of C extension at runtime, +# which appears to be broken in frozen program. So avoid collecting +# it altogether... +if False: + from PyInstaller.utils.hooks import collect_data_files + + hiddenimports += collect_submodules('zmq.backend.cffi') + datas += collect_data_files('zmq.backend.cffi', excludes=['**/__pycache__', ]) + +# Starting with pyzmq 22.0.0, the DLLs in Windows wheel are located in +# site-packages/pyzmq.libs directory along with a .load_order file. This +# file is required on python 3.7 and earlier. On later versions of python, +# the pyzmq.libs is required to exist. +if is_win and is_module_satisfies('pyzmq >= 22.0.0'): + zmq_root = os.path.dirname(get_module_file_attribute('zmq')) + libs_dir = os.path.join(zmq_root, os.path.pardir, 'pyzmq.libs') + # .load_order file (22.0.3 replaced underscore with dash and added + # version suffix on this file, hence the glob) + load_order_file = glob.glob(os.path.join(libs_dir, '.load*')) + datas += [(filename, 'pyzmq.libs') for filename in load_order_file] + # We need to collect DLLs into _MEIPASS, to avoid duplication due to + # subsequent binary analysis + dll_files = glob.glob(os.path.join(libs_dir, "*.dll")) + binaries += [(dll_file, '.') for dll_file in dll_files] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-zoneinfo.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-zoneinfo.py new file mode 100644 index 0000000..03a5e41 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/stdhooks/hook-zoneinfo.py @@ -0,0 +1,18 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2021 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +from PyInstaller.compat import is_win + +# On Windows, timezone data is provided by the tzdata package that is +# not directly loaded. +if is_win: + hiddenimports = ['tzdata'] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/utils/__init__.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/utils/__init__.py new file mode 100644 index 0000000..792d600 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/utils/__init__.py @@ -0,0 +1 @@ +# diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/utils/nvidia_cuda.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/utils/nvidia_cuda.py new file mode 100644 index 0000000..b93064a --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/utils/nvidia_cuda.py @@ -0,0 +1,77 @@ +# ------------------------------------------------------------------ +# Copyright (c) 2023 PyInstaller Development Team. +# +# This file is distributed under the terms of the GNU General Public +# License (version 2.0 or later). +# +# The full license is available in LICENSE, distributed with +# this software. +# +# SPDX-License-Identifier: GPL-2.0-or-later +# ------------------------------------------------------------------ + +import os +import re + +from PyInstaller import compat +from PyInstaller.utils.hooks import ( + logger, + is_module_satisfies, +) + + +# Helper for collecting shared libraries from NVIDIA CUDA packages on linux. +def collect_nvidia_cuda_binaries(hook_file): + # Find the module underlying this nvidia.something hook; i.e., change ``/path/to/hook-nvidia.something.py`` to + # ``nvidia.something``. + hook_name, hook_ext = os.path.splitext(os.path.basename(hook_file)) + assert hook_ext.startswith('.py') + assert hook_name.startswith('hook-') + module_name = hook_name[5:] + + # `search_patterns` was added to `collect_dynamic_libs` in PyInstaller 5.8, so that is the minimum required version. + binaries = [] + if is_module_satisfies('PyInstaller >= 5.8'): + from PyInstaller.utils.hooks import collect_dynamic_libs, PY_DYLIB_PATTERNS + binaries = collect_dynamic_libs( + module_name, + # Collect fully-versioned .so files (not included in default search patterns). + search_patterns=PY_DYLIB_PATTERNS + ["lib*.so.*"], + ) + else: + logger.warning("hook-%s: this hook requires PyInstaller >= 5.8!", module_name) + + return binaries + + +# Helper to turn list of requirements (e.g., ['nvidia-cublas-cu12', 'nvidia-nccl-cu12', 'nvidia-cudnn-cu12']) into +# list of corresponding nvidia.* module names (e.g., ['nvidia.cublas', 'nvidia.nccl', 'nvidia-cudnn']), while ignoring +# unrecognized requirements. Intended for use in hooks for frameworks, such as `torch` and `tensorflow`. +def infer_hiddenimports_from_requirements(requirements): + # All nvidia-* packages install to nvidia top-level package, so we cannot query top-level module via + # metadata. Instead, we manually translate them from dist name to package name. + _PATTERN = r'^nvidia-(?P.+)-cu[\d]+$' + nvidia_hiddenimports = [] + + for req in requirements: + m = re.match(_PATTERN, req) + if m is not None: + # Convert + package_name = "nvidia." + m.group('subpackage').replace('-', '_') + nvidia_hiddenimports.append(package_name) + + return nvidia_hiddenimports + + +def create_symlink_suppression_patterns(hook_file): + hook_name, hook_ext = os.path.splitext(os.path.basename(hook_file)) + assert hook_ext.startswith('.py') + assert hook_name.startswith('hook-') + module_name = hook_name[5:] + + # Applicable only to Linux + if not compat.is_linux: + return [] + + # Pattern: **/{module_dir}/lib/lib*.so* + return [os.path.join('**', *module_name.split('.'), 'lib', 'lib*.so*')] diff --git a/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/utils/vtkmodules.py b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/utils/vtkmodules.py new file mode 100644 index 0000000..6f9a5a7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/_pyinstaller_hooks_contrib/utils/vtkmodules.py @@ -0,0 +1,604 @@ +import os + +# This list of dependencies was obtained via analysis based on code in `vtkmodules/generate_pyi.py` and augmented with +# missing entries until all tests from `test_vtkmodules` pass. Instead of a pre-computed list, we could dynamically +# analyze each module when the hook is executed; however, such approach would be slower, and would also not account +# for all dependencies that had to be added manually. +# +# NOTE: `vtkmodules.vtkCommonCore` is a dependency of every module, so do not list it here. Modules with no additional +# dependencies are also not listed. +_module_dependencies = { + 'vtkmodules.vtkAcceleratorsVTKmDataModel': [ + 'vtkmodules.vtkAcceleratorsVTKmCore', + 'vtkmodules.vtkCommonDataModel', + ], + 'vtkmodules.vtkAcceleratorsVTKmFilters': [ + 'vtkmodules.vtkAcceleratorsVTKmCore', + 'vtkmodules.vtkAcceleratorsVTKmDataModel', + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersCore', + 'vtkmodules.vtkFiltersGeneral', + 'vtkmodules.vtkFiltersGeometry', + 'vtkmodules.vtkImagingCore', + ], + 'vtkmodules.vtkChartsCore': [ + 'vtkmodules.vtkRenderingContext2D', + 'vtkmodules.vtkFiltersGeneral', + ], + 'vtkmodules.vtkCommonColor': [ + 'vtkmodules.vtkCommonDataModel', + ], + 'vtkmodules.vtkCommonComputationalGeometry': [ + 'vtkmodules.vtkCommonDataModel', + ], + 'vtkmodules.vtkCommonDataModel': [ + 'vtkmodules.vtkCommonMath', + 'vtkmodules.vtkCommonTransforms', + 'vtkmodules.util.data_model', + ], + 'vtkmodules.vtkCommonExecutionModel': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.util.execution_model', + ], + 'vtkmodules.vtkCommonMisc': [ + 'vtkmodules.vtkCommonMath', + ], + 'vtkmodules.vtkCommonTransforms': [ + 'vtkmodules.vtkCommonMath', + ], + 'vtkmodules.vtkDomainsChemistry': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOLegacy', + 'vtkmodules.vtkIOXMLParser', + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkDomainsChemistryOpenGL2': [ + 'vtkmodules.vtkDomainsChemistry', + 'vtkmodules.vtkRenderingOpenGL2', + ], + 'vtkmodules.vtkFiltersAMR': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersCellGrid': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersCore': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkCommonMisc', + ], + 'vtkmodules.vtkFiltersExtraction': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersGeneral', + ], + 'vtkmodules.vtkFiltersFlowPaths': [ + 'vtkmodules.vtkCommonComputationalGeometry', + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkCommonMath', + ], + 'vtkmodules.vtkFiltersGeneral': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersCore', + ], + 'vtkmodules.vtkFiltersGeneric': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersGeometry': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersGeometryPreview': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersHybrid': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkCommonTransforms', + 'vtkmodules.vtkFiltersGeometry', + ], + 'vtkmodules.vtkFiltersHyperTree': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersCore', + 'vtkmodules.vtkFiltersGeneral', + ], + 'vtkmodules.vtkFiltersImaging': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersStatistics', + ], + 'vtkmodules.vtkFiltersModeling': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersGeneral', + ], + 'vtkmodules.vtkFiltersParallel': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersCore', + 'vtkmodules.vtkFiltersExtraction', + 'vtkmodules.vtkFiltersGeneral', + 'vtkmodules.vtkFiltersGeometry', + 'vtkmodules.vtkFiltersHybrid', + 'vtkmodules.vtkFiltersHyperTree', + 'vtkmodules.vtkFiltersModeling', + 'vtkmodules.vtkFiltersSources', + 'vtkmodules.vtkFiltersTexture', + ], + 'vtkmodules.vtkFiltersParallelDIY2': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersCore', + 'vtkmodules.vtkFiltersParallel', + ], + 'vtkmodules.vtkFiltersParallelImaging': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersImaging', + 'vtkmodules.vtkFiltersParallel', + 'vtkmodules.vtkImagingCore', + ], + 'vtkmodules.vtkFiltersParallelStatistics': [ + 'vtkmodules.vtkFiltersStatistics', + ], + 'vtkmodules.vtkFiltersPoints': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersModeling', + ], + 'vtkmodules.vtkFiltersProgrammable': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersPython': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersReduction': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersSMP': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkFiltersCore', + 'vtkmodules.vtkFiltersGeneral', + ], + 'vtkmodules.vtkFiltersSelection': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersSources': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersStatistics': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersTemporal': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersCore', + ], + 'vtkmodules.vtkFiltersTensor': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersTexture': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersTopology': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkFiltersVerdict': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkGeovisCore': [ + 'vtkmodules.vtkCommonTransforms', + ], + 'vtkmodules.vtkIOAMR': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOAsynchronous': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + 'vtkmodules.vtkIOImage', + 'vtkmodules.vtkIOXML', + ], + 'vtkmodules.vtkIOAvmesh': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + ], + 'vtkmodules.vtkIOCGNSReader': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOCONVERGECFD': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOCellGrid': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersCellGrid', + 'vtkmodules.vtkIOCore', + ], + 'vtkmodules.vtkIOCesium3DTiles': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + ], + 'vtkmodules.vtkIOChemistry': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + ], + 'vtkmodules.vtkIOCityGML': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOCore': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOERF': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOEnSight': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOEngys': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOExodus': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + 'vtkmodules.vtkIOXMLParser', + ], + 'vtkmodules.vtkIOExport': [ + 'vtkmodules.vtkIOCore', + 'vtkmodules.vtkIOImage', + 'vtkmodules.vtkIOXML', + 'vtkmodules.vtkRenderingContext2D', + 'vtkmodules.vtkRenderingCore', + 'vtkmodules.vtkRenderingFreeType', + 'vtkmodules.vtkRenderingVtkJS', + ], + 'vtkmodules.vtkIOExportGL2PS': [ + 'vtkmodules.vtkIOExport', + 'vtkmodules.vtkRenderingGL2PSOpenGL2', + ], + 'vtkmodules.vtkIOExportPDF': [ + 'vtkmodules.vtkIOExport', + 'vtkmodules.vtkRenderingContext2D', + ], + 'vtkmodules.vtkIOFDS': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOFLUENTCFF': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOGeoJSON': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + ], + 'vtkmodules.vtkIOGeometry': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + 'vtkmodules.vtkIOLegacy', + ], + 'vtkmodules.vtkIOH5Rage': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOH5part': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOHDF': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + ], + 'vtkmodules.vtkIOIOSS': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersCellGrid', + 'vtkmodules.vtkIOCore', + ], + 'vtkmodules.vtkIOImport': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkIOImage': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkImagingCore', + ], + 'vtkmodules.vtkIOInfovis': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOLegacy', + 'vtkmodules.vtkIOXML', + ], + 'vtkmodules.vtkIOLANLX3D': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOLSDyna': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOXMLParser', + ], + 'vtkmodules.vtkIOLegacy': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCellGrid', + 'vtkmodules.vtkIOCore', + ], + 'vtkmodules.vtkIOMINC': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + 'vtkmodules.vtkIOImage', + ], + 'vtkmodules.vtkIOMotionFX': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOMovie': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIONetCDF': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + ], + 'vtkmodules.vtkIOOMF': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOOggTheora': [ + 'vtkmodules.vtkIOMovie', + ], + 'vtkmodules.vtkIOPIO': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOPLY': [ + 'vtkmodules.vtkIOCore', + ], + 'vtkmodules.vtkIOParallel': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + 'vtkmodules.vtkIOGeometry', + 'vtkmodules.vtkIOImage', + 'vtkmodules.vtkIOLegacy', + ], + 'vtkmodules.vtkIOParallelExodus': [ + 'vtkmodules.vtkIOExodus', + ], + 'vtkmodules.vtkIOParallelLSDyna': [ + 'vtkmodules.vtkIOLSDyna', + ], + 'vtkmodules.vtkIOParallelXML': [ + 'vtkmodules.vtkIOXML', + ], + 'vtkmodules.vtkIOSQL': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOCore', + ], + 'vtkmodules.vtkIOSegY': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOImage', + ], + 'vtkmodules.vtkIOTRUCHAS': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOTecplotTable': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOVPIC': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOVeraOut': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOVideo': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkIOXML': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOXMLParser', + ], + 'vtkmodules.vtkIOXMLParser': [ + 'vtkmodules.vtkCommonDataModel', + ], + 'vtkmodules.vtkIOXdmf2': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkIOLegacy', + ], + 'vtkmodules.vtkImagingColor': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkImagingCore', + ], + 'vtkmodules.vtkImagingCore': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkImagingFourier': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkImagingCore', + ], + 'vtkmodules.vtkImagingGeneral': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkImagingCore', + ], + 'vtkmodules.vtkImagingHybrid': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkImagingMath': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkImagingMorphological': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkImagingCore', + 'vtkmodules.vtkImagingGeneral', + ], + 'vtkmodules.vtkImagingOpenGL2': [ + 'vtkmodules.vtkImagingGeneral', + 'vtkmodules.vtkRenderingOpenGL2', + ], + 'vtkmodules.vtkImagingSources': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkImagingStatistics': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkImagingStencil': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkImagingCore', + ], + 'vtkmodules.vtkInfovisCore': [ + 'vtkmodules.vtkCommonColor', + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkImagingSources', + 'vtkmodules.vtkIOImage', + 'vtkmodules.vtkRenderingFreeType', + ], + 'vtkmodules.vtkInfovisLayout': [ + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkInteractionImage': [ + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkInteractionStyle': [ + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkInteractionWidgets': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkFiltersGeneral', + 'vtkmodules.vtkFiltersSources', + 'vtkmodules.vtkRenderingContext2D', + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkPythonContext2D': [ + 'vtkmodules.vtkRenderingContext2D', + ], + 'vtkmodules.vtkRenderingAnnotation': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkRenderingCellGrid': [ + 'vtkmodules.vtkFiltersCellGrid', + 'vtkmodules.vtkRenderingCore', + 'vtkmodules.vtkRenderingOpenGL2', + ], + 'vtkmodules.vtkRenderingContext2D': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkRenderingContextOpenGL2': [ + 'vtkmodules.vtkRenderingContext2D', + 'vtkmodules.vtkRenderingFreeType', + 'vtkmodules.vtkRenderingOpenGL2', + ], + 'vtkmodules.vtkRenderingCore': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + ], + 'vtkmodules.vtkRenderingExternal': [ + 'vtkmodules.vtkRenderingCore', + 'vtkmodules.vtkRenderingOpenGL2', + ], + 'vtkmodules.vtkRenderingFreeType': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkRenderingGridAxes': [ + 'vtkmodules.vtkChartsCore', + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkRenderingGL2PSOpenGL2': [ + 'vtkmodules.vtkRenderingOpenGL2', + ], + 'vtkmodules.vtkRenderingHyperTreeGrid': [ + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkRenderingImage': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkRenderingLICOpenGL2': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkRenderingCore', + 'vtkmodules.vtkRenderingOpenGL2', + ], + 'vtkmodules.vtkRenderingLOD': [ + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkRenderingLabel': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkRenderingCore', + 'vtkmodules.vtkRenderingFreeType', + ], + 'vtkmodules.vtkRenderingMatplotlib': [ + 'vtkmodules.vtkRenderingFreeType', + ], + 'vtkmodules.vtkRenderingOpenGL2': [ + 'vtkmodules.vtkFiltersGeneral', + 'vtkmodules.vtkIOImage', + 'vtkmodules.vtkRenderingCore', + 'vtkmodules.vtkRenderingHyperTreeGrid', + 'vtkmodules.vtkRenderingUI', + ], + 'vtkmodules.vtkRenderingParallel': [ + 'vtkmodules.vtkRenderingCore', + 'vtkmodules.vtkRenderingOpenGL2', + ], + 'vtkmodules.vtkRenderingUI': [ + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkRenderingVR': [ + 'vtkmodules.vtkInteractionStyle', + 'vtkmodules.vtkInteractionWidgets', + 'vtkmodules.vtkIOXMLParser', + 'vtkmodules.vtkRenderingCore', + 'vtkmodules.vtkRenderingOpenGL2', + 'vtkmodules.vtkRenderingVolumeOpenGL2', + 'vtkmodules.vtkRenderingVRModels', + ], + 'vtkmodules.vtkRenderingVRModels': [ + 'vtkmodules.vtkRenderingCore', + 'vtkmodules.vtkRenderingOpenGL2', + ], + 'vtkmodules.vtkRenderingVolume': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkRenderingVolumeAMR': [ + 'vtkmodules.vtkImagingCore', + 'vtkmodules.vtkRenderingVolume', + 'vtkmodules.vtkRenderingVolumeOpenGL2', + ], + 'vtkmodules.vtkRenderingVolumeOpenGL2': [ + 'vtkmodules.vtkImagingCore', + 'vtkmodules.vtkImagingMath', + 'vtkmodules.vtkRenderingOpenGL2', + 'vtkmodules.vtkRenderingVolume', + ], + 'vtkmodules.vtkRenderingVtkJS': [ + 'vtkmodules.vtkRenderingSceneGraph', + ], + 'vtkmodules.vtkTestingRendering': [ + 'vtkmodules.vtkImagingColor', + 'vtkmodules.vtkIOXML', + 'vtkmodules.vtkRenderingCore', + ], + 'vtkmodules.vtkTestingSerialization': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkSerializationManager', + ], + 'vtkmodules.vtkViewsContext2D': [ + 'vtkmodules.vtkRenderingCore', + 'vtkmodules.vtkViewsCore', + ], + 'vtkmodules.vtkViewsCore': [ + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkInteractionWidgets', + ], + 'vtkmodules.vtkViewsInfovis': [ + 'vtkmodules.vtkCommonDataModel', + 'vtkmodules.vtkCommonExecutionModel', + 'vtkmodules.vtkInteractionStyle', + 'vtkmodules.vtkRenderingContext2D', + 'vtkmodules.vtkViewsCore', + ], + 'vtkmodules.vtkWebGLExporter': [ + 'vtkmodules.vtkIOExport', + ], +} + + +def add_vtkmodules_dependencies(hook_file): + # Find the module underlying this vtkmodules hook: change `/path/to/hook-vtkmodules.blah.py` to `vtkmodules.blah`. + hook_name, hook_ext = os.path.splitext(os.path.basename(hook_file)) + assert hook_ext.startswith('.py') + assert hook_name.startswith('hook-') + module_name = hook_name[5:] + + # Look up the list of hidden imports. + return ["vtkmodules.vtkCommonCore", *_module_dependencies.get(module_name, [])] diff --git a/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/LICENSE b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/LICENSE new file mode 100644 index 0000000..6013a21 --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/LICENSE @@ -0,0 +1,18 @@ +Copyright (c) 2004 Istvan Albert unless otherwise noted. +Copyright (c) 2006-2010 Bob Ippolito +Copyright (2) 2010-2020 Ronald Oussoren, et. al. + +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. + +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. diff --git a/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/METADATA b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/METADATA new file mode 100644 index 0000000..4e53760 --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/METADATA @@ -0,0 +1,307 @@ +Metadata-Version: 2.1 +Name: altgraph +Version: 0.17.5 +Summary: Python graph (network) package +Home-page: https://altgraph.readthedocs.io +Download-URL: http://pypi.python.org/pypi/altgraph +Author: Ronald Oussoren +Author-email: ronaldoussoren@mac.com +Maintainer: Ronald Oussoren +Maintainer-email: ronaldoussoren@mac.com +License: MIT +Keywords: graph +Platform: any +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 2 +Classifier: Programming Language :: Python :: 2.7 +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.4 +Classifier: Programming Language :: Python :: 3.5 +Classifier: Programming Language :: Python :: 3.6 +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 :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Programming Language :: Python :: 3.14 +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Topic :: Scientific/Engineering :: Mathematics +Classifier: Topic :: Scientific/Engineering :: Visualization +Description-Content-Type: text/x-rst; charset=UTF-8 +License-File: LICENSE +Project-URL: Documentation, https://altgraph.readthedocs.io/en/latest/ +Project-URL: Issue tracker, https://github.com/ronaldoussoren/altgraph/issues +Project-URL: Repository, https://github.com/ronaldoussoren/altgraph + +altgraph is a fork of graphlib: a graph (network) package for constructing +graphs, BFS and DFS traversals, topological sort, shortest paths, etc. with +graphviz output. + +altgraph includes some additional usage of Python 2.6+ features and +enhancements related to modulegraph and macholib. + +Project links +------------- + +* `Documentation `_ + +* `Issue Tracker `_ + +* `Repository `_ + + +Release history +=============== + +0.17.5 +------ + +* Update classifiers for Python 3.13 and 3.14 + +* Drop dependency on "pkg_resources" + +0.17.4 +------ + +* Update classifiers for Python 3.12 + +0.17.3 +------ + +* Update classifiers for Python 3.11 + +0.17.2 +------ + +* Change in setup.py to fix the sidebar links on PyPI + +0.17.1 +------ + +* Explicitly mark Python 3.10 as supported in wheel metadata. + +0.17 +---- + +* Explicitly mark Python 3.8 as supported in wheel metadata. + +* Migrate from Bitbucket to GitHub + +* Run black on the entire repository + +0.16.1 +------ + +* Explicitly mark Python 3.7 as supported in wheel metadata. + +0.16 +---- + +* Add LICENSE file + +0.15 +---- + +* ``ObjectGraph.get_edges``, ``ObjectGraph.getEdgeData`` and ``ObjectGraph.updateEdgeData`` + accept *None* as the node to get and treat this as an alias for *self* (as other + methods already did). + +0.14 +---- + +- Issue #7: Remove use of ``iteritems`` in altgraph.GraphAlgo code + +0.13 +---- + +- Issue #4: Graph._bfs_subgraph and back_bfs_subgraph return subgraphs with reversed edges + + Fix by "pombredanne" on bitbucket. + + +0.12 +---- + +- Added ``ObjectGraph.edgeData`` to retrieve the edge data + from a specific edge. + +- Added ``AltGraph.update_edge_data`` and ``ObjectGraph.updateEdgeData`` + to update the data associated with a graph edge. + +0.11 +---- + +- Stabilize the order of elements in dot file exports, + patch from bitbucket user 'pombredanne'. + +- Tweak setup.py file to remove dependency on distribute (but + keep the dependency on setuptools) + + +0.10.2 +------ + +- There where no classifiers in the package metadata due to a bug + in setup.py + +0.10.1 +------ + +This is a bugfix release + +Bug fixes: + +- Issue #3: The source archive contains a README.txt + while the setup file refers to ReadMe.txt. + + This is caused by a misfeature in distutils, as a + workaround I've renamed ReadMe.txt to README.txt + in the source tree and setup file. + + +0.10 +----- + +This is a minor feature release + +Features: + +- Do not use "2to3" to support Python 3. + + As a side effect of this altgraph now supports + Python 2.6 and later, and no longer supports + earlier releases of Python. + +- The order of attributes in the Dot output + is now always alphabetical. + + With this change the output will be consistent + between runs and Python versions. + +0.9 +--- + +This is a minor bugfix release + +Features: + +- Added ``altgraph.ObjectGraph.ObjectGraph.nodes``, a method + yielding all nodes in an object graph. + +Bugfixes: + +- The 0.8 release didn't work with py2app when using + python 3.x. + + +0.8 +----- + +This is a minor feature release. The major new feature +is a extensive set of unittests, which explains almost +all other changes in this release. + +Bugfixes: + +- Installing failed with Python 2.5 due to using a distutils + class that isn't available in that version of Python + (issue #1 on the issue tracker) + +- ``altgraph.GraphStat.degree_dist`` now actually works + +- ``altgraph.Graph.add_edge(a, b, create_nodes=False)`` will + no longer create the edge when one of the nodes doesn't + exist. + +- ``altgraph.Graph.forw_topo_sort`` failed for some sparse graphs. + +- ``altgraph.Graph.back_topo_sort`` was completely broken in + previous releases. + +- ``altgraph.Graph.forw_bfs_subgraph`` now actually works. + +- ``altgraph.Graph.back_bfs_subgraph`` now actually works. + +- ``altgraph.Graph.iterdfs`` now returns the correct result + when the ``forward`` argument is ``False``. + +- ``altgraph.Graph.iterdata`` now returns the correct result + when the ``forward`` argument is ``False``. + + +Features: + +- The ``altgraph.Graph`` constructor now accepts an argument + that contains 2- and 3-tuples instead of requireing that + all items have the same size. The (optional) argument can now + also be any iterator. + +- ``altgraph.Graph.Graph.add_node`` has no effect when you + add a hidden node. + +- The private method ``altgraph.Graph._bfs`` is no longer + present. + +- The private method ``altgraph.Graph._dfs`` is no longer + present. + +- ``altgraph.ObjectGraph`` now has a ``__contains__`` methods, + which means you can use the ``in`` operator to check if a + node is part of a graph. + +- ``altgraph.GraphUtil.generate_random_graph`` will raise + ``GraphError`` instead of looping forever when it is + impossible to create the requested graph. + +- ``altgraph.Dot.edge_style`` raises ``GraphError`` when + one of the nodes is not present in the graph. The method + silently added the tail in the past, but without ensuring + a consistent graph state. + +- ``altgraph.Dot.save_img`` now works when the mode is + ``"neato"``. + +0.7.2 +----- + +This is a minor bugfix release + +Bugfixes: + +- distutils didn't include the documentation subtree + +0.7.1 +----- + +This is a minor feature release + +Features: + +- Documentation is now generated using `sphinx `_ + and can be viewed at . + +- The repository has moved to bitbucket + +- ``altgraph.GraphStat.avg_hops`` is no longer present, the function had no + implementation and no specified behaviour. + +- the module ``altgraph.compat`` is gone, which means altgraph will no + longer work with Python 2.3. + + +0.7.0 +----- + +This is a minor feature release. + +Features: + +- Support for Python 3 + +- It is now possible to run tests using 'python setup.py test' + + (The actual testsuite is still very minimal though) diff --git a/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/RECORD b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/RECORD new file mode 100644 index 0000000..32d7ddf --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/RECORD @@ -0,0 +1,21 @@ +altgraph-0.17.5.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +altgraph-0.17.5.dist-info/LICENSE,sha256=bBlNbbDGTUVTXRDJUUK5sM2nt9zH8d3uMCs9U289vkY,1002 +altgraph-0.17.5.dist-info/METADATA,sha256=3GBkHboimjrvCfdk9WLDjZCLkwySYVry5iavMdb_GbU,7519 +altgraph-0.17.5.dist-info/RECORD,, +altgraph-0.17.5.dist-info/WHEEL,sha256=iYlv5fX357PQyRT2o6tw1bN-YcKFFHKqB_LwHO5wP-g,110 +altgraph-0.17.5.dist-info/top_level.txt,sha256=HEBeRWf5ItVPc7Y9hW7hGlrLXZjPoL4by6CAhBV_BwA,9 +altgraph-0.17.5.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1 +altgraph/Dot.py,sha256=gKEp6Su_CoOWQYt5HIVs_7MBYK1BEOhKX0RLAAA-vQs,9929 +altgraph/Graph.py,sha256=6b6fSHLA5QSqMDnSHIO7_WJnBYIdq3K5Bt8VipRODwg,20788 +altgraph/GraphAlgo.py,sha256=Uu9aTjSKWi38iQ_e9ZrwCnzQaI1WWFDhJ6kfmu0jxAA,5645 +altgraph/GraphStat.py,sha256=LKya4BKXJ5GZi5-sNYU17aOBTLxqn_tVgbiw4sWGYIU,1888 +altgraph/GraphUtil.py,sha256=1T4DJc2bJn6EIU_Ct4m0oiKlXWkXvqcXE8CGL2K9en8,3990 +altgraph/ObjectGraph.py,sha256=o7fPJtyBEgJSXAkUjzvj35B-FOY4uKzfLGqSvTitx8c,6490 +altgraph/__init__.py,sha256=Glu2oEC9U0oZLDEIJeudig16inwTvSiDKw8Av17_aNE,4957 +altgraph/__pycache__/Dot.cpython-312.pyc,, +altgraph/__pycache__/Graph.cpython-312.pyc,, +altgraph/__pycache__/GraphAlgo.cpython-312.pyc,, +altgraph/__pycache__/GraphStat.cpython-312.pyc,, +altgraph/__pycache__/GraphUtil.cpython-312.pyc,, +altgraph/__pycache__/ObjectGraph.cpython-312.pyc,, +altgraph/__pycache__/__init__.cpython-312.pyc,, diff --git a/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/WHEEL b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/WHEEL new file mode 100644 index 0000000..c34f116 --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/WHEEL @@ -0,0 +1,6 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.41.2) +Root-Is-Purelib: true +Tag: py2-none-any +Tag: py3-none-any + diff --git a/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/top_level.txt new file mode 100644 index 0000000..5ad6b8a --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/top_level.txt @@ -0,0 +1 @@ +altgraph diff --git a/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/zip-safe b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/zip-safe new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph-0.17.5.dist-info/zip-safe @@ -0,0 +1 @@ + diff --git a/venv/lib/python3.12/site-packages/altgraph/Dot.py b/venv/lib/python3.12/site-packages/altgraph/Dot.py new file mode 100644 index 0000000..1d19cb1 --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph/Dot.py @@ -0,0 +1,321 @@ +""" +altgraph.Dot - Interface to the dot language +============================================ + +The :py:mod:`~altgraph.Dot` module provides a simple interface to the +file format used in the +`graphviz `_ +program. The module is intended to offload the most tedious part of the process +(the **dot** file generation) while transparently exposing most of its +features. + +To display the graphs or to generate image files the +`graphviz `_ +package needs to be installed on the system, moreover the :command:`dot` and +:command:`dotty` programs must be accesible in the program path so that they +can be ran from processes spawned within the module. + +Example usage +------------- + +Here is a typical usage:: + + from altgraph import Graph, Dot + + # create a graph + edges = [ (1,2), (1,3), (3,4), (3,5), (4,5), (5,4) ] + graph = Graph.Graph(edges) + + # create a dot representation of the graph + dot = Dot.Dot(graph) + + # display the graph + dot.display() + + # save the dot representation into the mydot.dot file + dot.save_dot(file_name='mydot.dot') + + # save dot file as gif image into the graph.gif file + dot.save_img(file_name='graph', file_type='gif') + +Directed graph and non-directed graph +------------------------------------- + +Dot class can use for both directed graph and non-directed graph +by passing ``graphtype`` parameter. + +Example:: + + # create directed graph(default) + dot = Dot.Dot(graph, graphtype="digraph") + + # create non-directed graph + dot = Dot.Dot(graph, graphtype="graph") + +Customizing the output +---------------------- + +The graph drawing process may be customized by passing +valid :command:`dot` parameters for the nodes and edges. For a list of all +parameters see the `graphviz `_ +documentation. + +Example:: + + # customizing the way the overall graph is drawn + dot.style(size='10,10', rankdir='RL', page='5, 5' , ranksep=0.75) + + # customizing node drawing + dot.node_style(1, label='BASE_NODE',shape='box', color='blue' ) + dot.node_style(2, style='filled', fillcolor='red') + + # customizing edge drawing + dot.edge_style(1, 2, style='dotted') + dot.edge_style(3, 5, arrowhead='dot', label='binds', labelangle='90') + dot.edge_style(4, 5, arrowsize=2, style='bold') + + +.. note:: + + dotty (invoked via :py:func:`~altgraph.Dot.display`) may not be able to + display all graphics styles. To verify the output save it to an image file + and look at it that way. + +Valid attributes +---------------- + + - dot styles, passed via the :py:meth:`Dot.style` method:: + + rankdir = 'LR' (draws the graph horizontally, left to right) + ranksep = number (rank separation in inches) + + - node attributes, passed via the :py:meth:`Dot.node_style` method:: + + style = 'filled' | 'invisible' | 'diagonals' | 'rounded' + shape = 'box' | 'ellipse' | 'circle' | 'point' | 'triangle' + + - edge attributes, passed via the :py:meth:`Dot.edge_style` method:: + + style = 'dashed' | 'dotted' | 'solid' | 'invis' | 'bold' + arrowhead = 'box' | 'crow' | 'diamond' | 'dot' | 'inv' | 'none' + | 'tee' | 'vee' + weight = number (the larger the number the closer the nodes will be) + + - valid `graphviz colors + `_ + + - for more details on how to control the graph drawing process see the + `graphviz reference + `_. +""" +import os +import warnings + +from altgraph import GraphError + + +class Dot(object): + """ + A class providing a **graphviz** (dot language) representation + allowing a fine grained control over how the graph is being + displayed. + + If the :command:`dot` and :command:`dotty` programs are not in the current + system path their location needs to be specified in the contructor. + """ + + def __init__( + self, + graph=None, + nodes=None, + edgefn=None, + nodevisitor=None, + edgevisitor=None, + name="G", + dot="dot", + dotty="dotty", + neato="neato", + graphtype="digraph", + ): + """ + Initialization. + """ + self.name, self.attr = name, {} + + assert graphtype in ["graph", "digraph"] + self.type = graphtype + + self.temp_dot = "tmp_dot.dot" + self.temp_neo = "tmp_neo.dot" + + self.dot, self.dotty, self.neato = dot, dotty, neato + + # self.nodes: node styles + # self.edges: edge styles + self.nodes, self.edges = {}, {} + + if graph is not None and nodes is None: + nodes = graph + if graph is not None and edgefn is None: + + def edgefn(node, graph=graph): + return graph.out_nbrs(node) + + if nodes is None: + nodes = () + + seen = set() + for node in nodes: + if nodevisitor is None: + style = {} + else: + style = nodevisitor(node) + if style is not None: + self.nodes[node] = {} + self.node_style(node, **style) + seen.add(node) + if edgefn is not None: + for head in seen: + for tail in (n for n in edgefn(head) if n in seen): + if edgevisitor is None: + edgestyle = {} + else: + edgestyle = edgevisitor(head, tail) + if edgestyle is not None: + if head not in self.edges: + self.edges[head] = {} + self.edges[head][tail] = {} + self.edge_style(head, tail, **edgestyle) + + def style(self, **attr): + """ + Changes the overall style + """ + self.attr = attr + + def display(self, mode="dot"): + """ + Displays the current graph via dotty + """ + + if mode == "neato": + self.save_dot(self.temp_neo) + neato_cmd = "%s -o %s %s" % (self.neato, self.temp_dot, self.temp_neo) + os.system(neato_cmd) + else: + self.save_dot(self.temp_dot) + + plot_cmd = "%s %s" % (self.dotty, self.temp_dot) + os.system(plot_cmd) + + def node_style(self, node, **kwargs): + """ + Modifies a node style to the dot representation. + """ + if node not in self.edges: + self.edges[node] = {} + self.nodes[node] = kwargs + + def all_node_style(self, **kwargs): + """ + Modifies all node styles + """ + for node in self.nodes: + self.node_style(node, **kwargs) + + def edge_style(self, head, tail, **kwargs): + """ + Modifies an edge style to the dot representation. + """ + if tail not in self.nodes: + raise GraphError("invalid node %s" % (tail,)) + + try: + if tail not in self.edges[head]: + self.edges[head][tail] = {} + self.edges[head][tail] = kwargs + except KeyError: + raise GraphError("invalid edge %s -> %s " % (head, tail)) + + def iterdot(self): + # write graph title + if self.type == "digraph": + yield "digraph %s {\n" % (self.name,) + elif self.type == "graph": + yield "graph %s {\n" % (self.name,) + + else: + raise GraphError("unsupported graphtype %s" % (self.type,)) + + # write overall graph attributes + for attr_name, attr_value in sorted(self.attr.items()): + yield '%s="%s";' % (attr_name, attr_value) + yield "\n" + + # some reusable patterns + cpatt = '%s="%s",' # to separate attributes + epatt = "];\n" # to end attributes + + # write node attributes + for node_name, node_attr in sorted(self.nodes.items()): + yield '\t"%s" [' % (node_name,) + for attr_name, attr_value in sorted(node_attr.items()): + yield cpatt % (attr_name, attr_value) + yield epatt + + # write edge attributes + for head in sorted(self.edges): + for tail in sorted(self.edges[head]): + if self.type == "digraph": + yield '\t"%s" -> "%s" [' % (head, tail) + else: + yield '\t"%s" -- "%s" [' % (head, tail) + for attr_name, attr_value in sorted(self.edges[head][tail].items()): + yield cpatt % (attr_name, attr_value) + yield epatt + + # finish file + yield "}\n" + + def __iter__(self): + return self.iterdot() + + def save_dot(self, file_name=None): + """ + Saves the current graph representation into a file + """ + + if not file_name: + warnings.warn(DeprecationWarning, "always pass a file_name", stacklevel=2) + file_name = self.temp_dot + + with open(file_name, "w") as fp: + for chunk in self.iterdot(): + fp.write(chunk) + + def save_img(self, file_name=None, file_type="gif", mode="dot"): + """ + Saves the dot file as an image file + """ + + if not file_name: + warnings.warn(DeprecationWarning, "always pass a file_name", stacklevel=2) + file_name = "out" + + if mode == "neato": + self.save_dot(self.temp_neo) + neato_cmd = "%s -o %s %s" % (self.neato, self.temp_dot, self.temp_neo) + os.system(neato_cmd) + plot_cmd = self.dot + else: + self.save_dot(self.temp_dot) + plot_cmd = self.dot + + file_name = "%s.%s" % (file_name, file_type) + create_cmd = "%s -T%s %s -o %s" % ( + plot_cmd, + file_type, + self.temp_dot, + file_name, + ) + os.system(create_cmd) diff --git a/venv/lib/python3.12/site-packages/altgraph/Graph.py b/venv/lib/python3.12/site-packages/altgraph/Graph.py new file mode 100644 index 0000000..8088007 --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph/Graph.py @@ -0,0 +1,682 @@ +""" +altgraph.Graph - Base Graph class +================================= + +.. + #--Version 2.1 + #--Bob Ippolito October, 2004 + + #--Version 2.0 + #--Istvan Albert June, 2004 + + #--Version 1.0 + #--Nathan Denny, May 27, 1999 +""" + +from collections import deque + +from altgraph import GraphError + + +class Graph(object): + """ + The Graph class represents a directed graph with *N* nodes and *E* edges. + + Naming conventions: + + - the prefixes such as *out*, *inc* and *all* will refer to methods + that operate on the outgoing, incoming or all edges of that node. + + For example: :py:meth:`inc_degree` will refer to the degree of the node + computed over the incoming edges (the number of neighbours linking to + the node). + + - the prefixes such as *forw* and *back* will refer to the + orientation of the edges used in the method with respect to the node. + + For example: :py:meth:`forw_bfs` will start at the node then use the + outgoing edges to traverse the graph (goes forward). + """ + + def __init__(self, edges=None): + """ + Initialization + """ + + self.next_edge = 0 + self.nodes, self.edges = {}, {} + self.hidden_edges, self.hidden_nodes = {}, {} + + if edges is not None: + for item in edges: + if len(item) == 2: + head, tail = item + self.add_edge(head, tail) + elif len(item) == 3: + head, tail, data = item + self.add_edge(head, tail, data) + else: + raise GraphError("Cannot create edge from %s" % (item,)) + + def __repr__(self): + return "" % ( + self.number_of_nodes(), + self.number_of_edges(), + ) + + def add_node(self, node, node_data=None): + """ + Adds a new node to the graph. Arbitrary data can be attached to the + node via the node_data parameter. Adding the same node twice will be + silently ignored. + + The node must be a hashable value. + """ + # + # the nodes will contain tuples that will store incoming edges, + # outgoing edges and data + # + # index 0 -> incoming edges + # index 1 -> outgoing edges + + if node in self.hidden_nodes: + # Node is present, but hidden + return + + if node not in self.nodes: + self.nodes[node] = ([], [], node_data) + + def add_edge(self, head_id, tail_id, edge_data=1, create_nodes=True): + """ + Adds a directed edge going from head_id to tail_id. + Arbitrary data can be attached to the edge via edge_data. + It may create the nodes if adding edges between nonexisting ones. + + :param head_id: head node + :param tail_id: tail node + :param edge_data: (optional) data attached to the edge + :param create_nodes: (optional) creates the head_id or tail_id + node in case they did not exist + """ + # shorcut + edge = self.next_edge + + # add nodes if on automatic node creation + if create_nodes: + self.add_node(head_id) + self.add_node(tail_id) + + # update the corresponding incoming and outgoing lists in the nodes + # index 0 -> incoming edges + # index 1 -> outgoing edges + + try: + self.nodes[tail_id][0].append(edge) + self.nodes[head_id][1].append(edge) + except KeyError: + raise GraphError("Invalid nodes %s -> %s" % (head_id, tail_id)) + + # store edge information + self.edges[edge] = (head_id, tail_id, edge_data) + + self.next_edge += 1 + + def hide_edge(self, edge): + """ + Hides an edge from the graph. The edge may be unhidden at some later + time. + """ + try: + head_id, tail_id, edge_data = self.hidden_edges[edge] = self.edges[edge] + self.nodes[tail_id][0].remove(edge) + self.nodes[head_id][1].remove(edge) + del self.edges[edge] + except KeyError: + raise GraphError("Invalid edge %s" % edge) + + def hide_node(self, node): + """ + Hides a node from the graph. The incoming and outgoing edges of the + node will also be hidden. The node may be unhidden at some later time. + """ + try: + all_edges = self.all_edges(node) + self.hidden_nodes[node] = (self.nodes[node], all_edges) + for edge in all_edges: + self.hide_edge(edge) + del self.nodes[node] + except KeyError: + raise GraphError("Invalid node %s" % node) + + def restore_node(self, node): + """ + Restores a previously hidden node back into the graph and restores + all of its incoming and outgoing edges. + """ + try: + self.nodes[node], all_edges = self.hidden_nodes[node] + for edge in all_edges: + self.restore_edge(edge) + del self.hidden_nodes[node] + except KeyError: + raise GraphError("Invalid node %s" % node) + + def restore_edge(self, edge): + """ + Restores a previously hidden edge back into the graph. + """ + try: + head_id, tail_id, data = self.hidden_edges[edge] + self.nodes[tail_id][0].append(edge) + self.nodes[head_id][1].append(edge) + self.edges[edge] = head_id, tail_id, data + del self.hidden_edges[edge] + except KeyError: + raise GraphError("Invalid edge %s" % edge) + + def restore_all_edges(self): + """ + Restores all hidden edges. + """ + for edge in list(self.hidden_edges.keys()): + try: + self.restore_edge(edge) + except GraphError: + pass + + def restore_all_nodes(self): + """ + Restores all hidden nodes. + """ + for node in list(self.hidden_nodes.keys()): + self.restore_node(node) + + def __contains__(self, node): + """ + Test whether a node is in the graph + """ + return node in self.nodes + + def edge_by_id(self, edge): + """ + Returns the edge that connects the head_id and tail_id nodes + """ + try: + head, tail, data = self.edges[edge] + except KeyError: + head, tail = None, None + raise GraphError("Invalid edge %s" % edge) + + return (head, tail) + + def edge_by_node(self, head, tail): + """ + Returns the edge that connects the head_id and tail_id nodes + """ + for edge in self.out_edges(head): + if self.tail(edge) == tail: + return edge + return None + + def number_of_nodes(self): + """ + Returns the number of nodes + """ + return len(self.nodes) + + def number_of_edges(self): + """ + Returns the number of edges + """ + return len(self.edges) + + def __iter__(self): + """ + Iterates over all nodes in the graph + """ + return iter(self.nodes) + + def node_list(self): + """ + Return a list of the node ids for all visible nodes in the graph. + """ + return list(self.nodes.keys()) + + def edge_list(self): + """ + Returns an iterator for all visible nodes in the graph. + """ + return list(self.edges.keys()) + + def number_of_hidden_edges(self): + """ + Returns the number of hidden edges + """ + return len(self.hidden_edges) + + def number_of_hidden_nodes(self): + """ + Returns the number of hidden nodes + """ + return len(self.hidden_nodes) + + def hidden_node_list(self): + """ + Returns the list with the hidden nodes + """ + return list(self.hidden_nodes.keys()) + + def hidden_edge_list(self): + """ + Returns a list with the hidden edges + """ + return list(self.hidden_edges.keys()) + + def describe_node(self, node): + """ + return node, node data, outgoing edges, incoming edges for node + """ + incoming, outgoing, data = self.nodes[node] + return node, data, outgoing, incoming + + def describe_edge(self, edge): + """ + return edge, edge data, head, tail for edge + """ + head, tail, data = self.edges[edge] + return edge, data, head, tail + + def node_data(self, node): + """ + Returns the data associated with a node + """ + return self.nodes[node][2] + + def edge_data(self, edge): + """ + Returns the data associated with an edge + """ + return self.edges[edge][2] + + def update_edge_data(self, edge, edge_data): + """ + Replace the edge data for a specific edge + """ + self.edges[edge] = self.edges[edge][0:2] + (edge_data,) + + def head(self, edge): + """ + Returns the node of the head of the edge. + """ + return self.edges[edge][0] + + def tail(self, edge): + """ + Returns node of the tail of the edge. + """ + return self.edges[edge][1] + + def out_nbrs(self, node): + """ + List of nodes connected by outgoing edges + """ + return [self.tail(n) for n in self.out_edges(node)] + + def inc_nbrs(self, node): + """ + List of nodes connected by incoming edges + """ + return [self.head(n) for n in self.inc_edges(node)] + + def all_nbrs(self, node): + """ + List of nodes connected by incoming and outgoing edges + """ + return list(dict.fromkeys(self.inc_nbrs(node) + self.out_nbrs(node))) + + def out_edges(self, node): + """ + Returns a list of the outgoing edges + """ + try: + return list(self.nodes[node][1]) + except KeyError: + raise GraphError("Invalid node %s" % node) + + def inc_edges(self, node): + """ + Returns a list of the incoming edges + """ + try: + return list(self.nodes[node][0]) + except KeyError: + raise GraphError("Invalid node %s" % node) + + def all_edges(self, node): + """ + Returns a list of incoming and outging edges. + """ + return set(self.inc_edges(node) + self.out_edges(node)) + + def out_degree(self, node): + """ + Returns the number of outgoing edges + """ + return len(self.out_edges(node)) + + def inc_degree(self, node): + """ + Returns the number of incoming edges + """ + return len(self.inc_edges(node)) + + def all_degree(self, node): + """ + The total degree of a node + """ + return self.inc_degree(node) + self.out_degree(node) + + def _topo_sort(self, forward=True): + """ + Topological sort. + + Returns a list of nodes where the successors (based on outgoing and + incoming edges selected by the forward parameter) of any given node + appear in the sequence after that node. + """ + topo_list = [] + queue = deque() + indeg = {} + + # select the operation that will be performed + if forward: + get_edges = self.out_edges + get_degree = self.inc_degree + get_next = self.tail + else: + get_edges = self.inc_edges + get_degree = self.out_degree + get_next = self.head + + for node in self.node_list(): + degree = get_degree(node) + if degree: + indeg[node] = degree + else: + queue.append(node) + + while queue: + curr_node = queue.popleft() + topo_list.append(curr_node) + for edge in get_edges(curr_node): + tail_id = get_next(edge) + if tail_id in indeg: + indeg[tail_id] -= 1 + if indeg[tail_id] == 0: + queue.append(tail_id) + + if len(topo_list) == len(self.node_list()): + valid = True + else: + # the graph has cycles, invalid topological sort + valid = False + + return (valid, topo_list) + + def forw_topo_sort(self): + """ + Topological sort. + + Returns a list of nodes where the successors (based on outgoing edges) + of any given node appear in the sequence after that node. + """ + return self._topo_sort(forward=True) + + def back_topo_sort(self): + """ + Reverse topological sort. + + Returns a list of nodes where the successors (based on incoming edges) + of any given node appear in the sequence after that node. + """ + return self._topo_sort(forward=False) + + def _bfs_subgraph(self, start_id, forward=True): + """ + Private method creates a subgraph in a bfs order. + + The forward parameter specifies whether it is a forward or backward + traversal. + """ + if forward: + get_bfs = self.forw_bfs + get_nbrs = self.out_nbrs + else: + get_bfs = self.back_bfs + get_nbrs = self.inc_nbrs + + g = Graph() + bfs_list = get_bfs(start_id) + for node in bfs_list: + g.add_node(node) + + for node in bfs_list: + for nbr_id in get_nbrs(node): + if forward: + g.add_edge(node, nbr_id) + else: + g.add_edge(nbr_id, node) + + return g + + def forw_bfs_subgraph(self, start_id): + """ + Creates and returns a subgraph consisting of the breadth first + reachable nodes based on their outgoing edges. + """ + return self._bfs_subgraph(start_id, forward=True) + + def back_bfs_subgraph(self, start_id): + """ + Creates and returns a subgraph consisting of the breadth first + reachable nodes based on the incoming edges. + """ + return self._bfs_subgraph(start_id, forward=False) + + def iterdfs(self, start, end=None, forward=True): + """ + Collecting nodes in some depth first traversal. + + The forward parameter specifies whether it is a forward or backward + traversal. + """ + visited, stack = {start}, deque([start]) + + if forward: + get_edges = self.out_edges + get_next = self.tail + else: + get_edges = self.inc_edges + get_next = self.head + + while stack: + curr_node = stack.pop() + yield curr_node + if curr_node == end: + break + for edge in sorted(get_edges(curr_node)): + tail = get_next(edge) + if tail not in visited: + visited.add(tail) + stack.append(tail) + + def iterdata(self, start, end=None, forward=True, condition=None): + """ + Perform a depth-first walk of the graph (as ``iterdfs``) + and yield the item data of every node where condition matches. The + condition callback is only called when node_data is not None. + """ + + visited, stack = {start}, deque([start]) + + if forward: + get_edges = self.out_edges + get_next = self.tail + else: + get_edges = self.inc_edges + get_next = self.head + + get_data = self.node_data + + while stack: + curr_node = stack.pop() + curr_data = get_data(curr_node) + if curr_data is not None: + if condition is not None and not condition(curr_data): + continue + yield curr_data + if curr_node == end: + break + for edge in get_edges(curr_node): + tail = get_next(edge) + if tail not in visited: + visited.add(tail) + stack.append(tail) + + def _iterbfs(self, start, end=None, forward=True): + """ + The forward parameter specifies whether it is a forward or backward + traversal. Returns a list of tuples where the first value is the hop + value the second value is the node id. + """ + queue, visited = deque([(start, 0)]), {start} + + # the direction of the bfs depends on the edges that are sampled + if forward: + get_edges = self.out_edges + get_next = self.tail + else: + get_edges = self.inc_edges + get_next = self.head + + while queue: + curr_node, curr_step = queue.popleft() + yield (curr_node, curr_step) + if curr_node == end: + break + for edge in get_edges(curr_node): + tail = get_next(edge) + if tail not in visited: + visited.add(tail) + queue.append((tail, curr_step + 1)) + + def forw_bfs(self, start, end=None): + """ + Returns a list of nodes in some forward BFS order. + + Starting from the start node the breadth first search proceeds along + outgoing edges. + """ + return [node for node, step in self._iterbfs(start, end, forward=True)] + + def back_bfs(self, start, end=None): + """ + Returns a list of nodes in some backward BFS order. + + Starting from the start node the breadth first search proceeds along + incoming edges. + """ + return [node for node, _ in self._iterbfs(start, end, forward=False)] + + def forw_dfs(self, start, end=None): + """ + Returns a list of nodes in some forward DFS order. + + Starting with the start node the depth first search proceeds along + outgoing edges. + """ + return list(self.iterdfs(start, end, forward=True)) + + def back_dfs(self, start, end=None): + """ + Returns a list of nodes in some backward DFS order. + + Starting from the start node the depth first search proceeds along + incoming edges. + """ + return list(self.iterdfs(start, end, forward=False)) + + def connected(self): + """ + Returns :py:data:`True` if the graph's every node can be reached from + every other node. + """ + node_list = self.node_list() + for node in node_list: + bfs_list = self.forw_bfs(node) + if len(bfs_list) != len(node_list): + return False + return True + + def clust_coef(self, node): + """ + Computes and returns the local clustering coefficient of node. + + The local cluster coefficient is proportion of the actual number of + edges between neighbours of node and the maximum number of edges + between those neighbours. + + See "Local Clustering Coefficient" on + + for a formal definition. + """ + num = 0 + nbr_set = set(self.out_nbrs(node)) + + if node in nbr_set: + nbr_set.remove(node) # loop defense + + for nbr in nbr_set: + sec_set = set(self.out_nbrs(nbr)) + if nbr in sec_set: + sec_set.remove(nbr) # loop defense + num += len(nbr_set & sec_set) + + nbr_num = len(nbr_set) + if nbr_num: + clust_coef = float(num) / (nbr_num * (nbr_num - 1)) + else: + clust_coef = 0.0 + return clust_coef + + def get_hops(self, start, end=None, forward=True): + """ + Computes the hop distance to all nodes centered around a node. + + First order neighbours are at hop 1, their neigbours are at hop 2 etc. + Uses :py:meth:`forw_bfs` or :py:meth:`back_bfs` depending on the value + of the forward parameter. If the distance between all neighbouring + nodes is 1 the hop number corresponds to the shortest distance between + the nodes. + + :param start: the starting node + :param end: ending node (optional). When not specified will search the + whole graph. + :param forward: directionality parameter (optional). + If C{True} (default) it uses L{forw_bfs} otherwise L{back_bfs}. + :return: returns a list of tuples where each tuple contains the + node and the hop. + + Typical usage:: + + >>> print (graph.get_hops(1, 8)) + >>> [(1, 0), (2, 1), (3, 1), (4, 2), (5, 3), (7, 4), (8, 5)] + # node 1 is at 0 hops + # node 2 is at 1 hop + # ... + # node 8 is at 5 hops + """ + if forward: + return list(self._iterbfs(start=start, end=end, forward=True)) + else: + return list(self._iterbfs(start=start, end=end, forward=False)) diff --git a/venv/lib/python3.12/site-packages/altgraph/GraphAlgo.py b/venv/lib/python3.12/site-packages/altgraph/GraphAlgo.py new file mode 100644 index 0000000..f93e73d --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph/GraphAlgo.py @@ -0,0 +1,171 @@ +""" +altgraph.GraphAlgo - Graph algorithms +===================================== +""" +from altgraph import GraphError + + +def dijkstra(graph, start, end=None): + """ + Dijkstra's algorithm for shortest paths + + `David Eppstein, UC Irvine, 4 April 2002 + `_ + + `Python Cookbook Recipe + `_ + + Find shortest paths from the start node to all nodes nearer than or + equal to the end node. + + Dijkstra's algorithm is only guaranteed to work correctly when all edge + lengths are positive. This code does not verify this property for all + edges (only the edges examined until the end vertex is reached), but will + correctly compute shortest paths even for some graphs with negative edges, + and will raise an exception if it discovers that a negative edge has + caused it to make a mistake. + + Adapted to altgraph by Istvan Albert, Pennsylvania State University - + June, 9 2004 + """ + D = {} # dictionary of final distances + P = {} # dictionary of predecessors + Q = _priorityDictionary() # estimated distances of non-final vertices + Q[start] = 0 + + for v in Q: + D[v] = Q[v] + if v == end: + break + + for w in graph.out_nbrs(v): + edge_id = graph.edge_by_node(v, w) + vwLength = D[v] + graph.edge_data(edge_id) + if w in D: + if vwLength < D[w]: + raise GraphError( + "Dijkstra: found better path to already-final vertex" + ) + elif w not in Q or vwLength < Q[w]: + Q[w] = vwLength + P[w] = v + + return (D, P) + + +def shortest_path(graph, start, end): + """ + Find a single shortest path from the *start* node to the *end* node. + The input has the same conventions as dijkstra(). The output is a list of + the nodes in order along the shortest path. + + **Note that the distances must be stored in the edge data as numeric data** + """ + + D, P = dijkstra(graph, start, end) + Path = [] + while 1: + Path.append(end) + if end == start: + break + end = P[end] + Path.reverse() + return Path + + +# +# Utility classes and functions +# +class _priorityDictionary(dict): + """ + Priority dictionary using binary heaps (internal use only) + + David Eppstein, UC Irvine, 8 Mar 2002 + + Implements a data structure that acts almost like a dictionary, with + two modifications: + + 1. D.smallest() returns the value x minimizing D[x]. For this to + work correctly, all values D[x] stored in the dictionary must be + comparable. + + 2. iterating "for x in D" finds and removes the items from D in sorted + order. Each item is not removed until the next item is requested, + so D[x] will still return a useful value until the next iteration + of the for-loop. Each operation takes logarithmic amortized time. + """ + + def __init__(self): + """ + Initialize priorityDictionary by creating binary heap of pairs + (value,key). Note that changing or removing a dict entry will not + remove the old pair from the heap until it is found by smallest() + or until the heap is rebuilt. + """ + self.__heap = [] + dict.__init__(self) + + def smallest(self): + """ + Find smallest item after removing deleted items from front of heap. + """ + if len(self) == 0: + raise IndexError("smallest of empty priorityDictionary") + heap = self.__heap + while heap[0][1] not in self or self[heap[0][1]] != heap[0][0]: + lastItem = heap.pop() + insertionPoint = 0 + while 1: + smallChild = 2 * insertionPoint + 1 + if ( + smallChild + 1 < len(heap) + and heap[smallChild] > heap[smallChild + 1] + ): + smallChild += 1 + if smallChild >= len(heap) or lastItem <= heap[smallChild]: + heap[insertionPoint] = lastItem + break + heap[insertionPoint] = heap[smallChild] + insertionPoint = smallChild + return heap[0][1] + + def __iter__(self): + """ + Create destructive sorted iterator of priorityDictionary. + """ + + def iterfn(): + while len(self) > 0: + x = self.smallest() + yield x + del self[x] + + return iterfn() + + def __setitem__(self, key, val): + """ + Change value stored in dictionary and add corresponding pair to heap. + Rebuilds the heap if the number of deleted items gets large, to avoid + memory leakage. + """ + dict.__setitem__(self, key, val) + heap = self.__heap + if len(heap) > 2 * len(self): + self.__heap = [(v, k) for k, v in self.items()] + self.__heap.sort() + else: + newPair = (val, key) + insertionPoint = len(heap) + heap.append(None) + while insertionPoint > 0 and newPair < heap[(insertionPoint - 1) // 2]: + heap[insertionPoint] = heap[(insertionPoint - 1) // 2] + insertionPoint = (insertionPoint - 1) // 2 + heap[insertionPoint] = newPair + + def setdefault(self, key, val): + """ + Reimplement setdefault to pass through our customized __setitem__. + """ + if key not in self: + self[key] = val + return self[key] diff --git a/venv/lib/python3.12/site-packages/altgraph/GraphStat.py b/venv/lib/python3.12/site-packages/altgraph/GraphStat.py new file mode 100644 index 0000000..cccc66d --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph/GraphStat.py @@ -0,0 +1,73 @@ +""" +altgraph.GraphStat - Functions providing various graph statistics +================================================================= +""" + + +def degree_dist(graph, limits=(0, 0), bin_num=10, mode="out"): + """ + Computes the degree distribution for a graph. + + Returns a list of tuples where the first element of the tuple is the + center of the bin representing a range of degrees and the second element + of the tuple are the number of nodes with the degree falling in the range. + + Example:: + + .... + """ + + deg = [] + if mode == "inc": + get_deg = graph.inc_degree + else: + get_deg = graph.out_degree + + for node in graph: + deg.append(get_deg(node)) + + if not deg: + return [] + + results = _binning(values=deg, limits=limits, bin_num=bin_num) + + return results + + +_EPS = 1.0 / (2.0**32) + + +def _binning(values, limits=(0, 0), bin_num=10): + """ + Bins data that falls between certain limits, if the limits are (0, 0) the + minimum and maximum values are used. + + Returns a list of tuples where the first element of the tuple is the + center of the bin and the second element of the tuple are the counts. + """ + if limits == (0, 0): + min_val, max_val = min(values) - _EPS, max(values) + _EPS + else: + min_val, max_val = limits + + # get bin size + bin_size = (max_val - min_val) / float(bin_num) + bins = [0] * (bin_num) + + # will ignore these outliers for now + for value in values: + try: + if (value - min_val) >= 0: + index = int((value - min_val) / float(bin_size)) + bins[index] += 1 + except IndexError: + pass + + # make it ready for an x,y plot + result = [] + center = (bin_size / 2) + min_val + for i, y in enumerate(bins): + x = center + bin_size * i + result.append((x, y)) + + return result diff --git a/venv/lib/python3.12/site-packages/altgraph/GraphUtil.py b/venv/lib/python3.12/site-packages/altgraph/GraphUtil.py new file mode 100644 index 0000000..cfd6a34 --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph/GraphUtil.py @@ -0,0 +1,139 @@ +""" +altgraph.GraphUtil - Utility classes and functions +================================================== +""" + +import random +from collections import deque + +from altgraph import Graph, GraphError + + +def generate_random_graph(node_num, edge_num, self_loops=False, multi_edges=False): + """ + Generates and returns a :py:class:`~altgraph.Graph.Graph` instance with + *node_num* nodes randomly connected by *edge_num* edges. + """ + g = Graph.Graph() + + if not multi_edges: + if self_loops: + max_edges = node_num * node_num + else: + max_edges = node_num * (node_num - 1) + + if edge_num > max_edges: + raise GraphError("inconsistent arguments to 'generate_random_graph'") + + nodes = range(node_num) + + for node in nodes: + g.add_node(node) + + while 1: + head = random.choice(nodes) + tail = random.choice(nodes) + + # loop defense + if head == tail and not self_loops: + continue + + # multiple edge defense + if g.edge_by_node(head, tail) is not None and not multi_edges: + continue + + # add the edge + g.add_edge(head, tail) + if g.number_of_edges() >= edge_num: + break + + return g + + +def generate_scale_free_graph(steps, growth_num, self_loops=False, multi_edges=False): + """ + Generates and returns a :py:class:`~altgraph.Graph.Graph` instance that + will have *steps* \\* *growth_num* nodes and a scale free (powerlaw) + connectivity. Starting with a fully connected graph with *growth_num* + nodes at every step *growth_num* nodes are added to the graph and are + connected to existing nodes with a probability proportional to the degree + of these existing nodes. + """ + # The code doesn't seem to do what the documentation claims. + graph = Graph.Graph() + + # initialize the graph + store = [] + for i in range(growth_num): + for j in range(i + 1, growth_num): + store.append(i) + store.append(j) + graph.add_edge(i, j) + + # generate + for node in range(growth_num, steps * growth_num): + graph.add_node(node) + while graph.out_degree(node) < growth_num: + nbr = random.choice(store) + + # loop defense + if node == nbr and not self_loops: + continue + + # multi edge defense + if graph.edge_by_node(node, nbr) and not multi_edges: + continue + + graph.add_edge(node, nbr) + + for nbr in graph.out_nbrs(node): + store.append(node) + store.append(nbr) + + return graph + + +def filter_stack(graph, head, filters): + """ + Perform a walk in a depth-first order starting + at *head*. + + Returns (visited, removes, orphans). + + * visited: the set of visited nodes + * removes: the list of nodes where the node + data does not all *filters* + * orphans: tuples of (last_good, node), + where node is not in removes, is directly + reachable from a node in *removes* and + *last_good* is the closest upstream node that is not + in *removes*. + """ + + visited, removes, orphans = {head}, set(), set() + stack = deque([(head, head)]) + get_data = graph.node_data + get_edges = graph.out_edges + get_tail = graph.tail + + while stack: + last_good, node = stack.pop() + data = get_data(node) + if data is not None: + for filtfunc in filters: + if not filtfunc(data): + removes.add(node) + break + else: + last_good = node + for edge in get_edges(node): + tail = get_tail(edge) + if last_good is not node: + orphans.add((last_good, tail)) + if tail not in visited: + visited.add(tail) + stack.append((last_good, tail)) + + orphans = [(lg, tl) for (lg, tl) in orphans if tl not in removes] + + return visited, removes, orphans diff --git a/venv/lib/python3.12/site-packages/altgraph/ObjectGraph.py b/venv/lib/python3.12/site-packages/altgraph/ObjectGraph.py new file mode 100644 index 0000000..379b05b --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph/ObjectGraph.py @@ -0,0 +1,212 @@ +""" +altgraph.ObjectGraph - Graph of objects with an identifier +========================================================== + +A graph of objects that have a "graphident" attribute. +graphident is the key for the object in the graph +""" + +from altgraph import GraphError +from altgraph.Graph import Graph +from altgraph.GraphUtil import filter_stack + + +class ObjectGraph(object): + """ + A graph of objects that have a "graphident" attribute. + graphident is the key for the object in the graph + """ + + def __init__(self, graph=None, debug=0): + if graph is None: + graph = Graph() + self.graphident = self + self.graph = graph + self.debug = debug + self.indent = 0 + graph.add_node(self, None) + + def __repr__(self): + return "<%s>" % (type(self).__name__,) + + def flatten(self, condition=None, start=None): + """ + Iterate over the subgraph that is entirely reachable by condition + starting from the given start node or the ObjectGraph root + """ + if start is None: + start = self + start = self.getRawIdent(start) + return self.graph.iterdata(start=start, condition=condition) + + def nodes(self): + for ident in self.graph: + node = self.graph.node_data(ident) + if node is not None: + yield self.graph.node_data(ident) + + def get_edges(self, node): + if node is None: + node = self + start = self.getRawIdent(node) + _, _, outraw, incraw = self.graph.describe_node(start) + + def iter_edges(lst, n): + seen = set() + for tpl in (self.graph.describe_edge(e) for e in lst): + ident = tpl[n] + if ident not in seen: + yield self.findNode(ident) + seen.add(ident) + + return iter_edges(outraw, 3), iter_edges(incraw, 2) + + def edgeData(self, fromNode, toNode): + if fromNode is None: + fromNode = self + start = self.getRawIdent(fromNode) + stop = self.getRawIdent(toNode) + edge = self.graph.edge_by_node(start, stop) + return self.graph.edge_data(edge) + + def updateEdgeData(self, fromNode, toNode, edgeData): + if fromNode is None: + fromNode = self + start = self.getRawIdent(fromNode) + stop = self.getRawIdent(toNode) + edge = self.graph.edge_by_node(start, stop) + self.graph.update_edge_data(edge, edgeData) + + def filterStack(self, filters): + """ + Filter the ObjectGraph in-place by removing all edges to nodes that + do not match every filter in the given filter list + + Returns a tuple containing the number of: + (nodes_visited, nodes_removed, nodes_orphaned) + """ + visited, removes, orphans = filter_stack(self.graph, self, filters) + + for last_good, tail in orphans: + self.graph.add_edge(last_good, tail, edge_data="orphan") + + for node in removes: + self.graph.hide_node(node) + + return len(visited) - 1, len(removes), len(orphans) + + def removeNode(self, node): + """ + Remove the given node from the graph if it exists + """ + ident = self.getIdent(node) + if ident is not None: + self.graph.hide_node(ident) + + def removeReference(self, fromnode, tonode): + """ + Remove all edges from fromnode to tonode + """ + if fromnode is None: + fromnode = self + fromident = self.getIdent(fromnode) + toident = self.getIdent(tonode) + if fromident is not None and toident is not None: + while True: + edge = self.graph.edge_by_node(fromident, toident) + if edge is None: + break + self.graph.hide_edge(edge) + + def getIdent(self, node): + """ + Get the graph identifier for a node + """ + ident = self.getRawIdent(node) + if ident is not None: + return ident + node = self.findNode(node) + if node is None: + return None + return node.graphident + + def getRawIdent(self, node): + """ + Get the identifier for a node object + """ + if node is self: + return node + ident = getattr(node, "graphident", None) + return ident + + def __contains__(self, node): + return self.findNode(node) is not None + + def findNode(self, node): + """ + Find the node on the graph + """ + ident = self.getRawIdent(node) + if ident is None: + ident = node + try: + return self.graph.node_data(ident) + except KeyError: + return None + + def addNode(self, node): + """ + Add a node to the graph referenced by the root + """ + self.msg(4, "addNode", node) + + try: + self.graph.restore_node(node.graphident) + except GraphError: + self.graph.add_node(node.graphident, node) + + def createReference(self, fromnode, tonode, edge_data=None): + """ + Create a reference from fromnode to tonode + """ + if fromnode is None: + fromnode = self + fromident, toident = self.getIdent(fromnode), self.getIdent(tonode) + if fromident is None or toident is None: + return + self.msg(4, "createReference", fromnode, tonode, edge_data) + self.graph.add_edge(fromident, toident, edge_data=edge_data) + + def createNode(self, cls, name, *args, **kw): + """ + Add a node of type cls to the graph if it does not already exist + by the given name + """ + m = self.findNode(name) + if m is None: + m = cls(name, *args, **kw) + self.addNode(m) + return m + + def msg(self, level, s, *args): + """ + Print a debug message with the given level + """ + if s and level <= self.debug: + print("%s%s %s" % (" " * self.indent, s, " ".join(map(repr, args)))) + + def msgin(self, level, s, *args): + """ + Print a debug message and indent + """ + if level <= self.debug: + self.msg(level, s, *args) + self.indent = self.indent + 1 + + def msgout(self, level, s, *args): + """ + Dedent and print a debug message + """ + if level <= self.debug: + self.indent = self.indent - 1 + self.msg(level, s, *args) diff --git a/venv/lib/python3.12/site-packages/altgraph/__init__.py b/venv/lib/python3.12/site-packages/altgraph/__init__.py new file mode 100644 index 0000000..3624968 --- /dev/null +++ b/venv/lib/python3.12/site-packages/altgraph/__init__.py @@ -0,0 +1,146 @@ +""" +altgraph - a python graph library +================================= + +altgraph is a fork of `graphlib `_ tailored +to use newer Python 2.3+ features, including additional support used by the +py2app suite (modulegraph and macholib, specifically). + +altgraph is a python based graph (network) representation and manipulation +package. It has started out as an extension to the +`graph_lib module +`_ +written by Nathan Denny it has been significantly optimized and expanded. + +The :class:`altgraph.Graph.Graph` class is loosely modeled after the +`LEDA `_ +(Library of Efficient Datatypes) representation. The library +includes methods for constructing graphs, BFS and DFS traversals, +topological sort, finding connected components, shortest paths as well as a +number graph statistics functions. The library can also visualize graphs +via `graphviz `_. + +The package contains the following modules: + + - the :py:mod:`altgraph.Graph` module contains the + :class:`~altgraph.Graph.Graph` class that stores the graph data + + - the :py:mod:`altgraph.GraphAlgo` module implements graph algorithms + operating on graphs (:py:class:`~altgraph.Graph.Graph`} instances) + + - the :py:mod:`altgraph.GraphStat` module contains functions for + computing statistical measures on graphs + + - the :py:mod:`altgraph.GraphUtil` module contains functions for + generating, reading and saving graphs + + - the :py:mod:`altgraph.Dot` module contains functions for displaying + graphs via `graphviz `_ + + - the :py:mod:`altgraph.ObjectGraph` module implements a graph of + objects with a unique identifier + +Installation +------------ + +Download and unpack the archive then type:: + + python setup.py install + +This will install the library in the default location. For instructions on +how to customize the install procedure read the output of:: + + python setup.py --help install + +To verify that the code works run the test suite:: + + python setup.py test + +Example usage +------------- + +Lets assume that we want to analyze the graph below (links to the full picture) +GRAPH_IMG. Our script then might look the following way:: + + from altgraph import Graph, GraphAlgo, Dot + + # these are the edges + edges = [ (1,2), (2,4), (1,3), (2,4), (3,4), (4,5), (6,5), + (6,14), (14,15), (6, 15), (5,7), (7, 8), (7,13), (12,8), + (8,13), (11,12), (11,9), (13,11), (9,13), (13,10) ] + + # creates the graph + graph = Graph.Graph() + for head, tail in edges: + graph.add_edge(head, tail) + + # do a forward bfs from 1 at most to 20 + print(graph.forw_bfs(1)) + +This will print the nodes in some breadth first order:: + + [1, 2, 3, 4, 5, 7, 8, 13, 11, 10, 12, 9] + +If we wanted to get the hop-distance from node 1 to node 8 +we coud write:: + + print(graph.get_hops(1, 8)) + +This will print the following:: + + [(1, 0), (2, 1), (3, 1), (4, 2), (5, 3), (7, 4), (8, 5)] + +Node 1 is at 0 hops since it is the starting node, nodes 2,3 are 1 hop away ... +node 8 is 5 hops away. To find the shortest distance between two nodes you +can use:: + + print(GraphAlgo.shortest_path(graph, 1, 12)) + +It will print the nodes on one (if there are more) the shortest paths:: + + [1, 2, 4, 5, 7, 13, 11, 12] + +To display the graph we can use the GraphViz backend:: + + dot = Dot.Dot(graph) + + # display the graph on the monitor + dot.display() + + # save it in an image file + dot.save_img(file_name='graph', file_type='gif') + + + +.. + @author: U{Istvan Albert} + + @license: MIT License + + Copyright (c) 2004 Istvan Albert unless otherwise noted. + + 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. + + 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. + @requires: Python 2.3 or higher + + @newfield contributor: Contributors: + @contributor: U{Reka Albert } + +""" +__version__ = "0.17.5" + + +class GraphError(ValueError): + pass diff --git a/venv/lib/python3.12/site-packages/distutils-precedence.pth b/venv/lib/python3.12/site-packages/distutils-precedence.pth new file mode 100644 index 0000000..7f009fe --- /dev/null +++ b/venv/lib/python3.12/site-packages/distutils-precedence.pth @@ -0,0 +1 @@ +import os; var = 'SETUPTOOLS_USE_DISTUTILS'; enabled = os.environ.get(var, 'local') == 'local'; enabled and __import__('_distutils_hack').add_shim(); diff --git a/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/METADATA b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/METADATA new file mode 100644 index 0000000..10b290a --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/METADATA @@ -0,0 +1,105 @@ +Metadata-Version: 2.4 +Name: packaging +Version: 25.0 +Summary: Core utilities for Python packages +Author-email: Donald Stufft +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 +License-File: LICENSE +License-File: LICENSE.APACHE +License-File: LICENSE.BSD +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 `_. + +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/ + diff --git a/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/RECORD b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/RECORD new file mode 100644 index 0000000..1cf8646 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/RECORD @@ -0,0 +1,40 @@ +packaging-25.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +packaging-25.0.dist-info/METADATA,sha256=W2EaYJw4_vw9YWv0XSCuyY-31T8kXayp4sMPyFx6woI,3281 +packaging-25.0.dist-info/RECORD,, +packaging-25.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82 +packaging-25.0.dist-info/licenses/LICENSE,sha256=ytHvW9NA1z4HS6YU0m996spceUDD2MNIUuZcSQlobEg,197 +packaging-25.0.dist-info/licenses/LICENSE.APACHE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174 +packaging-25.0.dist-info/licenses/LICENSE.BSD,sha256=tw5-m3QvHMb5SLNMFqo5_-zpQZY2S8iP8NIYDwAo-sU,1344 +packaging/__init__.py,sha256=_0cDiPVf2S-bNfVmZguxxzmrIYWlyASxpqph4qsJWUc,494 +packaging/__pycache__/__init__.cpython-312.pyc,, +packaging/__pycache__/_elffile.cpython-312.pyc,, +packaging/__pycache__/_manylinux.cpython-312.pyc,, +packaging/__pycache__/_musllinux.cpython-312.pyc,, +packaging/__pycache__/_parser.cpython-312.pyc,, +packaging/__pycache__/_structures.cpython-312.pyc,, +packaging/__pycache__/_tokenizer.cpython-312.pyc,, +packaging/__pycache__/markers.cpython-312.pyc,, +packaging/__pycache__/metadata.cpython-312.pyc,, +packaging/__pycache__/requirements.cpython-312.pyc,, +packaging/__pycache__/specifiers.cpython-312.pyc,, +packaging/__pycache__/tags.cpython-312.pyc,, +packaging/__pycache__/utils.cpython-312.pyc,, +packaging/__pycache__/version.cpython-312.pyc,, +packaging/_elffile.py,sha256=UkrbDtW7aeq3qqoAfU16ojyHZ1xsTvGke_WqMTKAKd0,3286 +packaging/_manylinux.py,sha256=t4y_-dTOcfr36gLY-ztiOpxxJFGO2ikC11HgfysGxiM,9596 +packaging/_musllinux.py,sha256=p9ZqNYiOItGee8KcZFeHF_YcdhVwGHdK6r-8lgixvGQ,2694 +packaging/_parser.py,sha256=gYfnj0pRHflVc4RHZit13KNTyN9iiVcU2RUCGi22BwM,10221 +packaging/_structures.py,sha256=q3eVNmbWJGG_S0Dit_S3Ao8qQqz_5PYTXFAKBZe5yr4,1431 +packaging/_tokenizer.py,sha256=OYzt7qKxylOAJ-q0XyK1qAycyPRYLfMPdGQKRXkZWyI,5310 +packaging/licenses/__init__.py,sha256=VsK4o27CJXWfTi8r2ybJmsBoCdhpnBWuNrskaCVKP7U,5715 +packaging/licenses/__pycache__/__init__.cpython-312.pyc,, +packaging/licenses/__pycache__/_spdx.cpython-312.pyc,, +packaging/licenses/_spdx.py,sha256=oAm1ztPFwlsmCKe7lAAsv_OIOfS1cWDu9bNBkeu-2ns,48398 +packaging/markers.py,sha256=P0we27jm1xUzgGMJxBjtUFCIWeBxTsMeJTOJ6chZmAY,12049 +packaging/metadata.py,sha256=8IZErqQQnNm53dZZuYq4FGU4_dpyinMeH1QFBIWIkfE,34739 +packaging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +packaging/requirements.py,sha256=gYyRSAdbrIyKDY66ugIDUQjRMvxkH2ALioTmX3tnL6o,2947 +packaging/specifiers.py,sha256=gtPu5DTc-F9baLq3FTGEK6dPhHGCuwwZetaY0PSV2gs,40055 +packaging/tags.py,sha256=41s97W9Zatrq2Ed7Rc3qeBDaHe8pKKvYq2mGjwahfXk,22745 +packaging/utils.py,sha256=0F3Hh9OFuRgrhTgGZUl5K22Fv1YP2tZl1z_2gO6kJiA,5050 +packaging/version.py,sha256=olfyuk_DPbflNkJ4wBWetXQ17c74x3DB501degUv7DY,16676 diff --git a/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/WHEEL b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/WHEEL new file mode 100644 index 0000000..d8b9936 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: flit 3.12.0 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/licenses/LICENSE b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/licenses/LICENSE new file mode 100644 index 0000000..6f62d44 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/licenses/LICENSE @@ -0,0 +1,3 @@ +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. diff --git a/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/licenses/LICENSE.APACHE b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/licenses/LICENSE.APACHE new file mode 100644 index 0000000..f433b1a --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/licenses/LICENSE.APACHE @@ -0,0 +1,177 @@ + + 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 diff --git a/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/licenses/LICENSE.BSD b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/licenses/LICENSE.BSD new file mode 100644 index 0000000..42ce7b7 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging-25.0.dist-info/licenses/LICENSE.BSD @@ -0,0 +1,23 @@ +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. diff --git a/venv/lib/python3.12/site-packages/packaging/__init__.py b/venv/lib/python3.12/site-packages/packaging/__init__.py new file mode 100644 index 0000000..d45c22c --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/__init__.py @@ -0,0 +1,15 @@ +# 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__ = "25.0" + +__author__ = "Donald Stufft and individual contributors" +__email__ = "donald@stufft.io" + +__license__ = "BSD-2-Clause or Apache-2.0" +__copyright__ = f"2014 {__author__}" diff --git a/venv/lib/python3.12/site-packages/packaging/_elffile.py b/venv/lib/python3.12/site-packages/packaging/_elffile.py new file mode 100644 index 0000000..7a5afc3 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/_elffile.py @@ -0,0 +1,109 @@ +""" +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 MSB. + (2, 1): ("HHIQQQIHHH", ">IIQQQQQQ", (0, 2, 5)), # 64-bit MSB. + }[(self.capacity, self.encoding)] + except KeyError as e: + raise ELFInvalid( + f"unrecognized capacity ({self.capacity}) or 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 diff --git a/venv/lib/python3.12/site-packages/packaging/_manylinux.py b/venv/lib/python3.12/site-packages/packaging/_manylinux.py new file mode 100644 index 0000000..95f5576 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/_manylinux.py @@ -0,0 +1,262 @@ +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[0-9]+)\.(?P[0-9]+)", version_str) + if not m: + warnings.warn( + f"Expected glibc version with 2 components major.minor, 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}" diff --git a/venv/lib/python3.12/site-packages/packaging/_musllinux.py b/venv/lib/python3.12/site-packages/packaging/_musllinux.py new file mode 100644 index 0000000..d2bf30b --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/_musllinux.py @@ -0,0 +1,85 @@ +"""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 ") diff --git a/venv/lib/python3.12/site-packages/packaging/_parser.py b/venv/lib/python3.12/site-packages/packaging/_parser.py new file mode 100644 index 0000000..0007c0a --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/_parser.py @@ -0,0 +1,353 @@ +"""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" + ) diff --git a/venv/lib/python3.12/site-packages/packaging/_structures.py b/venv/lib/python3.12/site-packages/packaging/_structures.py new file mode 100644 index 0000000..90a6465 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/_structures.py @@ -0,0 +1,61 @@ +# 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() diff --git a/venv/lib/python3.12/site-packages/packaging/_tokenizer.py b/venv/lib/python3.12/site-packages/packaging/_tokenizer.py new file mode 100644 index 0000000..d28a9b6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/_tokenizer.py @@ -0,0 +1,195 @@ +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) + |extras? + |dependency_groups + )\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() diff --git a/venv/lib/python3.12/site-packages/packaging/licenses/__init__.py b/venv/lib/python3.12/site-packages/packaging/licenses/__init__.py new file mode 100644 index 0000000..6f7f9e6 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/licenses/__init__.py @@ -0,0 +1,145 @@ +####################################################################################### +# +# Adapted from: +# https://github.com/pypa/hatch/blob/5352e44/backend/src/hatchling/licenses/parse.py +# +# MIT License +# +# Copyright (c) 2017-present Ofek Lev +# +# 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__ = [ + "InvalidLicenseExpression", + "NormalizedLicenseExpression", + "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(" )", ")"), + ) diff --git a/venv/lib/python3.12/site-packages/packaging/licenses/_spdx.py b/venv/lib/python3.12/site-packages/packaging/licenses/_spdx.py new file mode 100644 index 0000000..eac2227 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/licenses/_spdx.py @@ -0,0 +1,759 @@ + +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}, +} diff --git a/venv/lib/python3.12/site-packages/packaging/markers.py b/venv/lib/python3.12/site-packages/packaging/markers.py new file mode 100644 index 0000000..e7cea57 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/markers.py @@ -0,0 +1,362 @@ +# 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 AbstractSet, Any, Callable, Literal, TypedDict, Union, 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__ = [ + "EvaluateContext", + "InvalidMarker", + "Marker", + "UndefinedComparison", + "UndefinedEnvironmentName", + "default_environment", +] + +Operator = Callable[[str, Union[str, AbstractSet[str]]], bool] +EvaluateContext = Literal["metadata", "lock_file", "requirement"] +MARKERS_ALLOWING_SET = {"extras", "dependency_groups"} + + +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 | AbstractSet[str]) -> bool: + if isinstance(rhs, str): + 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( + lhs: str, rhs: str | AbstractSet[str], key: str +) -> tuple[str, str | AbstractSet[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": + assert isinstance(rhs, str), "extra value must be a string" + return (canonicalize_name(lhs), canonicalize_name(rhs)) + if key in MARKERS_ALLOWING_SET: + if isinstance(rhs, str): # pragma: no cover + return (canonicalize_name(lhs), canonicalize_name(rhs)) + else: + return (canonicalize_name(lhs), {canonicalize_name(v) for v in rhs}) + + # other environment markers don't have such standards + return lhs, rhs + + +def _evaluate_markers( + markers: MarkerList, environment: dict[str, str | AbstractSet[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] + assert isinstance(lhs_value, str), "lhs must be a string" + 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: + # [ + # (, ')>, ), + # 'and', + # [ + # (, , ), + # 'or', + # (, , ) + # ] + # ] + 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"" + + 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, + context: EvaluateContext = "metadata", + ) -> 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 *context* parameter specifies what + context the markers are being evaluated for, which influences what markers + are considered valid. Acceptable values are "metadata" (for core metadata; + default), "lock_file", and "requirement" (i.e. all other situations). + + The environment is determined from the current Python process. + """ + current_environment = cast( + "dict[str, str | AbstractSet[str]]", default_environment() + ) + if context == "lock_file": + current_environment.update( + extras=frozenset(), dependency_groups=frozenset() + ) + elif context == "metadata": + 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 "extra" in current_environment and 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 | AbstractSet[str]], +) -> dict[str, str | AbstractSet[str]]: + """ + Work around platform.python_version() returning something that is not PEP 440 + compliant for non-tagged Python builds. + """ + python_full_version = cast(str, env["python_full_version"]) + if python_full_version.endswith("+"): + env["python_full_version"] = f"{python_full_version}local" + return env diff --git a/venv/lib/python3.12/site-packages/packaging/metadata.py b/venv/lib/python3.12/site-packages/packaging/metadata.py new file mode 100644 index 0000000..3bd8602 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/metadata.py @@ -0,0 +1,862 @@ +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)""" diff --git a/venv/lib/python3.12/site-packages/packaging/py.typed b/venv/lib/python3.12/site-packages/packaging/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/venv/lib/python3.12/site-packages/packaging/requirements.py b/venv/lib/python3.12/site-packages/packaging/requirements.py new file mode 100644 index 0000000..4e068c9 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/requirements.py @@ -0,0 +1,91 @@ +# 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"" + + 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 + ) diff --git a/venv/lib/python3.12/site-packages/packaging/specifiers.py b/venv/lib/python3.12/site-packages/packaging/specifiers.py new file mode 100644 index 0000000..c844804 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/specifiers.py @@ -0,0 +1,1019 @@ +# 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(~=|==|!=|<=|>=|<|>|===)) + """ + _version_regex_str = r""" + (?P + (?: + # 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. + (?=": "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') + =1.0.0')> + >>> Specifier('>=1.0.0', prereleases=False) + =1.0.0', prereleases=False)> + >>> Specifier('>=1.0.0', prereleases=True) + =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', ] + >>> 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') + =1.0.0')> + >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False) + =1.0.0', prereleases=False)> + >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True) + =1.0.0', prereleases=True)> + """ + pre = ( + f", prereleases={self.prereleases!r}" + if self._prereleases is not None + else "" + ) + + return f"" + + 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' + =1.0.0')> + >>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1') + =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) + [, =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', ] + >>> 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) diff --git a/venv/lib/python3.12/site-packages/packaging/tags.py b/venv/lib/python3.12/site-packages/packaging/tags.py new file mode 100644 index 0000000..8522f59 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/tags.py @@ -0,0 +1,656 @@ +# 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-- + - cp-abi3- + - cp-none- + - cp-abi3- # 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: + - -- + + 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- + - -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 android_platforms( + api_level: int | None = None, abi: str | None = None +) -> Iterator[str]: + """ + Yields the :attr:`~Tag.platform` tags for Android. If this function is invoked on + non-Android platforms, the ``api_level`` and ``abi`` arguments are required. + + :param int api_level: The maximum `API level + `__ to return. Defaults + to the current system's version, as returned by ``platform.android_ver``. + :param str abi: The `Android ABI `__, + e.g. ``arm64_v8a``. Defaults to the current system's ABI , as returned by + ``sysconfig.get_platform``. Hyphens and periods will be replaced with + underscores. + """ + if platform.system() != "Android" and (api_level is None or abi is None): + raise TypeError( + "on non-Android platforms, the api_level and abi arguments are required" + ) + + if api_level is None: + # Python 3.13 was the first version to return platform.system() == "Android", + # and also the first version to define platform.android_ver(). + api_level = platform.android_ver().api_level # type: ignore[attr-defined] + + if abi is None: + abi = sysconfig.get_platform().split("-")[-1] + abi = _normalize_string(abi) + + # 16 is the minimum API level known to have enough features to support CPython + # without major patching. Yield every API level from the maximum down to the + # minimum, inclusive. + min_api_level = 16 + for ver in range(api_level, min_api_level - 1, -1): + yield f"android_{ver}_{abi}" + + +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() == "Android": + return android_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) diff --git a/venv/lib/python3.12/site-packages/packaging/utils.py b/venv/lib/python3.12/site-packages/packaging/utils.py new file mode 100644 index 0000000..2345095 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/utils.py @@ -0,0 +1,163 @@ +# 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) diff --git a/venv/lib/python3.12/site-packages/packaging/version.py b/venv/lib/python3.12/site-packages/packaging/version.py new file mode 100644 index 0000000..c9bbda2 --- /dev/null +++ b/venv/lib/python3.12/site-packages/packaging/version.py @@ -0,0 +1,582 @@ +# 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') + + + :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[0-9]+)!)? # epoch + (?P[0-9]+(?:\.[0-9]+)*) # release segment + (?P
                                          # pre-release
+            [-_\.]?
+            (?Palpha|a|beta|b|preview|pre|c|rc)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+        (?P                                         # post release
+            (?:-(?P[0-9]+))
+            |
+            (?:
+                [-_\.]?
+                (?Ppost|rev|r)
+                [-_\.]?
+                (?P[0-9]+)?
+            )
+        )?
+        (?P                                          # dev release
+            [-_\.]?
+            (?Pdev)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+    )
+    (?:\+(?P[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
+    
+    >>> v2
+    
+    >>> 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')
+        
+        """
+        return f""
+
+    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
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/__init__.py b/venv/lib/python3.12/site-packages/pkg_resources/__init__.py
new file mode 100644
index 0000000..926765b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/__init__.py
@@ -0,0 +1,3713 @@
+"""
+Package resource API
+--------------------
+
+A resource is a logical file contained within a package, or a logical
+subdirectory thereof.  The package resource API expects resource names
+to have their path parts separated with ``/``, *not* whatever the local
+path separator is.  Do not use os.path operations to manipulate resource
+names being passed into the API.
+
+The package resource API is designed to work with normal filesystem packages,
+.egg files, and unpacked .egg files.  It can also work in a limited way with
+.zip files and with custom PEP 302 loaders that support the ``get_data()``
+method.
+
+This module is deprecated. Users are directed to :mod:`importlib.resources`,
+:mod:`importlib.metadata` and :pypi:`packaging` instead.
+"""
+
+from __future__ import annotations
+
+import sys
+
+if sys.version_info < (3, 9):  # noqa: UP036 # Check for unsupported versions
+    raise RuntimeError("Python 3.9 or later is required")
+
+import _imp
+import collections
+import email.parser
+import errno
+import functools
+import importlib
+import importlib.abc
+import importlib.machinery
+import inspect
+import io
+import ntpath
+import operator
+import os
+import pkgutil
+import platform
+import plistlib
+import posixpath
+import re
+import stat
+import tempfile
+import textwrap
+import time
+import types
+import warnings
+import zipfile
+import zipimport
+from collections.abc import Iterable, Iterator, Mapping, MutableSequence
+from pkgutil import get_importer
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    BinaryIO,
+    Callable,
+    Literal,
+    NamedTuple,
+    NoReturn,
+    Protocol,
+    TypeVar,
+    Union,
+    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)
+
+# capture these to bypass sandboxing
+from os import open as os_open, utime  # isort: skip
+from os.path import isdir, split  # isort: skip
+
+try:
+    from os import mkdir, rename, unlink
+
+    WRITE_SUPPORT = True
+except ImportError:
+    # no write support, probably under GAE
+    WRITE_SUPPORT = False
+
+import packaging.markers
+import packaging.requirements
+import packaging.specifiers
+import packaging.utils
+import packaging.version
+from jaraco.text import drop_comment, join_continuation, yield_lines
+from platformdirs import user_cache_dir as _user_cache_dir
+
+if TYPE_CHECKING:
+    from _typeshed import BytesPath, StrOrBytesPath, StrPath
+    from _typeshed.importlib import LoaderProtocol
+    from typing_extensions import Self, TypeAlias
+
+warnings.warn(
+    "pkg_resources is deprecated as an API. "
+    "See https://setuptools.pypa.io/en/latest/pkg_resources.html. "
+    "The pkg_resources package is slated for removal as early as "
+    "2025-11-30. Refrain from using this package or pin to "
+    "Setuptools<81.",
+    UserWarning,
+    stacklevel=2,
+)
+
+_T = TypeVar("_T")
+_DistributionT = TypeVar("_DistributionT", bound="Distribution")
+# Type aliases
+_NestedStr: TypeAlias = Union[str, Iterable[Union[str, Iterable["_NestedStr"]]]]
+_StrictInstallerType: TypeAlias = Callable[["Requirement"], "_DistributionT"]
+_InstallerType: TypeAlias = Callable[["Requirement"], Union["Distribution", None]]
+_PkgReqType: TypeAlias = Union[str, "Requirement"]
+_EPDistType: TypeAlias = Union["Distribution", _PkgReqType]
+_MetadataType: TypeAlias = Union["IResourceProvider", None]
+_ResolvedEntryPoint: TypeAlias = Any  # Can be any attribute in the module
+_ResourceStream: TypeAlias = Any  # TODO / Incomplete: A readable file-like object
+# Any object works, but let's indicate we expect something like a module (optionally has __loader__ or __file__)
+_ModuleLike: TypeAlias = Union[object, types.ModuleType]
+# Any: Should be _ModuleLike but we end up with issues where _ModuleLike doesn't have _ZipLoaderModule's __loader__
+_ProviderFactoryType: TypeAlias = Callable[[Any], "IResourceProvider"]
+_DistFinderType: TypeAlias = Callable[[_T, str, bool], Iterable["Distribution"]]
+_NSHandlerType: TypeAlias = Callable[[_T, str, str, types.ModuleType], Union[str, None]]
+_AdapterT = TypeVar(
+    "_AdapterT", _DistFinderType[Any], _ProviderFactoryType, _NSHandlerType[Any]
+)
+
+
+class _ZipLoaderModule(Protocol):
+    __loader__: zipimport.zipimporter
+
+
+_PEP440_FALLBACK = re.compile(r"^v?(?P(?:[0-9]+!)?[0-9]+(?:\.[0-9]+)*)", re.I)
+
+
+class PEP440Warning(RuntimeWarning):
+    """
+    Used when there is an issue with a version or specifier not complying with
+    PEP 440.
+    """
+
+
+parse_version = packaging.version.Version
+
+_state_vars: dict[str, str] = {}
+
+
+def _declare_state(vartype: str, varname: str, initial_value: _T) -> _T:
+    _state_vars[varname] = vartype
+    return initial_value
+
+
+def __getstate__() -> dict[str, Any]:
+    state = {}
+    g = globals()
+    for k, v in _state_vars.items():
+        state[k] = g['_sget_' + v](g[k])
+    return state
+
+
+def __setstate__(state: dict[str, Any]) -> dict[str, Any]:
+    g = globals()
+    for k, v in state.items():
+        g['_sset_' + _state_vars[k]](k, g[k], v)
+    return state
+
+
+def _sget_dict(val):
+    return val.copy()
+
+
+def _sset_dict(key, ob, state) -> None:
+    ob.clear()
+    ob.update(state)
+
+
+def _sget_object(val):
+    return val.__getstate__()
+
+
+def _sset_object(key, ob, state) -> None:
+    ob.__setstate__(state)
+
+
+_sget_none = _sset_none = lambda *args: None
+
+
+def get_supported_platform():
+    """Return this platform's maximum compatible version.
+
+    distutils.util.get_platform() normally reports the minimum version
+    of macOS that would be required to *use* extensions produced by
+    distutils.  But what we want when checking compatibility is to know the
+    version of macOS that we are *running*.  To allow usage of packages that
+    explicitly require a newer version of macOS, we must also know the
+    current version of the OS.
+
+    If this condition occurs for any other platform with a version in its
+    platform strings, this function should be extended accordingly.
+    """
+    plat = get_build_platform()
+    m = macosVersionString.match(plat)
+    if m is not None and sys.platform == "darwin":
+        try:
+            major_minor = '.'.join(_macos_vers()[:2])
+            build = m.group(3)
+            plat = f'macosx-{major_minor}-{build}'
+        except ValueError:
+            # not macOS
+            pass
+    return plat
+
+
+__all__ = [
+    # Basic resource access and distribution/entry point discovery
+    'require',
+    'run_script',
+    'get_provider',
+    'get_distribution',
+    'load_entry_point',
+    'get_entry_map',
+    'get_entry_info',
+    'iter_entry_points',
+    'resource_string',
+    'resource_stream',
+    'resource_filename',
+    'resource_listdir',
+    'resource_exists',
+    'resource_isdir',
+    # Environmental control
+    'declare_namespace',
+    'working_set',
+    'add_activation_listener',
+    'find_distributions',
+    'set_extraction_path',
+    'cleanup_resources',
+    'get_default_cache',
+    # Primary implementation classes
+    'Environment',
+    'WorkingSet',
+    'ResourceManager',
+    'Distribution',
+    'Requirement',
+    'EntryPoint',
+    # Exceptions
+    'ResolutionError',
+    'VersionConflict',
+    'DistributionNotFound',
+    'UnknownExtra',
+    'ExtractionError',
+    # Warnings
+    'PEP440Warning',
+    # Parsing functions and string utilities
+    'parse_requirements',
+    'parse_version',
+    'safe_name',
+    'safe_version',
+    'get_platform',
+    'compatible_platforms',
+    'yield_lines',
+    'split_sections',
+    'safe_extra',
+    'to_filename',
+    'invalid_marker',
+    'evaluate_marker',
+    # filesystem utilities
+    'ensure_directory',
+    'normalize_path',
+    # Distribution "precedence" constants
+    'EGG_DIST',
+    'BINARY_DIST',
+    'SOURCE_DIST',
+    'CHECKOUT_DIST',
+    'DEVELOP_DIST',
+    # "Provider" interfaces, implementations, and registration/lookup APIs
+    'IMetadataProvider',
+    'IResourceProvider',
+    'FileMetadata',
+    'PathMetadata',
+    'EggMetadata',
+    'EmptyProvider',
+    'empty_provider',
+    'NullProvider',
+    'EggProvider',
+    'DefaultProvider',
+    'ZipProvider',
+    'register_finder',
+    'register_namespace_handler',
+    'register_loader_type',
+    'fixup_namespace_packages',
+    'get_importer',
+    # Warnings
+    'PkgResourcesDeprecationWarning',
+    # Deprecated/backward compatibility only
+    'run_main',
+    'AvailableDistributions',
+]
+
+
+class ResolutionError(Exception):
+    """Abstract base for dependency resolution errors"""
+
+    def __repr__(self) -> str:
+        return self.__class__.__name__ + repr(self.args)
+
+
+class VersionConflict(ResolutionError):
+    """
+    An already-installed version conflicts with the requested version.
+
+    Should be initialized with the installed Distribution and the requested
+    Requirement.
+    """
+
+    _template = "{self.dist} is installed but {self.req} is required"
+
+    @property
+    def dist(self) -> Distribution:
+        return self.args[0]
+
+    @property
+    def req(self) -> Requirement:
+        return self.args[1]
+
+    def report(self):
+        return self._template.format(**locals())
+
+    def with_context(
+        self, required_by: set[Distribution | str]
+    ) -> Self | ContextualVersionConflict:
+        """
+        If required_by is non-empty, return a version of self that is a
+        ContextualVersionConflict.
+        """
+        if not required_by:
+            return self
+        args = self.args + (required_by,)
+        return ContextualVersionConflict(*args)
+
+
+class ContextualVersionConflict(VersionConflict):
+    """
+    A VersionConflict that accepts a third parameter, the set of the
+    requirements that required the installed Distribution.
+    """
+
+    _template = VersionConflict._template + ' by {self.required_by}'
+
+    @property
+    def required_by(self) -> set[str]:
+        return self.args[2]
+
+
+class DistributionNotFound(ResolutionError):
+    """A requested distribution was not found"""
+
+    _template = (
+        "The '{self.req}' distribution was not found "
+        "and is required by {self.requirers_str}"
+    )
+
+    @property
+    def req(self) -> Requirement:
+        return self.args[0]
+
+    @property
+    def requirers(self) -> set[str] | None:
+        return self.args[1]
+
+    @property
+    def requirers_str(self):
+        if not self.requirers:
+            return 'the application'
+        return ', '.join(self.requirers)
+
+    def report(self):
+        return self._template.format(**locals())
+
+    def __str__(self) -> str:
+        return self.report()
+
+
+class UnknownExtra(ResolutionError):
+    """Distribution doesn't have an "extra feature" of the given name"""
+
+
+_provider_factories: dict[type[_ModuleLike], _ProviderFactoryType] = {}
+
+PY_MAJOR = f'{sys.version_info.major}.{sys.version_info.minor}'
+EGG_DIST = 3
+BINARY_DIST = 2
+SOURCE_DIST = 1
+CHECKOUT_DIST = 0
+DEVELOP_DIST = -1
+
+
+def register_loader_type(
+    loader_type: type[_ModuleLike], provider_factory: _ProviderFactoryType
+) -> None:
+    """Register `provider_factory` to make providers for `loader_type`
+
+    `loader_type` is the type or class of a PEP 302 ``module.__loader__``,
+    and `provider_factory` is a function that, passed a *module* object,
+    returns an ``IResourceProvider`` for that module.
+    """
+    _provider_factories[loader_type] = provider_factory
+
+
+@overload
+def get_provider(moduleOrReq: str) -> IResourceProvider: ...
+@overload
+def get_provider(moduleOrReq: Requirement) -> Distribution: ...
+def get_provider(moduleOrReq: str | Requirement) -> IResourceProvider | Distribution:
+    """Return an IResourceProvider for the named module or requirement"""
+    if isinstance(moduleOrReq, Requirement):
+        return working_set.find(moduleOrReq) or require(str(moduleOrReq))[0]
+    try:
+        module = sys.modules[moduleOrReq]
+    except KeyError:
+        __import__(moduleOrReq)
+        module = sys.modules[moduleOrReq]
+    loader = getattr(module, '__loader__', None)
+    return _find_adapter(_provider_factories, loader)(module)
+
+
+@functools.cache
+def _macos_vers():
+    version = platform.mac_ver()[0]
+    # fallback for MacPorts
+    if version == '':
+        plist = '/System/Library/CoreServices/SystemVersion.plist'
+        if os.path.exists(plist):
+            with open(plist, 'rb') as fh:
+                plist_content = plistlib.load(fh)
+            if 'ProductVersion' in plist_content:
+                version = plist_content['ProductVersion']
+    return version.split('.')
+
+
+def _macos_arch(machine):
+    return {'PowerPC': 'ppc', 'Power_Macintosh': 'ppc'}.get(machine, machine)
+
+
+def get_build_platform():
+    """Return this platform's string for platform-specific distributions"""
+    from sysconfig import get_platform
+
+    plat = get_platform()
+    if sys.platform == "darwin" and not plat.startswith('macosx-'):
+        try:
+            version = _macos_vers()
+            machine = _macos_arch(os.uname()[4].replace(" ", "_"))
+            return f"macosx-{version[0]}.{version[1]}-{machine}"
+        except ValueError:
+            # if someone is running a non-Mac darwin system, this will fall
+            # through to the default implementation
+            pass
+    return plat
+
+
+macosVersionString = re.compile(r"macosx-(\d+)\.(\d+)-(.*)")
+darwinVersionString = re.compile(r"darwin-(\d+)\.(\d+)\.(\d+)-(.*)")
+# XXX backward compat
+get_platform = get_build_platform
+
+
+def compatible_platforms(provided: str | None, required: str | None) -> bool:
+    """Can code for the `provided` platform run on the `required` platform?
+
+    Returns true if either platform is ``None``, or the platforms are equal.
+
+    XXX Needs compatibility checks for Linux and other unixy OSes.
+    """
+    if provided is None or required is None or provided == required:
+        # easy case
+        return True
+
+    # macOS special cases
+    reqMac = macosVersionString.match(required)
+    if reqMac:
+        provMac = macosVersionString.match(provided)
+
+        # is this a Mac package?
+        if not provMac:
+            # this is backwards compatibility for packages built before
+            # setuptools 0.6. All packages built after this point will
+            # use the new macOS designation.
+            provDarwin = darwinVersionString.match(provided)
+            if provDarwin:
+                dversion = int(provDarwin.group(1))
+                macosversion = f"{reqMac.group(1)}.{reqMac.group(2)}"
+                if (
+                    dversion == 7
+                    and macosversion >= "10.3"
+                    or dversion == 8
+                    and macosversion >= "10.4"
+                ):
+                    return True
+            # egg isn't macOS or legacy darwin
+            return False
+
+        # are they the same major version and machine type?
+        if provMac.group(1) != reqMac.group(1) or provMac.group(3) != reqMac.group(3):
+            return False
+
+        # is the required OS major update >= the provided one?
+        if int(provMac.group(2)) > int(reqMac.group(2)):
+            return False
+
+        return True
+
+    # XXX Linux and other platforms' special cases should go here
+    return False
+
+
+@overload
+def get_distribution(dist: _DistributionT) -> _DistributionT: ...
+@overload
+def get_distribution(dist: _PkgReqType) -> Distribution: ...
+def get_distribution(dist: Distribution | _PkgReqType) -> Distribution:
+    """Return a current distribution object for a Requirement or string"""
+    if isinstance(dist, str):
+        dist = Requirement.parse(dist)
+    if isinstance(dist, Requirement):
+        dist = get_provider(dist)
+    if not isinstance(dist, Distribution):
+        raise TypeError("Expected str, Requirement, or Distribution", dist)
+    return dist
+
+
+def load_entry_point(dist: _EPDistType, group: str, name: str) -> _ResolvedEntryPoint:
+    """Return `name` entry point of `group` for `dist` or raise ImportError"""
+    return get_distribution(dist).load_entry_point(group, name)
+
+
+@overload
+def get_entry_map(
+    dist: _EPDistType, group: None = None
+) -> dict[str, dict[str, EntryPoint]]: ...
+@overload
+def get_entry_map(dist: _EPDistType, group: str) -> dict[str, EntryPoint]: ...
+def get_entry_map(dist: _EPDistType, group: str | None = None):
+    """Return the entry point map for `group`, or the full entry map"""
+    return get_distribution(dist).get_entry_map(group)
+
+
+def get_entry_info(dist: _EPDistType, group: str, name: str) -> EntryPoint | None:
+    """Return the EntryPoint object for `group`+`name`, or ``None``"""
+    return get_distribution(dist).get_entry_info(group, name)
+
+
+class IMetadataProvider(Protocol):
+    def has_metadata(self, name: str) -> bool:
+        """Does the package's distribution contain the named metadata?"""
+        ...
+
+    def get_metadata(self, name: str) -> str:
+        """The named metadata resource as a string"""
+        ...
+
+    def get_metadata_lines(self, name: str) -> Iterator[str]:
+        """Yield named metadata resource as list of non-blank non-comment lines
+
+        Leading and trailing whitespace is stripped from each line, and lines
+        with ``#`` as the first non-blank character are omitted."""
+        ...
+
+    def metadata_isdir(self, name: str) -> bool:
+        """Is the named metadata a directory?  (like ``os.path.isdir()``)"""
+        ...
+
+    def metadata_listdir(self, name: str) -> list[str]:
+        """List of metadata names in the directory (like ``os.listdir()``)"""
+        ...
+
+    def run_script(self, script_name: str, namespace: dict[str, Any]) -> None:
+        """Execute the named script in the supplied namespace dictionary"""
+        ...
+
+
+class IResourceProvider(IMetadataProvider, Protocol):
+    """An object that provides access to package resources"""
+
+    def get_resource_filename(
+        self, manager: ResourceManager, resource_name: str
+    ) -> str:
+        """Return a true filesystem path for `resource_name`
+
+        `manager` must be a ``ResourceManager``"""
+        ...
+
+    def get_resource_stream(
+        self, manager: ResourceManager, resource_name: str
+    ) -> _ResourceStream:
+        """Return a readable file-like object for `resource_name`
+
+        `manager` must be a ``ResourceManager``"""
+        ...
+
+    def get_resource_string(
+        self, manager: ResourceManager, resource_name: str
+    ) -> bytes:
+        """Return the contents of `resource_name` as :obj:`bytes`
+
+        `manager` must be a ``ResourceManager``"""
+        ...
+
+    def has_resource(self, resource_name: str) -> bool:
+        """Does the package contain the named resource?"""
+        ...
+
+    def resource_isdir(self, resource_name: str) -> bool:
+        """Is the named resource a directory?  (like ``os.path.isdir()``)"""
+        ...
+
+    def resource_listdir(self, resource_name: str) -> list[str]:
+        """List of resource names in the directory (like ``os.listdir()``)"""
+        ...
+
+
+class WorkingSet:
+    """A collection of active distributions on sys.path (or a similar list)"""
+
+    def __init__(self, entries: Iterable[str] | None = None) -> None:
+        """Create working set from list of path entries (default=sys.path)"""
+        self.entries: list[str] = []
+        self.entry_keys: dict[str | None, list[str]] = {}
+        self.by_key: dict[str, Distribution] = {}
+        self.normalized_to_canonical_keys: dict[str, str] = {}
+        self.callbacks: list[Callable[[Distribution], object]] = []
+
+        if entries is None:
+            entries = sys.path
+
+        for entry in entries:
+            self.add_entry(entry)
+
+    @classmethod
+    def _build_master(cls):
+        """
+        Prepare the master working set.
+        """
+        ws = cls()
+        try:
+            from __main__ import __requires__
+        except ImportError:
+            # The main program does not list any requirements
+            return ws
+
+        # ensure the requirements are met
+        try:
+            ws.require(__requires__)
+        except VersionConflict:
+            return cls._build_from_requirements(__requires__)
+
+        return ws
+
+    @classmethod
+    def _build_from_requirements(cls, req_spec):
+        """
+        Build a working set from a requirement spec. Rewrites sys.path.
+        """
+        # try it without defaults already on sys.path
+        # by starting with an empty path
+        ws = cls([])
+        reqs = parse_requirements(req_spec)
+        dists = ws.resolve(reqs, Environment())
+        for dist in dists:
+            ws.add(dist)
+
+        # add any missing entries from sys.path
+        for entry in sys.path:
+            if entry not in ws.entries:
+                ws.add_entry(entry)
+
+        # then copy back to sys.path
+        sys.path[:] = ws.entries
+        return ws
+
+    def add_entry(self, entry: str) -> None:
+        """Add a path item to ``.entries``, finding any distributions on it
+
+        ``find_distributions(entry, True)`` is used to find distributions
+        corresponding to the path entry, and they are added.  `entry` is
+        always appended to ``.entries``, even if it is already present.
+        (This is because ``sys.path`` can contain the same value more than
+        once, and the ``.entries`` of the ``sys.path`` WorkingSet should always
+        equal ``sys.path``.)
+        """
+        self.entry_keys.setdefault(entry, [])
+        self.entries.append(entry)
+        for dist in find_distributions(entry, True):
+            self.add(dist, entry, False)
+
+    def __contains__(self, dist: Distribution) -> bool:
+        """True if `dist` is the active distribution for its project"""
+        return self.by_key.get(dist.key) == dist
+
+    def find(self, req: Requirement) -> Distribution | None:
+        """Find a distribution matching requirement `req`
+
+        If there is an active distribution for the requested project, this
+        returns it as long as it meets the version requirement specified by
+        `req`.  But, if there is an active distribution for the project and it
+        does *not* meet the `req` requirement, ``VersionConflict`` is raised.
+        If there is no active distribution for the requested project, ``None``
+        is returned.
+        """
+        dist: Distribution | None = None
+
+        candidates = (
+            req.key,
+            self.normalized_to_canonical_keys.get(req.key),
+            safe_name(req.key).replace(".", "-"),
+        )
+
+        for candidate in filter(None, candidates):
+            dist = self.by_key.get(candidate)
+            if dist:
+                req.key = candidate
+                break
+
+        if dist is not None and dist not in req:
+            # XXX add more info
+            raise VersionConflict(dist, req)
+        return dist
+
+    def iter_entry_points(
+        self, group: str, name: str | None = None
+    ) -> Iterator[EntryPoint]:
+        """Yield entry point objects from `group` matching `name`
+
+        If `name` is None, yields all entry points in `group` from all
+        distributions in the working set, otherwise only ones matching
+        both `group` and `name` are yielded (in distribution order).
+        """
+        return (
+            entry
+            for dist in self
+            for entry in dist.get_entry_map(group).values()
+            if name is None or name == entry.name
+        )
+
+    def run_script(self, requires: str, script_name: str) -> None:
+        """Locate distribution for `requires` and run `script_name` script"""
+        ns = sys._getframe(1).f_globals
+        name = ns['__name__']
+        ns.clear()
+        ns['__name__'] = name
+        self.require(requires)[0].run_script(script_name, ns)
+
+    def __iter__(self) -> Iterator[Distribution]:
+        """Yield distributions for non-duplicate projects in the working set
+
+        The yield order is the order in which the items' path entries were
+        added to the working set.
+        """
+        seen = set()
+        for item in self.entries:
+            if item not in self.entry_keys:
+                # workaround a cache issue
+                continue
+
+            for key in self.entry_keys[item]:
+                if key not in seen:
+                    seen.add(key)
+                    yield self.by_key[key]
+
+    def add(
+        self,
+        dist: Distribution,
+        entry: str | None = None,
+        insert: bool = True,
+        replace: bool = False,
+    ) -> None:
+        """Add `dist` to working set, associated with `entry`
+
+        If `entry` is unspecified, it defaults to the ``.location`` of `dist`.
+        On exit from this routine, `entry` is added to the end of the working
+        set's ``.entries`` (if it wasn't already present).
+
+        `dist` is only added to the working set if it's for a project that
+        doesn't already have a distribution in the set, unless `replace=True`.
+        If it's added, any callbacks registered with the ``subscribe()`` method
+        will be called.
+        """
+        if insert:
+            dist.insert_on(self.entries, entry, replace=replace)
+
+        if entry is None:
+            entry = dist.location
+        keys = self.entry_keys.setdefault(entry, [])
+        keys2 = self.entry_keys.setdefault(dist.location, [])
+        if not replace and dist.key in self.by_key:
+            # ignore hidden distros
+            return
+
+        self.by_key[dist.key] = dist
+        normalized_name = packaging.utils.canonicalize_name(dist.key)
+        self.normalized_to_canonical_keys[normalized_name] = dist.key
+        if dist.key not in keys:
+            keys.append(dist.key)
+        if dist.key not in keys2:
+            keys2.append(dist.key)
+        self._added_new(dist)
+
+    @overload
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None,
+        installer: _StrictInstallerType[_DistributionT],
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[_DistributionT]: ...
+    @overload
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None = None,
+        *,
+        installer: _StrictInstallerType[_DistributionT],
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[_DistributionT]: ...
+    @overload
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None = None,
+        installer: _InstallerType | None = None,
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[Distribution]: ...
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None = None,
+        installer: _InstallerType | None | _StrictInstallerType[_DistributionT] = None,
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[Distribution] | list[_DistributionT]:
+        """List all distributions needed to (recursively) meet `requirements`
+
+        `requirements` must be a sequence of ``Requirement`` objects.  `env`,
+        if supplied, should be an ``Environment`` instance.  If
+        not supplied, it defaults to all distributions available within any
+        entry or distribution in the working set.  `installer`, if supplied,
+        will be invoked with each requirement that cannot be met by an
+        already-installed distribution; it should return a ``Distribution`` or
+        ``None``.
+
+        Unless `replace_conflicting=True`, raises a VersionConflict exception
+        if
+        any requirements are found on the path that have the correct name but
+        the wrong version.  Otherwise, if an `installer` is supplied it will be
+        invoked to obtain the correct version of the requirement and activate
+        it.
+
+        `extras` is a list of the extras to be used with these requirements.
+        This is important because extra requirements may look like `my_req;
+        extra = "my_extra"`, which would otherwise be interpreted as a purely
+        optional requirement.  Instead, we want to be able to assert that these
+        requirements are truly required.
+        """
+
+        # set up the stack
+        requirements = list(requirements)[::-1]
+        # set of processed requirements
+        processed = set()
+        # key -> dist
+        best: dict[str, Distribution] = {}
+        to_activate: list[Distribution] = []
+
+        req_extras = _ReqExtras()
+
+        # Mapping of requirement to set of distributions that required it;
+        # useful for reporting info about conflicts.
+        required_by = collections.defaultdict[Requirement, set[str]](set)
+
+        while requirements:
+            # process dependencies breadth-first
+            req = requirements.pop(0)
+            if req in processed:
+                # Ignore cyclic or redundant dependencies
+                continue
+
+            if not req_extras.markers_pass(req, extras):
+                continue
+
+            dist = self._resolve_dist(
+                req, best, replace_conflicting, env, installer, required_by, to_activate
+            )
+
+            # push the new requirements onto the stack
+            new_requirements = dist.requires(req.extras)[::-1]
+            requirements.extend(new_requirements)
+
+            # Register the new requirements needed by req
+            for new_requirement in new_requirements:
+                required_by[new_requirement].add(req.project_name)
+                req_extras[new_requirement] = req.extras
+
+            processed.add(req)
+
+        # return list of distros to activate
+        return to_activate
+
+    def _resolve_dist(
+        self, req, best, replace_conflicting, env, installer, required_by, to_activate
+    ) -> Distribution:
+        dist = best.get(req.key)
+        if dist is None:
+            # Find the best distribution and add it to the map
+            dist = self.by_key.get(req.key)
+            if dist is None or (dist not in req and replace_conflicting):
+                ws = self
+                if env is None:
+                    if dist is None:
+                        env = Environment(self.entries)
+                    else:
+                        # Use an empty environment and workingset to avoid
+                        # any further conflicts with the conflicting
+                        # distribution
+                        env = Environment([])
+                        ws = WorkingSet([])
+                dist = best[req.key] = env.best_match(
+                    req, ws, installer, replace_conflicting=replace_conflicting
+                )
+                if dist is None:
+                    requirers = required_by.get(req, None)
+                    raise DistributionNotFound(req, requirers)
+            to_activate.append(dist)
+        if dist not in req:
+            # Oops, the "best" so far conflicts with a dependency
+            dependent_req = required_by[req]
+            raise VersionConflict(dist, req).with_context(dependent_req)
+        return dist
+
+    @overload
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None,
+        installer: _StrictInstallerType[_DistributionT],
+        fallback: bool = True,
+    ) -> tuple[list[_DistributionT], dict[Distribution, Exception]]: ...
+    @overload
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None = None,
+        *,
+        installer: _StrictInstallerType[_DistributionT],
+        fallback: bool = True,
+    ) -> tuple[list[_DistributionT], dict[Distribution, Exception]]: ...
+    @overload
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None = None,
+        installer: _InstallerType | None = None,
+        fallback: bool = True,
+    ) -> tuple[list[Distribution], dict[Distribution, Exception]]: ...
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None = None,
+        installer: _InstallerType | None | _StrictInstallerType[_DistributionT] = None,
+        fallback: bool = True,
+    ) -> tuple[
+        list[Distribution] | list[_DistributionT],
+        dict[Distribution, Exception],
+    ]:
+        """Find all activatable distributions in `plugin_env`
+
+        Example usage::
+
+            distributions, errors = working_set.find_plugins(
+                Environment(plugin_dirlist)
+            )
+            # add plugins+libs to sys.path
+            map(working_set.add, distributions)
+            # display errors
+            print('Could not load', errors)
+
+        The `plugin_env` should be an ``Environment`` instance that contains
+        only distributions that are in the project's "plugin directory" or
+        directories. The `full_env`, if supplied, should be an ``Environment``
+        contains all currently-available distributions.  If `full_env` is not
+        supplied, one is created automatically from the ``WorkingSet`` this
+        method is called on, which will typically mean that every directory on
+        ``sys.path`` will be scanned for distributions.
+
+        `installer` is a standard installer callback as used by the
+        ``resolve()`` method. The `fallback` flag indicates whether we should
+        attempt to resolve older versions of a plugin if the newest version
+        cannot be resolved.
+
+        This method returns a 2-tuple: (`distributions`, `error_info`), where
+        `distributions` is a list of the distributions found in `plugin_env`
+        that were loadable, along with any other distributions that are needed
+        to resolve their dependencies.  `error_info` is a dictionary mapping
+        unloadable plugin distributions to an exception instance describing the
+        error that occurred. Usually this will be a ``DistributionNotFound`` or
+        ``VersionConflict`` instance.
+        """
+
+        plugin_projects = list(plugin_env)
+        # scan project names in alphabetic order
+        plugin_projects.sort()
+
+        error_info: dict[Distribution, Exception] = {}
+        distributions: dict[Distribution, Exception | None] = {}
+
+        if full_env is None:
+            env = Environment(self.entries)
+            env += plugin_env
+        else:
+            env = full_env + plugin_env
+
+        shadow_set = self.__class__([])
+        # put all our entries in shadow_set
+        list(map(shadow_set.add, self))
+
+        for project_name in plugin_projects:
+            for dist in plugin_env[project_name]:
+                req = [dist.as_requirement()]
+
+                try:
+                    resolvees = shadow_set.resolve(req, env, installer)
+
+                except ResolutionError as v:
+                    # save error info
+                    error_info[dist] = v
+                    if fallback:
+                        # try the next older version of project
+                        continue
+                    else:
+                        # give up on this project, keep going
+                        break
+
+                else:
+                    list(map(shadow_set.add, resolvees))
+                    distributions.update(dict.fromkeys(resolvees))
+
+                    # success, no need to try any more versions of this project
+                    break
+
+        sorted_distributions = list(distributions)
+        sorted_distributions.sort()
+
+        return sorted_distributions, error_info
+
+    def require(self, *requirements: _NestedStr) -> list[Distribution]:
+        """Ensure that distributions matching `requirements` are activated
+
+        `requirements` must be a string or a (possibly-nested) sequence
+        thereof, specifying the distributions and versions required.  The
+        return value is a sequence of the distributions that needed to be
+        activated to fulfill the requirements; all relevant distributions are
+        included, even if they were already activated in this working set.
+        """
+        needed = self.resolve(parse_requirements(requirements))
+
+        for dist in needed:
+            self.add(dist)
+
+        return needed
+
+    def subscribe(
+        self, callback: Callable[[Distribution], object], existing: bool = True
+    ) -> None:
+        """Invoke `callback` for all distributions
+
+        If `existing=True` (default),
+        call on all existing ones, as well.
+        """
+        if callback in self.callbacks:
+            return
+        self.callbacks.append(callback)
+        if not existing:
+            return
+        for dist in self:
+            callback(dist)
+
+    def _added_new(self, dist) -> None:
+        for callback in self.callbacks:
+            callback(dist)
+
+    def __getstate__(
+        self,
+    ) -> tuple[
+        list[str],
+        dict[str | None, list[str]],
+        dict[str, Distribution],
+        dict[str, str],
+        list[Callable[[Distribution], object]],
+    ]:
+        return (
+            self.entries[:],
+            self.entry_keys.copy(),
+            self.by_key.copy(),
+            self.normalized_to_canonical_keys.copy(),
+            self.callbacks[:],
+        )
+
+    def __setstate__(self, e_k_b_n_c) -> None:
+        entries, keys, by_key, normalized_to_canonical_keys, callbacks = e_k_b_n_c
+        self.entries = entries[:]
+        self.entry_keys = keys.copy()
+        self.by_key = by_key.copy()
+        self.normalized_to_canonical_keys = normalized_to_canonical_keys.copy()
+        self.callbacks = callbacks[:]
+
+
+class _ReqExtras(dict["Requirement", tuple[str, ...]]):
+    """
+    Map each requirement to the extras that demanded it.
+    """
+
+    def markers_pass(self, req: Requirement, extras: tuple[str, ...] | None = None):
+        """
+        Evaluate markers for req against each extra that
+        demanded it.
+
+        Return False if the req has a marker and fails
+        evaluation. Otherwise, return True.
+        """
+        return not req.marker or any(
+            req.marker.evaluate({'extra': extra})
+            for extra in self.get(req, ()) + (extras or ("",))
+        )
+
+
+class Environment:
+    """Searchable snapshot of distributions on a search path"""
+
+    def __init__(
+        self,
+        search_path: Iterable[str] | None = None,
+        platform: str | None = get_supported_platform(),
+        python: str | None = PY_MAJOR,
+    ) -> None:
+        """Snapshot distributions available on a search path
+
+        Any distributions found on `search_path` are added to the environment.
+        `search_path` should be a sequence of ``sys.path`` items.  If not
+        supplied, ``sys.path`` is used.
+
+        `platform` is an optional string specifying the name of the platform
+        that platform-specific distributions must be compatible with.  If
+        unspecified, it defaults to the current platform.  `python` is an
+        optional string naming the desired version of Python (e.g. ``'3.6'``);
+        it defaults to the current version.
+
+        You may explicitly set `platform` (and/or `python`) to ``None`` if you
+        wish to map *all* distributions, not just those compatible with the
+        running platform or Python version.
+        """
+        self._distmap: dict[str, list[Distribution]] = {}
+        self.platform = platform
+        self.python = python
+        self.scan(search_path)
+
+    def can_add(self, dist: Distribution) -> bool:
+        """Is distribution `dist` acceptable for this environment?
+
+        The distribution must match the platform and python version
+        requirements specified when this environment was created, or False
+        is returned.
+        """
+        py_compat = (
+            self.python is None
+            or dist.py_version is None
+            or dist.py_version == self.python
+        )
+        return py_compat and compatible_platforms(dist.platform, self.platform)
+
+    def remove(self, dist: Distribution) -> None:
+        """Remove `dist` from the environment"""
+        self._distmap[dist.key].remove(dist)
+
+    def scan(self, search_path: Iterable[str] | None = None) -> None:
+        """Scan `search_path` for distributions usable in this environment
+
+        Any distributions found are added to the environment.
+        `search_path` should be a sequence of ``sys.path`` items.  If not
+        supplied, ``sys.path`` is used.  Only distributions conforming to
+        the platform/python version defined at initialization are added.
+        """
+        if search_path is None:
+            search_path = sys.path
+
+        for item in search_path:
+            for dist in find_distributions(item):
+                self.add(dist)
+
+    def __getitem__(self, project_name: str) -> list[Distribution]:
+        """Return a newest-to-oldest list of distributions for `project_name`
+
+        Uses case-insensitive `project_name` comparison, assuming all the
+        project's distributions use their project's name converted to all
+        lowercase as their key.
+
+        """
+        distribution_key = project_name.lower()
+        return self._distmap.get(distribution_key, [])
+
+    def add(self, dist: Distribution) -> None:
+        """Add `dist` if we ``can_add()`` it and it has not already been added"""
+        if self.can_add(dist) and dist.has_version():
+            dists = self._distmap.setdefault(dist.key, [])
+            if dist not in dists:
+                dists.append(dist)
+                dists.sort(key=operator.attrgetter('hashcmp'), reverse=True)
+
+    @overload
+    def best_match(
+        self,
+        req: Requirement,
+        working_set: WorkingSet,
+        installer: _StrictInstallerType[_DistributionT],
+        replace_conflicting: bool = False,
+    ) -> _DistributionT: ...
+    @overload
+    def best_match(
+        self,
+        req: Requirement,
+        working_set: WorkingSet,
+        installer: _InstallerType | None = None,
+        replace_conflicting: bool = False,
+    ) -> Distribution | None: ...
+    def best_match(
+        self,
+        req: Requirement,
+        working_set: WorkingSet,
+        installer: _InstallerType | None | _StrictInstallerType[_DistributionT] = None,
+        replace_conflicting: bool = False,
+    ) -> Distribution | None:
+        """Find distribution best matching `req` and usable on `working_set`
+
+        This calls the ``find(req)`` method of the `working_set` to see if a
+        suitable distribution is already active.  (This may raise
+        ``VersionConflict`` if an unsuitable version of the project is already
+        active in the specified `working_set`.)  If a suitable distribution
+        isn't active, this method returns the newest distribution in the
+        environment that meets the ``Requirement`` in `req`.  If no suitable
+        distribution is found, and `installer` is supplied, then the result of
+        calling the environment's ``obtain(req, installer)`` method will be
+        returned.
+        """
+        try:
+            dist = working_set.find(req)
+        except VersionConflict:
+            if not replace_conflicting:
+                raise
+            dist = None
+        if dist is not None:
+            return dist
+        for dist in self[req.key]:
+            if dist in req:
+                return dist
+        # try to download/install
+        return self.obtain(req, installer)
+
+    @overload
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: _StrictInstallerType[_DistributionT],
+    ) -> _DistributionT: ...
+    @overload
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: Callable[[Requirement], None] | None = None,
+    ) -> None: ...
+    @overload
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: _InstallerType | None = None,
+    ) -> Distribution | None: ...
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: Callable[[Requirement], None]
+        | _InstallerType
+        | None
+        | _StrictInstallerType[_DistributionT] = None,
+    ) -> Distribution | None:
+        """Obtain a distribution matching `requirement` (e.g. via download)
+
+        Obtain a distro that matches requirement (e.g. via download).  In the
+        base ``Environment`` class, this routine just returns
+        ``installer(requirement)``, unless `installer` is None, in which case
+        None is returned instead.  This method is a hook that allows subclasses
+        to attempt other ways of obtaining a distribution before falling back
+        to the `installer` argument."""
+        return installer(requirement) if installer else None
+
+    def __iter__(self) -> Iterator[str]:
+        """Yield the unique project names of the available distributions"""
+        for key in self._distmap.keys():
+            if self[key]:
+                yield key
+
+    def __iadd__(self, other: Distribution | Environment) -> Self:
+        """In-place addition of a distribution or environment"""
+        if isinstance(other, Distribution):
+            self.add(other)
+        elif isinstance(other, Environment):
+            for project in other:
+                for dist in other[project]:
+                    self.add(dist)
+        else:
+            raise TypeError(f"Can't add {other!r} to environment")
+        return self
+
+    def __add__(self, other: Distribution | Environment) -> Self:
+        """Add an environment or distribution to an environment"""
+        new = self.__class__([], platform=None, python=None)
+        for env in self, other:
+            new += env
+        return new
+
+
+# XXX backward compatibility
+AvailableDistributions = Environment
+
+
+class ExtractionError(RuntimeError):
+    """An error occurred extracting a resource
+
+    The following attributes are available from instances of this exception:
+
+    manager
+        The resource manager that raised this exception
+
+    cache_path
+        The base directory for resource extraction
+
+    original_error
+        The exception instance that caused extraction to fail
+    """
+
+    manager: ResourceManager
+    cache_path: str
+    original_error: BaseException | None
+
+
+class ResourceManager:
+    """Manage resource extraction and packages"""
+
+    extraction_path: str | None = None
+
+    def __init__(self) -> None:
+        # acts like a set
+        self.cached_files: dict[str, Literal[True]] = {}
+
+    def resource_exists(
+        self, package_or_requirement: _PkgReqType, resource_name: str
+    ) -> bool:
+        """Does the named resource exist?"""
+        return get_provider(package_or_requirement).has_resource(resource_name)
+
+    def resource_isdir(
+        self, package_or_requirement: _PkgReqType, resource_name: str
+    ) -> bool:
+        """Is the named resource an existing directory?"""
+        return get_provider(package_or_requirement).resource_isdir(resource_name)
+
+    def resource_filename(
+        self, package_or_requirement: _PkgReqType, resource_name: str
+    ) -> str:
+        """Return a true filesystem path for specified resource"""
+        return get_provider(package_or_requirement).get_resource_filename(
+            self, resource_name
+        )
+
+    def resource_stream(
+        self, package_or_requirement: _PkgReqType, resource_name: str
+    ) -> _ResourceStream:
+        """Return a readable file-like object for specified resource"""
+        return get_provider(package_or_requirement).get_resource_stream(
+            self, resource_name
+        )
+
+    def resource_string(
+        self, package_or_requirement: _PkgReqType, resource_name: str
+    ) -> bytes:
+        """Return specified resource as :obj:`bytes`"""
+        return get_provider(package_or_requirement).get_resource_string(
+            self, resource_name
+        )
+
+    def resource_listdir(
+        self, package_or_requirement: _PkgReqType, resource_name: str
+    ) -> list[str]:
+        """List the contents of the named resource directory"""
+        return get_provider(package_or_requirement).resource_listdir(resource_name)
+
+    def extraction_error(self) -> NoReturn:
+        """Give an error message for problems extracting file(s)"""
+
+        old_exc = sys.exc_info()[1]
+        cache_path = self.extraction_path or get_default_cache()
+
+        tmpl = textwrap.dedent(
+            """
+            Can't extract file(s) to egg cache
+
+            The following error occurred while trying to extract file(s)
+            to the Python egg cache:
+
+              {old_exc}
+
+            The Python egg cache directory is currently set to:
+
+              {cache_path}
+
+            Perhaps your account does not have write access to this directory?
+            You can change the cache directory by setting the PYTHON_EGG_CACHE
+            environment variable to point to an accessible directory.
+            """
+        ).lstrip()
+        err = ExtractionError(tmpl.format(**locals()))
+        err.manager = self
+        err.cache_path = cache_path
+        err.original_error = old_exc
+        raise err
+
+    def get_cache_path(self, archive_name: str, names: Iterable[StrPath] = ()) -> str:
+        """Return absolute location in cache for `archive_name` and `names`
+
+        The parent directory of the resulting path will be created if it does
+        not already exist.  `archive_name` should be the base filename of the
+        enclosing egg (which may not be the name of the enclosing zipfile!),
+        including its ".egg" extension.  `names`, if provided, should be a
+        sequence of path name parts "under" the egg's extraction location.
+
+        This method should only be called by resource providers that need to
+        obtain an extraction location, and only for names they intend to
+        extract, as it tracks the generated names for possible cleanup later.
+        """
+        extract_path = self.extraction_path or get_default_cache()
+        target_path = os.path.join(extract_path, archive_name + '-tmp', *names)
+        try:
+            _bypass_ensure_directory(target_path)
+        except Exception:
+            self.extraction_error()
+
+        self._warn_unsafe_extraction_path(extract_path)
+
+        self.cached_files[target_path] = True
+        return target_path
+
+    @staticmethod
+    def _warn_unsafe_extraction_path(path) -> None:
+        """
+        If the default extraction path is overridden and set to an insecure
+        location, such as /tmp, it opens up an opportunity for an attacker to
+        replace an extracted file with an unauthorized payload. Warn the user
+        if a known insecure location is used.
+
+        See Distribute #375 for more details.
+        """
+        if os.name == 'nt' and not path.startswith(os.environ['windir']):
+            # On Windows, permissions are generally restrictive by default
+            #  and temp directories are not writable by other users, so
+            #  bypass the warning.
+            return
+        mode = os.stat(path).st_mode
+        if mode & stat.S_IWOTH or mode & stat.S_IWGRP:
+            msg = (
+                "Extraction path is writable by group/others "
+                "and vulnerable to attack when "
+                "used with get_resource_filename ({path}). "
+                "Consider a more secure "
+                "location (set with .set_extraction_path or the "
+                "PYTHON_EGG_CACHE environment variable)."
+            ).format(**locals())
+            warnings.warn(msg, UserWarning)
+
+    def postprocess(self, tempname: StrOrBytesPath, filename: StrOrBytesPath) -> None:
+        """Perform any platform-specific postprocessing of `tempname`
+
+        This is where Mac header rewrites should be done; other platforms don't
+        have anything special they should do.
+
+        Resource providers should call this method ONLY after successfully
+        extracting a compressed resource.  They must NOT call it on resources
+        that are already in the filesystem.
+
+        `tempname` is the current (temporary) name of the file, and `filename`
+        is the name it will be renamed to by the caller after this routine
+        returns.
+        """
+
+        if os.name == 'posix':
+            # Make the resource executable
+            mode = ((os.stat(tempname).st_mode) | 0o555) & 0o7777
+            os.chmod(tempname, mode)
+
+    def set_extraction_path(self, path: str) -> None:
+        """Set the base path where resources will be extracted to, if needed.
+
+        If you do not call this routine before any extractions take place, the
+        path defaults to the return value of ``get_default_cache()``.  (Which
+        is based on the ``PYTHON_EGG_CACHE`` environment variable, with various
+        platform-specific fallbacks.  See that routine's documentation for more
+        details.)
+
+        Resources are extracted to subdirectories of this path based upon
+        information given by the ``IResourceProvider``.  You may set this to a
+        temporary directory, but then you must call ``cleanup_resources()`` to
+        delete the extracted files when done.  There is no guarantee that
+        ``cleanup_resources()`` will be able to remove all extracted files.
+
+        (Note: you may not change the extraction path for a given resource
+        manager once resources have been extracted, unless you first call
+        ``cleanup_resources()``.)
+        """
+        if self.cached_files:
+            raise ValueError("Can't change extraction path, files already extracted")
+
+        self.extraction_path = path
+
+    def cleanup_resources(self, force: bool = False) -> list[str]:
+        """
+        Delete all extracted resource files and directories, returning a list
+        of the file and directory names that could not be successfully removed.
+        This function does not have any concurrency protection, so it should
+        generally only be called when the extraction path is a temporary
+        directory exclusive to a single process.  This method is not
+        automatically called; you must call it explicitly or register it as an
+        ``atexit`` function if you wish to ensure cleanup of a temporary
+        directory used for extractions.
+        """
+        # XXX
+        return []
+
+
+def get_default_cache() -> str:
+    """
+    Return the ``PYTHON_EGG_CACHE`` environment variable
+    or a platform-relevant user cache dir for an app
+    named "Python-Eggs".
+    """
+    return os.environ.get('PYTHON_EGG_CACHE') or _user_cache_dir(appname='Python-Eggs')
+
+
+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)
+
+
+def _forgiving_version(version) -> str:
+    """Fallback when ``safe_version`` is not safe enough
+    >>> parse_version(_forgiving_version('0.23ubuntu1'))
+    
+    >>> parse_version(_forgiving_version('0.23-'))
+    
+    >>> parse_version(_forgiving_version('0.-_'))
+    
+    >>> parse_version(_forgiving_version('42.+?1'))
+    
+    >>> parse_version(_forgiving_version('hello world'))
+    
+    """
+    version = version.replace(' ', '.')
+    match = _PEP440_FALLBACK.search(version)
+    if match:
+        safe = match["safe"]
+        rest = version[len(safe) :]
+    else:
+        safe = "0"
+        rest = version
+    local = f"sanitized.{_safe_segment(rest)}".strip(".")
+    return f"{safe}.dev0+{local}"
+
+
+def _safe_segment(segment):
+    """Convert an arbitrary string into a safe segment"""
+    segment = re.sub('[^A-Za-z0-9.]+', '-', segment)
+    segment = re.sub('-[^A-Za-z0-9]+', '-', segment)
+    return re.sub(r'\.[^A-Za-z0-9]+', '.', segment).strip(".-")
+
+
+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 to_filename(name: str) -> str:
+    """Convert a project or version name to its filename-escaped form
+
+    Any '-' characters are currently replaced with '_'.
+    """
+    return name.replace('-', '_')
+
+
+def invalid_marker(text: str) -> SyntaxError | Literal[False]:
+    """
+    Validate text as a PEP 508 environment marker; return an exception
+    if invalid or False otherwise.
+    """
+    try:
+        evaluate_marker(text)
+    except SyntaxError as e:
+        e.filename = None
+        e.lineno = None
+        return e
+    return False
+
+
+def evaluate_marker(text: str, extra: str | None = None) -> bool:
+    """
+    Evaluate a PEP 508 environment marker.
+    Return a boolean indicating the marker result in this environment.
+    Raise SyntaxError if marker is invalid.
+
+    This implementation uses the 'pyparsing' module.
+    """
+    try:
+        marker = packaging.markers.Marker(text)
+        return marker.evaluate()
+    except packaging.markers.InvalidMarker as e:
+        raise SyntaxError(e) from e
+
+
+class NullProvider:
+    """Try to implement resources and metadata for arbitrary PEP 302 loaders"""
+
+    egg_name: str | None = None
+    egg_info: str | None = None
+    loader: LoaderProtocol | None = None
+
+    def __init__(self, module: _ModuleLike) -> None:
+        self.loader = getattr(module, '__loader__', None)
+        self.module_path = os.path.dirname(getattr(module, '__file__', ''))
+
+    def get_resource_filename(
+        self, manager: ResourceManager, resource_name: str
+    ) -> str:
+        return self._fn(self.module_path, resource_name)
+
+    def get_resource_stream(
+        self, manager: ResourceManager, resource_name: str
+    ) -> BinaryIO:
+        return io.BytesIO(self.get_resource_string(manager, resource_name))
+
+    def get_resource_string(
+        self, manager: ResourceManager, resource_name: str
+    ) -> bytes:
+        return self._get(self._fn(self.module_path, resource_name))
+
+    def has_resource(self, resource_name: str) -> bool:
+        return self._has(self._fn(self.module_path, resource_name))
+
+    def _get_metadata_path(self, name):
+        return self._fn(self.egg_info, name)
+
+    def has_metadata(self, name: str) -> bool:
+        if not self.egg_info:
+            return False
+
+        path = self._get_metadata_path(name)
+        return self._has(path)
+
+    def get_metadata(self, name: str) -> str:
+        if not self.egg_info:
+            return ""
+        path = self._get_metadata_path(name)
+        value = self._get(path)
+        try:
+            return value.decode('utf-8')
+        except UnicodeDecodeError as exc:
+            # Include the path in the error message to simplify
+            # troubleshooting, and without changing the exception type.
+            exc.reason += f' in {name} file at path: {path}'
+            raise
+
+    def get_metadata_lines(self, name: str) -> Iterator[str]:
+        return yield_lines(self.get_metadata(name))
+
+    def resource_isdir(self, resource_name: str) -> bool:
+        return self._isdir(self._fn(self.module_path, resource_name))
+
+    def metadata_isdir(self, name: str) -> bool:
+        return bool(self.egg_info and self._isdir(self._fn(self.egg_info, name)))
+
+    def resource_listdir(self, resource_name: str) -> list[str]:
+        return self._listdir(self._fn(self.module_path, resource_name))
+
+    def metadata_listdir(self, name: str) -> list[str]:
+        if self.egg_info:
+            return self._listdir(self._fn(self.egg_info, name))
+        return []
+
+    def run_script(self, script_name: str, namespace: dict[str, Any]) -> None:
+        script = 'scripts/' + script_name
+        if not self.has_metadata(script):
+            raise ResolutionError(
+                "Script {script!r} not found in metadata at {self.egg_info!r}".format(
+                    **locals()
+                ),
+            )
+
+        script_text = self.get_metadata(script).replace('\r\n', '\n')
+        script_text = script_text.replace('\r', '\n')
+        script_filename = self._fn(self.egg_info, script)
+        namespace['__file__'] = script_filename
+        if os.path.exists(script_filename):
+            source = _read_utf8_with_fallback(script_filename)
+            code = compile(source, script_filename, 'exec')
+            exec(code, namespace, namespace)
+        else:
+            from linecache import cache
+
+            cache[script_filename] = (
+                len(script_text),
+                0,
+                script_text.split('\n'),
+                script_filename,
+            )
+            script_code = compile(script_text, script_filename, 'exec')
+            exec(script_code, namespace, namespace)
+
+    def _has(self, path) -> bool:
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _isdir(self, path) -> bool:
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _listdir(self, path) -> list[str]:
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _fn(self, base: str | None, resource_name: str):
+        if base is None:
+            raise TypeError(
+                "`base` parameter in `_fn` is `None`. Either override this method or check the parameter first."
+            )
+        self._validate_resource_path(resource_name)
+        if resource_name:
+            return os.path.join(base, *resource_name.split('/'))
+        return base
+
+    @staticmethod
+    def _validate_resource_path(path) -> None:
+        """
+        Validate the resource paths according to the docs.
+        https://setuptools.pypa.io/en/latest/pkg_resources.html#basic-resource-access
+
+        >>> warned = getfixture('recwarn')
+        >>> warnings.simplefilter('always')
+        >>> vrp = NullProvider._validate_resource_path
+        >>> vrp('foo/bar.txt')
+        >>> bool(warned)
+        False
+        >>> vrp('../foo/bar.txt')
+        >>> bool(warned)
+        True
+        >>> warned.clear()
+        >>> vrp('/foo/bar.txt')
+        >>> bool(warned)
+        True
+        >>> vrp('foo/../../bar.txt')
+        >>> bool(warned)
+        True
+        >>> warned.clear()
+        >>> vrp('foo/f../bar.txt')
+        >>> bool(warned)
+        False
+
+        Windows path separators are straight-up disallowed.
+        >>> vrp(r'\\foo/bar.txt')
+        Traceback (most recent call last):
+        ...
+        ValueError: Use of .. or absolute path in a resource path \
+is not allowed.
+
+        >>> vrp(r'C:\\foo/bar.txt')
+        Traceback (most recent call last):
+        ...
+        ValueError: Use of .. or absolute path in a resource path \
+is not allowed.
+
+        Blank values are allowed
+
+        >>> vrp('')
+        >>> bool(warned)
+        False
+
+        Non-string values are not.
+
+        >>> vrp(None)
+        Traceback (most recent call last):
+        ...
+        AttributeError: ...
+        """
+        invalid = (
+            os.path.pardir in path.split(posixpath.sep)
+            or posixpath.isabs(path)
+            or ntpath.isabs(path)
+            or path.startswith("\\")
+        )
+        if not invalid:
+            return
+
+        msg = "Use of .. or absolute path in a resource path is not allowed."
+
+        # Aggressively disallow Windows absolute paths
+        if (path.startswith("\\") or ntpath.isabs(path)) and not posixpath.isabs(path):
+            raise ValueError(msg)
+
+        # for compatibility, warn; in future
+        # raise ValueError(msg)
+        issue_warning(
+            msg[:-1] + " and will raise exceptions in a future release.",
+            DeprecationWarning,
+        )
+
+    def _get(self, path) -> bytes:
+        if hasattr(self.loader, 'get_data') and self.loader:
+            # Already checked get_data exists
+            return self.loader.get_data(path)  # type: ignore[attr-defined]
+        raise NotImplementedError(
+            "Can't perform this operation for loaders without 'get_data()'"
+        )
+
+
+register_loader_type(object, NullProvider)
+
+
+def _parents(path):
+    """
+    yield all parents of path including path
+    """
+    last = None
+    while path != last:
+        yield path
+        last = path
+        path, _ = os.path.split(path)
+
+
+class EggProvider(NullProvider):
+    """Provider based on a virtual filesystem"""
+
+    def __init__(self, module: _ModuleLike) -> None:
+        super().__init__(module)
+        self._setup_prefix()
+
+    def _setup_prefix(self):
+        # Assume that metadata may be nested inside a "basket"
+        # of multiple eggs and use module_path instead of .archive.
+        eggs = filter(_is_egg_path, _parents(self.module_path))
+        egg = next(eggs, None)
+        egg and self._set_egg(egg)
+
+    def _set_egg(self, path: str) -> None:
+        self.egg_name = os.path.basename(path)
+        self.egg_info = os.path.join(path, 'EGG-INFO')
+        self.egg_root = path
+
+
+class DefaultProvider(EggProvider):
+    """Provides access to package resources in the filesystem"""
+
+    def _has(self, path) -> bool:
+        return os.path.exists(path)
+
+    def _isdir(self, path) -> bool:
+        return os.path.isdir(path)
+
+    def _listdir(self, path):
+        return os.listdir(path)
+
+    def get_resource_stream(
+        self, manager: object, resource_name: str
+    ) -> io.BufferedReader:
+        return open(self._fn(self.module_path, resource_name), 'rb')
+
+    def _get(self, path) -> bytes:
+        with open(path, 'rb') as stream:
+            return stream.read()
+
+    @classmethod
+    def _register(cls) -> None:
+        loader_names = (
+            'SourceFileLoader',
+            'SourcelessFileLoader',
+        )
+        for name in loader_names:
+            loader_cls = getattr(importlib.machinery, name, type(None))
+            register_loader_type(loader_cls, cls)
+
+
+DefaultProvider._register()
+
+
+class EmptyProvider(NullProvider):
+    """Provider that returns nothing for all requests"""
+
+    # A special case, we don't want all Providers inheriting from NullProvider to have a potentially None module_path
+    module_path: str | None = None  # type: ignore[assignment]
+
+    _isdir = _has = lambda self, path: False
+
+    def _get(self, path) -> bytes:
+        return b''
+
+    def _listdir(self, path):
+        return []
+
+    def __init__(self) -> None:
+        pass
+
+
+empty_provider = EmptyProvider()
+
+
+class ZipManifests(dict[str, "MemoizedZipManifests.manifest_mod"]):
+    """
+    zip manifest builder
+    """
+
+    # `path` could be `StrPath | IO[bytes]` but that violates the LSP for `MemoizedZipManifests.load`
+    @classmethod
+    def build(cls, path: str) -> dict[str, zipfile.ZipInfo]:
+        """
+        Build a dictionary similar to the zipimport directory
+        caches, except instead of tuples, store ZipInfo objects.
+
+        Use a platform-specific path separator (os.sep) for the path keys
+        for compatibility with pypy on Windows.
+        """
+        with zipfile.ZipFile(path) as zfile:
+            items = (
+                (
+                    name.replace('/', os.sep),
+                    zfile.getinfo(name),
+                )
+                for name in zfile.namelist()
+            )
+            return dict(items)
+
+    load = build
+
+
+class MemoizedZipManifests(ZipManifests):
+    """
+    Memoized zipfile manifests.
+    """
+
+    class manifest_mod(NamedTuple):
+        manifest: dict[str, zipfile.ZipInfo]
+        mtime: float
+
+    def load(self, path: str) -> dict[str, zipfile.ZipInfo]:  # type: ignore[override] # ZipManifests.load is a classmethod
+        """
+        Load a manifest at path or return a suitable manifest already loaded.
+        """
+        path = os.path.normpath(path)
+        mtime = os.stat(path).st_mtime
+
+        if path not in self or self[path].mtime != mtime:
+            manifest = self.build(path)
+            self[path] = self.manifest_mod(manifest, mtime)
+
+        return self[path].manifest
+
+
+class ZipProvider(EggProvider):
+    """Resource support for zips and eggs"""
+
+    eagers: list[str] | None = None
+    _zip_manifests = MemoizedZipManifests()
+    # ZipProvider's loader should always be a zipimporter or equivalent
+    loader: zipimport.zipimporter
+
+    def __init__(self, module: _ZipLoaderModule) -> None:
+        super().__init__(module)
+        self.zip_pre = self.loader.archive + os.sep
+
+    def _zipinfo_name(self, fspath):
+        # Convert a virtual filename (full path to file) into a zipfile subpath
+        # usable with the zipimport directory cache for our target archive
+        fspath = fspath.rstrip(os.sep)
+        if fspath == self.loader.archive:
+            return ''
+        if fspath.startswith(self.zip_pre):
+            return fspath[len(self.zip_pre) :]
+        raise AssertionError(f"{fspath} is not a subpath of {self.zip_pre}")
+
+    def _parts(self, zip_path):
+        # Convert a zipfile subpath into an egg-relative path part list.
+        # pseudo-fs path
+        fspath = self.zip_pre + zip_path
+        if fspath.startswith(self.egg_root + os.sep):
+            return fspath[len(self.egg_root) + 1 :].split(os.sep)
+        raise AssertionError(f"{fspath} is not a subpath of {self.egg_root}")
+
+    @property
+    def zipinfo(self):
+        return self._zip_manifests.load(self.loader.archive)
+
+    def get_resource_filename(
+        self, manager: ResourceManager, resource_name: str
+    ) -> str:
+        if not self.egg_name:
+            raise NotImplementedError(
+                "resource_filename() only supported for .egg, not .zip"
+            )
+        # no need to lock for extraction, since we use temp names
+        zip_path = self._resource_to_zip(resource_name)
+        eagers = self._get_eager_resources()
+        if '/'.join(self._parts(zip_path)) in eagers:
+            for name in eagers:
+                self._extract_resource(manager, self._eager_to_zip(name))
+        return self._extract_resource(manager, zip_path)
+
+    @staticmethod
+    def _get_date_and_size(zip_stat):
+        size = zip_stat.file_size
+        # ymdhms+wday, yday, dst
+        date_time = zip_stat.date_time + (0, 0, -1)
+        # 1980 offset already done
+        timestamp = time.mktime(date_time)
+        return timestamp, size
+
+    # FIXME: 'ZipProvider._extract_resource' is too complex (12)
+    def _extract_resource(self, manager: ResourceManager, zip_path) -> str:  # noqa: C901
+        if zip_path in self._index():
+            for name in self._index()[zip_path]:
+                last = self._extract_resource(manager, os.path.join(zip_path, name))
+            # return the extracted directory name
+            return os.path.dirname(last)
+
+        timestamp, _size = self._get_date_and_size(self.zipinfo[zip_path])
+
+        if not WRITE_SUPPORT:
+            raise OSError(
+                '"os.rename" and "os.unlink" are not supported on this platform'
+            )
+        try:
+            if not self.egg_name:
+                raise OSError(
+                    '"egg_name" is empty. This likely means no egg could be found from the "module_path".'
+                )
+            real_path = manager.get_cache_path(self.egg_name, self._parts(zip_path))
+
+            if self._is_current(real_path, zip_path):
+                return real_path
+
+            outf, tmpnam = _mkstemp(
+                ".$extract",
+                dir=os.path.dirname(real_path),
+            )
+            os.write(outf, self.loader.get_data(zip_path))
+            os.close(outf)
+            utime(tmpnam, (timestamp, timestamp))
+            manager.postprocess(tmpnam, real_path)
+
+            try:
+                rename(tmpnam, real_path)
+
+            except OSError:
+                if os.path.isfile(real_path):
+                    if self._is_current(real_path, zip_path):
+                        # the file became current since it was checked above,
+                        #  so proceed.
+                        return real_path
+                    # Windows, del old file and retry
+                    elif os.name == 'nt':
+                        unlink(real_path)
+                        rename(tmpnam, real_path)
+                        return real_path
+                raise
+
+        except OSError:
+            # report a user-friendly error
+            manager.extraction_error()
+
+        return real_path
+
+    def _is_current(self, file_path, zip_path):
+        """
+        Return True if the file_path is current for this zip_path
+        """
+        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])
+        if not os.path.isfile(file_path):
+            return False
+        stat = os.stat(file_path)
+        if stat.st_size != size or stat.st_mtime != timestamp:
+            return False
+        # check that the contents match
+        zip_contents = self.loader.get_data(zip_path)
+        with open(file_path, 'rb') as f:
+            file_contents = f.read()
+        return zip_contents == file_contents
+
+    def _get_eager_resources(self):
+        if self.eagers is None:
+            eagers = []
+            for name in ('native_libs.txt', 'eager_resources.txt'):
+                if self.has_metadata(name):
+                    eagers.extend(self.get_metadata_lines(name))
+            self.eagers = eagers
+        return self.eagers
+
+    def _index(self):
+        try:
+            return self._dirindex
+        except AttributeError:
+            ind = {}
+            for path in self.zipinfo:
+                parts = path.split(os.sep)
+                while parts:
+                    parent = os.sep.join(parts[:-1])
+                    if parent in ind:
+                        ind[parent].append(parts[-1])
+                        break
+                    else:
+                        ind[parent] = [parts.pop()]
+            self._dirindex = ind
+            return ind
+
+    def _has(self, fspath) -> bool:
+        zip_path = self._zipinfo_name(fspath)
+        return zip_path in self.zipinfo or zip_path in self._index()
+
+    def _isdir(self, fspath) -> bool:
+        return self._zipinfo_name(fspath) in self._index()
+
+    def _listdir(self, fspath):
+        return list(self._index().get(self._zipinfo_name(fspath), ()))
+
+    def _eager_to_zip(self, resource_name: str):
+        return self._zipinfo_name(self._fn(self.egg_root, resource_name))
+
+    def _resource_to_zip(self, resource_name: str):
+        return self._zipinfo_name(self._fn(self.module_path, resource_name))
+
+
+register_loader_type(zipimport.zipimporter, ZipProvider)
+
+
+class FileMetadata(EmptyProvider):
+    """Metadata handler for standalone PKG-INFO files
+
+    Usage::
+
+        metadata = FileMetadata("/path/to/PKG-INFO")
+
+    This provider rejects all data and metadata requests except for PKG-INFO,
+    which is treated as existing, and will be the contents of the file at
+    the provided location.
+    """
+
+    def __init__(self, path: StrPath) -> None:
+        self.path = path
+
+    def _get_metadata_path(self, name):
+        return self.path
+
+    def has_metadata(self, name: str) -> bool:
+        return name == 'PKG-INFO' and os.path.isfile(self.path)
+
+    def get_metadata(self, name: str) -> str:
+        if name != 'PKG-INFO':
+            raise KeyError("No metadata except PKG-INFO is available")
+
+        with open(self.path, encoding='utf-8', errors="replace") as f:
+            metadata = f.read()
+        self._warn_on_replacement(metadata)
+        return metadata
+
+    def _warn_on_replacement(self, metadata) -> None:
+        replacement_char = '�'
+        if replacement_char in metadata:
+            tmpl = "{self.path} could not be properly decoded in UTF-8"
+            msg = tmpl.format(**locals())
+            warnings.warn(msg)
+
+    def get_metadata_lines(self, name: str) -> Iterator[str]:
+        return yield_lines(self.get_metadata(name))
+
+
+class PathMetadata(DefaultProvider):
+    """Metadata provider for egg directories
+
+    Usage::
+
+        # Development eggs:
+
+        egg_info = "/path/to/PackageName.egg-info"
+        base_dir = os.path.dirname(egg_info)
+        metadata = PathMetadata(base_dir, egg_info)
+        dist_name = os.path.splitext(os.path.basename(egg_info))[0]
+        dist = Distribution(basedir, project_name=dist_name, metadata=metadata)
+
+        # Unpacked egg directories:
+
+        egg_path = "/path/to/PackageName-ver-pyver-etc.egg"
+        metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO'))
+        dist = Distribution.from_filename(egg_path, metadata=metadata)
+    """
+
+    def __init__(self, path: str, egg_info: str) -> None:
+        self.module_path = path
+        self.egg_info = egg_info
+
+
+class EggMetadata(ZipProvider):
+    """Metadata provider for .egg files"""
+
+    def __init__(self, importer: zipimport.zipimporter) -> None:
+        """Create a metadata provider from a zipimporter"""
+
+        self.zip_pre = importer.archive + os.sep
+        self.loader = importer
+        if importer.prefix:
+            self.module_path = os.path.join(importer.archive, importer.prefix)
+        else:
+            self.module_path = importer.archive
+        self._setup_prefix()
+
+
+_distribution_finders: dict[type, _DistFinderType[Any]] = _declare_state(
+    'dict', '_distribution_finders', {}
+)
+
+
+def register_finder(
+    importer_type: type[_T], distribution_finder: _DistFinderType[_T]
+) -> None:
+    """Register `distribution_finder` to find distributions in sys.path items
+
+    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
+    handler), and `distribution_finder` is a callable that, passed a path
+    item and the importer instance, yields ``Distribution`` instances found on
+    that path item.  See ``pkg_resources.find_on_path`` for an example."""
+    _distribution_finders[importer_type] = distribution_finder
+
+
+def find_distributions(path_item: str, only: bool = False) -> Iterable[Distribution]:
+    """Yield distributions accessible via `path_item`"""
+    importer = get_importer(path_item)
+    finder = _find_adapter(_distribution_finders, importer)
+    return finder(importer, path_item, only)
+
+
+def find_eggs_in_zip(
+    importer: zipimport.zipimporter, path_item: str, only: bool = False
+) -> Iterator[Distribution]:
+    """
+    Find eggs in zip files; possibly multiple nested eggs.
+    """
+    if importer.archive.endswith('.whl'):
+        # wheels are not supported with this finder
+        # they don't have PKG-INFO metadata, and won't ever contain eggs
+        return
+    metadata = EggMetadata(importer)
+    if metadata.has_metadata('PKG-INFO'):
+        yield Distribution.from_filename(path_item, metadata=metadata)
+    if only:
+        # don't yield nested distros
+        return
+    for subitem in metadata.resource_listdir(''):
+        if _is_egg_path(subitem):
+            subpath = os.path.join(path_item, subitem)
+            dists = find_eggs_in_zip(zipimport.zipimporter(subpath), subpath)
+            yield from dists
+        elif subitem.lower().endswith(('.dist-info', '.egg-info')):
+            subpath = os.path.join(path_item, subitem)
+            submeta = EggMetadata(zipimport.zipimporter(subpath))
+            submeta.egg_info = subpath
+            yield Distribution.from_location(path_item, subitem, submeta)
+
+
+register_finder(zipimport.zipimporter, find_eggs_in_zip)
+
+
+def find_nothing(
+    importer: object | None, path_item: str | None, only: bool | None = False
+):
+    return ()
+
+
+register_finder(object, find_nothing)
+
+
+def find_on_path(importer: object | None, path_item, only=False):
+    """Yield distributions accessible on a sys.path directory"""
+    path_item = _normalize_cached(path_item)
+
+    if _is_unpacked_egg(path_item):
+        yield Distribution.from_filename(
+            path_item,
+            metadata=PathMetadata(path_item, os.path.join(path_item, 'EGG-INFO')),
+        )
+        return
+
+    entries = (os.path.join(path_item, child) for child in safe_listdir(path_item))
+
+    # scan for .egg and .egg-info in directory
+    for entry in sorted(entries):
+        fullpath = os.path.join(path_item, entry)
+        factory = dist_factory(path_item, entry, only)
+        yield from factory(fullpath)
+
+
+def dist_factory(path_item, entry, only):
+    """Return a dist_factory for the given entry."""
+    lower = entry.lower()
+    is_egg_info = lower.endswith('.egg-info')
+    is_dist_info = lower.endswith('.dist-info') and os.path.isdir(
+        os.path.join(path_item, entry)
+    )
+    is_meta = is_egg_info or is_dist_info
+    return (
+        distributions_from_metadata
+        if is_meta
+        else find_distributions
+        if not only and _is_egg_path(entry)
+        else resolve_egg_link
+        if not only and lower.endswith('.egg-link')
+        else NoDists()
+    )
+
+
+class NoDists:
+    """
+    >>> bool(NoDists())
+    False
+
+    >>> list(NoDists()('anything'))
+    []
+    """
+
+    def __bool__(self) -> Literal[False]:
+        return False
+
+    def __call__(self, fullpath: object):
+        return iter(())
+
+
+def safe_listdir(path: StrOrBytesPath):
+    """
+    Attempt to list contents of path, but suppress some exceptions.
+    """
+    try:
+        return os.listdir(path)
+    except (PermissionError, NotADirectoryError):
+        pass
+    except OSError as e:
+        # Ignore the directory if does not exist, not a directory or
+        # permission denied
+        if e.errno not in (errno.ENOTDIR, errno.EACCES, errno.ENOENT):
+            raise
+    return ()
+
+
+def distributions_from_metadata(path: str):
+    root = os.path.dirname(path)
+    if os.path.isdir(path):
+        if len(os.listdir(path)) == 0:
+            # empty metadata dir; skip
+            return
+        metadata: _MetadataType = PathMetadata(root, path)
+    else:
+        metadata = FileMetadata(path)
+    entry = os.path.basename(path)
+    yield Distribution.from_location(
+        root,
+        entry,
+        metadata,
+        precedence=DEVELOP_DIST,
+    )
+
+
+def non_empty_lines(path):
+    """
+    Yield non-empty lines from file at path
+    """
+    for line in _read_utf8_with_fallback(path).splitlines():
+        line = line.strip()
+        if line:
+            yield line
+
+
+def resolve_egg_link(path):
+    """
+    Given a path to an .egg-link, resolve distributions
+    present in the referenced path.
+    """
+    referenced_paths = non_empty_lines(path)
+    resolved_paths = (
+        os.path.join(os.path.dirname(path), ref) for ref in referenced_paths
+    )
+    dist_groups = map(find_distributions, resolved_paths)
+    return next(dist_groups, ())
+
+
+if hasattr(pkgutil, 'ImpImporter'):
+    register_finder(pkgutil.ImpImporter, find_on_path)
+
+register_finder(importlib.machinery.FileFinder, find_on_path)
+
+_namespace_handlers: dict[type, _NSHandlerType[Any]] = _declare_state(
+    'dict', '_namespace_handlers', {}
+)
+_namespace_packages: dict[str | None, list[str]] = _declare_state(
+    'dict', '_namespace_packages', {}
+)
+
+
+def register_namespace_handler(
+    importer_type: type[_T], namespace_handler: _NSHandlerType[_T]
+) -> None:
+    """Register `namespace_handler` to declare namespace packages
+
+    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
+    handler), and `namespace_handler` is a callable like this::
+
+        def namespace_handler(importer, path_entry, moduleName, module):
+            # return a path_entry to use for child packages
+
+    Namespace handlers are only called if the importer object has already
+    agreed that it can handle the relevant path item, and they should only
+    return a subpath if the module __path__ does not already contain an
+    equivalent subpath.  For an example namespace handler, see
+    ``pkg_resources.file_ns_handler``.
+    """
+    _namespace_handlers[importer_type] = namespace_handler
+
+
+def _handle_ns(packageName, path_item):
+    """Ensure that named package includes a subpath of path_item (if needed)"""
+
+    importer = get_importer(path_item)
+    if importer is None:
+        return None
+
+    # use find_spec (PEP 451) and fall-back to find_module (PEP 302)
+    try:
+        spec = importer.find_spec(packageName)
+    except AttributeError:
+        # capture warnings due to #1111
+        with warnings.catch_warnings():
+            warnings.simplefilter("ignore")
+            loader = importer.find_module(packageName)
+    else:
+        loader = spec.loader if spec else None
+
+    if loader is None:
+        return None
+    module = sys.modules.get(packageName)
+    if module is None:
+        module = sys.modules[packageName] = types.ModuleType(packageName)
+        module.__path__ = []
+        _set_parent_ns(packageName)
+    elif not hasattr(module, '__path__'):
+        raise TypeError("Not a package:", packageName)
+    handler = _find_adapter(_namespace_handlers, importer)
+    subpath = handler(importer, path_item, packageName, module)
+    if subpath is not None:
+        path = module.__path__
+        path.append(subpath)
+        importlib.import_module(packageName)
+        _rebuild_mod_path(path, packageName, module)
+    return subpath
+
+
+def _rebuild_mod_path(orig_path, package_name, module: types.ModuleType) -> None:
+    """
+    Rebuild module.__path__ ensuring that all entries are ordered
+    corresponding to their sys.path order
+    """
+    sys_path = [_normalize_cached(p) for p in sys.path]
+
+    def safe_sys_path_index(entry):
+        """
+        Workaround for #520 and #513.
+        """
+        try:
+            return sys_path.index(entry)
+        except ValueError:
+            return float('inf')
+
+    def position_in_sys_path(path):
+        """
+        Return the ordinal of the path based on its position in sys.path
+        """
+        path_parts = path.split(os.sep)
+        module_parts = package_name.count('.') + 1
+        parts = path_parts[:-module_parts]
+        return safe_sys_path_index(_normalize_cached(os.sep.join(parts)))
+
+    new_path = sorted(orig_path, key=position_in_sys_path)
+    new_path = [_normalize_cached(p) for p in new_path]
+
+    if isinstance(module.__path__, list):
+        module.__path__[:] = new_path
+    else:
+        module.__path__ = new_path
+
+
+def declare_namespace(packageName: str) -> None:
+    """Declare that package 'packageName' is a namespace package"""
+
+    msg = (
+        f"Deprecated call to `pkg_resources.declare_namespace({packageName!r})`.\n"
+        "Implementing implicit namespace packages (as specified in PEP 420) "
+        "is preferred to `pkg_resources.declare_namespace`. "
+        "See https://setuptools.pypa.io/en/latest/references/"
+        "keywords.html#keyword-namespace-packages"
+    )
+    warnings.warn(msg, DeprecationWarning, stacklevel=2)
+
+    _imp.acquire_lock()
+    try:
+        if packageName in _namespace_packages:
+            return
+
+        path: MutableSequence[str] = sys.path
+        parent, _, _ = packageName.rpartition('.')
+
+        if parent:
+            declare_namespace(parent)
+            if parent not in _namespace_packages:
+                __import__(parent)
+            try:
+                path = sys.modules[parent].__path__
+            except AttributeError as e:
+                raise TypeError("Not a package:", parent) from e
+
+        # Track what packages are namespaces, so when new path items are added,
+        # they can be updated
+        _namespace_packages.setdefault(parent or None, []).append(packageName)
+        _namespace_packages.setdefault(packageName, [])
+
+        for path_item in path:
+            # Ensure all the parent's path items are reflected in the child,
+            # if they apply
+            _handle_ns(packageName, path_item)
+
+    finally:
+        _imp.release_lock()
+
+
+def fixup_namespace_packages(path_item: str, parent: str | None = None) -> None:
+    """Ensure that previously-declared namespace packages include path_item"""
+    _imp.acquire_lock()
+    try:
+        for package in _namespace_packages.get(parent, ()):
+            subpath = _handle_ns(package, path_item)
+            if subpath:
+                fixup_namespace_packages(subpath, package)
+    finally:
+        _imp.release_lock()
+
+
+def file_ns_handler(
+    importer: object,
+    path_item: StrPath,
+    packageName: str,
+    module: types.ModuleType,
+):
+    """Compute an ns-package subpath for a filesystem or zipfile importer"""
+
+    subpath = os.path.join(path_item, packageName.split('.')[-1])
+    normalized = _normalize_cached(subpath)
+    for item in module.__path__:
+        if _normalize_cached(item) == normalized:
+            break
+    else:
+        # Only return the path if it's not already there
+        return subpath
+
+
+if hasattr(pkgutil, 'ImpImporter'):
+    register_namespace_handler(pkgutil.ImpImporter, file_ns_handler)
+
+register_namespace_handler(zipimport.zipimporter, file_ns_handler)
+register_namespace_handler(importlib.machinery.FileFinder, file_ns_handler)
+
+
+def null_ns_handler(
+    importer: object,
+    path_item: str | None,
+    packageName: str | None,
+    module: _ModuleLike | None,
+) -> None:
+    return None
+
+
+register_namespace_handler(object, null_ns_handler)
+
+
+@overload
+def normalize_path(filename: StrPath) -> str: ...
+@overload
+def normalize_path(filename: BytesPath) -> bytes: ...
+def normalize_path(filename: StrOrBytesPath) -> str | bytes:
+    """Normalize a file/dir name for comparison purposes"""
+    return os.path.normcase(os.path.realpath(os.path.normpath(_cygwin_patch(filename))))
+
+
+def _cygwin_patch(filename: StrOrBytesPath):  # pragma: nocover
+    """
+    Contrary to POSIX 2008, on Cygwin, getcwd (3) contains
+    symlink components. Using
+    os.path.abspath() works around this limitation. A fix in os.getcwd()
+    would probably better, in Cygwin even more so, except
+    that this seems to be by design...
+    """
+    return os.path.abspath(filename) if sys.platform == 'cygwin' else filename
+
+
+if TYPE_CHECKING:
+    # https://github.com/python/mypy/issues/16261
+    # https://github.com/python/typeshed/issues/6347
+    @overload
+    def _normalize_cached(filename: StrPath) -> str: ...
+    @overload
+    def _normalize_cached(filename: BytesPath) -> bytes: ...
+    def _normalize_cached(filename: StrOrBytesPath) -> str | bytes: ...
+
+else:
+
+    @functools.cache
+    def _normalize_cached(filename):
+        return normalize_path(filename)
+
+
+def _is_egg_path(path):
+    """
+    Determine if given path appears to be an egg.
+    """
+    return _is_zip_egg(path) or _is_unpacked_egg(path)
+
+
+def _is_zip_egg(path):
+    return (
+        path.lower().endswith('.egg')
+        and os.path.isfile(path)
+        and zipfile.is_zipfile(path)
+    )
+
+
+def _is_unpacked_egg(path):
+    """
+    Determine if given path appears to be an unpacked egg.
+    """
+    return path.lower().endswith('.egg') and os.path.isfile(
+        os.path.join(path, 'EGG-INFO', 'PKG-INFO')
+    )
+
+
+def _set_parent_ns(packageName) -> None:
+    parts = packageName.split('.')
+    name = parts.pop()
+    if parts:
+        parent = '.'.join(parts)
+        setattr(sys.modules[parent], name, sys.modules[packageName])
+
+
+MODULE = re.compile(r"\w+(\.\w+)*$").match
+EGG_NAME = re.compile(
+    r"""
+    (?P[^-]+) (
+        -(?P[^-]+) (
+            -py(?P[^-]+) (
+                -(?P.+)
+            )?
+        )?
+    )?
+    """,
+    re.VERBOSE | re.IGNORECASE,
+).match
+
+
+class EntryPoint:
+    """Object representing an advertised importable object"""
+
+    def __init__(
+        self,
+        name: str,
+        module_name: str,
+        attrs: Iterable[str] = (),
+        extras: Iterable[str] = (),
+        dist: Distribution | None = None,
+    ) -> None:
+        if not MODULE(module_name):
+            raise ValueError("Invalid module name", module_name)
+        self.name = name
+        self.module_name = module_name
+        self.attrs = tuple(attrs)
+        self.extras = tuple(extras)
+        self.dist = dist
+
+    def __str__(self) -> str:
+        s = f"{self.name} = {self.module_name}"
+        if self.attrs:
+            s += ':' + '.'.join(self.attrs)
+        if self.extras:
+            extras = ','.join(self.extras)
+            s += f' [{extras}]'
+        return s
+
+    def __repr__(self) -> str:
+        return f"EntryPoint.parse({str(self)!r})"
+
+    @overload
+    def load(
+        self,
+        require: Literal[True] = True,
+        env: Environment | None = None,
+        installer: _InstallerType | None = None,
+    ) -> _ResolvedEntryPoint: ...
+    @overload
+    def load(
+        self,
+        require: Literal[False],
+        *args: Any,
+        **kwargs: Any,
+    ) -> _ResolvedEntryPoint: ...
+    def load(
+        self,
+        require: bool = True,
+        *args: Environment | _InstallerType | None,
+        **kwargs: Environment | _InstallerType | None,
+    ) -> _ResolvedEntryPoint:
+        """
+        Require packages for this EntryPoint, then resolve it.
+        """
+        if not require or args or kwargs:
+            warnings.warn(
+                "Parameters to load are deprecated.  Call .resolve and "
+                ".require separately.",
+                PkgResourcesDeprecationWarning,
+                stacklevel=2,
+            )
+        if require:
+            # We could pass `env` and `installer` directly,
+            # but keeping `*args` and `**kwargs` for backwards compatibility
+            self.require(*args, **kwargs)  # type: ignore[arg-type]
+        return self.resolve()
+
+    def resolve(self) -> _ResolvedEntryPoint:
+        """
+        Resolve the entry point from its module and attrs.
+        """
+        module = __import__(self.module_name, fromlist=['__name__'], level=0)
+        try:
+            return functools.reduce(getattr, self.attrs, module)
+        except AttributeError as exc:
+            raise ImportError(str(exc)) from exc
+
+    def require(
+        self,
+        env: Environment | None = None,
+        installer: _InstallerType | None = None,
+    ) -> None:
+        if not self.dist:
+            error_cls = UnknownExtra if self.extras else AttributeError
+            raise error_cls("Can't require() without a distribution", self)
+
+        # Get the requirements for this entry point with all its extras and
+        # then resolve them. We have to pass `extras` along when resolving so
+        # that the working set knows what extras we want. Otherwise, for
+        # dist-info distributions, the working set will assume that the
+        # requirements for that extra are purely optional and skip over them.
+        reqs = self.dist.requires(self.extras)
+        items = working_set.resolve(reqs, env, installer, extras=self.extras)
+        list(map(working_set.add, items))
+
+    pattern = re.compile(
+        r'\s*'
+        r'(?P.+?)\s*'
+        r'=\s*'
+        r'(?P[\w.]+)\s*'
+        r'(:\s*(?P[\w.]+))?\s*'
+        r'(?P\[.*\])?\s*$'
+    )
+
+    @classmethod
+    def parse(cls, src: str, dist: Distribution | None = None) -> Self:
+        """Parse a single entry point from string `src`
+
+        Entry point syntax follows the form::
+
+            name = some.module:some.attr [extra1, extra2]
+
+        The entry name and module name are required, but the ``:attrs`` and
+        ``[extras]`` parts are optional
+        """
+        m = cls.pattern.match(src)
+        if not m:
+            msg = "EntryPoint must be in 'name=module:attrs [extras]' format"
+            raise ValueError(msg, src)
+        res = m.groupdict()
+        extras = cls._parse_extras(res['extras'])
+        attrs = res['attr'].split('.') if res['attr'] else ()
+        return cls(res['name'], res['module'], attrs, extras, dist)
+
+    @classmethod
+    def _parse_extras(cls, extras_spec):
+        if not extras_spec:
+            return ()
+        req = Requirement.parse('x' + extras_spec)
+        if req.specs:
+            raise ValueError
+        return req.extras
+
+    @classmethod
+    def parse_group(
+        cls,
+        group: str,
+        lines: _NestedStr,
+        dist: Distribution | None = None,
+    ) -> dict[str, Self]:
+        """Parse an entry point group"""
+        if not MODULE(group):
+            raise ValueError("Invalid group name", group)
+        this: dict[str, Self] = {}
+        for line in yield_lines(lines):
+            ep = cls.parse(line, dist)
+            if ep.name in this:
+                raise ValueError("Duplicate entry point", group, ep.name)
+            this[ep.name] = ep
+        return this
+
+    @classmethod
+    def parse_map(
+        cls,
+        data: str | Iterable[str] | dict[str, str | Iterable[str]],
+        dist: Distribution | None = None,
+    ) -> dict[str, dict[str, Self]]:
+        """Parse a map of entry point groups"""
+        _data: Iterable[tuple[str | None, str | Iterable[str]]]
+        if isinstance(data, dict):
+            _data = data.items()
+        else:
+            _data = split_sections(data)
+        maps: dict[str, dict[str, Self]] = {}
+        for group, lines in _data:
+            if group is None:
+                if not lines:
+                    continue
+                raise ValueError("Entry points must be listed in groups")
+            group = group.strip()
+            if group in maps:
+                raise ValueError("Duplicate group name", group)
+            maps[group] = cls.parse_group(group, lines, dist)
+        return maps
+
+
+def _version_from_file(lines):
+    """
+    Given an iterable of lines from a Metadata file, return
+    the value of the Version field, if present, or None otherwise.
+    """
+
+    def is_version_line(line):
+        return line.lower().startswith('version:')
+
+    version_lines = filter(is_version_line, lines)
+    line = next(iter(version_lines), '')
+    _, _, value = line.partition(':')
+    return safe_version(value.strip()) or None
+
+
+class Distribution:
+    """Wrap an actual or potential sys.path entry w/metadata"""
+
+    PKG_INFO = 'PKG-INFO'
+
+    def __init__(
+        self,
+        location: str | None = None,
+        metadata: _MetadataType = None,
+        project_name: str | None = None,
+        version: str | None = None,
+        py_version: str | None = PY_MAJOR,
+        platform: str | None = None,
+        precedence: int = EGG_DIST,
+    ) -> None:
+        self.project_name = safe_name(project_name or 'Unknown')
+        if version is not None:
+            self._version = safe_version(version)
+        self.py_version = py_version
+        self.platform = platform
+        self.location = location
+        self.precedence = precedence
+        self._provider = metadata or empty_provider
+
+    @classmethod
+    def from_location(
+        cls,
+        location: str,
+        basename: StrPath,
+        metadata: _MetadataType = None,
+        **kw: int,  # We could set `precedence` explicitly, but keeping this as `**kw` for full backwards and subclassing compatibility
+    ) -> Distribution:
+        project_name, version, py_version, platform = [None] * 4
+        basename, ext = os.path.splitext(basename)
+        if ext.lower() in _distributionImpl:
+            cls = _distributionImpl[ext.lower()]
+
+            match = EGG_NAME(basename)
+            if match:
+                project_name, version, py_version, platform = match.group(
+                    'name', 'ver', 'pyver', 'plat'
+                )
+        return cls(
+            location,
+            metadata,
+            project_name=project_name,
+            version=version,
+            py_version=py_version,
+            platform=platform,
+            **kw,
+        )._reload_version()
+
+    def _reload_version(self):
+        return self
+
+    @property
+    def hashcmp(self):
+        return (
+            self._forgiving_parsed_version,
+            self.precedence,
+            self.key,
+            self.location,
+            self.py_version or '',
+            self.platform or '',
+        )
+
+    def __hash__(self) -> int:
+        return hash(self.hashcmp)
+
+    def __lt__(self, other: Distribution) -> bool:
+        return self.hashcmp < other.hashcmp
+
+    def __le__(self, other: Distribution) -> bool:
+        return self.hashcmp <= other.hashcmp
+
+    def __gt__(self, other: Distribution) -> bool:
+        return self.hashcmp > other.hashcmp
+
+    def __ge__(self, other: Distribution) -> bool:
+        return self.hashcmp >= other.hashcmp
+
+    def __eq__(self, other: object) -> bool:
+        if not isinstance(other, self.__class__):
+            # It's not a Distribution, so they are not equal
+            return False
+        return self.hashcmp == other.hashcmp
+
+    def __ne__(self, other: object) -> bool:
+        return not self == other
+
+    # These properties have to be lazy so that we don't have to load any
+    # metadata until/unless it's actually needed.  (i.e., some distributions
+    # may not know their name or version without loading PKG-INFO)
+
+    @property
+    def key(self):
+        try:
+            return self._key
+        except AttributeError:
+            self._key = key = self.project_name.lower()
+            return key
+
+    @property
+    def parsed_version(self):
+        if not hasattr(self, "_parsed_version"):
+            try:
+                self._parsed_version = parse_version(self.version)
+            except packaging.version.InvalidVersion as ex:
+                info = f"(package: {self.project_name})"
+                if hasattr(ex, "add_note"):
+                    ex.add_note(info)  # PEP 678
+                    raise
+                raise packaging.version.InvalidVersion(f"{str(ex)} {info}") from None
+
+        return self._parsed_version
+
+    @property
+    def _forgiving_parsed_version(self):
+        try:
+            return self.parsed_version
+        except packaging.version.InvalidVersion as ex:
+            self._parsed_version = parse_version(_forgiving_version(self.version))
+
+            notes = "\n".join(getattr(ex, "__notes__", []))  # PEP 678
+            msg = f"""!!\n\n
+            *************************************************************************
+            {str(ex)}\n{notes}
+
+            This is a long overdue deprecation.
+            For the time being, `pkg_resources` will use `{self._parsed_version}`
+            as a replacement to avoid breaking existing environments,
+            but no future compatibility is guaranteed.
+
+            If you maintain package {self.project_name} you should implement
+            the relevant changes to adequate the project to PEP 440 immediately.
+            *************************************************************************
+            \n\n!!
+            """
+            warnings.warn(msg, DeprecationWarning)
+
+            return self._parsed_version
+
+    @property
+    def version(self):
+        try:
+            return self._version
+        except AttributeError as e:
+            version = self._get_version()
+            if version is None:
+                path = self._get_metadata_path_for_display(self.PKG_INFO)
+                msg = f"Missing 'Version:' header and/or {self.PKG_INFO} file at path: {path}"
+                raise ValueError(msg, self) from e
+
+            return version
+
+    @property
+    def _dep_map(self):
+        """
+        A map of extra to its list of (direct) requirements
+        for this distribution, including the null extra.
+        """
+        try:
+            return self.__dep_map
+        except AttributeError:
+            self.__dep_map = self._filter_extras(self._build_dep_map())
+        return self.__dep_map
+
+    @staticmethod
+    def _filter_extras(
+        dm: dict[str | None, list[Requirement]],
+    ) -> dict[str | None, list[Requirement]]:
+        """
+        Given a mapping of extras to dependencies, strip off
+        environment markers and filter out any dependencies
+        not matching the markers.
+        """
+        for extra in list(filter(None, dm)):
+            new_extra: str | None = extra
+            reqs = dm.pop(extra)
+            new_extra, _, marker = extra.partition(':')
+            fails_marker = marker and (
+                invalid_marker(marker) or not evaluate_marker(marker)
+            )
+            if fails_marker:
+                reqs = []
+            new_extra = safe_extra(new_extra) or None
+
+            dm.setdefault(new_extra, []).extend(reqs)
+        return dm
+
+    def _build_dep_map(self):
+        dm = {}
+        for name in 'requires.txt', 'depends.txt':
+            for extra, reqs in split_sections(self._get_metadata(name)):
+                dm.setdefault(extra, []).extend(parse_requirements(reqs))
+        return dm
+
+    def requires(self, extras: Iterable[str] = ()) -> list[Requirement]:
+        """List of Requirements needed for this distro if `extras` are used"""
+        dm = self._dep_map
+        deps: list[Requirement] = []
+        deps.extend(dm.get(None, ()))
+        for ext in extras:
+            try:
+                deps.extend(dm[safe_extra(ext)])
+            except KeyError as e:
+                raise UnknownExtra(f"{self} has no such extra feature {ext!r}") from e
+        return deps
+
+    def _get_metadata_path_for_display(self, name):
+        """
+        Return the path to the given metadata file, if available.
+        """
+        try:
+            # We need to access _get_metadata_path() on the provider object
+            # directly rather than through this class's __getattr__()
+            # since _get_metadata_path() is marked private.
+            path = self._provider._get_metadata_path(name)
+
+        # Handle exceptions e.g. in case the distribution's metadata
+        # provider doesn't support _get_metadata_path().
+        except Exception:
+            return '[could not detect]'
+
+        return path
+
+    def _get_metadata(self, name):
+        if self.has_metadata(name):
+            yield from self.get_metadata_lines(name)
+
+    def _get_version(self):
+        lines = self._get_metadata(self.PKG_INFO)
+        return _version_from_file(lines)
+
+    def activate(self, path: list[str] | None = None, replace: bool = False) -> None:
+        """Ensure distribution is importable on `path` (default=sys.path)"""
+        if path is None:
+            path = sys.path
+        self.insert_on(path, replace=replace)
+        if path is sys.path and self.location is not None:
+            fixup_namespace_packages(self.location)
+            for pkg in self._get_metadata('namespace_packages.txt'):
+                if pkg in sys.modules:
+                    declare_namespace(pkg)
+
+    def egg_name(self):
+        """Return what this distribution's standard .egg filename should be"""
+        filename = f"{to_filename(self.project_name)}-{to_filename(self.version)}-py{self.py_version or PY_MAJOR}"
+
+        if self.platform:
+            filename += '-' + self.platform
+        return filename
+
+    def __repr__(self) -> str:
+        if self.location:
+            return f"{self} ({self.location})"
+        else:
+            return str(self)
+
+    def __str__(self) -> str:
+        try:
+            version = getattr(self, 'version', None)
+        except ValueError:
+            version = None
+        version = version or "[unknown version]"
+        return f"{self.project_name} {version}"
+
+    def __getattr__(self, attr: str):
+        """Delegate all unrecognized public attributes to .metadata provider"""
+        if attr.startswith('_'):
+            raise AttributeError(attr)
+        return getattr(self._provider, attr)
+
+    def __dir__(self):
+        return list(
+            set(super().__dir__())
+            | set(attr for attr in self._provider.__dir__() if not attr.startswith('_'))
+        )
+
+    @classmethod
+    def from_filename(
+        cls,
+        filename: StrPath,
+        metadata: _MetadataType = None,
+        **kw: int,  # We could set `precedence` explicitly, but keeping this as `**kw` for full backwards and subclassing compatibility
+    ) -> Distribution:
+        return cls.from_location(
+            _normalize_cached(filename), os.path.basename(filename), metadata, **kw
+        )
+
+    def as_requirement(self):
+        """Return a ``Requirement`` that matches this distribution exactly"""
+        if isinstance(self.parsed_version, packaging.version.Version):
+            spec = f"{self.project_name}=={self.parsed_version}"
+        else:
+            spec = f"{self.project_name}==={self.parsed_version}"
+
+        return Requirement.parse(spec)
+
+    def load_entry_point(self, group: str, name: str) -> _ResolvedEntryPoint:
+        """Return the `name` entry point of `group` or raise ImportError"""
+        ep = self.get_entry_info(group, name)
+        if ep is None:
+            raise ImportError(f"Entry point {(group, name)!r} not found")
+        return ep.load()
+
+    @overload
+    def get_entry_map(self, group: None = None) -> dict[str, dict[str, EntryPoint]]: ...
+    @overload
+    def get_entry_map(self, group: str) -> dict[str, EntryPoint]: ...
+    def get_entry_map(self, group: str | None = None):
+        """Return the entry point map for `group`, or the full entry map"""
+        if not hasattr(self, "_ep_map"):
+            self._ep_map = EntryPoint.parse_map(
+                self._get_metadata('entry_points.txt'), self
+            )
+        if group is not None:
+            return self._ep_map.get(group, {})
+        return self._ep_map
+
+    def get_entry_info(self, group: str, name: str) -> EntryPoint | None:
+        """Return the EntryPoint object for `group`+`name`, or ``None``"""
+        return self.get_entry_map(group).get(name)
+
+    # FIXME: 'Distribution.insert_on' is too complex (13)
+    def insert_on(  # noqa: C901
+        self,
+        path: list[str],
+        loc=None,
+        replace: bool = False,
+    ) -> None:
+        """Ensure self.location is on path
+
+        If replace=False (default):
+            - If location is already in path anywhere, do nothing.
+            - Else:
+              - If it's an egg and its parent directory is on path,
+                insert just ahead of the parent.
+              - Else: add to the end of path.
+        If replace=True:
+            - If location is already on path anywhere (not eggs)
+              or higher priority than its parent (eggs)
+              do nothing.
+            - Else:
+              - If it's an egg and its parent directory is on path,
+                insert just ahead of the parent,
+                removing any lower-priority entries.
+              - Else: add it to the front of path.
+        """
+
+        loc = loc or self.location
+        if not loc:
+            return
+
+        nloc = _normalize_cached(loc)
+        bdir = os.path.dirname(nloc)
+        npath = [(p and _normalize_cached(p) or p) for p in path]
+
+        for p, item in enumerate(npath):
+            if item == nloc:
+                if replace:
+                    break
+                else:
+                    # don't modify path (even removing duplicates) if
+                    # found and not replace
+                    return
+            elif item == bdir and self.precedence == EGG_DIST:
+                # if it's an .egg, give it precedence over its directory
+                # UNLESS it's already been added to sys.path and replace=False
+                if (not replace) and nloc in npath[p:]:
+                    return
+                if path is sys.path:
+                    self.check_version_conflict()
+                path.insert(p, loc)
+                npath.insert(p, nloc)
+                break
+        else:
+            if path is sys.path:
+                self.check_version_conflict()
+            if replace:
+                path.insert(0, loc)
+            else:
+                path.append(loc)
+            return
+
+        # p is the spot where we found or inserted loc; now remove duplicates
+        while True:
+            try:
+                np = npath.index(nloc, p + 1)
+            except ValueError:
+                break
+            else:
+                del npath[np], path[np]
+                # ha!
+                p = np
+
+        return
+
+    def check_version_conflict(self):
+        if self.key == 'setuptools':
+            # ignore the inevitable setuptools self-conflicts  :(
+            return
+
+        nsp = dict.fromkeys(self._get_metadata('namespace_packages.txt'))
+        loc = normalize_path(self.location)
+        for modname in self._get_metadata('top_level.txt'):
+            if (
+                modname not in sys.modules
+                or modname in nsp
+                or modname in _namespace_packages
+            ):
+                continue
+            if modname in ('pkg_resources', 'setuptools', 'site'):
+                continue
+            fn = getattr(sys.modules[modname], '__file__', None)
+            if fn and (
+                normalize_path(fn).startswith(loc) or fn.startswith(self.location)
+            ):
+                continue
+            issue_warning(
+                f"Module {modname} was already imported from {fn}, "
+                f"but {self.location} is being added to sys.path",
+            )
+
+    def has_version(self) -> bool:
+        try:
+            self.version
+        except ValueError:
+            issue_warning("Unbuilt egg for " + repr(self))
+            return False
+        except SystemError:
+            # TODO: remove this except clause when python/cpython#103632 is fixed.
+            return False
+        return True
+
+    def clone(self, **kw: str | int | IResourceProvider | None) -> Self:
+        """Copy this distribution, substituting in any changed keyword args"""
+        names = 'project_name version py_version platform location precedence'
+        for attr in names.split():
+            kw.setdefault(attr, getattr(self, attr, None))
+        kw.setdefault('metadata', self._provider)
+        # Unsafely unpacking. But keeping **kw for backwards and subclassing compatibility
+        return self.__class__(**kw)  # type:ignore[arg-type]
+
+    @property
+    def extras(self):
+        return [dep for dep in self._dep_map if dep]
+
+
+class EggInfoDistribution(Distribution):
+    def _reload_version(self):
+        """
+        Packages installed by distutils (e.g. numpy or scipy),
+        which uses an old safe_version, and so
+        their version numbers can get mangled when
+        converted to filenames (e.g., 1.11.0.dev0+2329eae to
+        1.11.0.dev0_2329eae). These distributions will not be
+        parsed properly
+        downstream by Distribution and safe_version, so
+        take an extra step and try to get the version number from
+        the metadata file itself instead of the filename.
+        """
+        md_version = self._get_version()
+        if md_version:
+            self._version = md_version
+        return self
+
+
+class DistInfoDistribution(Distribution):
+    """
+    Wrap an actual or potential sys.path entry
+    w/metadata, .dist-info style.
+    """
+
+    PKG_INFO = 'METADATA'
+    EQEQ = re.compile(r"([\(,])\s*(\d.*?)\s*([,\)])")
+
+    @property
+    def _parsed_pkg_info(self):
+        """Parse and cache metadata"""
+        try:
+            return self._pkg_info
+        except AttributeError:
+            metadata = self.get_metadata(self.PKG_INFO)
+            self._pkg_info = email.parser.Parser().parsestr(metadata)
+            return self._pkg_info
+
+    @property
+    def _dep_map(self):
+        try:
+            return self.__dep_map
+        except AttributeError:
+            self.__dep_map = self._compute_dependencies()
+            return self.__dep_map
+
+    def _compute_dependencies(self) -> dict[str | None, list[Requirement]]:
+        """Recompute this distribution's dependencies."""
+        self.__dep_map: dict[str | None, list[Requirement]] = {None: []}
+
+        reqs: list[Requirement] = []
+        # Including any condition expressions
+        for req in self._parsed_pkg_info.get_all('Requires-Dist') or []:
+            reqs.extend(parse_requirements(req))
+
+        def reqs_for_extra(extra):
+            for req in reqs:
+                if not req.marker or req.marker.evaluate({'extra': extra}):
+                    yield req
+
+        common = types.MappingProxyType(dict.fromkeys(reqs_for_extra(None)))
+        self.__dep_map[None].extend(common)
+
+        for extra in self._parsed_pkg_info.get_all('Provides-Extra') or []:
+            s_extra = safe_extra(extra.strip())
+            self.__dep_map[s_extra] = [
+                r for r in reqs_for_extra(extra) if r not in common
+            ]
+
+        return self.__dep_map
+
+
+_distributionImpl = {
+    '.egg': Distribution,
+    '.egg-info': EggInfoDistribution,
+    '.dist-info': DistInfoDistribution,
+}
+
+
+def issue_warning(*args, **kw):
+    level = 1
+    g = globals()
+    try:
+        # find the first stack frame that is *not* code in
+        # the pkg_resources module, to use for the warning
+        while sys._getframe(level).f_globals is g:
+            level += 1
+    except ValueError:
+        pass
+    warnings.warn(stacklevel=level + 1, *args, **kw)
+
+
+def parse_requirements(strs: _NestedStr) -> map[Requirement]:
+    """
+    Yield ``Requirement`` objects for each specification in `strs`.
+
+    `strs` must be a string, or a (possibly-nested) iterable thereof.
+    """
+    return map(Requirement, join_continuation(map(drop_comment, yield_lines(strs))))
+
+
+class RequirementParseError(packaging.requirements.InvalidRequirement):
+    "Compatibility wrapper for InvalidRequirement"
+
+
+class Requirement(packaging.requirements.Requirement):
+    # prefer variable length tuple to set (as found in
+    # packaging.requirements.Requirement)
+    extras: tuple[str, ...]  # type: ignore[assignment]
+
+    def __init__(self, requirement_string: str) -> None:
+        """DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!"""
+        super().__init__(requirement_string)
+        self.unsafe_name = self.name
+        project_name = safe_name(self.name)
+        self.project_name, self.key = project_name, project_name.lower()
+        self.specs = [(spec.operator, spec.version) for spec in self.specifier]
+        self.extras = tuple(map(safe_extra, self.extras))
+        self.hashCmp = (
+            self.key,
+            self.url,
+            self.specifier,
+            frozenset(self.extras),
+            str(self.marker) if self.marker else None,
+        )
+        self.__hash = hash(self.hashCmp)
+
+    def __eq__(self, other: object) -> bool:
+        return isinstance(other, Requirement) and self.hashCmp == other.hashCmp
+
+    def __ne__(self, other: object) -> bool:
+        return not self == other
+
+    def __contains__(
+        self, item: Distribution | packaging.specifiers.UnparsedVersion
+    ) -> bool:
+        if isinstance(item, Distribution):
+            if item.key != self.key:
+                return False
+
+            version = item.version
+        else:
+            version = item
+
+        # Allow prereleases always in order to match the previous behavior of
+        # this method. In the future this should be smarter and follow PEP 440
+        # more accurately.
+        return self.specifier.contains(
+            version,
+            prereleases=True,
+        )
+
+    def __hash__(self) -> int:
+        return self.__hash
+
+    def __repr__(self) -> str:
+        return f"Requirement.parse({str(self)!r})"
+
+    @staticmethod
+    def parse(s: str | Iterable[str]) -> Requirement:
+        (req,) = parse_requirements(s)
+        return req
+
+
+def _always_object(classes):
+    """
+    Ensure object appears in the mro even
+    for old-style classes.
+    """
+    if object not in classes:
+        return classes + (object,)
+    return classes
+
+
+def _find_adapter(registry: Mapping[type, _AdapterT], ob: object) -> _AdapterT:
+    """Return an adapter factory for `ob` from `registry`"""
+    types = _always_object(inspect.getmro(getattr(ob, '__class__', type(ob))))
+    for t in types:
+        if t in registry:
+            return registry[t]
+    # _find_adapter would previously return None, and immediately be called.
+    # So we're raising a TypeError to keep backward compatibility if anyone depended on that behaviour.
+    raise TypeError(f"Could not find adapter for {registry} and {ob}")
+
+
+def ensure_directory(path: StrOrBytesPath) -> None:
+    """Ensure that the parent directory of `path` exists"""
+    dirname = os.path.dirname(path)
+    os.makedirs(dirname, exist_ok=True)
+
+
+def _bypass_ensure_directory(path) -> None:
+    """Sandbox-bypassing version of ensure_directory()"""
+    if not WRITE_SUPPORT:
+        raise OSError('"os.mkdir" not supported on this platform.')
+    dirname, filename = split(path)
+    if dirname and filename and not isdir(dirname):
+        _bypass_ensure_directory(dirname)
+        try:
+            mkdir(dirname, 0o755)
+        except FileExistsError:
+            pass
+
+
+def split_sections(s: _NestedStr) -> Iterator[tuple[str | None, list[str]]]:
+    """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 _mkstemp(*args, **kw):
+    old_open = os.open
+    try:
+        # temporarily bypass sandboxing
+        os.open = os_open
+        return tempfile.mkstemp(*args, **kw)
+    finally:
+        # and then put it back
+        os.open = old_open
+
+
+# Silence the PEP440Warning by default, so that end users don't get hit by it
+# randomly just because they use pkg_resources. We want to append the rule
+# because we want earlier uses of filterwarnings to take precedence over this
+# one.
+warnings.filterwarnings("ignore", category=PEP440Warning, append=True)
+
+
+class PkgResourcesDeprecationWarning(Warning):
+    """
+    Base class for warning about deprecations in ``pkg_resources``
+
+    This class is not derived from ``DeprecationWarning``, and as such is
+    visible by default.
+    """
+
+
+# Ported from ``setuptools`` to avoid introducing an import inter-dependency:
+_LOCALE_ENCODING = "locale" if sys.version_info >= (3, 10) else None
+
+
+# This must go before calls to `_call_aside`. See https://github.com/pypa/setuptools/pull/4422
+def _read_utf8_with_fallback(file: str, fallback_encoding=_LOCALE_ENCODING) -> str:
+    """See setuptools.unicode_utils._read_utf8_with_fallback"""
+    try:
+        with open(file, "r", encoding="utf-8") as f:
+            return f.read()
+    except UnicodeDecodeError:  # pragma: no cover
+        msg = f"""\
+        ********************************************************************************
+        `encoding="utf-8"` fails with {file!r}, trying `encoding={fallback_encoding!r}`.
+
+        This fallback behaviour is considered **deprecated** and future versions of
+        `setuptools/pkg_resources` 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?
+        #       See comment in setuptools.unicode_utils._Utf8EncodingNeeded
+        warnings.warn(msg, PkgResourcesDeprecationWarning, stacklevel=2)
+        with open(file, "r", encoding=fallback_encoding) as f:
+            return f.read()
+
+
+# from jaraco.functools 1.3
+def _call_aside(f, *args, **kwargs):
+    f(*args, **kwargs)
+    return f
+
+
+@_call_aside
+def _initialize(g=globals()) -> None:
+    "Set up global resource manager (deliberately not state-saved)"
+    manager = ResourceManager()
+    g['_manager'] = manager
+    g.update(
+        (name, getattr(manager, name))
+        for name in dir(manager)
+        if not name.startswith('_')
+    )
+
+
+@_call_aside
+def _initialize_master_working_set() -> None:
+    """
+    Prepare the master working set and make the ``require()``
+    API available.
+
+    This function has explicit effects on the global state
+    of pkg_resources. It is intended to be invoked once at
+    the initialization of this module.
+
+    Invocation by other packages is unsupported and done
+    at their own risk.
+    """
+    working_set = _declare_state('object', 'working_set', WorkingSet._build_master())
+
+    require = working_set.require
+    iter_entry_points = working_set.iter_entry_points
+    add_activation_listener = working_set.subscribe
+    run_script = working_set.run_script
+    # backward compatibility
+    run_main = run_script
+    # Activate all distributions already on sys.path with replace=False and
+    # ensure that all distributions added to the working set in the future
+    # (e.g. by calling ``require()``) will get activated as well,
+    # with higher priority (replace=True).
+    tuple(dist.activate(replace=False) for dist in working_set)
+    add_activation_listener(
+        lambda dist: dist.activate(replace=True),
+        existing=False,
+    )
+    working_set.entries = []
+    # match order
+    list(map(working_set.add_entry, sys.path))
+    globals().update(locals())
+
+
+if TYPE_CHECKING:
+    # All of these are set by the @_call_aside methods above
+    __resource_manager = ResourceManager()  # Won't exist at runtime
+    resource_exists = __resource_manager.resource_exists
+    resource_isdir = __resource_manager.resource_isdir
+    resource_filename = __resource_manager.resource_filename
+    resource_stream = __resource_manager.resource_stream
+    resource_string = __resource_manager.resource_string
+    resource_listdir = __resource_manager.resource_listdir
+    set_extraction_path = __resource_manager.set_extraction_path
+    cleanup_resources = __resource_manager.cleanup_resources
+
+    working_set = WorkingSet()
+    require = working_set.require
+    iter_entry_points = working_set.iter_entry_points
+    add_activation_listener = working_set.subscribe
+    run_script = working_set.run_script
+    run_main = run_script
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/api_tests.txt b/venv/lib/python3.12/site-packages/pkg_resources/api_tests.txt
new file mode 100644
index 0000000..d72b85a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/api_tests.txt
@@ -0,0 +1,424 @@
+Pluggable Distributions of Python Software
+==========================================
+
+Distributions
+-------------
+
+A "Distribution" is a collection of files that represent a "Release" of a
+"Project" as of a particular point in time, denoted by a
+"Version"::
+
+    >>> import sys, pkg_resources
+    >>> from pkg_resources import Distribution
+    >>> Distribution(project_name="Foo", version="1.2")
+    Foo 1.2
+
+Distributions have a location, which can be a filename, URL, or really anything
+else you care to use::
+
+    >>> dist = Distribution(
+    ...     location="http://example.com/something",
+    ...     project_name="Bar", version="0.9"
+    ... )
+
+    >>> dist
+    Bar 0.9 (http://example.com/something)
+
+
+Distributions have various introspectable attributes::
+
+    >>> dist.location
+    'http://example.com/something'
+
+    >>> dist.project_name
+    'Bar'
+
+    >>> dist.version
+    '0.9'
+
+    >>> dist.py_version == '{}.{}'.format(*sys.version_info)
+    True
+
+    >>> print(dist.platform)
+    None
+
+Including various computed attributes::
+
+    >>> from pkg_resources import parse_version
+    >>> dist.parsed_version == parse_version(dist.version)
+    True
+
+    >>> dist.key    # case-insensitive form of the project name
+    'bar'
+
+Distributions are compared (and hashed) by version first::
+
+    >>> Distribution(version='1.0') == Distribution(version='1.0')
+    True
+    >>> Distribution(version='1.0') == Distribution(version='1.1')
+    False
+    >>> Distribution(version='1.0') <  Distribution(version='1.1')
+    True
+
+but also by project name (case-insensitive), platform, Python version,
+location, etc.::
+
+    >>> Distribution(project_name="Foo",version="1.0") == \
+    ... Distribution(project_name="Foo",version="1.0")
+    True
+
+    >>> Distribution(project_name="Foo",version="1.0") == \
+    ... Distribution(project_name="foo",version="1.0")
+    True
+
+    >>> Distribution(project_name="Foo",version="1.0") == \
+    ... Distribution(project_name="Foo",version="1.1")
+    False
+
+    >>> Distribution(project_name="Foo",py_version="2.3",version="1.0") == \
+    ... Distribution(project_name="Foo",py_version="2.4",version="1.0")
+    False
+
+    >>> Distribution(location="spam",version="1.0") == \
+    ... Distribution(location="spam",version="1.0")
+    True
+
+    >>> Distribution(location="spam",version="1.0") == \
+    ... Distribution(location="baz",version="1.0")
+    False
+
+
+
+Hash and compare distribution by prio/plat
+
+Get version from metadata
+provider capabilities
+egg_name()
+as_requirement()
+from_location, from_filename (w/path normalization)
+
+Releases may have zero or more "Requirements", which indicate
+what releases of another project the release requires in order to
+function.  A Requirement names the other project, expresses some criteria
+as to what releases of that project are acceptable, and lists any "Extras"
+that the requiring release may need from that project.  (An Extra is an
+optional feature of a Release, that can only be used if its additional
+Requirements are satisfied.)
+
+
+
+The Working Set
+---------------
+
+A collection of active distributions is called a Working Set.  Note that a
+Working Set can contain any importable distribution, not just pluggable ones.
+For example, the Python standard library is an importable distribution that
+will usually be part of the Working Set, even though it is not pluggable.
+Similarly, when you are doing development work on a project, the files you are
+editing are also a Distribution.  (And, with a little attention to the
+directory names used,  and including some additional metadata, such a
+"development distribution" can be made pluggable as well.)
+
+    >>> from pkg_resources import WorkingSet
+
+A working set's entries are the sys.path entries that correspond to the active
+distributions.  By default, the working set's entries are the items on
+``sys.path``::
+
+    >>> ws = WorkingSet()
+    >>> ws.entries == sys.path
+    True
+
+But you can also create an empty working set explicitly, and add distributions
+to it::
+
+    >>> ws = WorkingSet([])
+    >>> ws.add(dist)
+    >>> ws.entries
+    ['http://example.com/something']
+    >>> dist in ws
+    True
+    >>> Distribution('foo',version="") in ws
+    False
+
+And you can iterate over its distributions::
+
+    >>> list(ws)
+    [Bar 0.9 (http://example.com/something)]
+
+Adding the same distribution more than once is a no-op::
+
+    >>> ws.add(dist)
+    >>> list(ws)
+    [Bar 0.9 (http://example.com/something)]
+
+For that matter, adding multiple distributions for the same project also does
+nothing, because a working set can only hold one active distribution per
+project -- the first one added to it::
+
+    >>> ws.add(
+    ...     Distribution(
+    ...         'http://example.com/something', project_name="Bar",
+    ...         version="7.2"
+    ...     )
+    ... )
+    >>> list(ws)
+    [Bar 0.9 (http://example.com/something)]
+
+You can append a path entry to a working set using ``add_entry()``::
+
+    >>> ws.entries
+    ['http://example.com/something']
+    >>> ws.add_entry(pkg_resources.__file__)
+    >>> ws.entries
+    ['http://example.com/something', '...pkg_resources...']
+
+Multiple additions result in multiple entries, even if the entry is already in
+the working set (because ``sys.path`` can contain the same entry more than
+once)::
+
+    >>> ws.add_entry(pkg_resources.__file__)
+    >>> ws.entries
+    ['...example.com...', '...pkg_resources...', '...pkg_resources...']
+
+And you can specify the path entry a distribution was found under, using the
+optional second parameter to ``add()``::
+
+    >>> ws = WorkingSet([])
+    >>> ws.add(dist,"foo")
+    >>> ws.entries
+    ['foo']
+
+But even if a distribution is found under multiple path entries, it still only
+shows up once when iterating the working set:
+
+    >>> ws.add_entry(ws.entries[0])
+    >>> list(ws)
+    [Bar 0.9 (http://example.com/something)]
+
+You can ask a WorkingSet to ``find()`` a distribution matching a requirement::
+
+    >>> from pkg_resources import Requirement
+    >>> print(ws.find(Requirement.parse("Foo==1.0")))   # no match, return None
+    None
+
+    >>> ws.find(Requirement.parse("Bar==0.9"))  # match, return distribution
+    Bar 0.9 (http://example.com/something)
+
+Note that asking for a conflicting version of a distribution already in a
+working set triggers a ``pkg_resources.VersionConflict`` error:
+
+    >>> try:
+    ...     ws.find(Requirement.parse("Bar==1.0"))
+    ... except pkg_resources.VersionConflict as exc:
+    ...     print(str(exc))
+    ... else:
+    ...     raise AssertionError("VersionConflict was not raised")
+    (Bar 0.9 (http://example.com/something), Requirement.parse('Bar==1.0'))
+
+You can subscribe a callback function to receive notifications whenever a new
+distribution is added to a working set.  The callback is immediately invoked
+once for each existing distribution in the working set, and then is called
+again for new distributions added thereafter::
+
+    >>> def added(dist): print("Added %s" % dist)
+    >>> ws.subscribe(added)
+    Added Bar 0.9
+    >>> foo12 = Distribution(project_name="Foo", version="1.2", location="f12")
+    >>> ws.add(foo12)
+    Added Foo 1.2
+
+Note, however, that only the first distribution added for a given project name
+will trigger a callback, even during the initial ``subscribe()`` callback::
+
+    >>> foo14 = Distribution(project_name="Foo", version="1.4", location="f14")
+    >>> ws.add(foo14)   # no callback, because Foo 1.2 is already active
+
+    >>> ws = WorkingSet([])
+    >>> ws.add(foo12)
+    >>> ws.add(foo14)
+    >>> ws.subscribe(added)
+    Added Foo 1.2
+
+And adding a callback more than once has no effect, either::
+
+    >>> ws.subscribe(added)     # no callbacks
+
+    # and no double-callbacks on subsequent additions, either
+    >>> just_a_test = Distribution(project_name="JustATest", version="0.99")
+    >>> ws.add(just_a_test)
+    Added JustATest 0.99
+
+
+Finding Plugins
+---------------
+
+``WorkingSet`` objects can be used to figure out what plugins in an
+``Environment`` can be loaded without any resolution errors::
+
+    >>> from pkg_resources import Environment
+
+    >>> plugins = Environment([])   # normally, a list of plugin directories
+    >>> plugins.add(foo12)
+    >>> plugins.add(foo14)
+    >>> plugins.add(just_a_test)
+
+In the simplest case, we just get the newest version of each distribution in
+the plugin environment::
+
+    >>> ws = WorkingSet([])
+    >>> ws.find_plugins(plugins)
+    ([JustATest 0.99, Foo 1.4 (f14)], {})
+
+But if there's a problem with a version conflict or missing requirements, the
+method falls back to older versions, and the error info dict will contain an
+exception instance for each unloadable plugin::
+
+    >>> ws.add(foo12)   # this will conflict with Foo 1.4
+    >>> ws.find_plugins(plugins)
+    ([JustATest 0.99, Foo 1.2 (f12)], {Foo 1.4 (f14): VersionConflict(...)})
+
+But if you disallow fallbacks, the failed plugin will be skipped instead of
+trying older versions::
+
+    >>> ws.find_plugins(plugins, fallback=False)
+    ([JustATest 0.99], {Foo 1.4 (f14): VersionConflict(...)})
+
+
+
+Platform Compatibility Rules
+----------------------------
+
+On the Mac, there are potential compatibility issues for modules compiled
+on newer versions of macOS than what the user is running. Additionally,
+macOS will soon have two platforms to contend with: Intel and PowerPC.
+
+Basic equality works as on other platforms::
+
+    >>> from pkg_resources import compatible_platforms as cp
+    >>> reqd = 'macosx-10.4-ppc'
+    >>> cp(reqd, reqd)
+    True
+    >>> cp("win32", reqd)
+    False
+
+Distributions made on other machine types are not compatible::
+
+    >>> cp("macosx-10.4-i386", reqd)
+    False
+
+Distributions made on earlier versions of the OS are compatible, as
+long as they are from the same top-level version. The patchlevel version
+number does not matter::
+
+    >>> cp("macosx-10.4-ppc", reqd)
+    True
+    >>> cp("macosx-10.3-ppc", reqd)
+    True
+    >>> cp("macosx-10.5-ppc", reqd)
+    False
+    >>> cp("macosx-9.5-ppc", reqd)
+    False
+
+Backwards compatibility for packages made via earlier versions of
+setuptools is provided as well::
+
+    >>> cp("darwin-8.2.0-Power_Macintosh", reqd)
+    True
+    >>> cp("darwin-7.2.0-Power_Macintosh", reqd)
+    True
+    >>> cp("darwin-8.2.0-Power_Macintosh", "macosx-10.3-ppc")
+    False
+
+
+Environment Markers
+-------------------
+
+    >>> from pkg_resources import invalid_marker as im, evaluate_marker as em
+    >>> import os
+
+    >>> print(im("sys_platform"))
+    Expected marker operator, one of <=, <, !=, ==, >=, >, ~=, ===, in, not in
+        sys_platform
+                    ^
+
+    >>> print(im("sys_platform=="))
+    Expected a marker variable or quoted string
+        sys_platform==
+                      ^
+
+    >>> print(im("sys_platform=='win32'"))
+    False
+
+    >>> print(im("sys=='x'"))
+    Expected a marker variable or quoted string
+        sys=='x'
+        ^
+
+    >>> print(im("(extra)"))
+    Expected marker operator, one of <=, <, !=, ==, >=, >, ~=, ===, in, not in
+        (extra)
+              ^
+
+    >>> print(im("(extra"))
+    Expected marker operator, one of <=, <, !=, ==, >=, >, ~=, ===, in, not in
+        (extra
+              ^
+
+    >>> print(im("os.open('foo')=='y'"))
+    Expected a marker variable or quoted string
+        os.open('foo')=='y'
+        ^
+
+    >>> print(im("'x'=='y' and os.open('foo')=='y'"))   # no short-circuit!
+    Expected a marker variable or quoted string
+        'x'=='y' and os.open('foo')=='y'
+                     ^
+
+    >>> print(im("'x'=='x' or os.open('foo')=='y'"))   # no short-circuit!
+    Expected a marker variable or quoted string
+        'x'=='x' or os.open('foo')=='y'
+                    ^
+
+    >>> print(im("r'x'=='x'"))
+    Expected a marker variable or quoted string
+        r'x'=='x'
+        ^
+
+    >>> print(im("'''x'''=='x'"))
+    Expected marker operator, one of <=, <, !=, ==, >=, >, ~=, ===, in, not in
+        '''x'''=='x'
+          ^
+
+    >>> print(im('"""x"""=="x"'))
+    Expected marker operator, one of <=, <, !=, ==, >=, >, ~=, ===, in, not in
+        """x"""=="x"
+          ^
+
+    >>> print(im(r"x\n=='x'"))
+    Expected a marker variable or quoted string
+        x\n=='x'
+        ^
+
+    >>> print(im("os.open=='y'"))
+    Expected a marker variable or quoted string
+        os.open=='y'
+        ^
+
+    >>> em("sys_platform=='win32'") == (sys.platform=='win32')
+    True
+
+    >>> em("python_version >= '2.7'")
+    True
+
+    >>> em("python_version > '2.6'")
+    True
+
+    >>> im("implementation_name=='cpython'")
+    False
+
+    >>> im("platform_python_implementation=='CPython'")
+    False
+
+    >>> im("implementation_version=='3.5.1'")
+    False
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/py.typed b/venv/lib/python3.12/site-packages/pkg_resources/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/__init__.py b/venv/lib/python3.12/site-packages/pkg_resources/tests/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package-source/setup.cfg b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package-source/setup.cfg
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package-source/setup.py b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package-source/setup.py
new file mode 100644
index 0000000..ce90806
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package-source/setup.py
@@ -0,0 +1,7 @@
+import setuptools
+
+setuptools.setup(
+    name="my-test-package",
+    version="1.0",
+    zip_safe=True,
+)
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package-zip/my-test-package.zip b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package-zip/my-test-package.zip
new file mode 100644
index 0000000..81f9a01
Binary files /dev/null and b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package-zip/my-test-package.zip differ
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/PKG-INFO b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/PKG-INFO
new file mode 100644
index 0000000..7328e3f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/PKG-INFO
@@ -0,0 +1,10 @@
+Metadata-Version: 1.0
+Name: my-test-package
+Version: 1.0
+Summary: UNKNOWN
+Home-page: UNKNOWN
+Author: UNKNOWN
+Author-email: UNKNOWN
+License: UNKNOWN
+Description: UNKNOWN
+Platform: UNKNOWN
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/SOURCES.txt b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/SOURCES.txt
new file mode 100644
index 0000000..3c4ee16
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/SOURCES.txt
@@ -0,0 +1,7 @@
+setup.cfg
+setup.py
+my_test_package.egg-info/PKG-INFO
+my_test_package.egg-info/SOURCES.txt
+my_test_package.egg-info/dependency_links.txt
+my_test_package.egg-info/top_level.txt
+my_test_package.egg-info/zip-safe
\ No newline at end of file
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/dependency_links.txt b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/dependency_links.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/dependency_links.txt
@@ -0,0 +1 @@
+
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/top_level.txt b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/top_level.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/top_level.txt
@@ -0,0 +1 @@
+
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/zip-safe b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/zip-safe
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/zip-safe
@@ -0,0 +1 @@
+
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_zipped-egg/my_test_package-1.0-py3.7.egg b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_zipped-egg/my_test_package-1.0-py3.7.egg
new file mode 100644
index 0000000..5115b89
Binary files /dev/null and b/venv/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_zipped-egg/my_test_package-1.0-py3.7.egg differ
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/test_find_distributions.py b/venv/lib/python3.12/site-packages/pkg_resources/tests/test_find_distributions.py
new file mode 100644
index 0000000..301b36d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/tests/test_find_distributions.py
@@ -0,0 +1,56 @@
+import shutil
+from pathlib import Path
+
+import pytest
+
+import pkg_resources
+
+TESTS_DATA_DIR = Path(__file__).parent / 'data'
+
+
+class TestFindDistributions:
+    @pytest.fixture
+    def target_dir(self, tmpdir):
+        target_dir = tmpdir.mkdir('target')
+        # place a .egg named directory in the target that is not an egg:
+        target_dir.mkdir('not.an.egg')
+        return target_dir
+
+    def test_non_egg_dir_named_egg(self, target_dir):
+        dists = pkg_resources.find_distributions(str(target_dir))
+        assert not list(dists)
+
+    def test_standalone_egg_directory(self, target_dir):
+        shutil.copytree(
+            TESTS_DATA_DIR / 'my-test-package_unpacked-egg',
+            target_dir,
+            dirs_exist_ok=True,
+        )
+        dists = pkg_resources.find_distributions(str(target_dir))
+        assert [dist.project_name for dist in dists] == ['my-test-package']
+        dists = pkg_resources.find_distributions(str(target_dir), only=True)
+        assert not list(dists)
+
+    def test_zipped_egg(self, target_dir):
+        shutil.copytree(
+            TESTS_DATA_DIR / 'my-test-package_zipped-egg',
+            target_dir,
+            dirs_exist_ok=True,
+        )
+        dists = pkg_resources.find_distributions(str(target_dir))
+        assert [dist.project_name for dist in dists] == ['my-test-package']
+        dists = pkg_resources.find_distributions(str(target_dir), only=True)
+        assert not list(dists)
+
+    def test_zipped_sdist_one_level_removed(self, target_dir):
+        shutil.copytree(
+            TESTS_DATA_DIR / 'my-test-package-zip', target_dir, dirs_exist_ok=True
+        )
+        dists = pkg_resources.find_distributions(
+            str(target_dir / "my-test-package.zip")
+        )
+        assert [dist.project_name for dist in dists] == ['my-test-package']
+        dists = pkg_resources.find_distributions(
+            str(target_dir / "my-test-package.zip"), only=True
+        )
+        assert not list(dists)
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/test_integration_zope_interface.py b/venv/lib/python3.12/site-packages/pkg_resources/tests/test_integration_zope_interface.py
new file mode 100644
index 0000000..4e37c34
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/tests/test_integration_zope_interface.py
@@ -0,0 +1,54 @@
+import platform
+from inspect import cleandoc
+
+import jaraco.path
+import pytest
+
+pytestmark = pytest.mark.integration
+
+
+# For the sake of simplicity this test uses fixtures defined in
+# `setuptools.test.fixtures`,
+# and it also exercise conditions considered deprecated...
+# So if needed this test can be deleted.
+@pytest.mark.skipif(
+    platform.system() != "Linux",
+    reason="only demonstrated to fail on Linux in #4399",
+)
+def test_interop_pkg_resources_iter_entry_points(tmp_path, venv):
+    """
+    Importing pkg_resources.iter_entry_points on console_scripts
+    seems to cause trouble with zope-interface, when deprecates installation method
+    is used. See #4399.
+    """
+    project = {
+        "pkg": {
+            "foo.py": cleandoc(
+                """
+                from pkg_resources import iter_entry_points
+
+                def bar():
+                    print("Print me if you can")
+                """
+            ),
+            "setup.py": cleandoc(
+                """
+                from setuptools import setup, find_packages
+
+                setup(
+                    install_requires=["zope-interface==6.4.post2"],
+                    entry_points={
+                        "console_scripts": [
+                            "foo=foo:bar",
+                        ],
+                    },
+                )
+                """
+            ),
+        }
+    }
+    jaraco.path.build(project, prefix=tmp_path)
+    cmd = ["pip", "install", "-e", ".", "--no-use-pep517"]
+    venv.run(cmd, cwd=tmp_path / "pkg")  # Needs this version of pkg_resources installed
+    out = venv.run(["foo"])
+    assert "Print me if you can" in out
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/test_markers.py b/venv/lib/python3.12/site-packages/pkg_resources/tests/test_markers.py
new file mode 100644
index 0000000..9306d5b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/tests/test_markers.py
@@ -0,0 +1,8 @@
+from unittest import mock
+
+from pkg_resources import evaluate_marker
+
+
+@mock.patch('platform.python_version', return_value='2.7.10')
+def test_ordering(python_version_mock):
+    assert evaluate_marker("python_full_version > '2.7.3'") is True
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/test_pkg_resources.py b/venv/lib/python3.12/site-packages/pkg_resources/tests/test_pkg_resources.py
new file mode 100644
index 0000000..cfc9b16
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/tests/test_pkg_resources.py
@@ -0,0 +1,485 @@
+from __future__ import annotations
+
+import builtins
+import datetime
+import inspect
+import os
+import plistlib
+import stat
+import subprocess
+import sys
+import tempfile
+import zipfile
+from unittest import mock
+
+import pytest
+
+import pkg_resources
+from pkg_resources import DistInfoDistribution, Distribution, EggInfoDistribution
+
+import distutils.command.install_egg_info
+import distutils.dist
+
+
+class EggRemover(str):
+    def __call__(self):
+        if self in sys.path:
+            sys.path.remove(self)
+        if os.path.exists(self):
+            os.remove(self)
+
+
+class TestZipProvider:
+    finalizers: list[EggRemover] = []
+
+    ref_time = datetime.datetime(2013, 5, 12, 13, 25, 0)
+    "A reference time for a file modification"
+
+    @classmethod
+    def setup_class(cls):
+        "create a zip egg and add it to sys.path"
+        egg = tempfile.NamedTemporaryFile(suffix='.egg', delete=False)
+        zip_egg = zipfile.ZipFile(egg, 'w')
+        zip_info = zipfile.ZipInfo()
+        zip_info.filename = 'mod.py'
+        zip_info.date_time = cls.ref_time.timetuple()
+        zip_egg.writestr(zip_info, 'x = 3\n')
+        zip_info = zipfile.ZipInfo()
+        zip_info.filename = 'data.dat'
+        zip_info.date_time = cls.ref_time.timetuple()
+        zip_egg.writestr(zip_info, 'hello, world!')
+        zip_info = zipfile.ZipInfo()
+        zip_info.filename = 'subdir/mod2.py'
+        zip_info.date_time = cls.ref_time.timetuple()
+        zip_egg.writestr(zip_info, 'x = 6\n')
+        zip_info = zipfile.ZipInfo()
+        zip_info.filename = 'subdir/data2.dat'
+        zip_info.date_time = cls.ref_time.timetuple()
+        zip_egg.writestr(zip_info, 'goodbye, world!')
+        zip_egg.close()
+        egg.close()
+
+        sys.path.append(egg.name)
+        subdir = os.path.join(egg.name, 'subdir')
+        sys.path.append(subdir)
+        cls.finalizers.append(EggRemover(subdir))
+        cls.finalizers.append(EggRemover(egg.name))
+
+    @classmethod
+    def teardown_class(cls):
+        for finalizer in cls.finalizers:
+            finalizer()
+
+    def test_resource_listdir(self):
+        import mod  # pyright: ignore[reportMissingImports] # Temporary package for test
+
+        zp = pkg_resources.ZipProvider(mod)
+
+        expected_root = ['data.dat', 'mod.py', 'subdir']
+        assert sorted(zp.resource_listdir('')) == expected_root
+
+        expected_subdir = ['data2.dat', 'mod2.py']
+        assert sorted(zp.resource_listdir('subdir')) == expected_subdir
+        assert sorted(zp.resource_listdir('subdir/')) == expected_subdir
+
+        assert zp.resource_listdir('nonexistent') == []
+        assert zp.resource_listdir('nonexistent/') == []
+
+        import mod2  # pyright: ignore[reportMissingImports] # Temporary package for test
+
+        zp2 = pkg_resources.ZipProvider(mod2)
+
+        assert sorted(zp2.resource_listdir('')) == expected_subdir
+
+        assert zp2.resource_listdir('subdir') == []
+        assert zp2.resource_listdir('subdir/') == []
+
+    def test_resource_filename_rewrites_on_change(self):
+        """
+        If a previous call to get_resource_filename has saved the file, but
+        the file has been subsequently mutated with different file of the
+        same size and modification time, it should not be overwritten on a
+        subsequent call to get_resource_filename.
+        """
+        import mod  # pyright: ignore[reportMissingImports] # Temporary package for test
+
+        manager = pkg_resources.ResourceManager()
+        zp = pkg_resources.ZipProvider(mod)
+        filename = zp.get_resource_filename(manager, 'data.dat')
+        actual = datetime.datetime.fromtimestamp(os.stat(filename).st_mtime)
+        assert actual == self.ref_time
+        f = open(filename, 'w', encoding="utf-8")
+        f.write('hello, world?')
+        f.close()
+        ts = self.ref_time.timestamp()
+        os.utime(filename, (ts, ts))
+        filename = zp.get_resource_filename(manager, 'data.dat')
+        with open(filename, encoding="utf-8") as f:
+            assert f.read() == 'hello, world!'
+        manager.cleanup_resources()
+
+
+class TestResourceManager:
+    def test_get_cache_path(self):
+        mgr = pkg_resources.ResourceManager()
+        path = mgr.get_cache_path('foo')
+        type_ = str(type(path))
+        message = "Unexpected type from get_cache_path: " + type_
+        assert isinstance(path, str), message
+
+    def test_get_cache_path_race(self, tmpdir):
+        # Patch to os.path.isdir to create a race condition
+        def patched_isdir(dirname, unpatched_isdir=pkg_resources.isdir):
+            patched_isdir.dirnames.append(dirname)
+
+            was_dir = unpatched_isdir(dirname)
+            if not was_dir:
+                os.makedirs(dirname)
+            return was_dir
+
+        patched_isdir.dirnames = []
+
+        # Get a cache path with a "race condition"
+        mgr = pkg_resources.ResourceManager()
+        mgr.set_extraction_path(str(tmpdir))
+
+        archive_name = os.sep.join(('foo', 'bar', 'baz'))
+        with mock.patch.object(pkg_resources, 'isdir', new=patched_isdir):
+            mgr.get_cache_path(archive_name)
+
+        # Because this test relies on the implementation details of this
+        # function, these assertions are a sentinel to ensure that the
+        # test suite will not fail silently if the implementation changes.
+        called_dirnames = patched_isdir.dirnames
+        assert len(called_dirnames) == 2
+        assert called_dirnames[0].split(os.sep)[-2:] == ['foo', 'bar']
+        assert called_dirnames[1].split(os.sep)[-1:] == ['foo']
+
+    """
+    Tests to ensure that pkg_resources runs independently from setuptools.
+    """
+
+    def test_setuptools_not_imported(self):
+        """
+        In a separate Python environment, import pkg_resources and assert
+        that action doesn't cause setuptools to be imported.
+        """
+        lines = (
+            'import pkg_resources',
+            'import sys',
+            ('assert "setuptools" not in sys.modules, "setuptools was imported"'),
+        )
+        cmd = [sys.executable, '-c', '; '.join(lines)]
+        subprocess.check_call(cmd)
+
+
+def make_test_distribution(metadata_path, metadata):
+    """
+    Make a test Distribution object, and return it.
+
+    :param metadata_path: the path to the metadata file that should be
+        created. This should be inside a distribution directory that should
+        also be created. For example, an argument value might end with
+        ".dist-info/METADATA".
+    :param metadata: the desired contents of the metadata file, as bytes.
+    """
+    dist_dir = os.path.dirname(metadata_path)
+    os.mkdir(dist_dir)
+    with open(metadata_path, 'wb') as f:
+        f.write(metadata)
+    dists = list(pkg_resources.distributions_from_metadata(dist_dir))
+    (dist,) = dists
+
+    return dist
+
+
+def test_get_metadata__bad_utf8(tmpdir):
+    """
+    Test a metadata file with bytes that can't be decoded as utf-8.
+    """
+    filename = 'METADATA'
+    # Convert the tmpdir LocalPath object to a string before joining.
+    metadata_path = os.path.join(str(tmpdir), 'foo.dist-info', filename)
+    # Encode a non-ascii string with the wrong encoding (not utf-8).
+    metadata = 'née'.encode('iso-8859-1')
+    dist = make_test_distribution(metadata_path, metadata=metadata)
+
+    with pytest.raises(UnicodeDecodeError) as excinfo:
+        dist.get_metadata(filename)
+
+    exc = excinfo.value
+    actual = str(exc)
+    expected = (
+        # The error message starts with "'utf-8' codec ..." However, the
+        # spelling of "utf-8" can vary (e.g. "utf8") so we don't include it
+        "codec can't decode byte 0xe9 in position 1: "
+        'invalid continuation byte in METADATA file at path: '
+    )
+    assert expected in actual, f'actual: {actual}'
+    assert actual.endswith(metadata_path), f'actual: {actual}'
+
+
+def make_distribution_no_version(tmpdir, basename):
+    """
+    Create a distribution directory with no file containing the version.
+    """
+    dist_dir = tmpdir / basename
+    dist_dir.ensure_dir()
+    # Make the directory non-empty so distributions_from_metadata()
+    # will detect it and yield it.
+    dist_dir.join('temp.txt').ensure()
+
+    dists = list(pkg_resources.distributions_from_metadata(dist_dir))
+    assert len(dists) == 1
+    (dist,) = dists
+
+    return dist, dist_dir
+
+
+@pytest.mark.parametrize(
+    ("suffix", "expected_filename", "expected_dist_type"),
+    [
+        ('egg-info', 'PKG-INFO', EggInfoDistribution),
+        ('dist-info', 'METADATA', DistInfoDistribution),
+    ],
+)
+@pytest.mark.xfail(
+    sys.version_info[:2] == (3, 12) and sys.version_info.releaselevel != 'final',
+    reason="https://github.com/python/cpython/issues/103632",
+)
+def test_distribution_version_missing(
+    tmpdir, suffix, expected_filename, expected_dist_type
+):
+    """
+    Test Distribution.version when the "Version" header is missing.
+    """
+    basename = f'foo.{suffix}'
+    dist, dist_dir = make_distribution_no_version(tmpdir, basename)
+
+    expected_text = (
+        f"Missing 'Version:' header and/or {expected_filename} file at path: "
+    )
+    metadata_path = os.path.join(dist_dir, expected_filename)
+
+    # Now check the exception raised when the "version" attribute is accessed.
+    with pytest.raises(ValueError) as excinfo:
+        dist.version
+
+    err = str(excinfo.value)
+    # Include a string expression after the assert so the full strings
+    # will be visible for inspection on failure.
+    assert expected_text in err, str((expected_text, err))
+
+    # Also check the args passed to the ValueError.
+    msg, dist = excinfo.value.args
+    assert expected_text in msg
+    # Check that the message portion contains the path.
+    assert metadata_path in msg, str((metadata_path, msg))
+    assert type(dist) is expected_dist_type
+
+
+@pytest.mark.xfail(
+    sys.version_info[:2] == (3, 12) and sys.version_info.releaselevel != 'final',
+    reason="https://github.com/python/cpython/issues/103632",
+)
+def test_distribution_version_missing_undetected_path():
+    """
+    Test Distribution.version when the "Version" header is missing and
+    the path can't be detected.
+    """
+    # Create a Distribution object with no metadata argument, which results
+    # in an empty metadata provider.
+    dist = Distribution('/foo')
+    with pytest.raises(ValueError) as excinfo:
+        dist.version
+
+    msg, dist = excinfo.value.args
+    expected = (
+        "Missing 'Version:' header and/or PKG-INFO file at path: [could not detect]"
+    )
+    assert msg == expected
+
+
+@pytest.mark.parametrize('only', [False, True])
+def test_dist_info_is_not_dir(tmp_path, only):
+    """Test path containing a file with dist-info extension."""
+    dist_info = tmp_path / 'foobar.dist-info'
+    dist_info.touch()
+    assert not pkg_resources.dist_factory(str(tmp_path), str(dist_info), only)
+
+
+def test_macos_vers_fallback(monkeypatch, tmp_path):
+    """Regression test for pkg_resources._macos_vers"""
+    orig_open = builtins.open
+
+    # Pretend we need to use the plist file
+    monkeypatch.setattr('platform.mac_ver', mock.Mock(return_value=('', (), '')))
+
+    # Create fake content for the fake plist file
+    with open(tmp_path / 'fake.plist', 'wb') as fake_file:
+        plistlib.dump({"ProductVersion": "11.4"}, fake_file)
+
+    # Pretend the fake file exists
+    monkeypatch.setattr('os.path.exists', mock.Mock(return_value=True))
+
+    def fake_open(file, *args, **kwargs):
+        return orig_open(tmp_path / 'fake.plist', *args, **kwargs)
+
+    # Ensure that the _macos_vers works correctly
+    with mock.patch('builtins.open', mock.Mock(side_effect=fake_open)) as m:
+        pkg_resources._macos_vers.cache_clear()
+        assert pkg_resources._macos_vers() == ["11", "4"]
+        pkg_resources._macos_vers.cache_clear()
+
+    m.assert_called()
+
+
+class TestDeepVersionLookupDistutils:
+    @pytest.fixture
+    def env(self, tmpdir):
+        """
+        Create a package environment, similar to a virtualenv,
+        in which packages are installed.
+        """
+
+        class Environment(str):
+            pass
+
+        env = Environment(tmpdir)
+        tmpdir.chmod(stat.S_IRWXU)
+        subs = 'home', 'lib', 'scripts', 'data', 'egg-base'
+        env.paths = dict((dirname, str(tmpdir / dirname)) for dirname in subs)
+        list(map(os.mkdir, env.paths.values()))
+        return env
+
+    def create_foo_pkg(self, env, version):
+        """
+        Create a foo package installed (distutils-style) to env.paths['lib']
+        as version.
+        """
+        ld = "This package has unicode metadata! ❄"
+        attrs = dict(name='foo', version=version, long_description=ld)
+        dist = distutils.dist.Distribution(attrs)
+        iei_cmd = distutils.command.install_egg_info.install_egg_info(dist)
+        iei_cmd.initialize_options()
+        iei_cmd.install_dir = env.paths['lib']
+        iei_cmd.finalize_options()
+        iei_cmd.run()
+
+    def test_version_resolved_from_egg_info(self, env):
+        version = '1.11.0.dev0+2329eae'
+        self.create_foo_pkg(env, version)
+
+        # this requirement parsing will raise a VersionConflict unless the
+        # .egg-info file is parsed (see #419 on BitBucket)
+        req = pkg_resources.Requirement.parse('foo>=1.9')
+        dist = pkg_resources.WorkingSet([env.paths['lib']]).find(req)
+        assert dist.version == version
+
+    @pytest.mark.parametrize(
+        ("unnormalized", "normalized"),
+        [
+            ('foo', 'foo'),
+            ('foo/', 'foo'),
+            ('foo/bar', 'foo/bar'),
+            ('foo/bar/', 'foo/bar'),
+        ],
+    )
+    def test_normalize_path_trailing_sep(self, unnormalized, normalized):
+        """Ensure the trailing slash is cleaned for path comparison.
+
+        See pypa/setuptools#1519.
+        """
+        result_from_unnormalized = pkg_resources.normalize_path(unnormalized)
+        result_from_normalized = pkg_resources.normalize_path(normalized)
+        assert result_from_unnormalized == result_from_normalized
+
+    @pytest.mark.skipif(
+        os.path.normcase('A') != os.path.normcase('a'),
+        reason='Testing case-insensitive filesystems.',
+    )
+    @pytest.mark.parametrize(
+        ("unnormalized", "normalized"),
+        [
+            ('MiXeD/CasE', 'mixed/case'),
+        ],
+    )
+    def test_normalize_path_normcase(self, unnormalized, normalized):
+        """Ensure mixed case is normalized on case-insensitive filesystems."""
+        result_from_unnormalized = pkg_resources.normalize_path(unnormalized)
+        result_from_normalized = pkg_resources.normalize_path(normalized)
+        assert result_from_unnormalized == result_from_normalized
+
+    @pytest.mark.skipif(
+        os.path.sep != '\\',
+        reason='Testing systems using backslashes as path separators.',
+    )
+    @pytest.mark.parametrize(
+        ("unnormalized", "expected"),
+        [
+            ('forward/slash', 'forward\\slash'),
+            ('forward/slash/', 'forward\\slash'),
+            ('backward\\slash\\', 'backward\\slash'),
+        ],
+    )
+    def test_normalize_path_backslash_sep(self, unnormalized, expected):
+        """Ensure path seps are cleaned on backslash path sep systems."""
+        result = pkg_resources.normalize_path(unnormalized)
+        assert result.endswith(expected)
+
+
+class TestWorkdirRequire:
+    def fake_site_packages(self, tmp_path, monkeypatch, dist_files):
+        site_packages = tmp_path / "site-packages"
+        site_packages.mkdir()
+        for file, content in self.FILES.items():
+            path = site_packages / file
+            path.parent.mkdir(exist_ok=True, parents=True)
+            path.write_text(inspect.cleandoc(content), encoding="utf-8")
+
+        monkeypatch.setattr(sys, "path", [site_packages])
+        return os.fspath(site_packages)
+
+    FILES = {
+        "pkg1_mod-1.2.3.dist-info/METADATA": """
+            Metadata-Version: 2.4
+            Name: pkg1.mod
+            Version: 1.2.3
+            """,
+        "pkg2.mod-0.42.dist-info/METADATA": """
+            Metadata-Version: 2.1
+            Name: pkg2.mod
+            Version: 0.42
+            """,
+        "pkg3_mod.egg-info/PKG-INFO": """
+            Name: pkg3.mod
+            Version: 1.2.3.4
+            """,
+        "pkg4.mod.egg-info/PKG-INFO": """
+            Name: pkg4.mod
+            Version: 0.42.1
+            """,
+    }
+
+    @pytest.mark.parametrize(
+        ("version", "requirement"),
+        [
+            ("1.2.3", "pkg1.mod>=1"),
+            ("0.42", "pkg2.mod>=0.4"),
+            ("1.2.3.4", "pkg3.mod<=2"),
+            ("0.42.1", "pkg4.mod>0.2,<1"),
+        ],
+    )
+    def test_require_non_normalised_name(
+        self, tmp_path, monkeypatch, version, requirement
+    ):
+        # https://github.com/pypa/setuptools/issues/4853
+        site_packages = self.fake_site_packages(tmp_path, monkeypatch, self.FILES)
+        ws = pkg_resources.WorkingSet([site_packages])
+
+        for req in [requirement, requirement.replace(".", "-")]:
+            [dist] = ws.require(req)
+            assert dist.version == version
+            assert os.path.samefile(
+                os.path.commonpath([dist.location, site_packages]), site_packages
+            )
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/test_resources.py b/venv/lib/python3.12/site-packages/pkg_resources/tests/test_resources.py
new file mode 100644
index 0000000..70436c0
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/tests/test_resources.py
@@ -0,0 +1,869 @@
+import itertools
+import os
+import platform
+import string
+import sys
+
+import pytest
+from packaging.specifiers import SpecifierSet
+
+import pkg_resources
+from pkg_resources import (
+    Distribution,
+    EntryPoint,
+    Requirement,
+    VersionConflict,
+    WorkingSet,
+    parse_requirements,
+    parse_version,
+    safe_name,
+    safe_version,
+)
+
+
+# from Python 3.6 docs. Available from itertools on Python 3.10
+def pairwise(iterable):
+    "s -> (s0,s1), (s1,s2), (s2, s3), ..."
+    a, b = itertools.tee(iterable)
+    next(b, None)
+    return zip(a, b)
+
+
+class Metadata(pkg_resources.EmptyProvider):
+    """Mock object to return metadata as if from an on-disk distribution"""
+
+    def __init__(self, *pairs) -> None:
+        self.metadata = dict(pairs)
+
+    def has_metadata(self, name) -> bool:
+        return name in self.metadata
+
+    def get_metadata(self, name):
+        return self.metadata[name]
+
+    def get_metadata_lines(self, name):
+        return pkg_resources.yield_lines(self.get_metadata(name))
+
+
+dist_from_fn = pkg_resources.Distribution.from_filename
+
+
+class TestDistro:
+    def testCollection(self):
+        # empty path should produce no distributions
+        ad = pkg_resources.Environment([], platform=None, python=None)
+        assert list(ad) == []
+        assert ad['FooPkg'] == []
+        ad.add(dist_from_fn("FooPkg-1.3_1.egg"))
+        ad.add(dist_from_fn("FooPkg-1.4-py2.4-win32.egg"))
+        ad.add(dist_from_fn("FooPkg-1.2-py2.4.egg"))
+
+        # Name is in there now
+        assert ad['FooPkg']
+        # But only 1 package
+        assert list(ad) == ['foopkg']
+
+        # Distributions sort by version
+        expected = ['1.4', '1.3-1', '1.2']
+        assert [dist.version for dist in ad['FooPkg']] == expected
+
+        # Removing a distribution leaves sequence alone
+        ad.remove(ad['FooPkg'][1])
+        assert [dist.version for dist in ad['FooPkg']] == ['1.4', '1.2']
+
+        # And inserting adds them in order
+        ad.add(dist_from_fn("FooPkg-1.9.egg"))
+        assert [dist.version for dist in ad['FooPkg']] == ['1.9', '1.4', '1.2']
+
+        ws = WorkingSet([])
+        foo12 = dist_from_fn("FooPkg-1.2-py2.4.egg")
+        foo14 = dist_from_fn("FooPkg-1.4-py2.4-win32.egg")
+        (req,) = parse_requirements("FooPkg>=1.3")
+
+        # Nominal case: no distros on path, should yield all applicable
+        assert ad.best_match(req, ws).version == '1.9'
+        # If a matching distro is already installed, should return only that
+        ws.add(foo14)
+        assert ad.best_match(req, ws).version == '1.4'
+
+        # If the first matching distro is unsuitable, it's a version conflict
+        ws = WorkingSet([])
+        ws.add(foo12)
+        ws.add(foo14)
+        with pytest.raises(VersionConflict):
+            ad.best_match(req, ws)
+
+        # If more than one match on the path, the first one takes precedence
+        ws = WorkingSet([])
+        ws.add(foo14)
+        ws.add(foo12)
+        ws.add(foo14)
+        assert ad.best_match(req, ws).version == '1.4'
+
+    def checkFooPkg(self, d):
+        assert d.project_name == "FooPkg"
+        assert d.key == "foopkg"
+        assert d.version == "1.3.post1"
+        assert d.py_version == "2.4"
+        assert d.platform == "win32"
+        assert d.parsed_version == parse_version("1.3-1")
+
+    def testDistroBasics(self):
+        d = Distribution(
+            "/some/path",
+            project_name="FooPkg",
+            version="1.3-1",
+            py_version="2.4",
+            platform="win32",
+        )
+        self.checkFooPkg(d)
+
+        d = Distribution("/some/path")
+        assert d.py_version == f'{sys.version_info.major}.{sys.version_info.minor}'
+        assert d.platform is None
+
+    def testDistroParse(self):
+        d = dist_from_fn("FooPkg-1.3.post1-py2.4-win32.egg")
+        self.checkFooPkg(d)
+        d = dist_from_fn("FooPkg-1.3.post1-py2.4-win32.egg-info")
+        self.checkFooPkg(d)
+
+    def testDistroMetadata(self):
+        d = Distribution(
+            "/some/path",
+            project_name="FooPkg",
+            py_version="2.4",
+            platform="win32",
+            metadata=Metadata(('PKG-INFO', "Metadata-Version: 1.0\nVersion: 1.3-1\n")),
+        )
+        self.checkFooPkg(d)
+
+    def distRequires(self, txt):
+        return Distribution("/foo", metadata=Metadata(('depends.txt', txt)))
+
+    def checkRequires(self, dist, txt, extras=()):
+        assert list(dist.requires(extras)) == list(parse_requirements(txt))
+
+    def testDistroDependsSimple(self):
+        for v in "Twisted>=1.5", "Twisted>=1.5\nZConfig>=2.0":
+            self.checkRequires(self.distRequires(v), v)
+
+    needs_object_dir = pytest.mark.skipif(
+        not hasattr(object, '__dir__'),
+        reason='object.__dir__ necessary for self.__dir__ implementation',
+    )
+
+    def test_distribution_dir(self):
+        d = pkg_resources.Distribution()
+        dir(d)
+
+    @needs_object_dir
+    def test_distribution_dir_includes_provider_dir(self):
+        d = pkg_resources.Distribution()
+        before = d.__dir__()
+        assert 'test_attr' not in before
+        d._provider.test_attr = None
+        after = d.__dir__()
+        assert len(after) == len(before) + 1
+        assert 'test_attr' in after
+
+    @needs_object_dir
+    def test_distribution_dir_ignores_provider_dir_leading_underscore(self):
+        d = pkg_resources.Distribution()
+        before = d.__dir__()
+        assert '_test_attr' not in before
+        d._provider._test_attr = None
+        after = d.__dir__()
+        assert len(after) == len(before)
+        assert '_test_attr' not in after
+
+    def testResolve(self):
+        ad = pkg_resources.Environment([])
+        ws = WorkingSet([])
+        # Resolving no requirements -> nothing to install
+        assert list(ws.resolve([], ad)) == []
+        # Request something not in the collection -> DistributionNotFound
+        with pytest.raises(pkg_resources.DistributionNotFound):
+            ws.resolve(parse_requirements("Foo"), ad)
+
+        Foo = Distribution.from_filename(
+            "/foo_dir/Foo-1.2.egg",
+            metadata=Metadata(('depends.txt', "[bar]\nBaz>=2.0")),
+        )
+        ad.add(Foo)
+        ad.add(Distribution.from_filename("Foo-0.9.egg"))
+
+        # Request thing(s) that are available -> list to activate
+        for i in range(3):
+            targets = list(ws.resolve(parse_requirements("Foo"), ad))
+            assert targets == [Foo]
+            list(map(ws.add, targets))
+        with pytest.raises(VersionConflict):
+            ws.resolve(parse_requirements("Foo==0.9"), ad)
+        ws = WorkingSet([])  # reset
+
+        # Request an extra that causes an unresolved dependency for "Baz"
+        with pytest.raises(pkg_resources.DistributionNotFound):
+            ws.resolve(parse_requirements("Foo[bar]"), ad)
+        Baz = Distribution.from_filename(
+            "/foo_dir/Baz-2.1.egg", metadata=Metadata(('depends.txt', "Foo"))
+        )
+        ad.add(Baz)
+
+        # Activation list now includes resolved dependency
+        assert list(ws.resolve(parse_requirements("Foo[bar]"), ad)) == [Foo, Baz]
+        # Requests for conflicting versions produce VersionConflict
+        with pytest.raises(VersionConflict) as vc:
+            ws.resolve(parse_requirements("Foo==1.2\nFoo!=1.2"), ad)
+
+        msg = 'Foo 0.9 is installed but Foo==1.2 is required'
+        assert vc.value.report() == msg
+
+    def test_environment_marker_evaluation_negative(self):
+        """Environment markers are evaluated at resolution time."""
+        ad = pkg_resources.Environment([])
+        ws = WorkingSet([])
+        res = ws.resolve(parse_requirements("Foo;python_version<'2'"), ad)
+        assert list(res) == []
+
+    def test_environment_marker_evaluation_positive(self):
+        ad = pkg_resources.Environment([])
+        ws = WorkingSet([])
+        Foo = Distribution.from_filename("/foo_dir/Foo-1.2.dist-info")
+        ad.add(Foo)
+        res = ws.resolve(parse_requirements("Foo;python_version>='2'"), ad)
+        assert list(res) == [Foo]
+
+    def test_environment_marker_evaluation_called(self):
+        """
+        If one package foo requires bar without any extras,
+        markers should pass for bar without extras.
+        """
+        (parent_req,) = parse_requirements("foo")
+        (req,) = parse_requirements("bar;python_version>='2'")
+        req_extras = pkg_resources._ReqExtras({req: parent_req.extras})
+        assert req_extras.markers_pass(req)
+
+        (parent_req,) = parse_requirements("foo[]")
+        (req,) = parse_requirements("bar;python_version>='2'")
+        req_extras = pkg_resources._ReqExtras({req: parent_req.extras})
+        assert req_extras.markers_pass(req)
+
+    def test_marker_evaluation_with_extras(self):
+        """Extras are also evaluated as markers at resolution time."""
+        ad = pkg_resources.Environment([])
+        ws = WorkingSet([])
+        Foo = Distribution.from_filename(
+            "/foo_dir/Foo-1.2.dist-info",
+            metadata=Metadata((
+                "METADATA",
+                "Provides-Extra: baz\nRequires-Dist: quux; extra=='baz'",
+            )),
+        )
+        ad.add(Foo)
+        assert list(ws.resolve(parse_requirements("Foo"), ad)) == [Foo]
+        quux = Distribution.from_filename("/foo_dir/quux-1.0.dist-info")
+        ad.add(quux)
+        res = list(ws.resolve(parse_requirements("Foo[baz]"), ad))
+        assert res == [Foo, quux]
+
+    def test_marker_evaluation_with_extras_normlized(self):
+        """Extras are also evaluated as markers at resolution time."""
+        ad = pkg_resources.Environment([])
+        ws = WorkingSet([])
+        Foo = Distribution.from_filename(
+            "/foo_dir/Foo-1.2.dist-info",
+            metadata=Metadata((
+                "METADATA",
+                "Provides-Extra: baz-lightyear\n"
+                "Requires-Dist: quux; extra=='baz-lightyear'",
+            )),
+        )
+        ad.add(Foo)
+        assert list(ws.resolve(parse_requirements("Foo"), ad)) == [Foo]
+        quux = Distribution.from_filename("/foo_dir/quux-1.0.dist-info")
+        ad.add(quux)
+        res = list(ws.resolve(parse_requirements("Foo[baz-lightyear]"), ad))
+        assert res == [Foo, quux]
+
+    def test_marker_evaluation_with_multiple_extras(self):
+        ad = pkg_resources.Environment([])
+        ws = WorkingSet([])
+        Foo = Distribution.from_filename(
+            "/foo_dir/Foo-1.2.dist-info",
+            metadata=Metadata((
+                "METADATA",
+                "Provides-Extra: baz\n"
+                "Requires-Dist: quux; extra=='baz'\n"
+                "Provides-Extra: bar\n"
+                "Requires-Dist: fred; extra=='bar'\n",
+            )),
+        )
+        ad.add(Foo)
+        quux = Distribution.from_filename("/foo_dir/quux-1.0.dist-info")
+        ad.add(quux)
+        fred = Distribution.from_filename("/foo_dir/fred-0.1.dist-info")
+        ad.add(fred)
+        res = list(ws.resolve(parse_requirements("Foo[baz,bar]"), ad))
+        assert sorted(res) == [fred, quux, Foo]
+
+    def test_marker_evaluation_with_extras_loop(self):
+        ad = pkg_resources.Environment([])
+        ws = WorkingSet([])
+        a = Distribution.from_filename(
+            "/foo_dir/a-0.2.dist-info",
+            metadata=Metadata(("METADATA", "Requires-Dist: c[a]")),
+        )
+        b = Distribution.from_filename(
+            "/foo_dir/b-0.3.dist-info",
+            metadata=Metadata(("METADATA", "Requires-Dist: c[b]")),
+        )
+        c = Distribution.from_filename(
+            "/foo_dir/c-1.0.dist-info",
+            metadata=Metadata((
+                "METADATA",
+                "Provides-Extra: a\n"
+                "Requires-Dist: b;extra=='a'\n"
+                "Provides-Extra: b\n"
+                "Requires-Dist: foo;extra=='b'",
+            )),
+        )
+        foo = Distribution.from_filename("/foo_dir/foo-0.1.dist-info")
+        for dist in (a, b, c, foo):
+            ad.add(dist)
+        res = list(ws.resolve(parse_requirements("a"), ad))
+        assert res == [a, c, b, foo]
+
+    @pytest.mark.xfail(
+        sys.version_info[:2] == (3, 12) and sys.version_info.releaselevel != 'final',
+        reason="https://github.com/python/cpython/issues/103632",
+    )
+    def testDistroDependsOptions(self):
+        d = self.distRequires(
+            """
+            Twisted>=1.5
+            [docgen]
+            ZConfig>=2.0
+            docutils>=0.3
+            [fastcgi]
+            fcgiapp>=0.1"""
+        )
+        self.checkRequires(d, "Twisted>=1.5")
+        self.checkRequires(
+            d, "Twisted>=1.5 ZConfig>=2.0 docutils>=0.3".split(), ["docgen"]
+        )
+        self.checkRequires(d, "Twisted>=1.5 fcgiapp>=0.1".split(), ["fastcgi"])
+        self.checkRequires(
+            d,
+            "Twisted>=1.5 ZConfig>=2.0 docutils>=0.3 fcgiapp>=0.1".split(),
+            ["docgen", "fastcgi"],
+        )
+        self.checkRequires(
+            d,
+            "Twisted>=1.5 fcgiapp>=0.1 ZConfig>=2.0 docutils>=0.3".split(),
+            ["fastcgi", "docgen"],
+        )
+        with pytest.raises(pkg_resources.UnknownExtra):
+            d.requires(["foo"])
+
+
+class TestWorkingSet:
+    def test_find_conflicting(self):
+        ws = WorkingSet([])
+        Foo = Distribution.from_filename("/foo_dir/Foo-1.2.egg")
+        ws.add(Foo)
+
+        # create a requirement that conflicts with Foo 1.2
+        req = next(parse_requirements("Foo<1.2"))
+
+        with pytest.raises(VersionConflict) as vc:
+            ws.find(req)
+
+        msg = 'Foo 1.2 is installed but Foo<1.2 is required'
+        assert vc.value.report() == msg
+
+    def test_resolve_conflicts_with_prior(self):
+        """
+        A ContextualVersionConflict should be raised when a requirement
+        conflicts with a prior requirement for a different package.
+        """
+        # Create installation where Foo depends on Baz 1.0 and Bar depends on
+        # Baz 2.0.
+        ws = WorkingSet([])
+        md = Metadata(('depends.txt', "Baz==1.0"))
+        Foo = Distribution.from_filename("/foo_dir/Foo-1.0.egg", metadata=md)
+        ws.add(Foo)
+        md = Metadata(('depends.txt', "Baz==2.0"))
+        Bar = Distribution.from_filename("/foo_dir/Bar-1.0.egg", metadata=md)
+        ws.add(Bar)
+        Baz = Distribution.from_filename("/foo_dir/Baz-1.0.egg")
+        ws.add(Baz)
+        Baz = Distribution.from_filename("/foo_dir/Baz-2.0.egg")
+        ws.add(Baz)
+
+        with pytest.raises(VersionConflict) as vc:
+            ws.resolve(parse_requirements("Foo\nBar\n"))
+
+        msg = "Baz 1.0 is installed but Baz==2.0 is required by "
+        msg += repr(set(['Bar']))
+        assert vc.value.report() == msg
+
+
+class TestEntryPoints:
+    def assertfields(self, ep):
+        assert ep.name == "foo"
+        assert ep.module_name == "pkg_resources.tests.test_resources"
+        assert ep.attrs == ("TestEntryPoints",)
+        assert ep.extras == ("x",)
+        assert ep.load() is TestEntryPoints
+        expect = "foo = pkg_resources.tests.test_resources:TestEntryPoints [x]"
+        assert str(ep) == expect
+
+    def setup_method(self, method):
+        self.dist = Distribution.from_filename(
+            "FooPkg-1.2-py2.4.egg", metadata=Metadata(('requires.txt', '[x]'))
+        )
+
+    def testBasics(self):
+        ep = EntryPoint(
+            "foo",
+            "pkg_resources.tests.test_resources",
+            ["TestEntryPoints"],
+            ["x"],
+            self.dist,
+        )
+        self.assertfields(ep)
+
+    def testParse(self):
+        s = "foo = pkg_resources.tests.test_resources:TestEntryPoints [x]"
+        ep = EntryPoint.parse(s, self.dist)
+        self.assertfields(ep)
+
+        ep = EntryPoint.parse("bar baz=  spammity[PING]")
+        assert ep.name == "bar baz"
+        assert ep.module_name == "spammity"
+        assert ep.attrs == ()
+        assert ep.extras == ("ping",)
+
+        ep = EntryPoint.parse(" fizzly =  wocka:foo")
+        assert ep.name == "fizzly"
+        assert ep.module_name == "wocka"
+        assert ep.attrs == ("foo",)
+        assert ep.extras == ()
+
+        # plus in the name
+        spec = "html+mako = mako.ext.pygmentplugin:MakoHtmlLexer"
+        ep = EntryPoint.parse(spec)
+        assert ep.name == 'html+mako'
+
+    reject_specs = "foo", "x=a:b:c", "q=x/na", "fez=pish:tush-z", "x=f[a]>2"
+
+    @pytest.mark.parametrize("reject_spec", reject_specs)
+    def test_reject_spec(self, reject_spec):
+        with pytest.raises(ValueError):
+            EntryPoint.parse(reject_spec)
+
+    def test_printable_name(self):
+        """
+        Allow any printable character in the name.
+        """
+        # Create a name with all printable characters; strip the whitespace.
+        name = string.printable.strip()
+        spec = "{name} = module:attr".format(**locals())
+        ep = EntryPoint.parse(spec)
+        assert ep.name == name
+
+    def checkSubMap(self, m):
+        assert len(m) == len(self.submap_expect)
+        for key, ep in self.submap_expect.items():
+            assert m.get(key).name == ep.name
+            assert m.get(key).module_name == ep.module_name
+            assert sorted(m.get(key).attrs) == sorted(ep.attrs)
+            assert sorted(m.get(key).extras) == sorted(ep.extras)
+
+    submap_expect = dict(
+        feature1=EntryPoint('feature1', 'somemodule', ['somefunction']),
+        feature2=EntryPoint(
+            'feature2', 'another.module', ['SomeClass'], ['extra1', 'extra2']
+        ),
+        feature3=EntryPoint('feature3', 'this.module', extras=['something']),
+    )
+    submap_str = """
+            # define features for blah blah
+            feature1 = somemodule:somefunction
+            feature2 = another.module:SomeClass [extra1,extra2]
+            feature3 = this.module [something]
+    """
+
+    def testParseList(self):
+        self.checkSubMap(EntryPoint.parse_group("xyz", self.submap_str))
+        with pytest.raises(ValueError):
+            EntryPoint.parse_group("x a", "foo=bar")
+        with pytest.raises(ValueError):
+            EntryPoint.parse_group("x", ["foo=baz", "foo=bar"])
+
+    def testParseMap(self):
+        m = EntryPoint.parse_map({'xyz': self.submap_str})
+        self.checkSubMap(m['xyz'])
+        assert list(m.keys()) == ['xyz']
+        m = EntryPoint.parse_map("[xyz]\n" + self.submap_str)
+        self.checkSubMap(m['xyz'])
+        assert list(m.keys()) == ['xyz']
+        with pytest.raises(ValueError):
+            EntryPoint.parse_map(["[xyz]", "[xyz]"])
+        with pytest.raises(ValueError):
+            EntryPoint.parse_map(self.submap_str)
+
+    def testDeprecationWarnings(self):
+        ep = EntryPoint(
+            "foo", "pkg_resources.tests.test_resources", ["TestEntryPoints"], ["x"]
+        )
+        with pytest.warns(pkg_resources.PkgResourcesDeprecationWarning):
+            ep.load(require=False)
+
+
+class TestRequirements:
+    def testBasics(self):
+        r = Requirement.parse("Twisted>=1.2")
+        assert str(r) == "Twisted>=1.2"
+        assert repr(r) == "Requirement.parse('Twisted>=1.2')"
+        assert r == Requirement("Twisted>=1.2")
+        assert r == Requirement("twisTed>=1.2")
+        assert r != Requirement("Twisted>=2.0")
+        assert r != Requirement("Zope>=1.2")
+        assert r != Requirement("Zope>=3.0")
+        assert r != Requirement("Twisted[extras]>=1.2")
+
+    def testOrdering(self):
+        r1 = Requirement("Twisted==1.2c1,>=1.2")
+        r2 = Requirement("Twisted>=1.2,==1.2c1")
+        assert r1 == r2
+        assert str(r1) == str(r2)
+        assert str(r2) == "Twisted==1.2c1,>=1.2"
+        assert Requirement("Twisted") != Requirement(
+            "Twisted @ https://localhost/twisted.zip"
+        )
+
+    def testBasicContains(self):
+        r = Requirement("Twisted>=1.2")
+        foo_dist = Distribution.from_filename("FooPkg-1.3_1.egg")
+        twist11 = Distribution.from_filename("Twisted-1.1.egg")
+        twist12 = Distribution.from_filename("Twisted-1.2.egg")
+        assert parse_version('1.2') in r
+        assert parse_version('1.1') not in r
+        assert '1.2' in r
+        assert '1.1' not in r
+        assert foo_dist not in r
+        assert twist11 not in r
+        assert twist12 in r
+
+    def testOptionsAndHashing(self):
+        r1 = Requirement.parse("Twisted[foo,bar]>=1.2")
+        r2 = Requirement.parse("Twisted[bar,FOO]>=1.2")
+        assert r1 == r2
+        assert set(r1.extras) == set(("foo", "bar"))
+        assert set(r2.extras) == set(("foo", "bar"))
+        assert hash(r1) == hash(r2)
+        assert hash(r1) == hash((
+            "twisted",
+            None,
+            SpecifierSet(">=1.2"),
+            frozenset(["foo", "bar"]),
+            None,
+        ))
+        assert hash(
+            Requirement.parse("Twisted @ https://localhost/twisted.zip")
+        ) == hash((
+            "twisted",
+            "https://localhost/twisted.zip",
+            SpecifierSet(),
+            frozenset(),
+            None,
+        ))
+
+    def testVersionEquality(self):
+        r1 = Requirement.parse("foo==0.3a2")
+        r2 = Requirement.parse("foo!=0.3a4")
+        d = Distribution.from_filename
+
+        assert d("foo-0.3a4.egg") not in r1
+        assert d("foo-0.3a1.egg") not in r1
+        assert d("foo-0.3a4.egg") not in r2
+
+        assert d("foo-0.3a2.egg") in r1
+        assert d("foo-0.3a2.egg") in r2
+        assert d("foo-0.3a3.egg") in r2
+        assert d("foo-0.3a5.egg") in r2
+
+    def testSetuptoolsProjectName(self):
+        """
+        The setuptools project should implement the setuptools package.
+        """
+
+        assert Requirement.parse('setuptools').project_name == 'setuptools'
+        # setuptools 0.7 and higher means setuptools.
+        assert Requirement.parse('setuptools == 0.7').project_name == 'setuptools'
+        assert Requirement.parse('setuptools == 0.7a1').project_name == 'setuptools'
+        assert Requirement.parse('setuptools >= 0.7').project_name == 'setuptools'
+
+
+class TestParsing:
+    def testEmptyParse(self):
+        assert list(parse_requirements('')) == []
+
+    def testYielding(self):
+        for inp, out in [
+            ([], []),
+            ('x', ['x']),
+            ([[]], []),
+            (' x\n y', ['x', 'y']),
+            (['x\n\n', 'y'], ['x', 'y']),
+        ]:
+            assert list(pkg_resources.yield_lines(inp)) == out
+
+    def testSplitting(self):
+        sample = """
+                    x
+                    [Y]
+                    z
+
+                    a
+                    [b ]
+                    # foo
+                    c
+                    [ d]
+                    [q]
+                    v
+                    """
+        assert list(pkg_resources.split_sections(sample)) == [
+            (None, ["x"]),
+            ("Y", ["z", "a"]),
+            ("b", ["c"]),
+            ("d", []),
+            ("q", ["v"]),
+        ]
+        with pytest.raises(ValueError):
+            list(pkg_resources.split_sections("[foo"))
+
+    def testSafeName(self):
+        assert safe_name("adns-python") == "adns-python"
+        assert safe_name("WSGI Utils") == "WSGI-Utils"
+        assert safe_name("WSGI  Utils") == "WSGI-Utils"
+        assert safe_name("Money$$$Maker") == "Money-Maker"
+        assert safe_name("peak.web") != "peak-web"
+
+    def testSafeVersion(self):
+        assert safe_version("1.2-1") == "1.2.post1"
+        assert safe_version("1.2 alpha") == "1.2.alpha"
+        assert safe_version("2.3.4 20050521") == "2.3.4.20050521"
+        assert safe_version("Money$$$Maker") == "Money-Maker"
+        assert safe_version("peak.web") == "peak.web"
+
+    def testSimpleRequirements(self):
+        assert list(parse_requirements('Twis-Ted>=1.2-1')) == [
+            Requirement('Twis-Ted>=1.2-1')
+        ]
+        assert list(parse_requirements('Twisted >=1.2, \\ # more\n<2.0')) == [
+            Requirement('Twisted>=1.2,<2.0')
+        ]
+        assert Requirement.parse("FooBar==1.99a3") == Requirement("FooBar==1.99a3")
+        with pytest.raises(ValueError):
+            Requirement.parse(">=2.3")
+        with pytest.raises(ValueError):
+            Requirement.parse("x\\")
+        with pytest.raises(ValueError):
+            Requirement.parse("x==2 q")
+        with pytest.raises(ValueError):
+            Requirement.parse("X==1\nY==2")
+        with pytest.raises(ValueError):
+            Requirement.parse("#")
+
+    def test_requirements_with_markers(self):
+        assert Requirement.parse("foobar;os_name=='a'") == Requirement.parse(
+            "foobar;os_name=='a'"
+        )
+        assert Requirement.parse(
+            "name==1.1;python_version=='2.7'"
+        ) != Requirement.parse("name==1.1;python_version=='3.6'")
+        assert Requirement.parse(
+            "name==1.0;python_version=='2.7'"
+        ) != Requirement.parse("name==1.2;python_version=='2.7'")
+        assert Requirement.parse(
+            "name[foo]==1.0;python_version=='3.6'"
+        ) != Requirement.parse("name[foo,bar]==1.0;python_version=='3.6'")
+
+    def test_local_version(self):
+        parse_requirements('foo==1.0+org1')
+
+    def test_spaces_between_multiple_versions(self):
+        parse_requirements('foo>=1.0, <3')
+        parse_requirements('foo >= 1.0, < 3')
+
+    @pytest.mark.parametrize(
+        ("lower", "upper"),
+        [
+            ('1.2-rc1', '1.2rc1'),
+            ('0.4', '0.4.0'),
+            ('0.4.0.0', '0.4.0'),
+            ('0.4.0-0', '0.4-0'),
+            ('0post1', '0.0post1'),
+            ('0pre1', '0.0c1'),
+            ('0.0.0preview1', '0c1'),
+            ('0.0c1', '0-rc1'),
+            ('1.2a1', '1.2.a.1'),
+            ('1.2.a', '1.2a'),
+        ],
+    )
+    def testVersionEquality(self, lower, upper):
+        assert parse_version(lower) == parse_version(upper)
+
+    torture = """
+        0.80.1-3 0.80.1-2 0.80.1-1 0.79.9999+0.80.0pre4-1
+        0.79.9999+0.80.0pre2-3 0.79.9999+0.80.0pre2-2
+        0.77.2-1 0.77.1-1 0.77.0-1
+        """
+
+    @pytest.mark.parametrize(
+        ("lower", "upper"),
+        [
+            ('2.1', '2.1.1'),
+            ('2a1', '2b0'),
+            ('2a1', '2.1'),
+            ('2.3a1', '2.3'),
+            ('2.1-1', '2.1-2'),
+            ('2.1-1', '2.1.1'),
+            ('2.1', '2.1post4'),
+            ('2.1a0-20040501', '2.1'),
+            ('1.1', '02.1'),
+            ('3.2', '3.2.post0'),
+            ('3.2post1', '3.2post2'),
+            ('0.4', '4.0'),
+            ('0.0.4', '0.4.0'),
+            ('0post1', '0.4post1'),
+            ('2.1.0-rc1', '2.1.0'),
+            ('2.1dev', '2.1a0'),
+        ]
+        + list(pairwise(reversed(torture.split()))),
+    )
+    def testVersionOrdering(self, lower, upper):
+        assert parse_version(lower) < parse_version(upper)
+
+    def testVersionHashable(self):
+        """
+        Ensure that our versions stay hashable even though we've subclassed
+        them and added some shim code to them.
+        """
+        assert hash(parse_version("1.0")) == hash(parse_version("1.0"))
+
+
+class TestNamespaces:
+    ns_str = "__import__('pkg_resources').declare_namespace(__name__)\n"
+
+    @pytest.fixture
+    def symlinked_tmpdir(self, tmpdir):
+        """
+        Where available, return the tempdir as a symlink,
+        which as revealed in #231 is more fragile than
+        a natural tempdir.
+        """
+        if not hasattr(os, 'symlink'):
+            yield str(tmpdir)
+            return
+
+        link_name = str(tmpdir) + '-linked'
+        os.symlink(str(tmpdir), link_name)
+        try:
+            yield type(tmpdir)(link_name)
+        finally:
+            os.unlink(link_name)
+
+    @pytest.fixture(autouse=True)
+    def patched_path(self, tmpdir):
+        """
+        Patch sys.path to include the 'site-pkgs' dir. Also
+        restore pkg_resources._namespace_packages to its
+        former state.
+        """
+        saved_ns_pkgs = pkg_resources._namespace_packages.copy()
+        saved_sys_path = sys.path[:]
+        site_pkgs = tmpdir.mkdir('site-pkgs')
+        sys.path.append(str(site_pkgs))
+        try:
+            yield
+        finally:
+            pkg_resources._namespace_packages = saved_ns_pkgs
+            sys.path = saved_sys_path
+
+    issue591 = pytest.mark.xfail(platform.system() == 'Windows', reason="#591")
+
+    @issue591
+    def test_two_levels_deep(self, symlinked_tmpdir):
+        """
+        Test nested namespace packages
+        Create namespace packages in the following tree :
+            site-packages-1/pkg1/pkg2
+            site-packages-2/pkg1/pkg2
+        Check both are in the _namespace_packages dict and that their __path__
+        is correct
+        """
+        real_tmpdir = symlinked_tmpdir.realpath()
+        tmpdir = symlinked_tmpdir
+        sys.path.append(str(tmpdir / 'site-pkgs2'))
+        site_dirs = tmpdir / 'site-pkgs', tmpdir / 'site-pkgs2'
+        for site in site_dirs:
+            pkg1 = site / 'pkg1'
+            pkg2 = pkg1 / 'pkg2'
+            pkg2.ensure_dir()
+            (pkg1 / '__init__.py').write_text(self.ns_str, encoding='utf-8')
+            (pkg2 / '__init__.py').write_text(self.ns_str, encoding='utf-8')
+        with pytest.warns(DeprecationWarning, match="pkg_resources.declare_namespace"):
+            import pkg1  # pyright: ignore[reportMissingImports] # Temporary package for test
+        assert "pkg1" in pkg_resources._namespace_packages
+        # attempt to import pkg2 from site-pkgs2
+        with pytest.warns(DeprecationWarning, match="pkg_resources.declare_namespace"):
+            import pkg1.pkg2  # pyright: ignore[reportMissingImports] # Temporary package for test
+        # check the _namespace_packages dict
+        assert "pkg1.pkg2" in pkg_resources._namespace_packages
+        assert pkg_resources._namespace_packages["pkg1"] == ["pkg1.pkg2"]
+        # check the __path__ attribute contains both paths
+        expected = [
+            str(real_tmpdir / "site-pkgs" / "pkg1" / "pkg2"),
+            str(real_tmpdir / "site-pkgs2" / "pkg1" / "pkg2"),
+        ]
+        assert pkg1.pkg2.__path__ == expected
+
+    @issue591
+    def test_path_order(self, symlinked_tmpdir):
+        """
+        Test that if multiple versions of the same namespace package subpackage
+        are on different sys.path entries, that only the one earliest on
+        sys.path is imported, and that the namespace package's __path__ is in
+        the correct order.
+
+        Regression test for https://github.com/pypa/setuptools/issues/207
+        """
+
+        tmpdir = symlinked_tmpdir
+        site_dirs = (
+            tmpdir / "site-pkgs",
+            tmpdir / "site-pkgs2",
+            tmpdir / "site-pkgs3",
+        )
+
+        vers_str = "__version__ = %r"
+
+        for number, site in enumerate(site_dirs, 1):
+            if number > 1:
+                sys.path.append(str(site))
+            nspkg = site / 'nspkg'
+            subpkg = nspkg / 'subpkg'
+            subpkg.ensure_dir()
+            (nspkg / '__init__.py').write_text(self.ns_str, encoding='utf-8')
+            (subpkg / '__init__.py').write_text(vers_str % number, encoding='utf-8')
+
+        with pytest.warns(DeprecationWarning, match="pkg_resources.declare_namespace"):
+            import nspkg  # pyright: ignore[reportMissingImports] # Temporary package for test
+            import nspkg.subpkg  # pyright: ignore[reportMissingImports] # Temporary package for test
+        expected = [str(site.realpath() / 'nspkg') for site in site_dirs]
+        assert nspkg.__path__ == expected
+        assert nspkg.subpkg.__version__ == 1
diff --git a/venv/lib/python3.12/site-packages/pkg_resources/tests/test_working_set.py b/venv/lib/python3.12/site-packages/pkg_resources/tests/test_working_set.py
new file mode 100644
index 0000000..ed20c59
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pkg_resources/tests/test_working_set.py
@@ -0,0 +1,505 @@
+import functools
+import inspect
+import re
+import textwrap
+
+import pytest
+
+import pkg_resources
+
+from .test_resources import Metadata
+
+
+def strip_comments(s):
+    return '\n'.join(
+        line
+        for line in s.split('\n')
+        if line.strip() and not line.strip().startswith('#')
+    )
+
+
+def parse_distributions(s):
+    """
+    Parse a series of distribution specs of the form:
+    {project_name}-{version}
+       [optional, indented requirements specification]
+
+    Example:
+
+        foo-0.2
+        bar-1.0
+          foo>=3.0
+          [feature]
+          baz
+
+    yield 2 distributions:
+        - project_name=foo, version=0.2
+        - project_name=bar, version=1.0,
+          requires=['foo>=3.0', 'baz; extra=="feature"']
+    """
+    s = s.strip()
+    for spec in re.split(r'\n(?=[^\s])', s):
+        if not spec:
+            continue
+        fields = spec.split('\n', 1)
+        assert 1 <= len(fields) <= 2
+        name, version = fields.pop(0).rsplit('-', 1)
+        if fields:
+            requires = textwrap.dedent(fields.pop(0))
+            metadata = Metadata(('requires.txt', requires))
+        else:
+            metadata = None
+        dist = pkg_resources.Distribution(
+            project_name=name, version=version, metadata=metadata
+        )
+        yield dist
+
+
+class FakeInstaller:
+    def __init__(self, installable_dists) -> None:
+        self._installable_dists = installable_dists
+
+    def __call__(self, req):
+        return next(
+            iter(filter(lambda dist: dist in req, self._installable_dists)), None
+        )
+
+
+def parametrize_test_working_set_resolve(*test_list):
+    idlist = []
+    argvalues = []
+    for test in test_list:
+        (
+            name,
+            installed_dists,
+            installable_dists,
+            requirements,
+            expected1,
+            expected2,
+        ) = (
+            strip_comments(s.lstrip())
+            for s in textwrap.dedent(test).lstrip().split('\n\n', 5)
+        )
+        installed_dists = list(parse_distributions(installed_dists))
+        installable_dists = list(parse_distributions(installable_dists))
+        requirements = list(pkg_resources.parse_requirements(requirements))
+        for id_, replace_conflicting, expected in (
+            (name, False, expected1),
+            (name + '_replace_conflicting', True, expected2),
+        ):
+            idlist.append(id_)
+            expected = strip_comments(expected.strip())
+            if re.match(r'\w+$', expected):
+                expected = getattr(pkg_resources, expected)
+                assert issubclass(expected, Exception)
+            else:
+                expected = list(parse_distributions(expected))
+            argvalues.append(
+                pytest.param(
+                    installed_dists,
+                    installable_dists,
+                    requirements,
+                    replace_conflicting,
+                    expected,
+                )
+            )
+    return pytest.mark.parametrize(
+        (
+            "installed_dists",
+            "installable_dists",
+            "requirements",
+            "replace_conflicting",
+            "resolved_dists_or_exception",
+        ),
+        argvalues,
+        ids=idlist,
+    )
+
+
+@parametrize_test_working_set_resolve(
+    """
+    # id
+    noop
+
+    # installed
+
+    # installable
+
+    # wanted
+
+    # resolved
+
+    # resolved [replace conflicting]
+    """,
+    """
+    # id
+    already_installed
+
+    # installed
+    foo-3.0
+
+    # installable
+
+    # wanted
+    foo>=2.1,!=3.1,<4
+
+    # resolved
+    foo-3.0
+
+    # resolved [replace conflicting]
+    foo-3.0
+    """,
+    """
+    # id
+    installable_not_installed
+
+    # installed
+
+    # installable
+    foo-3.0
+    foo-4.0
+
+    # wanted
+    foo>=2.1,!=3.1,<4
+
+    # resolved
+    foo-3.0
+
+    # resolved [replace conflicting]
+    foo-3.0
+    """,
+    """
+    # id
+    not_installable
+
+    # installed
+
+    # installable
+
+    # wanted
+    foo>=2.1,!=3.1,<4
+
+    # resolved
+    DistributionNotFound
+
+    # resolved [replace conflicting]
+    DistributionNotFound
+    """,
+    """
+    # id
+    no_matching_version
+
+    # installed
+
+    # installable
+    foo-3.1
+
+    # wanted
+    foo>=2.1,!=3.1,<4
+
+    # resolved
+    DistributionNotFound
+
+    # resolved [replace conflicting]
+    DistributionNotFound
+    """,
+    """
+    # id
+    installable_with_installed_conflict
+
+    # installed
+    foo-3.1
+
+    # installable
+    foo-3.5
+
+    # wanted
+    foo>=2.1,!=3.1,<4
+
+    # resolved
+    VersionConflict
+
+    # resolved [replace conflicting]
+    foo-3.5
+    """,
+    """
+    # id
+    not_installable_with_installed_conflict
+
+    # installed
+    foo-3.1
+
+    # installable
+
+    # wanted
+    foo>=2.1,!=3.1,<4
+
+    # resolved
+    VersionConflict
+
+    # resolved [replace conflicting]
+    DistributionNotFound
+    """,
+    """
+    # id
+    installed_with_installed_require
+
+    # installed
+    foo-3.9
+    baz-0.1
+        foo>=2.1,!=3.1,<4
+
+    # installable
+
+    # wanted
+    baz
+
+    # resolved
+    foo-3.9
+    baz-0.1
+
+    # resolved [replace conflicting]
+    foo-3.9
+    baz-0.1
+    """,
+    """
+    # id
+    installed_with_conflicting_installed_require
+
+    # installed
+    foo-5
+    baz-0.1
+        foo>=2.1,!=3.1,<4
+
+    # installable
+
+    # wanted
+    baz
+
+    # resolved
+    VersionConflict
+
+    # resolved [replace conflicting]
+    DistributionNotFound
+    """,
+    """
+    # id
+    installed_with_installable_conflicting_require
+
+    # installed
+    foo-5
+    baz-0.1
+        foo>=2.1,!=3.1,<4
+
+    # installable
+    foo-2.9
+
+    # wanted
+    baz
+
+    # resolved
+    VersionConflict
+
+    # resolved [replace conflicting]
+    baz-0.1
+    foo-2.9
+    """,
+    """
+    # id
+    installed_with_installable_require
+
+    # installed
+    baz-0.1
+        foo>=2.1,!=3.1,<4
+
+    # installable
+    foo-3.9
+
+    # wanted
+    baz
+
+    # resolved
+    foo-3.9
+    baz-0.1
+
+    # resolved [replace conflicting]
+    foo-3.9
+    baz-0.1
+    """,
+    """
+    # id
+    installable_with_installed_require
+
+    # installed
+    foo-3.9
+
+    # installable
+    baz-0.1
+        foo>=2.1,!=3.1,<4
+
+    # wanted
+    baz
+
+    # resolved
+    foo-3.9
+    baz-0.1
+
+    # resolved [replace conflicting]
+    foo-3.9
+    baz-0.1
+    """,
+    """
+    # id
+    installable_with_installable_require
+
+    # installed
+
+    # installable
+    foo-3.9
+    baz-0.1
+        foo>=2.1,!=3.1,<4
+
+    # wanted
+    baz
+
+    # resolved
+    foo-3.9
+    baz-0.1
+
+    # resolved [replace conflicting]
+    foo-3.9
+    baz-0.1
+    """,
+    """
+    # id
+    installable_with_conflicting_installable_require
+
+    # installed
+    foo-5
+
+    # installable
+    foo-2.9
+    baz-0.1
+        foo>=2.1,!=3.1,<4
+
+    # wanted
+    baz
+
+    # resolved
+    VersionConflict
+
+    # resolved [replace conflicting]
+    baz-0.1
+    foo-2.9
+    """,
+    """
+    # id
+    conflicting_installables
+
+    # installed
+
+    # installable
+    foo-2.9
+    foo-5.0
+
+    # wanted
+    foo>=2.1,!=3.1,<4
+    foo>=4
+
+    # resolved
+    VersionConflict
+
+    # resolved [replace conflicting]
+    VersionConflict
+    """,
+    """
+    # id
+    installables_with_conflicting_requires
+
+    # installed
+
+    # installable
+    foo-2.9
+        dep==1.0
+    baz-5.0
+        dep==2.0
+    dep-1.0
+    dep-2.0
+
+    # wanted
+    foo
+    baz
+
+    # resolved
+    VersionConflict
+
+    # resolved [replace conflicting]
+    VersionConflict
+    """,
+    """
+    # id
+    installables_with_conflicting_nested_requires
+
+    # installed
+
+    # installable
+    foo-2.9
+        dep1
+    dep1-1.0
+        subdep<1.0
+    baz-5.0
+        dep2
+    dep2-1.0
+        subdep>1.0
+    subdep-0.9
+    subdep-1.1
+
+    # wanted
+    foo
+    baz
+
+    # resolved
+    VersionConflict
+
+    # resolved [replace conflicting]
+    VersionConflict
+    """,
+    """
+    # id
+    wanted_normalized_name_installed_canonical
+
+    # installed
+    foo.bar-3.6
+
+    # installable
+
+    # wanted
+    foo-bar==3.6
+
+    # resolved
+    foo.bar-3.6
+
+    # resolved [replace conflicting]
+    foo.bar-3.6
+    """,
+)
+def test_working_set_resolve(
+    installed_dists,
+    installable_dists,
+    requirements,
+    replace_conflicting,
+    resolved_dists_or_exception,
+):
+    ws = pkg_resources.WorkingSet([])
+    list(map(ws.add, installed_dists))
+    resolve_call = functools.partial(
+        ws.resolve,
+        requirements,
+        installer=FakeInstaller(installable_dists),
+        replace_conflicting=replace_conflicting,
+    )
+    if inspect.isclass(resolved_dists_or_exception):
+        with pytest.raises(resolved_dists_or_exception):
+            resolve_call()
+    else:
+        assert sorted(resolve_call()) == sorted(resolved_dists_or_exception)
diff --git a/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/METADATA b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/METADATA
new file mode 100644
index 0000000..73244d5
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/METADATA
@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: pyinstaller
+Version: 6.17.0
+Summary: PyInstaller bundles a Python application and all its dependencies into a single package.
+Project-URL: Homepage, https://pyinstaller.org
+Project-URL: Documentation, https://pyinstaller.org
+Project-URL: Source Code, https://github.com/pyinstaller/pyinstaller
+Project-URL: Release Notes, https://pyinstaller.org/en/stable/CHANGES.html
+Author: Hartmut Goebel, Giovanni Bajo, David Vierra, David Cortesi, Martin Zibricky
+License: GPLv2-or-later with a special exception which allows to use PyInstaller to build and distribute non-free programs (including commercial ones)
+License-File: COPYING.txt
+Keywords: app,apps,bundle,convert,executable,packaging,standalone
+Classifier: Development Status :: 6 - Mature
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Other Audience
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
+Classifier: Natural Language :: English
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: POSIX :: AIX
+Classifier: Operating System :: POSIX :: BSD
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: POSIX :: SunOS/Solaris
+Classifier: Programming Language :: C
+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 :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Interpreters
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Installation/Setup
+Classifier: Topic :: System :: Software Distribution
+Classifier: Topic :: Utilities
+Requires-Python: <3.15,>=3.8
+Requires-Dist: altgraph
+Requires-Dist: importlib-metadata>=4.6; python_version < '3.10'
+Requires-Dist: macholib>=1.8; sys_platform == 'darwin'
+Requires-Dist: packaging>=22.0
+Requires-Dist: pefile>=2022.5.30; sys_platform == 'win32'
+Requires-Dist: pyinstaller-hooks-contrib>=2025.9
+Requires-Dist: pywin32-ctypes>=0.2.1; sys_platform == 'win32'
+Requires-Dist: setuptools>=42.0.0
+Provides-Extra: completion
+Requires-Dist: argcomplete; extra == 'completion'
+Provides-Extra: hook-testing
+Requires-Dist: execnet>=1.5.0; extra == 'hook-testing'
+Requires-Dist: psutil; extra == 'hook-testing'
+Requires-Dist: pytest>=2.7.3; extra == 'hook-testing'
+Description-Content-Type: text/x-rst
+
+PyInstaller Overview
+====================
+
+.. image:: https://img.shields.io/pypi/v/pyinstaller
+   :alt: PyPI
+   :target: https://pypi.org/project/pyinstaller
+.. image:: https://img.shields.io/pypi/pyversions/pyinstaller
+   :alt: PyPI - Python Version
+   :target: https://pypi.org/project/pyinstaller
+.. image:: https://img.shields.io/readthedocs/pyinstaller/stable
+   :alt: Read the Docs (version)
+   :target: https://pyinstaller.org
+.. image:: https://img.shields.io/pypi/dm/pyinstaller
+   :alt: PyPI - Downloads
+   :target: https://pypistats.org/packages/pyinstaller
+
+
+PyInstaller bundles a Python application and all its dependencies into a single
+package. The user can run the packaged app without installing a Python
+interpreter or any modules.
+
+:Documentation: https://pyinstaller.org/
+:Code:          https://github.com/pyinstaller/pyinstaller
+
+PyInstaller reads a Python script written by you. It analyzes your code
+to discover every other module and library your script needs in order to
+execute. Then it collects copies of all those files -- including the active
+Python interpreter! -- and puts them with your script in a single folder, or
+optionally in a single executable file.
+
+
+PyInstaller is tested against Windows, macOS, and GNU/Linux.
+However, it is not a cross-compiler:
+to make a Windows app you run PyInstaller in Windows; to make
+a GNU/Linux app you run it in GNU/Linux, etc.
+PyInstaller has been used successfully
+with AIX, Solaris, FreeBSD and OpenBSD,
+but is not tested against them as part of the continuous integration tests.
+
+
+Main Advantages
+---------------
+
+- Works out-of-the-box with any Python version 3.8-3.14.
+- Fully multi-platform, and uses the OS support to load the dynamic libraries,
+  thus ensuring full compatibility.
+- Correctly bundles the major Python packages such as numpy, PyQt5,
+  PySide2, PyQt6, PySide6, wxPython, matplotlib and others out-of-the-box.
+- Compatible with many third-party packages out-of-the-box. (All the required
+  tricks to make external packages work are already integrated.)
+- Works with code signing on macOS.
+- Bundles MS Visual C++ DLLs on Windows.
+
+
+Installation
+------------
+
+PyInstaller is available on PyPI. You can install it through `pip`:
+
+.. code:: bash
+
+      pip install pyinstaller
+
+
+Requirements and Tested Platforms
+---------------------------------
+
+- Python:
+    - 3.8-3.14. Note that Python 3.10.0 contains a bug making it unsupportable by
+      PyInstaller. PyInstaller will also not work with beta releases of Python
+      3.15.
+- Windows (32-bit/64-bit/ARM64):
+    - PyInstaller should work on Windows 7 or newer, but we only officially support Windows 8+.
+    - Support for Python installed from the Windows Store without using virtual
+      environments requires PyInstaller 4.4 or later.
+- Linux:
+    - GNU libc based distributions on architectures ``x86_64``, ``aarch64``,
+      ``i686``, ``ppc64le``, ``s390x``.
+    - musl libc based distributions on architectures ``x86_64``, ``aarch64``.
+    - ldd: Console application to print the shared libraries required
+      by each program or shared library. This typically can be found in
+      the distribution package `glibc` or `libc-bin`.
+    - objdump: Console application to display information from
+      object files. This typically can be found in the
+      distribution package `binutils`.
+    - objcopy: Console application to copy and translate object files.
+      This typically can be found in the distribution package `binutils`,
+      too.
+    - Raspberry Pi users on ``armv5``-``armv7`` should `add piwheels as an extra
+      index URL `_ then ``pip install pyinstaller``
+      as usual.
+- macOS (``x86_64`` or ``arm64``):
+    - macOS 10.15 (Catalina) or newer.
+    - Supports building ``universal2`` applications provided that your installation
+      of Python and all your dependencies are also compiled ``universal2``.
+
+
+Usage
+-----
+
+Basic usage is very simple - just run it against your main script:
+
+.. code:: bash
+
+      pyinstaller /path/to/yourscript.py
+
+For more details, see the `manual`_.
+
+
+Untested Platforms
+------------------
+
+The following platforms have been contributed, and any feedback or
+enhancements on these are welcome.
+
+- FreeBSD
+    - ldd
+- Solaris
+    - ldd
+    - objdump
+- AIX
+    - AIX 6.1 or newer. PyInstaller will not work with statically
+      linked Python libraries.
+    - ldd
+- Linux on any other libc implementation/architecture combination not listed
+  above.
+
+Before using any contributed platform, you need to build the PyInstaller
+bootloader. This will happen automatically when you ``pip install pyinstaller``
+provided that you have an appropriate C compiler (typically
+either ``gcc`` or ``clang``) and zlib's development headers already installed.
+
+
+Support
+-------
+
+- Official debugging guide: https://pyinstaller.org/en/v6.17.0/when-things-go-wrong.html
+- Assorted user contributed help topics: https://github.com/pyinstaller/pyinstaller/wiki
+- Web based Q&A forums: https://github.com/pyinstaller/pyinstaller/discussions
+- Email based Q&A forums: https://groups.google.com/g/pyinstaller
+
+
+Changes in this Release
+-----------------------
+
+You can find a detailed list of changes in this release
+in the `Changelog`_ section of the manual.
+
+.. _`manual`: https://pyinstaller.org/en/v6.17.0/
+.. _`Changelog`: https://pyinstaller.org/en/v6.17.0/CHANGES.html
diff --git a/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/RECORD b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/RECORD
new file mode 100644
index 0000000..20223e9
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/RECORD
@@ -0,0 +1,1103 @@
+../../../bin/pyi-archive_viewer,sha256=eVHUqNbPlOtAKzZJ06uf13wL3s7fpr-PWIj_mQ0rIqg,269
+../../../bin/pyi-bindepend,sha256=BjXMHAvpjNQ9yIVQY88-fyLe5s8mw9oOW8wcd7aWQrs,264
+../../../bin/pyi-grab_version,sha256=Ock2beuoljPJGlGLktJ98yVP2-ilKn1sJIkhWMfMUsI,267
+../../../bin/pyi-makespec,sha256=3y77L7NiM0BhamclTU7aF6wXs98EP8CDAvSGShASJ64,263
+../../../bin/pyi-set_version,sha256=92C1VpHO0hPH-Il7DknpJ_4fUOeeL1_xA-o30oTXsN8,266
+../../../bin/pyinstaller,sha256=6ytxhxnioaJixcpsyb7d25YgrjvRynS3NzAXmI5vOog,280
+PyInstaller/__init__.py,sha256=mMEvNyFSZXSnoeCx_IYV70zPFHVhKNrnD53VhzkLbSw,2012
+PyInstaller/__main__.py,sha256=OsbjFkY_6cjuKXAnEHo0TJVkO_1nRzTKC3-DAXjlHCc,12636
+PyInstaller/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/__pycache__/__main__.cpython-312.pyc,,
+PyInstaller/__pycache__/_recursion_too_deep_message.cpython-312.pyc,,
+PyInstaller/__pycache__/_shared_with_waf.cpython-312.pyc,,
+PyInstaller/__pycache__/compat.cpython-312.pyc,,
+PyInstaller/__pycache__/config.cpython-312.pyc,,
+PyInstaller/__pycache__/configure.cpython-312.pyc,,
+PyInstaller/__pycache__/exceptions.cpython-312.pyc,,
+PyInstaller/__pycache__/log.cpython-312.pyc,,
+PyInstaller/_recursion_too_deep_message.py,sha256=Nq51eGfSfiU_CKYk7nAvz591LHiLsmY4KVEK5Lr-HUQ,1820
+PyInstaller/_shared_with_waf.py,sha256=cTCVmYHJJpku5m5x6FT01fTLtyGdp0q0t0eInTQUKuM,4064
+PyInstaller/archive/__init__.py,sha256=fNGhsx0m5s9iq4yMvH6J1tI0vzUKWd62lIQNSnKTGCE,22
+PyInstaller/archive/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/archive/__pycache__/pyz_crypto.cpython-312.pyc,,
+PyInstaller/archive/__pycache__/readers.cpython-312.pyc,,
+PyInstaller/archive/__pycache__/writers.cpython-312.pyc,,
+PyInstaller/archive/pyz_crypto.py,sha256=9SsKY26cVDwVxlwD-6LSC0Pw3rsIoOhV-A6Y6s9IPBI,747
+PyInstaller/archive/readers.py,sha256=5c-KM7xo7SyU1S2mh4AJS1w1n0w4zzWvAE7ckAFqNhM,8413
+PyInstaller/archive/writers.py,sha256=lMcMSLwEcgKQkfMPmiqofOIZ4pXv0RA_HL_WN-M1rvw,20133
+PyInstaller/bootloader/Linux-64bit-intel/run,sha256=N7d_n7QRRSiUnr8yZtLJkw0YjopDG3UQoHGMmD5NqDs,64224
+PyInstaller/bootloader/Linux-64bit-intel/run_d,sha256=Ruh9ESy4btnYpD3EP7r1TGmCWGsxYW6fx0bcjUMy5ac,72416
+PyInstaller/building/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
+PyInstaller/building/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/building/__pycache__/api.cpython-312.pyc,,
+PyInstaller/building/__pycache__/build_main.cpython-312.pyc,,
+PyInstaller/building/__pycache__/datastruct.cpython-312.pyc,,
+PyInstaller/building/__pycache__/icon.cpython-312.pyc,,
+PyInstaller/building/__pycache__/makespec.cpython-312.pyc,,
+PyInstaller/building/__pycache__/osx.cpython-312.pyc,,
+PyInstaller/building/__pycache__/splash.cpython-312.pyc,,
+PyInstaller/building/__pycache__/splash_templates.cpython-312.pyc,,
+PyInstaller/building/__pycache__/templates.cpython-312.pyc,,
+PyInstaller/building/__pycache__/utils.cpython-312.pyc,,
+PyInstaller/building/api.py,sha256=v01ewgc3OKNazvCQ4emGOAN7lfL8zvDeZDW_IXMk8-c,68975
+PyInstaller/building/build_main.py,sha256=oM4vW3yLKU6MsjDRMjdFkMOquJuqwlonfuhRjMpyjMQ,61241
+PyInstaller/building/datastruct.py,sha256=AGQQTL4cfQIApxl_vD5LRpl5nHpEcCN5El3u89jkRmU,17435
+PyInstaller/building/icon.py,sha256=BMyohNvNi-Zp1hbC0i9wExyxoa9QMP_7wfQqBOnauYg,4015
+PyInstaller/building/makespec.py,sha256=jJL3eA7znzM1yvVq3Wv_W_vhzim409y6NO9QGcEc0mA,36003
+PyInstaller/building/osx.py,sha256=aWQ4tyU2IX1ZWjqBIYi-FothBoi1qMkYhjfcN6_XKJQ,42305
+PyInstaller/building/splash.py,sha256=T1XCgV91YUClsuv1IVax2GRvpvO0c7kxMiG8nKAIi_M,23272
+PyInstaller/building/splash_templates.py,sha256=VmtOwhx6B37ufbvbTC74uADLpWEFpev-qjnFNJlpdIE,7453
+PyInstaller/building/templates.py,sha256=T64VeVrybxnFVL-m4OmoVgmbmGsgBmz-GltBSLu-YWg,3146
+PyInstaller/building/utils.py,sha256=-i0l9eA9YuujxpNeTdafJNWN-hqABKpPZ8OGIteZazE,39380
+PyInstaller/compat.py,sha256=4kBnUi70fHAPT98RCKxFNFxJaVUPsj2CDDi38Ilw3dE,30202
+PyInstaller/config.py,sha256=7GMtLgwDTZwcG2pwY6jUEtCQbLA7K_5hauTvbGdQ5Eo,1852
+PyInstaller/configure.py,sha256=cy15xry6JclyWqGfhTPtsCgJXfRA8Qp7CMGTgHZYeFA,4160
+PyInstaller/depend/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
+PyInstaller/depend/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/depend/__pycache__/analysis.cpython-312.pyc,,
+PyInstaller/depend/__pycache__/bindepend.cpython-312.pyc,,
+PyInstaller/depend/__pycache__/bytecode.cpython-312.pyc,,
+PyInstaller/depend/__pycache__/dylib.cpython-312.pyc,,
+PyInstaller/depend/__pycache__/imphook.cpython-312.pyc,,
+PyInstaller/depend/__pycache__/imphookapi.cpython-312.pyc,,
+PyInstaller/depend/__pycache__/utils.cpython-312.pyc,,
+PyInstaller/depend/analysis.py,sha256=RQrJ2BJDwwqS5BwZJ_D275AqnF7DPqrzNAWtIsP3OfU,51122
+PyInstaller/depend/bindepend.py,sha256=aXJ1_2cb3uvrIESHcV4a0l-Z9VcI7Ae_gobzaLuAv2o,54537
+PyInstaller/depend/bytecode.py,sha256=K0ozQz4DmwbSH8V5vM91ENW_YAMREvFqL3ymJt5a964,15434
+PyInstaller/depend/dylib.py,sha256=IBT4jYgNXY0rCF8DriCCaO3HZW7dg9xZu-9lqnKh2A0,13220
+PyInstaller/depend/imphook.py,sha256=LRcdRjQmQcTjBcq_zsuhg4T506f_j5jHawRMrIIEsdo,27568
+PyInstaller/depend/imphookapi.py,sha256=BWYiSWTJZEX1a13kqi5lKCahgsCLD9K-NVhKL1f40yQ,21231
+PyInstaller/depend/utils.py,sha256=bQcgsAnLPGUHIarf7d8Q1H_uPtoNZVXbN1R9mQZ9fUc,13848
+PyInstaller/exceptions.py,sha256=PdZjbwpxt36S4hB3AkK6oHic9CI3QD58n-vQOlBJIBo,2460
+PyInstaller/fake-modules/__pycache__/pyi_splash.cpython-312.pyc,,
+PyInstaller/fake-modules/_pyi_rth_utils/__init__.py,sha256=eB5Dwu9lqSMqbLtIXpkYUaU7dEiymGkij-MOIDO9ZdI,1710
+PyInstaller/fake-modules/_pyi_rth_utils/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/fake-modules/_pyi_rth_utils/__pycache__/_win32.cpython-312.pyc,,
+PyInstaller/fake-modules/_pyi_rth_utils/__pycache__/qt.cpython-312.pyc,,
+PyInstaller/fake-modules/_pyi_rth_utils/__pycache__/tempfile.cpython-312.pyc,,
+PyInstaller/fake-modules/_pyi_rth_utils/_win32.py,sha256=8DO_CZTynydjJJmIHCgvvjBpjc46MN5bg0dOkQsIX1M,11564
+PyInstaller/fake-modules/_pyi_rth_utils/qt.py,sha256=24b7dxj7GQQiXeFuYm74TQBDUCGnEdREuQhyvEKAepM,4204
+PyInstaller/fake-modules/_pyi_rth_utils/tempfile.py,sha256=xU--svg9lzC2Aj6dTrQMCh2Zek4-eN1sLrRjKpoEct0,2262
+PyInstaller/fake-modules/pyi_splash.py,sha256=646pzN_1FX9yUcnjBeBSvER6z2Nwvc8X0YjMXSpYZJs,7690
+PyInstaller/hooks/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
+PyInstaller/hooks/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PIL.Image.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PIL.ImageFilter.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PIL.SpiderImagePlugin.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PIL.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QAxContainer.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.Qsci.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.Qt.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.Qt3DAnimation.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.Qt3DCore.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.Qt3DExtras.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.Qt3DInput.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.Qt3DLogic.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.Qt3DRender.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtBluetooth.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtChart.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtCore.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtDBus.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtDataVisualization.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtDesigner.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtGui.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtHelp.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtLocation.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtMacExtras.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtMultimedia.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtMultimediaWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtNetwork.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtNetworkAuth.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtNfc.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtOpenGL.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtPositioning.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtPrintSupport.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtPurchasing.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtQml.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtQuick.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtQuick3D.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtQuickWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtRemoteObjects.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtScript.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtSensors.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtSerialPort.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtSql.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtSvg.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtTest.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtTextToSpeech.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtWebChannel.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtWebEngine.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtWebEngineCore.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtWebEngineWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtWebKit.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtWebKitWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtWebSockets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtWinExtras.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtX11Extras.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtXml.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.QtXmlPatterns.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt5.uic.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QAxContainer.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.Qsci.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.Qt3DAnimation.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.Qt3DCore.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.Qt3DExtras.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.Qt3DInput.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.Qt3DLogic.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.Qt3DRender.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtBluetooth.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtCharts.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtCore.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtDBus.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtDataVisualization.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtDesigner.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtGraphs.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtGraphsWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtGui.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtHelp.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtMultimedia.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtMultimediaWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtNetwork.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtNetworkAuth.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtNfc.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtOpenGL.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtOpenGLWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtPdf.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtPdfWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtPositioning.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtPrintSupport.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtQml.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtQuick.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtQuick3D.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtQuickWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtRemoteObjects.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtSensors.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtSerialPort.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtSpatialAudio.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtSql.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtStateMachine.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtSvg.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtSvgWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtTest.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtTextToSpeech.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtWebChannel.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtWebEngineCore.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtWebEngineQuick.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtWebEngineWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtWebSockets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.QtXml.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PyQt6.uic.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.Qt3DAnimation.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.Qt3DCore.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.Qt3DExtras.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.Qt3DInput.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.Qt3DLogic.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.Qt3DRender.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtAxContainer.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtCharts.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtConcurrent.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtCore.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtDataVisualization.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtGui.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtHelp.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtLocation.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtMacExtras.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtMultimedia.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtMultimediaWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtNetwork.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtOpenGL.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtOpenGLFunctions.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtPositioning.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtPrintSupport.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtQml.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtQuick.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtQuickControls2.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtQuickWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtRemoteObjects.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtScript.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtScriptTools.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtScxml.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtSensors.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtSerialPort.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtSql.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtSvg.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtTest.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtTextToSpeech.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtUiTools.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtWebChannel.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtWebEngine.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtWebEngineCore.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtWebEngineWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtWebKit.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtWebKitWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtWebSockets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtWinExtras.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtX11Extras.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtXml.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.QtXmlPatterns.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.Qwt5.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide2.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.Qt3DAnimation.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.Qt3DCore.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.Qt3DExtras.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.Qt3DInput.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.Qt3DLogic.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.Qt3DRender.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtAxContainer.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtBluetooth.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtCharts.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtConcurrent.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtCore.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtDBus.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtDataVisualization.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtDesigner.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtGraphs.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtGraphsWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtGui.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtHelp.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtHttpServer.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtLocation.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtMultimedia.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtMultimediaWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtNetwork.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtNetworkAuth.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtNfc.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtOpenGL.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtOpenGLWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtPdf.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtPdfWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtPositioning.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtPrintSupport.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtQml.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtQuick.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtQuick3D.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtQuickControls2.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtQuickWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtRemoteObjects.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtScxml.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtSensors.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtSerialBus.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtSerialPort.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtSpatialAudio.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtSql.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtStateMachine.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtSvg.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtSvgWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtTest.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtTextToSpeech.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtUiTools.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtWebChannel.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtWebEngineCore.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtWebEngineQuick.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtWebEngineWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtWebSockets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtWidgets.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.QtXml.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-PySide6.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-_ctypes.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-_osx_support.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-_pyi_rth_utils.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-_tkinter.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-babel.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-difflib.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-distutils.command.check.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-distutils.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-distutils.util.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-django.contrib.sessions.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-django.core.cache.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-django.core.mail.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-django.core.management.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-django.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-django.db.backends.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-django.db.backends.mysql.base.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-django.db.backends.oracle.base.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-django.template.loaders.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-encodings.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gevent.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.Adw.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.AppIndicator3.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.Atk.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.AyatanaAppIndicator3.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.Champlain.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.Clutter.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.DBus.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GIRepository.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GLib.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GModule.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GObject.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.Gdk.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GdkPixbuf.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.Gio.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.Graphene.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.Gsk.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.Gst.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstAllocators.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstApp.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstAudio.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstBadAudio.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstBase.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstCheck.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstCodecs.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstController.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstGL.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstGLEGL.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstGLWayland.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstGLX11.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstInsertBin.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstMpegts.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstNet.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstPbutils.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstPlay.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstPlayer.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstRtp.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstRtsp.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstRtspServer.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstSdp.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstTag.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstTranscoder.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstVideo.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstVulkan.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstVulkanWayland.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstVulkanXCB.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GstWebRTC.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.Gtk.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GtkChamplain.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GtkClutter.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GtkSource.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.GtkosxApplication.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.HarfBuzz.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.OsmGpsMap.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.Pango.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.PangoCairo.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.Rsvg.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.cairo.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.freetype2.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-gi.repository.xlib.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-heapq.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-idlelib.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-importlib_metadata.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-importlib_resources.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-keyring.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-kivy.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-lib2to3.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-matplotlib.backend_bases.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-matplotlib.backends.backend_qtagg.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-matplotlib.backends.backend_qtcairo.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-matplotlib.backends.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-matplotlib.backends.qt_compat.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-matplotlib.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-matplotlib.numerix.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-matplotlib.pyplot.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-multiprocessing.util.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-numpy.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-pandas.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-pandas.io.clipboard.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-pandas.io.formats.style.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-pandas.plotting.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-pickle.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-pkg_resources.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-platform.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-pygments.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-pytz.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-pytzdata.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-qtawesome.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-qtpy.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-scapy.layers.all.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-scipy.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-scipy.io.matlab.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-scipy.linalg.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-scipy.sparse.csgraph.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-scipy.spatial._ckdtree.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-scipy.spatial.transform.rotation.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-scipy.special._ellip_harm_2.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-scipy.special._ufuncs.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-scipy.stats._stats.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-scrapy.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-setuptools._vendor.importlib_metadata.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-setuptools._vendor.jaraco.text.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-setuptools.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-shelve.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-shiboken6.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-sphinx.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-sqlalchemy.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-sqlite3.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-sysconfig.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-wcwidth.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-win32ctypes.core.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-xml.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-xml.dom.domreg.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-xml.etree.cElementTree.cpython-312.pyc,,
+PyInstaller/hooks/__pycache__/hook-zope.interface.cpython-312.pyc,,
+PyInstaller/hooks/hook-PIL.Image.py,sha256=xVqeatL2Pyud1OfdEd_NsBYoWKgJxYndA5zAJUq65Qs,845
+PyInstaller/hooks/hook-PIL.ImageFilter.py,sha256=SzNTo7kh7tRKKovVkCTWvGg6MHzGBTacbqPI-e55gkk,589
+PyInstaller/hooks/hook-PIL.SpiderImagePlugin.py,sha256=RfNA7s9x1Ti__UNR1aFGJbIAilfhyX99q1hDJ7eWwng,773
+PyInstaller/hooks/hook-PIL.py,sha256=iDHOmiCbD_JVYkhIfyILP8RqfhH16iRONpADqoa-q44,1100
+PyInstaller/hooks/hook-PyQt5.QAxContainer.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.Qsci.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.Qt.py,sha256=0zjBifUSNvurC278Y49db6609OP9D0Ad6uuGSQCQASk,1275
+PyInstaller/hooks/hook-PyQt5.Qt3DAnimation.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.Qt3DCore.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.Qt3DExtras.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.Qt3DInput.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.Qt3DLogic.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.Qt3DRender.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtBluetooth.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtChart.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtCore.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtDBus.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtDataVisualization.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtDesigner.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtGui.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtHelp.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtLocation.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtMacExtras.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtMultimedia.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtMultimediaWidgets.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtNetwork.py,sha256=ulfru1n_aKP8t70lPw9mmA1JOUCUVKRuE2udksUzQHQ,710
+PyInstaller/hooks/hook-PyQt5.QtNetworkAuth.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtNfc.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtOpenGL.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtPositioning.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtPrintSupport.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtPurchasing.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtQml.py,sha256=9iBtfG0pUGnSHFAyzJdUaOX6tftELh1iEYE-BF1f3U8,764
+PyInstaller/hooks/hook-PyQt5.QtQuick.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtQuick3D.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtQuickWidgets.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtRemoteObjects.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtScript.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtSensors.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtSerialPort.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtSql.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtSvg.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtTest.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtTextToSpeech.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtWebChannel.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtWebEngine.py,sha256=8v1T1hQOX9jSD3y6rEiwdEOytqqNB7FxGejXbVkDlMU,633
+PyInstaller/hooks/hook-PyQt5.QtWebEngineCore.py,sha256=aZzbd6E_89Ype_7HqLt987AKQsZ81NWsZJhHz9sxBqA,995
+PyInstaller/hooks/hook-PyQt5.QtWebEngineWidgets.py,sha256=8v1T1hQOX9jSD3y6rEiwdEOytqqNB7FxGejXbVkDlMU,633
+PyInstaller/hooks/hook-PyQt5.QtWebKit.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtWebKitWidgets.py,sha256=8v1T1hQOX9jSD3y6rEiwdEOytqqNB7FxGejXbVkDlMU,633
+PyInstaller/hooks/hook-PyQt5.QtWebSockets.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtWidgets.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtWinExtras.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtX11Extras.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtXml.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.QtXmlPatterns.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PyQt5.py,sha256=EJVCGUfy59jwZgAPgRCfKDMU8xA2nTw-jV_881EoTrU,1182
+PyInstaller/hooks/hook-PyQt5.uic.py,sha256=84RPP_83POC6omCwnWObq5ll63SxVoSvwfhX3j_exD4,979
+PyInstaller/hooks/hook-PyQt6.QAxContainer.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.Qsci.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.Qt3DAnimation.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.Qt3DCore.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.Qt3DExtras.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.Qt3DInput.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.Qt3DLogic.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.Qt3DRender.py,sha256=oVmMojFOwYquJN_iyTDESJ0nhs4ehshmtt46ud2cu0k,670
+PyInstaller/hooks/hook-PyQt6.QtBluetooth.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtCharts.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtCore.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.QtDBus.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtDataVisualization.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtDesigner.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtGraphs.py,sha256=blAESbNJe5EvN8vnKt4Ruf99AfbjB49fo3xO0cJHmWE,752
+PyInstaller/hooks/hook-PyQt6.QtGraphsWidgets.py,sha256=ttLfQTZX2kg5s6FbKjIQLmj1VEnUGLvmfsvLtmyaty0,760
+PyInstaller/hooks/hook-PyQt6.QtGui.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.QtHelp.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.QtMultimedia.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtMultimediaWidgets.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtNetwork.py,sha256=dgck_Mmop4kEanguw_yXaedNRxzOOuu7bEtZyVYYh-U,710
+PyInstaller/hooks/hook-PyQt6.QtNetworkAuth.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtNfc.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtOpenGL.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.QtOpenGLWidgets.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.QtPdf.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtPdfWidgets.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtPositioning.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtPrintSupport.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.QtQml.py,sha256=PLw5WhHb8V0WXXFY69RZLMWIZXwB_lr3mut0AyWmCIw,764
+PyInstaller/hooks/hook-PyQt6.QtQuick.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.QtQuick3D.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtQuickWidgets.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.QtRemoteObjects.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtSensors.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtSerialPort.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtSpatialAudio.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtSql.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.QtStateMachine.py,sha256=39XOFBtBbyJJUKVIto-dc0wL4XpIxuZZcWTWPtFGkeI,752
+PyInstaller/hooks/hook-PyQt6.QtSvg.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.QtSvgWidgets.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtTest.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.QtTextToSpeech.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtWebChannel.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtWebEngineCore.py,sha256=ztLvvV7IFg9gGr-uq6HwSGRRqAPuJfwJueHsbwmK_is,1351
+PyInstaller/hooks/hook-PyQt6.QtWebEngineQuick.py,sha256=cq1LjMw4S_JrC47Ihz1kh7td06JQ1FO_a94J0dJFG94,633
+PyInstaller/hooks/hook-PyQt6.QtWebEngineWidgets.py,sha256=cq1LjMw4S_JrC47Ihz1kh7td06JQ1FO_a94J0dJFG94,633
+PyInstaller/hooks/hook-PyQt6.QtWebSockets.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PyQt6.QtWidgets.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.QtXml.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PyQt6.py,sha256=9M5liqiED7hrlqRFSJzWn2fgiUjS0-ljCri_lr9PyG0,1025
+PyInstaller/hooks/hook-PyQt6.uic.py,sha256=aqbbDAUty1kOTEHQDKak-N1Yk78pQIXt1LtgLiOw3Sg,979
+PyInstaller/hooks/hook-PySide2.Qt3DAnimation.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.Qt3DCore.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.Qt3DExtras.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.Qt3DInput.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.Qt3DLogic.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.Qt3DRender.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtAxContainer.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtCharts.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtConcurrent.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtCore.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtDataVisualization.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtGui.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtHelp.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtLocation.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtMacExtras.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtMultimedia.py,sha256=DyIsljc-dNhSMZsjyFtouaLp8ZLdhUWQaMeaQQ8cQjY,979
+PyInstaller/hooks/hook-PySide2.QtMultimediaWidgets.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtNetwork.py,sha256=52vtimdyB73bgVxazsQ-VfNnEAj_VDjl9eX0Uk6OVxs,714
+PyInstaller/hooks/hook-PySide2.QtOpenGL.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtOpenGLFunctions.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtPositioning.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtPrintSupport.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtQml.py,sha256=5W2Zr3rpyso-91Hjc28tfRkEYOdulhdwQnOX3uMBBzQ,804
+PyInstaller/hooks/hook-PySide2.QtQuick.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtQuickControls2.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtQuickWidgets.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtRemoteObjects.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtScript.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtScriptTools.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtScxml.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtSensors.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtSerialPort.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtSql.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtSvg.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtTest.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtTextToSpeech.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtUiTools.py,sha256=vK9DFnB41R-Falc9v-vpXr_MvCo719gJfAaYGn_pbAo,710
+PyInstaller/hooks/hook-PySide2.QtWebChannel.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtWebEngine.py,sha256=8v1T1hQOX9jSD3y6rEiwdEOytqqNB7FxGejXbVkDlMU,633
+PyInstaller/hooks/hook-PySide2.QtWebEngineCore.py,sha256=95kMNBhui4wfAOqu0R5P0atuk28qNx76CiglODAnJwQ,1003
+PyInstaller/hooks/hook-PySide2.QtWebEngineWidgets.py,sha256=8v1T1hQOX9jSD3y6rEiwdEOytqqNB7FxGejXbVkDlMU,633
+PyInstaller/hooks/hook-PySide2.QtWebKit.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtWebKitWidgets.py,sha256=8v1T1hQOX9jSD3y6rEiwdEOytqqNB7FxGejXbVkDlMU,633
+PyInstaller/hooks/hook-PySide2.QtWebSockets.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtWidgets.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtWinExtras.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtX11Extras.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtXml.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.QtXmlPatterns.py,sha256=UochHJ51ckZ_syXJyeLM264STUXRCB_RUsv3oCd6g98,633
+PyInstaller/hooks/hook-PySide2.Qwt5.py,sha256=iPZ4IL_gOs0h5pYTjvYHnJCdVCB-sDvpHFpoX-VOh_k,972
+PyInstaller/hooks/hook-PySide2.py,sha256=6vzXvVtUQYJiifknYcvJJdV1ojWoAQJxonYBddpPoiQ,1141
+PyInstaller/hooks/hook-PySide6.Qt3DAnimation.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.Qt3DCore.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.Qt3DExtras.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.Qt3DInput.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.Qt3DLogic.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.Qt3DRender.py,sha256=45jlg3Va-bAusaRaZA3JWfJGg4XgfS_exNnbvCVBPw0,1122
+PyInstaller/hooks/hook-PySide6.QtAxContainer.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtBluetooth.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtCharts.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtConcurrent.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtCore.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtDBus.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtDataVisualization.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtDesigner.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtGraphs.py,sha256=rgWc6i9j5HrbRyVDZjptPrNu24NT-Uc0_bJAj8Z8v9o,628
+PyInstaller/hooks/hook-PySide6.QtGraphsWidgets.py,sha256=w9ICAH2zNa2KniPB7NunLK3MpI1ECJmzkpEaOq2j64Q,764
+PyInstaller/hooks/hook-PySide6.QtGui.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtHelp.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtHttpServer.py,sha256=pnm0JlKbPaJvU4C2CBTZf5YOFdLv0JzstefyQTmc3M8,837
+PyInstaller/hooks/hook-PySide6.QtLocation.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtMultimedia.py,sha256=apdddXdKLkbCSREJo8W9zHP_iZh-wiFGZeezSMYKw2c,981
+PyInstaller/hooks/hook-PySide6.QtMultimediaWidgets.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtNetwork.py,sha256=o1tB7jEyZGCUQzEv-uypg8ghl3iMaEUJR9uppFjlSAk,714
+PyInstaller/hooks/hook-PySide6.QtNetworkAuth.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtNfc.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtOpenGL.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtOpenGLWidgets.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtPdf.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtPdfWidgets.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtPositioning.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtPrintSupport.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtQml.py,sha256=kPZge8513WUfKoV4yr49zND7K-m5oug7gHAZVJt3sDc,768
+PyInstaller/hooks/hook-PySide6.QtQuick.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtQuick3D.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtQuickControls2.py,sha256=rlKwMNNYovkBDloHUZjpQFS6bungJ8ZRjiHaHpPeWhs,671
+PyInstaller/hooks/hook-PySide6.QtQuickWidgets.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtRemoteObjects.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtScxml.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtSensors.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtSerialBus.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtSerialPort.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtSpatialAudio.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtSql.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtStateMachine.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtSvg.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtSvgWidgets.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtTest.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtTextToSpeech.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtUiTools.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtWebChannel.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtWebEngineCore.py,sha256=1UZE0ztcu68M7GFmrKWcnpa2bCQ17-TqcstWktaJg2c,1410
+PyInstaller/hooks/hook-PySide6.QtWebEngineQuick.py,sha256=cq1LjMw4S_JrC47Ihz1kh7td06JQ1FO_a94J0dJFG94,633
+PyInstaller/hooks/hook-PySide6.QtWebEngineWidgets.py,sha256=cq1LjMw4S_JrC47Ihz1kh7td06JQ1FO_a94J0dJFG94,633
+PyInstaller/hooks/hook-PySide6.QtWebSockets.py,sha256=xyYQlN8teZE9iQ9eCbUVKEKG7Q7fKhShb4skrs0llHY,633
+PyInstaller/hooks/hook-PySide6.QtWidgets.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.QtXml.py,sha256=2F9qD4YqIZq6DMKRegn7DHvS6Eq3IWkBa5SRie11N-o,633
+PyInstaller/hooks/hook-PySide6.py,sha256=_vu5Cx2tP-xeizvYi7oZS2g62KmK8tCfAyvs1Ga7dQY,1279
+PyInstaller/hooks/hook-_ctypes.py,sha256=-RA1I8O6zhuvzfVS7VCsdys75eaSZzclhbgqm2-2uys,941
+PyInstaller/hooks/hook-_osx_support.py,sha256=YlOlf5q3sG9wuU1R7qcn5YV9_9oO0BtXddyR30xXRo0,1047
+PyInstaller/hooks/hook-_pyi_rth_utils.py,sha256=HvliUIYSZQFmhLz9ABAzwK-iNurl6oY_eM9mgJRIcHQ,680
+PyInstaller/hooks/hook-_tkinter.py,sha256=2Sz18FAMHPdfdG1cLIyXTqyoXf5y7UcNDA8CIZLApdU,1191
+PyInstaller/hooks/hook-babel.py,sha256=2W8yoXGOs2c7gmoI71VzKsiVwIrNfOywB3NPK46wweI,924
+PyInstaller/hooks/hook-difflib.py,sha256=whXBs38P70PWAv5IW-L6B3phR_D3gkzzT6jap7PqBCE,577
+PyInstaller/hooks/hook-distutils.command.check.py,sha256=so8h5fLMRsiJrEVWNaAPAekziYQY744kpA2J8BFDioQ,606
+PyInstaller/hooks/hook-distutils.py,sha256=JHrLMrbVMTCwqV83Z84eOaXNYruODZrz-aan1x-2R4c,1893
+PyInstaller/hooks/hook-distutils.util.py,sha256=ogjFFsduAfi4QXp2K-qMovorSZM0Wk-ON9lsIKpn1d0,661
+PyInstaller/hooks/hook-django.contrib.sessions.py,sha256=1bXvBmfdjldiywMQPSkl5e94NShMoUmtTLoW5yN4k3M,635
+PyInstaller/hooks/hook-django.core.cache.py,sha256=yiRj8bhzRhB4rkQWiFe4RAtSuJsRakzfMNg8mtknjzo,629
+PyInstaller/hooks/hook-django.core.mail.py,sha256=Fhwo_CjxNQ8jh9_cu0Z5d0QlX5-8LRO4LusKc3sskwc,1069
+PyInstaller/hooks/hook-django.core.management.py,sha256=g8NXb7a-cgfo0IRIZuravW1YcSxDvLASr1p3trefhQM,942
+PyInstaller/hooks/hook-django.db.backends.mysql.base.py,sha256=XDf5vHB7eUZnQzP_xc68F1w2avWO1vKzAxykpSACHss,611
+PyInstaller/hooks/hook-django.db.backends.oracle.base.py,sha256=NtUXz6s4xJyxJgVXsatrMO3X42RxnVq5-v1JAMVU29k,563
+PyInstaller/hooks/hook-django.db.backends.py,sha256=NTWkllG7dc-TR-6rCkcNvlEfwlmGi8vhVbXxQuOKa8o,983
+PyInstaller/hooks/hook-django.py,sha256=5chCU9FUO1Th8-GcVhQgO4VpovCg9ysU3LWSf3yXWAE,3922
+PyInstaller/hooks/hook-django.template.loaders.py,sha256=rcU0WR52DFFxt91MWHscKaDxhvja94d7Ggejtw_5aH0,626
+PyInstaller/hooks/hook-encodings.py,sha256=zTyqMMiW7ghKxyygcOl6MJfmQwt5EdyD1JJnzB7Ol34,612
+PyInstaller/hooks/hook-gevent.py,sha256=_EFWvRtFto7AN-mx-cBcn6L9u-rtZtLeLbwx7Lv6meM,1011
+PyInstaller/hooks/hook-gi.py,sha256=JANdcD3ll_ZiLRN2EhsEM25YPsY1VIKhxeOetCR6FiA,1075
+PyInstaller/hooks/hook-gi.repository.Adw.py,sha256=NwRYqmZESkyKkpCOJbNq8BVu_h5Y7Qw7_bBSsAWe6As,698
+PyInstaller/hooks/hook-gi.repository.AppIndicator3.py,sha256=Bwid2vErvCkB1kkjYc6QJnnv3_Jqf3VvC1fn2vkz6AY,710
+PyInstaller/hooks/hook-gi.repository.Atk.py,sha256=di-iBdmgg6BNhdXgUi0NSTIilzAF7dAx213vlZXzaIo,1084
+PyInstaller/hooks/hook-gi.repository.AyatanaAppIndicator3.py,sha256=9BTVgthn0s8CLk52V-bB4GRmfxlR7N45CGvAbcG4WNM,717
+PyInstaller/hooks/hook-gi.repository.Champlain.py,sha256=b-WMOJ5wo9IJxTA8VEtRA0DkoLGIKGpZRROt97K6sdA,707
+PyInstaller/hooks/hook-gi.repository.Clutter.py,sha256=VR3XwfcdcerLYuG6C_8jH9DbX9Ka2reBBZ_aFkC8__o,704
+PyInstaller/hooks/hook-gi.repository.DBus.py,sha256=pv9g8ObQCghzaLzGYrf5oYoA0fAhVMGktw1v2d4Okkw,701
+PyInstaller/hooks/hook-gi.repository.GIRepository.py,sha256=pADSM-De6Pa6jl45ZBKeP9ObE2At2vWpKUe-8Q3PUbs,709
+PyInstaller/hooks/hook-gi.repository.GLib.py,sha256=6Lhx56wjr3wl5oeSx134eVVWK2WudF13kPOqzKyfvm4,1490
+PyInstaller/hooks/hook-gi.repository.GModule.py,sha256=fpyExmwwNceUthEUZpS9EuaanoKqc8NAsGFuZgov_mM,704
+PyInstaller/hooks/hook-gi.repository.GObject.py,sha256=KkT6C-YbGIoPMkPfCLXprAWdSB2_Cn6f52-pdQ9c_9s,905
+PyInstaller/hooks/hook-gi.repository.Gdk.py,sha256=gGUVXbJ9sKf8WPjrxjPTlW0QEriKy6gvKre3GTP4NbA,1393
+PyInstaller/hooks/hook-gi.repository.GdkPixbuf.py,sha256=6JhaOIB_M6aUwoUz84Kn5tv7hNi69zTefIFxxMesKWc,6320
+PyInstaller/hooks/hook-gi.repository.Gio.py,sha256=Y4nb97wSrb0S4AyEuhe81oew6z_usYosbdmrJKXm8co,2736
+PyInstaller/hooks/hook-gi.repository.Graphene.py,sha256=kPN5lzSJZ1yH-wQ0s00vL_zHMckNH7SS1w7dz4-5Dhc,705
+PyInstaller/hooks/hook-gi.repository.Gsk.py,sha256=UK0rvXX0CsHNyJ3SLs29aOnN92KFoSKtSXU08exYzjM,700
+PyInstaller/hooks/hook-gi.repository.Gst.py,sha256=1yevQzFiRUAjzTkwiZOgsQiu6rrUYB_Hg3KpviSfT7c,3461
+PyInstaller/hooks/hook-gi.repository.GstAllocators.py,sha256=ryA-HqngziZjrL3OBCF6zOvqT4INKhejrRi8JNNIB3s,710
+PyInstaller/hooks/hook-gi.repository.GstApp.py,sha256=eyqjhws-xrCrfFFDhqHjp8RV-GLiI5Qop3FSx84aoJA,703
+PyInstaller/hooks/hook-gi.repository.GstAudio.py,sha256=kJnvOIlWDflbCMFNatGsN7Ql1Xvo9ffmdRlzHFnKKT8,705
+PyInstaller/hooks/hook-gi.repository.GstBadAudio.py,sha256=tCt0HhYm9M98SiBREXCrKh__d5KuT0FZFr1QlZhq7BM,708
+PyInstaller/hooks/hook-gi.repository.GstBase.py,sha256=JaETtokmwH78qQfpjesqKTfBEk-1g1ktvMaIpXzFTEU,704
+PyInstaller/hooks/hook-gi.repository.GstCheck.py,sha256=2vgJstFwiiKyARmpag0wfBcU3pevgm8Zo4dySyEzRyg,705
+PyInstaller/hooks/hook-gi.repository.GstCodecs.py,sha256=_IktlFHwuRd7dWNTY7I-WkddtSPTnarXFTOlQXiVt18,706
+PyInstaller/hooks/hook-gi.repository.GstController.py,sha256=IOq8HWRh_VPdY7NT4OV0-pmFAAYYcKBwZ0QA0WIBanY,710
+PyInstaller/hooks/hook-gi.repository.GstGL.py,sha256=L6bSj5NSIu6XMPpC7tjGukuKJtbXVkQsf8zRM_g5EZY,702
+PyInstaller/hooks/hook-gi.repository.GstGLEGL.py,sha256=FrSoWPNESToC36pZGVpVIiiJ3ox798AqZRGUwMiAzSM,705
+PyInstaller/hooks/hook-gi.repository.GstGLWayland.py,sha256=LTQqLLY99wUKQqlbG3eQ_5SRo4g_enehVKUshE3wB8o,709
+PyInstaller/hooks/hook-gi.repository.GstGLX11.py,sha256=CW8_aDTy1eg5-h0scvoDrwf1_WmfSyubG4-LOS-yhlE,705
+PyInstaller/hooks/hook-gi.repository.GstInsertBin.py,sha256=9YyLJmMHQl7i-q1oTZckGC23_YTDbVpTI58fhw9C6A0,709
+PyInstaller/hooks/hook-gi.repository.GstMpegts.py,sha256=1H4EnbwZW70trU8ivRv2EowUZvebs1B5sO27bKX7Lvo,706
+PyInstaller/hooks/hook-gi.repository.GstNet.py,sha256=anwfzAqBlaGh_Kmy25z2-YynVJo4cgKKgsLzvqUtrvU,703
+PyInstaller/hooks/hook-gi.repository.GstPbutils.py,sha256=eIaEhzlsyawjzjiiqNGFwIiflfDWZ1GO1GnY72gIolk,707
+PyInstaller/hooks/hook-gi.repository.GstPlay.py,sha256=kih5CSzeBI2Zgg7DIz-9ZQbs0MKjqbjBKtLE0bE8vzY,704
+PyInstaller/hooks/hook-gi.repository.GstPlayer.py,sha256=4-8kI3EHUf610zfcA6ovaU_1YiMybz8m1jX-N_9dbRM,706
+PyInstaller/hooks/hook-gi.repository.GstRtp.py,sha256=MT5yvnKq1FBaEFIWy0yGZAQKC8Z20tuQUSB_koDwPIw,703
+PyInstaller/hooks/hook-gi.repository.GstRtsp.py,sha256=h7pOjxw1sFEpe33M3r_-24YczqfI1sQg0Y2ZBQ6nlFE,704
+PyInstaller/hooks/hook-gi.repository.GstRtspServer.py,sha256=lAIHSUOIrC7XQ4ZG5AbR2J-OiukSFK2TiBWBLaq7gZo,710
+PyInstaller/hooks/hook-gi.repository.GstSdp.py,sha256=ywxH8YxjksNuhpdeWrGIkSuMBF8xBau-YkYXqFIl9DM,703
+PyInstaller/hooks/hook-gi.repository.GstTag.py,sha256=bu9I6OoSUEVNbkrUOUFHKe0e057INqeMCeyB5AHH0dM,703
+PyInstaller/hooks/hook-gi.repository.GstTranscoder.py,sha256=m6YtxnRBG1wWalzZgtTKOIv8fKvzwiHjepbckfli7vc,710
+PyInstaller/hooks/hook-gi.repository.GstVideo.py,sha256=6wDSl-9fg_C3qorsgiCnHrqR46Y0tA4NnWEQnAX0tug,705
+PyInstaller/hooks/hook-gi.repository.GstVulkan.py,sha256=wQXXd9_Wp03xsu_Y8ml3bGBDj1JjB1NxqYSqZ6XJFUk,706
+PyInstaller/hooks/hook-gi.repository.GstVulkanWayland.py,sha256=0t7TQcr5pJ058whWXN-pVJhYvbmA0bPMkjshDyRWY7Y,713
+PyInstaller/hooks/hook-gi.repository.GstVulkanXCB.py,sha256=CVKjOp2xJ6Iq3MxbtV9nQJTV0TQXvsumojRzI5NkkFM,709
+PyInstaller/hooks/hook-gi.repository.GstWebRTC.py,sha256=9W6manw1GmQKnWA-Cq6rbykbAAoEQB359XBMwRmQWv8,706
+PyInstaller/hooks/hook-gi.repository.Gtk.py,sha256=8kAtofOZcoiBjTgf0S2mBxv5thpFU3JFEeQ5YG8TiTo,2150
+PyInstaller/hooks/hook-gi.repository.GtkChamplain.py,sha256=mk1keoUxkuD8FHfIFW8i9IpSpN2qiUvVRWVNnOco8nI,710
+PyInstaller/hooks/hook-gi.repository.GtkClutter.py,sha256=Yu6TRHQVi42DsZsoKWwE2G-GDGNzMUrxTR5BBQRkyOc,707
+PyInstaller/hooks/hook-gi.repository.GtkSource.py,sha256=MERiaYTs-_swaRUFS1BqJQ5T5FpfrgPSvH9I4pjzKo4,1297
+PyInstaller/hooks/hook-gi.repository.GtkosxApplication.py,sha256=E-nWcs8eef4Gu1N5miKUMaXPMI0xu3O6PRzX1ZkP9Zw,781
+PyInstaller/hooks/hook-gi.repository.HarfBuzz.py,sha256=vUu5j4FBHqQPLGbjhkWJx1tWi86-HxiBmkgRjrXEpko,705
+PyInstaller/hooks/hook-gi.repository.OsmGpsMap.py,sha256=oGpZN1d-JF7uZxDDqaSpyMAAuTkV5VDegmg1G-K0uV4,701
+PyInstaller/hooks/hook-gi.repository.Pango.py,sha256=yB2ZbRI2vG1OuigPDCIGRKqIxPPAE2SGQ5dh5UoL9uU,702
+PyInstaller/hooks/hook-gi.repository.PangoCairo.py,sha256=0z-JkDB74mtvK-qBbIpqB9UmChAPfcY4Z0cdXa7156U,707
+PyInstaller/hooks/hook-gi.repository.Rsvg.py,sha256=MSJ-t4VyiKdxUy51pxwmpl6dZ6X-PUJ3pPyrn4bVtvk,696
+PyInstaller/hooks/hook-gi.repository.cairo.py,sha256=8E7NMq7RGLg5S506KrHp02qPi8Xq70cTQLz8-2L1Yko,702
+PyInstaller/hooks/hook-gi.repository.freetype2.py,sha256=X6cMHL6XRVrw92SFGRAmwCrWm_k8fHJdk8bVsBxUAnY,706
+PyInstaller/hooks/hook-gi.repository.xlib.py,sha256=MvSXmdVHKrEPpbCRVikFfpK_tCPifwGSyTjkxZ70WMA,701
+PyInstaller/hooks/hook-heapq.py,sha256=gjF79X1Jt5zDPGD9Q_VdmBfn8_NZCn622l7YArn2u38,578
+PyInstaller/hooks/hook-idlelib.py,sha256=96jkUh7GNAPaBdV2ebvtuW7QhnmVMp8F_uvRl7IEyug,602
+PyInstaller/hooks/hook-importlib_metadata.py,sha256=lWesTFNaBn9FjUekBi82wqRwZTU35JqeXRRdBn8hvUA,1350
+PyInstaller/hooks/hook-importlib_resources.py,sha256=qnYt9Bu6zOErsKmDsk6dX7ImRVwCV_cDNSZJRFK7Hxo,1015
+PyInstaller/hooks/hook-keyring.py,sha256=bYnya8YRlh8Cn1DLoDNINWMp_YTKgnSZafhHIecGS1Y,888
+PyInstaller/hooks/hook-kivy.py,sha256=QlC2_9p6MqyKuIVePUGVHzxl_y4j7EC3k_Wlr5UKdXc,1126
+PyInstaller/hooks/hook-lib2to3.py,sha256=uU3mDEtYPN-Z_GxO-zt6orNo7qK8Q_30bSugb02RyPo,653
+PyInstaller/hooks/hook-matplotlib.backend_bases.py,sha256=7iniaWkwXT6sohBNGxq9mA1EpQdZe8i6G4-FdW25Eos,533
+PyInstaller/hooks/hook-matplotlib.backends.backend_qtagg.py,sha256=P1oAFSt-848iD4kuhE4AthDGWXmsV1tgI9gPTCMOLWM,894
+PyInstaller/hooks/hook-matplotlib.backends.backend_qtcairo.py,sha256=tBYzMUrY7pKSuBklcAJvVrKZ8mddX1O-nxy_YgkIrq8,896
+PyInstaller/hooks/hook-matplotlib.backends.py,sha256=hHVvlAX_SfB97kVDK4vcGgXWpEYQsnlfabnLowfSFaE,9656
+PyInstaller/hooks/hook-matplotlib.backends.qt_compat.py,sha256=YmmBT0MiyEDmVXrNMpgj0G9EEjUma2a5xGsCUSpvWoM,1284
+PyInstaller/hooks/hook-matplotlib.numerix.py,sha256=IeAi4MV6B5QJ1xhrrknpna6W7GOoU-hHZDqGRi0jJbw,683
+PyInstaller/hooks/hook-matplotlib.py,sha256=oScRuUc0Y3jXjp_Yy1vkyETtkrOZzwRr-eWmWKOeDhY,1568
+PyInstaller/hooks/hook-matplotlib.pyplot.py,sha256=Z_bOet2njmp6DZt4nc6afxLyGBCbgSsj9TEc3rerX0o,560
+PyInstaller/hooks/hook-multiprocessing.util.py,sha256=d9rgj6yOLda8nXxCQofqgcQABGhl4snJu-oIA4tk8zw,791
+PyInstaller/hooks/hook-numpy.py,sha256=_bfCsgFEid-ln8SDvmMkJ93pBbasCbAjxV9YAsBZGYM,6435
+PyInstaller/hooks/hook-pandas.io.clipboard.py,sha256=syzylK5jU3Lm8IFomqrdtKx_-rZzdEGUnG5X6vaquC4,1156
+PyInstaller/hooks/hook-pandas.io.formats.style.py,sha256=zxvJxol9G5FwRjU90EpmzgMBlzx03lrLkAorhDAXxa4,751
+PyInstaller/hooks/hook-pandas.plotting.py,sha256=XGZMzp_CUX8VTzLG-4Stbb8AAM_ICnW758-eQGrBDwc,938
+PyInstaller/hooks/hook-pandas.py,sha256=x7kjmXFdtYYWYlBMgNq4wjO0vMalSrf_XgJiB-vxq2o,955
+PyInstaller/hooks/hook-pickle.py,sha256=UodGjHVD_QtTR8VW2mQ8XL4toCpHYfU3QIVwPd1DOu4,589
+PyInstaller/hooks/hook-pkg_resources.py,sha256=CoQupujLoZgi79d_flMEhFPpOUJxDJGXgqBXCww3cLI,3563
+PyInstaller/hooks/hook-platform.py,sha256=PXPyeR-xcVpVagddP0opUdW6QNi5F_gOTkl7f4b77S8,713
+PyInstaller/hooks/hook-pygments.py,sha256=bFqk7NfL9GXrMTDCWUv1oOK9pQbx1354THBLlgsqOFE,1184
+PyInstaller/hooks/hook-pytz.py,sha256=R99csLktIulf07o-Sg2hVfF6BxVmodBR7-VWn6JVzr8,968
+PyInstaller/hooks/hook-pytzdata.py,sha256=h6qOdqNVmFnWE0b1DeE-gpVqeL-MVs25VbC-s8dsvNY,603
+PyInstaller/hooks/hook-qtawesome.py,sha256=UDQFON0R3GbQoPxJ2nBYmr11FOVbc2mZn0jWg0i8q28,792
+PyInstaller/hooks/hook-qtpy.py,sha256=Imf8Sma0zykdKY_ltMlKtccb0CWPsL0DY0UWjU2ckYE,1179
+PyInstaller/hooks/hook-scapy.layers.all.py,sha256=71caVRTCmcClHNBwlmRKKBHZfWEYE9qubn_DNxN8Xbo,930
+PyInstaller/hooks/hook-scipy.io.matlab.py,sha256=_W8WtCFFsLIoxUX5DRDj2YULfi4bo13OkK6MoNKj25g,655
+PyInstaller/hooks/hook-scipy.linalg.py,sha256=iXsaTpTOgNalynuMqMdI0JRenRsZ1G5kx_D8EKJWaRU,633
+PyInstaller/hooks/hook-scipy.py,sha256=WalWq9WnqRkPUTtGuvzqgGhNQTSSt0TirT4Rt0WBRng,2943
+PyInstaller/hooks/hook-scipy.sparse.csgraph.py,sha256=pCQv4w_ReJsQCl0udEomCM9WcrsYVJ1QGxxW5IikLLY,611
+PyInstaller/hooks/hook-scipy.spatial._ckdtree.py,sha256=9cQwER19CKpDXOpaUniZIpg4Oj3AdycsV1g_KVfE4Sw,759
+PyInstaller/hooks/hook-scipy.spatial.transform.rotation.py,sha256=YJ44N1xt8P1SB3PKSfuPiB1E2iV1MSLWLMKS_hSmlL0,793
+PyInstaller/hooks/hook-scipy.special._ellip_harm_2.py,sha256=UlLNQkgYOCFCmMItBKvvVRwSUZpAWJRst0IpdJqX8M4,1317
+PyInstaller/hooks/hook-scipy.special._ufuncs.py,sha256=v1GYZ6g5NA9g0GfZV7ymBz-xIGD_3oWv9MoaPGxSElA,1258
+PyInstaller/hooks/hook-scipy.stats._stats.py,sha256=9HkYRAJhusS5gyXIvhBjtkc2z0EjvtMY_0zTBxq70sY,656
+PyInstaller/hooks/hook-scrapy.py,sha256=360AxhD-RoAKPY9gNo-DW4Yx9YCc1WTTJ_VKRu6Amp0,819
+PyInstaller/hooks/hook-setuptools._vendor.importlib_metadata.py,sha256=olw_k1O_UERG8lXz7aqi3iOg7svYNEAZX6t3dDXRxg0,1127
+PyInstaller/hooks/hook-setuptools._vendor.jaraco.text.py,sha256=4mzkjFNSvo27UGVm6dteGPB8ilUgb1LEbnmnSiMeW6o,927
+PyInstaller/hooks/hook-setuptools.py,sha256=iyfdli1uj8DMObrg9mDuCK55KhlezS2cdJWHQt9PeUw,4466
+PyInstaller/hooks/hook-shelve.py,sha256=ToCfEfqwboTS42HS9Ugv1h0xAo2M_CmBb8_gP2cldqE,603
+PyInstaller/hooks/hook-shiboken6.py,sha256=1krp8Ui-4Kl5IoPzX3HECUmD5BG2M0J3LNHLvaVnpw0,766
+PyInstaller/hooks/hook-sphinx.py,sha256=fc8mbEuArO9mEelgapVJjI3Lcln1u4d_XkW4nMudpYE,1998
+PyInstaller/hooks/hook-sqlalchemy.py,sha256=14Ccv93R6oHjyYlXTQ-l0F3x1xcf_4xkI_O0Hk4jOmc,3496
+PyInstaller/hooks/hook-sqlite3.py,sha256=oZ2oAKTuORGunOzbvMDyRKV9lLpDbMede9ozuyLDeqM,813
+PyInstaller/hooks/hook-sysconfig.py,sha256=5IcB6ZlhVkP6kf8csyo8Xrz7WleJTbWEhMZKoswAUu0,1558
+PyInstaller/hooks/hook-wcwidth.py,sha256=zWcpM-dXNP7vuhDyjEMhlsjWQQ9WPtTtxn1S9xG5jc8,602
+PyInstaller/hooks/hook-win32ctypes.core.py,sha256=_IqEnHRy2Jhq-57MKZGFZGS5Bvg53vMp9eQqzeaJY0E,1204
+PyInstaller/hooks/hook-xml.dom.domreg.py,sha256=dCHWL_UpnTqCnrv7DL3-IWULcqthaJVtm2WX4FTmPHo,569
+PyInstaller/hooks/hook-xml.etree.cElementTree.py,sha256=Duh1C8zTwmt_lg_Ek9rLgxxww88fgpiuGyI8OynK-q8,615
+PyInstaller/hooks/hook-xml.py,sha256=oxHKZoo7YNgI_8qG9q3wgYukjIDr27PL8Wv051SrzyA,569
+PyInstaller/hooks/hook-zope.interface.py,sha256=1Xrezxtifo9OUMPDTDGGaEoOn04xIU33OsO_lvX2gWM,539
+PyInstaller/hooks/pre_find_module_path/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
+PyInstaller/hooks/pre_find_module_path/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/hooks/pre_find_module_path/__pycache__/hook-PyQt5.uic.port_v2.cpython-312.pyc,,
+PyInstaller/hooks/pre_find_module_path/__pycache__/hook-_pyi_rth_utils.cpython-312.pyc,,
+PyInstaller/hooks/pre_find_module_path/__pycache__/hook-distutils.cpython-312.pyc,,
+PyInstaller/hooks/pre_find_module_path/__pycache__/hook-pyi_splash.cpython-312.pyc,,
+PyInstaller/hooks/pre_find_module_path/__pycache__/hook-tkinter.cpython-312.pyc,,
+PyInstaller/hooks/pre_find_module_path/hook-PyQt5.uic.port_v2.py,sha256=lMGJ1xNvaAxuHkGivHHno1q7QZ_F0WsTKstlmc4NcHc,696
+PyInstaller/hooks/pre_find_module_path/hook-_pyi_rth_utils.py,sha256=cPgCZrMJdWTO43CEN4J3mvtlzF9yWlEBsEmzi5u8fyo,905
+PyInstaller/hooks/pre_find_module_path/hook-distutils.py,sha256=yLU8K5hn85G2y5Hs_XF0hgMP9hQg3qIqOJKEv2q39jo,2347
+PyInstaller/hooks/pre_find_module_path/hook-pyi_splash.py,sha256=edbvRQ2Thc2qHA36uUCLHPC-HIembOEkr5bA8orH9pU,1412
+PyInstaller/hooks/pre_find_module_path/hook-tkinter.py,sha256=lbu1k3kYhULblbqn90-g5GN2qir7Rz7ShbTfYEyGAiw,834
+PyInstaller/hooks/pre_safe_import_module/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
+PyInstaller/hooks/pre_safe_import_module/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-autocommand.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-backports.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-backports.tarfile.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-distutils.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.overrides.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.Adw.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.AppIndicator3.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.Atk.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.AyatanaAppIndicator3.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.Champlain.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.Clutter.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.DBus.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GIRepository.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GLib.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GModule.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GObject.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.Gdk.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GdkPixbuf.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.Gio.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.Graphene.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.Gsk.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.Gst.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstAllocators.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstApp.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstAudio.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstBadAudio.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstBase.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstCheck.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstCodecs.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstController.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstGL.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstGLEGL.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstGLWayland.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstGLX11.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstInsertBin.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstMpegts.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstNet.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstPbutils.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstPlay.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstPlayer.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstRtp.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstRtsp.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstRtspServer.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstSdp.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstTag.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstTranscoder.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstVideo.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstVulkan.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstVulkanWayland.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstVulkanXCB.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GstWebRTC.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.Gtk.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GtkChamplain.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GtkClutter.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GtkSource.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.GtkosxApplication.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.HarfBuzz.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.OsmGpsMap.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.Pango.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.PangoCairo.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.Rsvg.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.cairo.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.freetype2.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-gi.repository.xlib.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-importlib_metadata.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-importlib_resources.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-inflect.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-jaraco.context.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-jaraco.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-jaraco.functools.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-jaraco.text.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-more_itertools.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-ordered_set.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-packaging.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-platformdirs.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-setuptools.extern.six.moves.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-six.moves.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-tomli.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-typeguard.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-typing_extensions.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-urllib3.packages.six.moves.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-wheel.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/__pycache__/hook-zipp.cpython-312.pyc,,
+PyInstaller/hooks/pre_safe_import_module/hook-autocommand.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-backports.py,sha256=57Bgm9DMWWePvCw1T1w9Ovh914faMrdPJEjSIvIXiTs,1065
+PyInstaller/hooks/pre_safe_import_module/hook-backports.tarfile.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-distutils.py,sha256=LDvJiYH0gr2-e5UC0wD5U2MU2jB2KHvGIlDqmMT4Ubw,1235
+PyInstaller/hooks/pre_safe_import_module/hook-gi.overrides.py,sha256=hKhJpZtsRAsds1zJNXLTugc--aj_WyX0f6n9be2Kvd4,967
+PyInstaller/hooks/pre_safe_import_module/hook-gi.py,sha256=pMxtWOGZGHgWx2DEEv9JNNXNZ2F5P47qVZ_ULYwveEk,2123
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Adw.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.AppIndicator3.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Atk.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.AyatanaAppIndicator3.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Champlain.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Clutter.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.DBus.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GIRepository.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GLib.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GModule.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GObject.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gdk.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GdkPixbuf.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gio.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Graphene.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gsk.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gst.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstAllocators.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstApp.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstAudio.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstBadAudio.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstBase.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstCheck.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstCodecs.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstController.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGL.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGLEGL.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGLWayland.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstGLX11.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstInsertBin.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstMpegts.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstNet.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstPbutils.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstPlay.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstPlayer.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstRtp.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstRtsp.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstRtspServer.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstSdp.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstTag.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstTranscoder.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVideo.py,sha256=wwWsrx5A4AsvLZimx7h9M9T0gBFBqPXb5z2MIgX3EEs,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVulkan.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVulkanWayland.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstVulkanXCB.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GstWebRTC.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Gtk.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkChamplain.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkClutter.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkSource.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.GtkosxApplication.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.HarfBuzz.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.OsmGpsMap.py,sha256=mdWqvlAxndJqNKYJe9BztzcirvlmQvMz2T5XHVSgpZI,778
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Pango.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.PangoCairo.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.Rsvg.py,sha256=chs1dkxyPW2BIP7sE38MzcWJuoCrZcV7bl83D3y5vaU,778
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.cairo.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.freetype2.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-gi.repository.xlib.py,sha256=c5f74KePUHt-7fH_tJQfuqB44ysYTLbCm76u2QVB07U,783
+PyInstaller/hooks/pre_safe_import_module/hook-importlib_metadata.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-importlib_resources.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-inflect.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-jaraco.context.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-jaraco.functools.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-jaraco.py,sha256=57Bgm9DMWWePvCw1T1w9Ovh914faMrdPJEjSIvIXiTs,1065
+PyInstaller/hooks/pre_safe_import_module/hook-jaraco.text.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-more_itertools.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-ordered_set.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-packaging.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-platformdirs.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-setuptools.extern.six.moves.py,sha256=A-aFL3cZ_AgA2Ia5UPEnFijM5vCP-S-U24kiOMrgdpY,1629
+PyInstaller/hooks/pre_safe_import_module/hook-six.moves.py,sha256=drAs8emHi0X9vxDtKo-n3XBTanM6RuJPJATfVoVFOXE,3744
+PyInstaller/hooks/pre_safe_import_module/hook-tomli.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-typeguard.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-typing_extensions.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-urllib3.packages.six.moves.py,sha256=vLiXNHM4LwX4sWP6j_pQnBpLpwFXz0TCxHnQpqUdjf8,1380
+PyInstaller/hooks/pre_safe_import_module/hook-wheel.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/pre_safe_import_module/hook-zipp.py,sha256=O56uUBdY_je3jGpxwWo_qyKHCUPZX805adawrj8kBBE,924
+PyInstaller/hooks/rthooks.dat,sha256=bdXIqqe9MG02b81XxSNDeewioDtjKLydPCyiPZsX9g8,956
+PyInstaller/hooks/rthooks/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
+PyInstaller/hooks/rthooks/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth__tkinter.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_django.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_gdkpixbuf.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_gi.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_gio.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_glib.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_gstreamer.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_gtk.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_inspect.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_kivy.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_mplconfig.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_multiprocessing.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_pkgres.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_pkgutil.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_pyqt5.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_pyqt6.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_pyside2.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_pyside6.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/__pycache__/pyi_rth_setuptools.cpython-312.pyc,,
+PyInstaller/hooks/rthooks/pyi_rth__tkinter.py,sha256=iF0MUBG5v18Mygb1sgqkvSgFPGmgF-z0DmtlOK2n9DE,1381
+PyInstaller/hooks/rthooks/pyi_rth_django.py,sha256=9FeO_ektm32U-b-dZvvNdjrT0S6-H3I5rFCHSvBmG0A,1111
+PyInstaller/hooks/rthooks/pyi_rth_gdkpixbuf.py,sha256=EkY4CtxJbg0SGAh32whgj0vBeSW1v64PPuveWkOS8NE,1436
+PyInstaller/hooks/rthooks/pyi_rth_gi.py,sha256=H5wdL7AjlrfPib7En_YYLebfltmm5V4AUZ_PacAEFlQ,632
+PyInstaller/hooks/rthooks/pyi_rth_gio.py,sha256=6T0LIFqi8l5HzCWE-0mYIQ6DaxNGn0533Xn7V0uhLZo,631
+PyInstaller/hooks/rthooks/pyi_rth_glib.py,sha256=s7VmqbBTJBAU--RrroztL5u7CY3seSbFM6xR6BpCa1U,1444
+PyInstaller/hooks/rthooks/pyi_rth_gstreamer.py,sha256=QKecSKSWJP-hLaD8NFM38rYIhKrGmxxWPRIqpAXUS9A,1174
+PyInstaller/hooks/rthooks/pyi_rth_gtk.py,sha256=yR1NT5tRR-g9y-bG7Tk7ZosPTNHMnV7KFme7dlz6NFA,886
+PyInstaller/hooks/rthooks/pyi_rth_inspect.py,sha256=6dsxH5e3UKMKQi4L8r3P91FNpnzTWw9hia14aVb_Grw,5809
+PyInstaller/hooks/rthooks/pyi_rth_kivy.py,sha256=jIBZeNe2Kmbxi00XJ96l5KvNWD9KCvzFQp-Ug93-FpU,737
+PyInstaller/hooks/rthooks/pyi_rth_mplconfig.py,sha256=XuCFEHpud0vYuwQX56LcuGoZgkjB_pHPyseJcs5UwSY,1808
+PyInstaller/hooks/rthooks/pyi_rth_multiprocessing.py,sha256=6a2ZoTIVNGKHdB-aAAfG7dVN56R9soM5AJV0-D9T-Yg,2219
+PyInstaller/hooks/rthooks/pyi_rth_pkgres.py,sha256=GUwPb_352RjVnfnnoEYruG1gbZGjrCqCfcK3ockc_xQ,8867
+PyInstaller/hooks/rthooks/pyi_rth_pkgutil.py,sha256=fQBqlnVnS5zH2LEeqYrQN63qXb2269-bekXIYVAcQgQ,3066
+PyInstaller/hooks/rthooks/pyi_rth_pyqt5.py,sha256=og6YoJVF0NfPDvZUCydq5Hc1mOylHfoPlZr5U9FDQ4c,3542
+PyInstaller/hooks/rthooks/pyi_rth_pyqt6.py,sha256=La9r6nfWJzXPGi9llkcEq5PvLaZLnkqdhCMhySS6oQY,3803
+PyInstaller/hooks/rthooks/pyi_rth_pyside2.py,sha256=UNxayNyGCcbxheNwM0zz9shmGuOcy4ubIr0OQ0qHJms,3235
+PyInstaller/hooks/rthooks/pyi_rth_pyside6.py,sha256=0SAB-MUdyPdxFNnUgHixB-HXwNvYnQOPTucn08GlN6s,3730
+PyInstaller/hooks/rthooks/pyi_rth_setuptools.py,sha256=rrDcdbUGSuUnUeXDRR_HalxM1-ghtJiWFIgOvOIIMPo,1430
+PyInstaller/isolated/__init__.py,sha256=eY1YBvBNir3Mwn2-lSXEBmiY-i_jz1ZZ_uQVRq_qZms,1526
+PyInstaller/isolated/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/isolated/__pycache__/_child.cpython-312.pyc,,
+PyInstaller/isolated/__pycache__/_parent.cpython-312.pyc,,
+PyInstaller/isolated/_child.py,sha256=sQERIgcb0bB38MAZP2s6UM29yEKkVeB_jV0lEHXckzQ,3980
+PyInstaller/isolated/_parent.py,sha256=w1AGtK8vWlazpJUaAjlBV10MSs1JEtfVnxq_T40pY2Q,18005
+PyInstaller/lib/README.rst,sha256=VdkvnJUKg6D2bv3nfb-bJoWQ00jTf-pLbvv7KbsSaTA,1333
+PyInstaller/lib/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
+PyInstaller/lib/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/lib/modulegraph/__init__.py,sha256=q1XQN2YGfSINUSLuBsTs7uhMArf62AFQxdSrq3fS4-o,21
+PyInstaller/lib/modulegraph/__main__.py,sha256=hiwjxxmiY3QfLQ7f0Pd_eSDQYL8MXQyQtkRoJSHe3hU,2653
+PyInstaller/lib/modulegraph/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/lib/modulegraph/__pycache__/__main__.cpython-312.pyc,,
+PyInstaller/lib/modulegraph/__pycache__/find_modules.cpython-312.pyc,,
+PyInstaller/lib/modulegraph/__pycache__/modulegraph.cpython-312.pyc,,
+PyInstaller/lib/modulegraph/__pycache__/util.cpython-312.pyc,,
+PyInstaller/lib/modulegraph/find_modules.py,sha256=D3B5WujxMc6syDuReriZfwxoFw7mBbkLj3-MADyVLD8,1754
+PyInstaller/lib/modulegraph/modulegraph.py,sha256=ECq1P4QcAOLFmlzn1xUn67fuWxp5bJlf59tCu2dZ1jw,133257
+PyInstaller/lib/modulegraph/util.py,sha256=S-0SI65fylZqvy0bN-xMB1xRYp5o0qo7UJnX5IwCzcg,849
+PyInstaller/loader/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
+PyInstaller/loader/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/loader/__pycache__/pyiboot01_bootstrap.cpython-312.pyc,,
+PyInstaller/loader/__pycache__/pyimod01_archive.cpython-312.pyc,,
+PyInstaller/loader/__pycache__/pyimod02_importers.cpython-312.pyc,,
+PyInstaller/loader/__pycache__/pyimod03_ctypes.cpython-312.pyc,,
+PyInstaller/loader/__pycache__/pyimod04_pywin32.cpython-312.pyc,,
+PyInstaller/loader/pyiboot01_bootstrap.py,sha256=L-dAFf4veUwC6xF9qXPvCxuimCDVYyf_f8QU5cJ803A,3712
+PyInstaller/loader/pyimod01_archive.py,sha256=ONLIuAG2whZdRLxA9HvB4jARAnIAPaZ9TU6qWa9P85c,5518
+PyInstaller/loader/pyimod02_importers.py,sha256=M-eGrcINJHzFrPAuqgIfhinzC409W_ih5lEIjMoTLu8,36530
+PyInstaller/loader/pyimod03_ctypes.py,sha256=qTwuwWd8xdd_pMAAE2udo29hOI-VNvKxpmGTsynR8xI,4914
+PyInstaller/loader/pyimod04_pywin32.py,sha256=vFVETWdFpZIroatj0TGpDE2fAMgAVTs80IQjrNGYKuw,2936
+PyInstaller/log.py,sha256=SSZ3NemgYXUOXstVKATS9I2yHTgWQubljlZoFG4DgAk,2065
+PyInstaller/utils/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
+PyInstaller/utils/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/utils/__pycache__/conftest.cpython-312.pyc,,
+PyInstaller/utils/__pycache__/misc.cpython-312.pyc,,
+PyInstaller/utils/__pycache__/osx.cpython-312.pyc,,
+PyInstaller/utils/__pycache__/run_tests.cpython-312.pyc,,
+PyInstaller/utils/__pycache__/tests.cpython-312.pyc,,
+PyInstaller/utils/cliutils/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
+PyInstaller/utils/cliutils/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/utils/cliutils/__pycache__/archive_viewer.cpython-312.pyc,,
+PyInstaller/utils/cliutils/__pycache__/bindepend.cpython-312.pyc,,
+PyInstaller/utils/cliutils/__pycache__/grab_version.cpython-312.pyc,,
+PyInstaller/utils/cliutils/__pycache__/makespec.cpython-312.pyc,,
+PyInstaller/utils/cliutils/__pycache__/set_version.cpython-312.pyc,,
+PyInstaller/utils/cliutils/archive_viewer.py,sha256=zflk6gsqU7G7pPy68BbawHTa376M1NlqLgJ3Wimdp8k,9375
+PyInstaller/utils/cliutils/bindepend.py,sha256=3ds2RnLHUtRYZricqMPRjMcVccKsn9zcwauPCFIRHLA,1844
+PyInstaller/utils/cliutils/grab_version.py,sha256=lfBf_ow1Q4PmwIftV-9hMFEq7eWIWAi5we1au5p6yhI,1857
+PyInstaller/utils/cliutils/makespec.py,sha256=dO9-KTe_lsUFlurY2gF6bOnd7OAn2hvGcmgg2n-GBSs,1640
+PyInstaller/utils/cliutils/set_version.py,sha256=FbC-FfXZs3W0XAvpgsy16T8HPJgZbFlHd2xB9EBwIMc,1503
+PyInstaller/utils/conftest.py,sha256=ryuQRLF3ZjIkVSLVDThXWUVz3S738_9IF2OON80HlSc,26380
+PyInstaller/utils/hooks/__init__.py,sha256=2GOLqXWVVdLdcsl-lTd5MkY3slLvhkwUQ7bdIis1Cys,55139
+PyInstaller/utils/hooks/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/utils/hooks/__pycache__/conda.cpython-312.pyc,,
+PyInstaller/utils/hooks/__pycache__/django.cpython-312.pyc,,
+PyInstaller/utils/hooks/__pycache__/gi.cpython-312.pyc,,
+PyInstaller/utils/hooks/__pycache__/setuptools.cpython-312.pyc,,
+PyInstaller/utils/hooks/__pycache__/tcl_tk.cpython-312.pyc,,
+PyInstaller/utils/hooks/conda.py,sha256=bgygZ2Gp_koKiljtzx-mYAtz6_lWri0znzHshVw_kVA,15209
+PyInstaller/utils/hooks/django.py,sha256=veWnLehyo9xC94_D0TchQuCL4M2-T6EVjNrsoUEoiO0,6135
+PyInstaller/utils/hooks/gi.py,sha256=gAMVjICXEjrnqJCmGYLYmtvwzr0MNjau57O3qDnUwtY,19112
+PyInstaller/utils/hooks/qt/__init__.py,sha256=OTAUqiQFoZJCPCh0_kl_-tsKInz8Fi-8nSn4dFPAxFw,75633
+PyInstaller/utils/hooks/qt/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/utils/hooks/qt/__pycache__/_modules_info.cpython-312.pyc,,
+PyInstaller/utils/hooks/qt/_modules_info.py,sha256=weHgxjAUZ1vEInFM5GcKeoUcUnNDgRsKt0-Xid9Jakc,25225
+PyInstaller/utils/hooks/setuptools.py,sha256=o-UfrcZfhrm0NwoRSeUMusygmbRRy8h3sWuNhnF9NY8,15734
+PyInstaller/utils/hooks/tcl_tk.py,sha256=uRlNzvFuDkcodYKUMAiQHa6wRq89_iTv4tlobMrBIY8,15544
+PyInstaller/utils/misc.py,sha256=5NmfvxjaomhoPEg7yRv1-evvTWTD2HQysd3lhOfgRNg,7030
+PyInstaller/utils/osx.py,sha256=PghjSUN0tHA_JwPEBc4QOKhLlCrr7Skdke6_OFq8YFs,31254
+PyInstaller/utils/run_tests.py,sha256=OCnUmL3dBAN5D-wKM1Dg3sSvsMy925LicSEktIyYodE,2875
+PyInstaller/utils/tests.py,sha256=jZCnSJEFNdwRIiSk_Yrv6v6pY0f7tbdUlAPbdWva9MM,4402
+PyInstaller/utils/win32/__init__.py,sha256=fNGhsx0m5s9iq4yMvH6J1tI0vzUKWd62lIQNSnKTGCE,22
+PyInstaller/utils/win32/__pycache__/__init__.cpython-312.pyc,,
+PyInstaller/utils/win32/__pycache__/icon.cpython-312.pyc,,
+PyInstaller/utils/win32/__pycache__/versioninfo.cpython-312.pyc,,
+PyInstaller/utils/win32/__pycache__/winmanifest.cpython-312.pyc,,
+PyInstaller/utils/win32/__pycache__/winresource.cpython-312.pyc,,
+PyInstaller/utils/win32/__pycache__/winutils.cpython-312.pyc,,
+PyInstaller/utils/win32/icon.py,sha256=mF5Zh58zqj2SR5w3T4GBm4HmyHmTFA9f5MbkPeiU540,9340
+PyInstaller/utils/win32/versioninfo.py,sha256=ublPhIIV3cExqq02y75Vo9tG0IlU9ffrPDcUSDNN-IE,20570
+PyInstaller/utils/win32/winmanifest.py,sha256=zO7kzIDp7MD_9GeF_RfsTrxaTOu_UnICMQUJFGoO54M,10644
+PyInstaller/utils/win32/winresource.py,sha256=DcA0UehlxjoU4s-mRPc51kHrQcHY0GEmAddGnYTekyk,7625
+PyInstaller/utils/win32/winutils.py,sha256=lyx9VtyNtYnjsDIhB2JlK8AaYGrbdMNFPdYmdOpOlXg,9175
+pyinstaller-6.17.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+pyinstaller-6.17.0.dist-info/METADATA,sha256=9eu--iI7G_i8prmO5I7Jo-_0LyIZSpMk5RwD4_QFT5k,8466
+pyinstaller-6.17.0.dist-info/RECORD,,
+pyinstaller-6.17.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pyinstaller-6.17.0.dist-info/WHEEL,sha256=ElIck4UKS1gfqi_USxboIISULsrnySUDnW4muwHK3us,104
+pyinstaller-6.17.0.dist-info/entry_points.txt,sha256=laaKjYFiMC3YuqudHNNx42-TdVB-y4YDLNDOrRFgk4I,376
+pyinstaller-6.17.0.dist-info/licenses/COPYING.txt,sha256=3Pdf25WdseO0HA-FBQadLs54G17Gs9Ck0wl1z8ZYAkU,32138
diff --git a/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/REQUESTED b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/REQUESTED
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/WHEEL b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/WHEEL
new file mode 100644
index 0000000..16259e0
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-manylinux2014_x86_64
diff --git a/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/entry_points.txt b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/entry_points.txt
new file mode 100644
index 0000000..22c2452
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/entry_points.txt
@@ -0,0 +1,7 @@
+[console_scripts]
+pyi-archive_viewer = PyInstaller.utils.cliutils.archive_viewer:run
+pyi-bindepend = PyInstaller.utils.cliutils.bindepend:run
+pyi-grab_version = PyInstaller.utils.cliutils.grab_version:run
+pyi-makespec = PyInstaller.utils.cliutils.makespec:run
+pyi-set_version = PyInstaller.utils.cliutils.set_version:run
+pyinstaller = PyInstaller.__main__:_console_script_run
diff --git a/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/licenses/COPYING.txt b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/licenses/COPYING.txt
new file mode 100644
index 0000000..51bf4bd
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller-6.17.0.dist-info/licenses/COPYING.txt
@@ -0,0 +1,636 @@
+================================
+ The PyInstaller licensing terms
+================================
+ 
+
+Copyright (c) 2010-2023, PyInstaller Development Team
+Copyright (c) 2005-2009, Giovanni Bajo
+Based on previous work under copyright (c) 2002 McMillan Enterprises, Inc.
+
+
+PyInstaller is licensed under the terms of the GNU General Public License
+as published by the Free Software Foundation; either version 2 of the License,
+or (at your option) any later version.
+
+
+Bootloader Exception
+--------------------
+
+In addition to the permissions in the GNU General Public License, the
+authors give you unlimited permission to link or embed compiled bootloader
+and related files into combinations with other programs, and to distribute
+those combinations without any restriction coming from the use of those
+files. (The General Public License restrictions do apply in other respects;
+for example, they cover modification of the files, and distribution when
+not linked into a combined executable.)
+ 
+ 
+Bootloader and Related Files
+----------------------------
+
+Bootloader and related files are files which are embedded within the
+final executable. This includes files in directories:
+
+./bootloader/
+./PyInstaller/loader
+
+
+Run-time Hooks
+----------------------------
+
+Run-time Hooks are a different kind of files embedded within the final
+executable. To ease moving them into a separate repository, or into the
+respective project, these files are now licensed under the Apache License,
+Version 2.0.
+
+Run-time Hooks are in the directory
+./PyInstaller/hooks/rthooks
+
+
+The PyInstaller.isolated submodule
+----------------------------------
+
+By request, the PyInstaller.isolated submodule and its corresponding tests are
+additionally licensed with the MIT license so that it may be reused outside of
+PyInstaller under GPL 2.0 or MIT terms and conditions -- whichever is the most
+suitable to the recipient downstream project. Affected files/directories are:
+
+./PyInstaller/isolated/
+./tests/unit/test_isolation.py
+
+
+About the PyInstaller Development Team
+--------------------------------------
+
+The PyInstaller Development Team is the set of contributors
+to the PyInstaller project. A full list with details is kept
+in the documentation directory, in the file
+``doc/CREDITS.rst``.
+
+The core team that coordinates development on GitHub can be found here:
+https://github.com/pyinstaller/pyinstaller.  As of 2021, it consists of:
+
+* Hartmut Goebel
+* Jasper Harrison
+* Bryan Jones
+* Brenainn Woodsend
+* Rok Mandeljc
+
+Our Copyright Policy
+--------------------
+
+PyInstaller uses a shared copyright model. Each contributor maintains copyright
+over their contributions to PyInstaller. But, it is important to note that these
+contributions are typically only changes to the repositories. Thus,
+the PyInstaller source code, in its entirety is not the copyright of any single
+person or institution.  Instead, it is the collective copyright of the entire
+PyInstaller Development Team.  If individual contributors want to maintain
+a record of what changes/contributions they have specific copyright on, they
+should indicate their copyright in the commit message of the change, when they
+commit the change to the PyInstaller repository.
+
+With this in mind, the following banner should be used in any source code file
+to indicate the copyright and license terms:
+
+
+#-----------------------------------------------------------------------------
+# Copyright (c) 2005-2023, PyInstaller Development Team.
+#
+# Distributed under the terms of the GNU General Public License (version 2
+# or later) with exception for distributing the bootloader.
+#
+# The full license is in the file COPYING.txt, distributed with this software.
+#
+# SPDX-License-Identifier: (GPL-2.0-or-later WITH Bootloader-exception)
+#-----------------------------------------------------------------------------
+
+
+For run-time hooks, the following banner should be used:
+
+#-----------------------------------------------------------------------------
+# Copyright (c) 2005-2023, PyInstaller Development Team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+#
+# The full license is in the file COPYING.txt, distributed with this software.
+#
+# SPDX-License-Identifier: Apache-2.0
+#-----------------------------------------------------------------------------
+
+
+================================
+GNU General Public License
+================================
+
+https://gnu.org/licenses/gpl-2.0.html
+
+
+		    GNU GENERAL PUBLIC LICENSE
+		       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+ 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+			    Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Library General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+		    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) Accompany it with the complete corresponding machine-readable
+    source code, which must be distributed under the terms of Sections
+    1 and 2 above on a medium customarily used for software interchange; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable.  However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+  5. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+  7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded.  In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the 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 Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation.  If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission.  For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this.  Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+			    NO WARRANTY
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+		     END OF TERMS AND CONDITIONS
+
+================================
+Apache License 2.0
+================================
+
+                                 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.
+
+===========
+MIT License
+===========
+
+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.
diff --git a/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/METADATA b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/METADATA
new file mode 100644
index 0000000..f88d9b0
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/METADATA
@@ -0,0 +1,374 @@
+Metadata-Version: 2.4
+Name: pyinstaller-hooks-contrib
+Version: 2025.10
+Summary: Community maintained hooks for PyInstaller
+Home-page: https://github.com/pyinstaller/pyinstaller-hooks-contrib
+Download-URL: https://pypi.org/project/pyinstaller-hooks-contrib
+Maintainer: Legorooj
+Maintainer-email: legorooj@protonmail.com
+Keywords: pyinstaller development hooks
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: setuptools>=42.0.0
+Requires-Dist: importlib_metadata>=4.6; python_version < "3.10"
+Requires-Dist: packaging>=22.0
+Dynamic: description-content-type
+Dynamic: download-url
+Dynamic: license-file
+
+# `pyinstaller-hooks-contrib`: The PyInstaller community hooks repository
+
+What happens when (your?) package doesn't work with PyInstaller? Say you have data files that you need at runtime?
+PyInstaller doesn't bundle those. Your package requires others which PyInstaller can't see? How do you fix that?
+
+In summary, a "hook" file extends PyInstaller to adapt it to the special needs and methods used by a Python package.
+The word "hook" is used for two kinds of files. A runtime hook helps the bootloader to launch an app, setting up the
+environment. A package hook (there are several types of those) tells PyInstaller what to include in the final app -
+such as the data files and (hidden) imports mentioned above.
+
+This repository is a collection of hooks for many packages, and allows PyInstaller to work with these packages
+seamlessly.
+
+
+## Installation
+
+`pyinstaller-hooks-contrib` is automatically installed when you install PyInstaller, or can be installed with pip:
+
+```commandline
+pip install -U pyinstaller-hooks-contrib
+```
+
+
+## I can't see a hook for `a-package`
+
+Either `a-package` works fine without a hook, or no-one has contributed hooks.
+If you'd like to add a hook, or view information about hooks,
+please see below.
+
+
+## Hook configuration (options)
+
+Hooks that support configuration (options) and their options are documented in
+[Supported hooks and options](hooks-config.rst).
+
+
+## I want to help!
+
+If you've got a hook you want to share then great!
+The rest of this page will walk you through the process of contributing a hook.
+If you've been here before then you may want to skip to the [summary checklist](#summary)
+
+**Unless you are very comfortable with `git rebase -i`, please provide one hook per pull request!**
+**If you have more than one then submit them in separate pull requests.**
+
+
+### Setup
+
+[Fork this repo](https://github.com/pyinstaller/pyinstaller-hooks-contrib/fork) if you haven't already done so.
+(If you have a fork already but its old, click the **Fetch upstream** button on your fork's homepage.)
+Clone and `cd` inside your fork by running the following (replacing `bob-the-barnacle` with your github username):
+
+```
+git clone https://github.com/bob-the-barnacle/pyinstaller-hoooks-contrib.git
+cd pyinstaller-hooks-contrib
+```
+
+Create a new branch for you changes (replacing `foo` with the name of the package):
+You can name this branch whatever you like.
+
+```
+git checkout -b hook-for-foo
+```
+
+If you wish to create a virtual environment then do it now before proceeding to the next step.
+
+Install this repo in editable mode.
+This will overwrite your current installation.
+(Note that you can reverse this with `pip install --force-reinstall pyinstaller-hooks-contrib`).
+
+```
+pip install -e .
+pip install -r requirements-test.txt
+pip install flake8 pyinstaller
+```
+
+Note that on macOS and Linux, `pip` may by called `pip3`.
+If you normally use `pip3` and `python3` then use `pip3` here too.
+You may skip the 2nd line if you have no intention of providing tests (but please do provide tests!).
+
+
+### Add the hook
+
+Standard hooks live in the [_pyinstaller_hooks_contrib/stdhooks/](../master/_pyinstaller_hooks_contrib/stdhooks/) directory.
+Runtime hooks live in the [_pyinstaller_hooks_contrib/rthooks/](../master/_pyinstaller_hooks_contrib/rthooks/) directory.
+Simply copy your hook into there.
+If you're unsure if your hook is a runtime hook then it almost certainly is a standard hook.
+
+Please annotate (with comments) anything unusual in the hook.
+*Unusual* here is defined as any of the following:
+
+*   Long lists of `hiddenimport` submodules.
+    If you need lots of hidden imports then use [`collect_submodules('foo')`](https://pyinstaller.readthedocs.io/en/latest/hooks.html#PyInstaller.utils.hooks.collect_submodules).
+    For bonus points, track down why so many submodules are hidden. Typical causes are:
+    *   Lazily loaded submodules (`importlib.importmodule()` inside a module `__getattr__()`).
+    *   Dynamically loaded *backends*.
+    *   Usage of `Cython` or Python extension modules containing `import` statements.
+*   Use of [`collect_all()`](https://pyinstaller.readthedocs.io/en/latest/hooks.html#PyInstaller.utils.hooks.collect_all).
+    This function's performance is abismal and [it is broken by
+    design](https://github.com/pyinstaller/pyinstaller/issues/6458#issuecomment-1000481631) because it confuses
+    packages with distributions.
+    Check that you really do need to collect all of submodules, data files, binaries, metadata and dependencies.
+    If you do then add a comment to say so (and if you know it - why).
+    Do not simply use `collect_all()` just to *future proof* the hook.
+*   Any complicated `os.path` arithmetic (by which I simply mean overly complex filename manipulations).
+
+
+#### Add the copyright header
+
+All source files must contain the copyright header to be covered by our terms and conditions.
+
+If you are **adding** a new hook (or any new python file), copy/paste the appropriate copyright header (below) at the top
+replacing 2021 with the current year.
+
+
GPL 2 header for standard hooks or other Python files.
+
+```python
+# ------------------------------------------------------------------
+# Copyright (c) 2024 PyInstaller Development Team.
+#
+# This file is distributed under the terms of the GNU General Public
+# License (version 2.0 or later).
+#
+# The full license is available in LICENSE, distributed with
+# this software.
+#
+# SPDX-License-Identifier: GPL-2.0-or-later
+# ------------------------------------------------------------------
+```
+
+

+
+
Apache header for runtime hooks only.
+Again, if you're unsure if your hook is a runtime hook then it'll be a standard hook.
+
+```python
+# ------------------------------------------------------------------
+# Copyright (c) 2024 PyInstaller Development Team.
+#
+# This file is distributed under the terms of the Apache License 2.0
+#
+# The full license is available in LICENSE, distributed with
+# this software.
+#
+# SPDX-License-Identifier: Apache-2.0
+# ------------------------------------------------------------------
+```
+
+

+
+
+If you are **updating** a hook, skip this step.
+Do not update the year of the copyright header - even if it's out of date.
+
+
+### Test
+
+Having tests is key to our continuous integration.
+With them we can automatically verify that your hook works on all platforms, all Python versions and new versions of
+libraries as and when they are released.
+Without them, we have no idea if the hook is broken until someone finds out the hard way.
+Please write tests!!!
+
+Some user interface libraries may be impossible to test without user interaction
+or a wrapper library for some web API may require credentials (and possibly a paid subscription) to test.
+In such cases, don't provide a test.
+Instead explain either in the commit message or when you open your pull request why an automatic test is impractical
+then skip on to [the next step](#run-linter).
+
+
+#### Write tests(s)
+
+A test should be the least amount of code required to cause a breakage
+if you do not have the hook which you are contributing.
+For example if you are writing a hook for a library called `foo`
+which crashes immediately under PyInstaller on `import foo` then `import foo` is your test.
+If `import foo` works even without the hook then you will have to get a bit more creative.
+Good sources of such minimal tests are introductory examples
+from the documentation of whichever library you're writing a hook for.
+Package's internal data files and hidden dependencies are prone to moving around so
+tests should not explicitly check for presence of data files or hidden modules directly -
+rather they should use parts of the library which are expected to use said data files or hidden modules.
+
+Tests generally live in [tests/test_libraries.py](../master/tests/test_libraries.py).
+Navigate there and add something like the following, replacing all occurrences of `foo` with the real name of the library.
+(Note where you put it in that file doesn't matter.)
+
+```python
+@importorskip('foo')
+def test_foo(pyi_builder):
+    pyi_builder.test_source("""
+
+        # Your test here!
+        import foo
+
+        foo.something_fooey()
+
+    """)
+```
+
+If the library has changed significantly over past versions then you may need to add version constraints to the test.
+To do that, replace the `@importorskip("foo")` with a call to `PyInstaller.utils.tests.requires()` (e.g.
+`@requires("foo >= 1.4")`) to only run the test if the given version constraint is satisfied.
+Note that `@importorskip` uses module names (something you'd `import`) whereas `@requires` uses distribution names
+(something you'd `pip install`) so you'd use `@importorskip("PIL")` but `@requires("pillow")`.
+For most packages, the distribution and packages names are the same.
+
+
+#### Run the test locally
+
+Running our full test suite is not recommended as it will spend a very long time testing code which you have not touched.
+Instead, run tests individually using either the `-k` option to search for test names:
+
+```
+pytest -k test_foo
+```
+
+Or using full paths:
+```
+pytest tests/test_libraries.py::test_foo
+```
+
+
+#### Pin the test requirement
+
+Get the version of the package you are working with (`pip show foo`)
+and add it to the [requirements-test-libraries.txt](../master/requirements-test-libraries.txt) file.
+The requirements already in there should guide you on the syntax.
+
+
+#### Run the test on CI/CD
+
+
CI/CD now triggers itself when you open a pull request.
+These instructions for triggering jobs manually are obsolete except in rare cases.
+
+To test hooks on all platforms we use Github's continuous integration (CI/CD).
+Our CI/CD is a bit unusual in that it's triggered manually and takes arguments
+which limit which tests are run.
+This is for the same reason we filter tests when running locally -
+the full test suite takes ages.
+
+First push the changes you've made so far.
+
+```commandline
+git push --set-upstream origin hook-for-foo
+```
+
+Replace *billy-the-buffalo* with your Github username in the following url then open it.
+It should take you to the `oneshot-test` actions workflow on your fork.
+You may be asked if you want to enable actions on your fork - say yes.
+```
+https://github.com/billy-the-buffalo/pyinstaller-hooks-contrib/actions/workflows/oneshot-test.yml
+```
+
+Find the **Run workflow** button and click on it.
+If you can't see the button,
+select the **Oneshot test** tab from the list of workflows on the left of the page
+and it should appear.
+A dialog should appear containing one drop-down menu and 5 line-edit fields.
+This dialog is where you specify what to test and which platforms and Python versions to test on.
+Its fields are as follows:
+
+1.  A branch to run from. Set this to the branch which you are using (e.g. ``hook-for-foo``),
+2.  Which package(s) to install and their version(s).
+    Which packages to test are inferred from which packages are installed.
+    You can generally just copy your own changes to the `requirements-test-libraries.txt` file into this box.
+    * Set to `foo` to test the latest version of `foo`,
+    * Set to `foo==1.2, foo==2.3` (note the comma) to test two different versions of `foo` in separate jobs,
+    * Set to `foo bar` (note the lack of a comma) to test `foo` and `bar` in the same job,
+3.  Which OS or OSs to run on
+    * Set to `ubuntu` to test only `ubuntu`,
+    * Set to `ubuntu, macos, windows` (order is unimportant) to test all three OSs.
+4.  Which Python version(s) to run on
+    * Set to `3.9` to test only Python 3.9,
+    * Set to `3.8, 3.9, 3.10, 3.11` to test all currently supported version of Python.
+5.  The final two options can generally be left alone.
+
+Hit the green **Run workflow** button at the bottom of the dialog, wait a few seconds then refresh the page.
+Your workflow run should appear.
+
+We'll eventually want to see a build (or collection of builds) which pass on
+all OSs and all Python versions.
+Once you have one, hang onto its URL - you'll need it when you submit the pull request.
+If you can't get it to work - that's fine.
+Open a pull request as a draft, show us what you've got and we'll try and help.
+
+
+#### Triggering CI/CD from a terminal
+
+If you find repeatedly entering the configuration into Github's **Run workflow** dialog arduous
+then we also have a CLI script to launch it.
+Run ``python scripts/cloud-test.py --help`` which should walk you through it.
+You will have to enter all the details again but, thanks to the wonders of terminal history,
+rerunning a configuration is just a case of pressing up then enter.
+
+

+
+
+### Run Linter
+
+We use `flake8` to enforce code-style.
+`pip install flake8` if you haven't already then run it with the following.
+
+```
+flake8
+```
+
+No news is good news.
+If it complains about your changes then do what it asks then run it again.
+If you don't understand the errors it come up with them lookup the error code
+in each line (a capital letter followed by a number e.g. `W391`).
+
+**Please do not fix flake8 issues found in parts of the repository other than the bit that you are working on.** Not only is it very boring for you, but it is harder for maintainers to
+review your changes because so many of them are irrelevant to the hook you are adding or changing.
+
+
+### Add a news entry
+
+Please read [news/README.txt](https://github.com/pyinstaller/pyinstaller-hooks-contrib/blob/master/news/README.txt) before submitting you pull request.
+This will require you to know the pull request number before you make the pull request.
+You can usually guess it by adding 1 to the number of [the latest issue or pull request](https://github.com/pyinstaller/pyinstaller-hooks-contrib/issues?q=sort%3Acreated-desc).
+Alternatively, [submit the pull request](#submit-the-pull-request) as a draft,
+then add, commit and push the news item after you know your pull request number.
+
+
+### Summary
+
+A brief checklist for before submitting your pull request:
+
+* [ ] All new Python files have [the appropriate copyright header](#add-the-copyright-header).
+* [ ] You have written a [news entry](#add-a-news-entry).
+* [ ] Your changes [satisfy the linter](#run-linter) (run `flake8`).
+* [ ] You have written tests (if possible) and [pinned the test requirement](#pin-the-test-requirement).
+
+
+### Submit the pull request
+
+Once you've done all the above, run `git push --set-upstream origin hook-for-foo` then go ahead and create a pull request.
+If you're stuck doing any of the above steps, create a draft pull request and explain what's wrong - we'll sort you out...
+Feel free to copy/paste commit messages into the Github pull request title and description.
+If you've never done a pull request before, note that you can edit it simply by running `git push` again.
+No need to close the old one and start a new one.
+
+---
+
+If you plan to contribute frequently or are interested in becoming a developer,
+send an email to `legorooj@protonmail.com` to let us know.
diff --git a/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/RECORD b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/RECORD
new file mode 100644
index 0000000..9224d5d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/RECORD
@@ -0,0 +1,1397 @@
+_pyinstaller_hooks_contrib/__init__.py,sha256=Xl5TpgKCZsaKqpZxic0OObIx8zyxsUWPfxgqk9lKb4A,2143
+_pyinstaller_hooks_contrib/__pycache__/__init__.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/__pycache__/__init__.cpython-39.pyc,sha256=nQ3WuYhua27GfzVDKf2U6Sg0zyf_K0iths5NpYFdDDY,772
+_pyinstaller_hooks_contrib/__pycache__/compat.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/compat.py,sha256=0j90ldRf8YpffLKamgybdqt4OepoPO1gFHI7HKE08b8,1535
+_pyinstaller_hooks_contrib/pre_find_module_path/__init__.py,sha256=XqTB__uJKeDTb84jwHlEmqemORWifP5u1Qi4lRzoTqo,420
+_pyinstaller_hooks_contrib/pre_find_module_path/__pycache__/__init__.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/pre_safe_import_module/__init__.py,sha256=XqTB__uJKeDTb84jwHlEmqemORWifP5u1Qi4lRzoTqo,420
+_pyinstaller_hooks_contrib/pre_safe_import_module/__pycache__/__init__.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/pre_safe_import_module/__pycache__/hook-tensorflow.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/pre_safe_import_module/__pycache__/hook-win32com.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/pre_safe_import_module/hook-tensorflow.py,sha256=2g3DIc1sCJGnaWQtAHNtU4P0GxBwO2qb07leNCLQVqw,1415
+_pyinstaller_hooks_contrib/pre_safe_import_module/hook-win32com.py,sha256=0MWymjscSjZYmAZ5y8EnHQaWiWxNKP9gvxYjKJWlbpc,1591
+_pyinstaller_hooks_contrib/rthooks.dat,sha256=3njJi-VRQez966tAcQge2yu82SxpbIEVevqNj7MVinI,599
+_pyinstaller_hooks_contrib/rthooks/__init__.py,sha256=QCvGkX3OU8wyd01O8N1mu-joIPa0-FEZ7eUxvpLXCMY,380
+_pyinstaller_hooks_contrib/rthooks/__pycache__/__init__.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_cryptography_openssl.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_enchant.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_ffpyplayer.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_findlibs.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_nltk.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_osgeo.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_pygraphviz.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_pyproj.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_pyqtgraph_multiprocess.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_pythoncom.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_pywintypes.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_tensorflow.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_traitlets.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/__pycache__/pyi_rth_usb.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_cryptography_openssl.py,sha256=jnzEkk1MZzFk9Mf3fGKvargi127JTaE2QdSrECbiDx4,755
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_enchant.py,sha256=PrKqo5wO5SRSiGnZUXxVUFs-HWXLUHp5ky9HBO-Xtto,903
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_ffpyplayer.py,sha256=qKPwYCFQmmBKitKrbQ0BFTra3bbVmGXB8QwcxXkng6Y,879
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_findlibs.py,sha256=8-W84xT-BaTVFz8HUL58Txrq9h73hlDnfZECvQXhW9o,2468
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_nltk.py,sha256=J50SKKti3MvZIWBRnIBBaqtq91dQ1ogRCVrDvn6Ea54,534
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_osgeo.py,sha256=3REIgW6smeuQhOkiO2OkQ0K6YSqppDHFOmgnJ6AlTZk,1090
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_pygraphviz.py,sha256=G5baiXo35aEQuqdzrRqmPd9BVhdsv5xO9O-5WJvdSpk,1076
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_pyproj.py,sha256=GBehG9sdgrdac6t47V-6azNz5CCjbVegCeezuajdC9k,754
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_pyqtgraph_multiprocess.py,sha256=-Lp14Eho5voCKCiR6Wy6a5Ce8ubwO45giXawxD_EGtE,2469
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_pythoncom.py,sha256=HYSYLvFIWF2p_-VBreDLFLLkux2WzUFvxJX3dmuDyu8,1259
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_pywintypes.py,sha256=HYSYLvFIWF2p_-VBreDLFLLkux2WzUFvxJX3dmuDyu8,1259
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_tensorflow.py,sha256=5iE26zQTgDcjxvnSKy_CCXpJOLVN9-6cQEeFpb_8h34,2665
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_traitlets.py,sha256=6zxDqoyDuCwvg7u-Xu13zsW1hN58Ns8TGqEA06mytow,806
+_pyinstaller_hooks_contrib/rthooks/pyi_rth_usb.py,sha256=ZFT233gTCWeU-NY4cb7ixTr9MUe3VKEDnwxpHFleang,3216
+_pyinstaller_hooks_contrib/stdhooks/__init__.py,sha256=XqTB__uJKeDTb84jwHlEmqemORWifP5u1Qi4lRzoTqo,420
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/__init__.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-BTrees.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-CTkMessagebox.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-Crypto.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-Cryptodome.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-HtmlTestRunner.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-IPython.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-OpenGL.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-OpenGL_accelerate.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-PyTaskbar.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-Xlib.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-_mssql.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-_mysql.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-accessible_output2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-adbutils.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-adios.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-afmformats.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-aliyunsdkcore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-altair.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-amazonproduct.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-anyio.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-apkutils.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-appdirs.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-appy.pod.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-apscheduler.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-argon2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-astor.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-astroid.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-astropy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-astropy_iers_data.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-av.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-avro.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-azurerm.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-backports.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-backports.zoneinfo.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-bacon.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-bcrypt.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-bitsandbytes.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-black.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-bleak.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-blib2to3.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-blspy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-bokeh.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-boto.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-boto3.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-botocore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-branca.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cairocffi.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cairosvg.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-capstone.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cassandra.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-celpy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-certifi.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cf_units.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cftime.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-charset_normalizer.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cloudpickle.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cloudscraper.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-clr.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-clr_loader.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cmocean.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-compliance_checker.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-comtypes.client.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-countrycode.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-countryinfo.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cryptography.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cumm.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-customtkinter.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cv2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cx_Oracle.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-cytoolz.itertoolz.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dash.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dash_bootstrap_components.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dash_core_components.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dash_html_components.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dash_renderer.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dash_table.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dash_uploader.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dask.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-datasets.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dateparser.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dateparser.utils.strptime.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dateutil.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dbus_fast.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dclab.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-detectron2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-discid.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-distorm3.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-distributed.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dns.rdata.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-docutils.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-docx.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-docx2pdf.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-duckdb.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-dynaconf.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-easyocr.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eccodeslib.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eckitlib.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eel.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-emoji.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-enchant.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eng_to_ipa.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-ens.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-enzyme.parsers.ebml.core.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eth_abi.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eth_account.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eth_hash.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eth_keyfile.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eth_keys.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eth_rlp.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eth_typing.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eth_utils.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-eth_utils.network.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-exchangelib.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-fabric.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-fairscale.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-faker.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-falcon.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-fastai.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-fastparquet.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-fckitlib.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-ffpyplayer.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-fiona.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-flask_compress.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-flask_restx.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-flex.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-flirpy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-fmpy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-folium.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-freetype.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-frictionless.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-fsspec.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-fvcore.nn.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-gadfly.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-gbulb.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-gcloud.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-geopandas.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-gitlab.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-globus_sdk.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-gmplot.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-gmsh.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-gooey.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-google.api_core.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-google.cloud.bigquery.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-google.cloud.core.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-google.cloud.kms_v1.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-google.cloud.pubsub_v1.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-google.cloud.speech.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-google.cloud.storage.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-google.cloud.translate.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-googleapiclient.model.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-grapheme.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-graphql_query.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-great_expectations.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-gribapi.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-grpc.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-gst._gst.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-gtk.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-h3.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-h5py.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-hdf5plugin.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-hexbytes.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-httplib2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-humanize.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-hydra.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-ijson.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-imageio.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-imageio_ffmpeg.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-iminuit.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-intake.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-iso639.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-itk.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-jaraco.text.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-jedi.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-jieba.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-jinja2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-jinxed.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-jira.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-jsonpath_rw_ext.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-jsonrpcserver.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-jsonschema.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-jsonschema_specifications.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-jupyterlab.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-kaleido.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-khmernltk.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-kinterbasdb.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-langchain.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-langchain_classic.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-langcodes.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-langdetect.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-laonlp.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-lark.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-ldfparser.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-lensfunpy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-libaudioverse.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-librosa.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-lightgbm.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-lightning.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-limits.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-linear_operator.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-lingua.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-litestar.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-llvmlite.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-logilab.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-lxml.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-lxml.etree.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-lxml.isoschematron.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-lxml.objectify.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-lz4.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-magic.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-mako.codegen.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-mariadb.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-markdown.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-mecab.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-metpy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-migrate.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-mimesis.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-minecraft_launcher_lib.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-mistune.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-mnemonic.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-monai.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-moviepy.audio.fx.all.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-moviepy.video.fx.all.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-mpl_toolkits.basemap.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-msoffcrypto.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nacl.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-names.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nanite.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-narwhals.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nbconvert.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nbdime.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nbformat.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nbt.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-ncclient.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-netCDF4.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nicegui.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-niquests.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nltk.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nnpy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-notebook.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-numba.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-numbers_parser.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-numcodecs.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.cublas.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.cuda_cupti.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.cuda_nvcc.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.cuda_nvrtc.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.cuda_runtime.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.cudnn.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.cufft.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.curand.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.cusolver.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.cusparse.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.nccl.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.nvjitlink.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-nvidia.nvtx.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-office365.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-onnxruntime.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-opencc.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-openpyxl.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-opentelemetry.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-orjson.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-osgeo.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pandas_flavor.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-panel.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-parsedatetime.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-parso.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-passlib.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-paste.exceptions.reporter.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-patoolib.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-patsy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pdfminer.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pendulum.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-phonenumbers.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pingouin.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pint.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pinyin.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-platformdirs.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-plotly.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pointcept.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pptx.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-prettytable.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-psutil.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-psychopy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-psycopg2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-psycopg_binary.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-publicsuffix2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pubsub.core.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-puremagic.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-py.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyarrow.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pycountry.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pycparser.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pycrfsuite.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pydantic.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pydicom.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pydivert.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyecharts.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel-io.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel-ods.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel-ods3.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel-odsr.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel-xls.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel-xlsx.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel-xlsxw.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel_io.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel_ods.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel_ods3.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel_odsr.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel_xls.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel_xlsx.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcel_xlsxw.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyexcelerate.Writer.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pygraphviz.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pygwalker.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pylibmagic.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pylint.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pylsl.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pymediainfo.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pymorphy3.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pymssql.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pynng.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pynput.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyodbc.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyopencl.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pypdfium2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pypdfium2_raw.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pypemicro.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyphen.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyppeteer.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyproj.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pypsexec.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pypylon.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyqtgraph.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyshark.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pysnmp.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pystray.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pytest.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pythainlp.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pythoncom.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyttsx.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyttsx3.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyviz_comms.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pyvjoy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pywintypes.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-pywt.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-qtmodern.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-radicale.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-raven.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-rawpy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-rdflib.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-redmine.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-regex.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-reportlab.lib.utils.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-reportlab.pdfbase._fontdata.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-resampy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-rlp.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-rpy2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-rtree.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-ruamel.yaml.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-rubicon.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sacremoses.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sam2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-saml2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-schwifty.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-seedir.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-selectolax.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-selenium.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sentry_sdk.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-setuptools_scm.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-shapely.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-shotgun_api3.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-simplemma.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.color.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.data.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.draw.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.exposure.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.feature.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.filters.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.future.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.graph.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.io.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.measure.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.metrics.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.morphology.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.registration.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.restoration.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skimage.transform.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.cluster.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.externals.array_api_compat.cupy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.externals.array_api_compat.dask.array.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.externals.array_api_compat.numpy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.externals.array_api_compat.torch.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.linear_model.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.metrics.cluster.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.metrics.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.metrics.pairwise.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.neighbors.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.tree.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sklearn.utils.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-skyfield.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-slixmpp.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sound_lib.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sounddevice.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-soundfile.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-spacy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-speech_recognition.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-spiceypy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-spnego.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-srsly.msgpack._packer.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sspilib.raw.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-statsmodels.tsa.statespace.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-stdnum.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-storm.database.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sudachipy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sunpy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-sv_ttk.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-swagger_spec_validator.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-tableauhyperapi.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-tables.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-tcod.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-tensorflow.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-text_unidecode.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-textdistance.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-thinc.backends.numpy_ops.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-thinc.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-timezonefinder.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-timm.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-tinycss2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-tkinterdnd2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-tkinterweb.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-tkinterweb_tkhtml.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-toga.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-toga_cocoa.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-toga_gtk.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-toga_winforms.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-torch.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-torchao.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-torchaudio.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-torchtext.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-torchvision.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-torchvision.io.image.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_client.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_code.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_components.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_datagrid.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_deckgl.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_formkit.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_grid.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_iframe.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_keycloak.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_leaflet.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_markdown.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_matplotlib.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_mesh_streamer.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_plotly.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_pvui.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_quasar.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_rca.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_router.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_simput.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_tauri.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_tweakpane.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_vega.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_vtk.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_vtk3d.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_vtklocal.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_vuetify.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trame_xterm.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-transformers.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-travertino.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-trimesh.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-triton.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-ttkthemes.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-ttkwidgets.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-tzdata.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-tzwhere.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-u1db.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-ultralytics.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-umap.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-unidecode.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-uniseg.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-urllib3.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-urllib3_future.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-usb.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-uuid6.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-uvicorn.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-uvloop.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vaderSentiment.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkAcceleratorsVTKmCore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkAcceleratorsVTKmDataModel.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkAcceleratorsVTKmFilters.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkChartsCore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkCommonColor.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkCommonComputationalGeometry.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkCommonDataModel.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkCommonExecutionModel.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkCommonMath.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkCommonMisc.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkCommonPython.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkCommonSystem.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkCommonTransforms.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkDomainsChemistry.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkDomainsChemistryOpenGL2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersAMR.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersCellGrid.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersCore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersExtraction.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersFlowPaths.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersGeneral.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersGeneric.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersGeometry.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersGeometryPreview.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersHybrid.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersHyperTree.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersImaging.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersModeling.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersParallel.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersParallelDIY2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersParallelImaging.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersParallelStatistics.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersPoints.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersProgrammable.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersPython.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersReduction.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersSMP.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersSelection.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersSources.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersStatistics.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersTemporal.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersTensor.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersTexture.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersTopology.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkFiltersVerdict.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkGeovisCore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOAMR.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOAsynchronous.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOAvmesh.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOCGNSReader.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOCONVERGECFD.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOCellGrid.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOCesium3DTiles.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOChemistry.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOCityGML.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOCore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOERF.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOEnSight.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOEngys.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOExodus.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOExport.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOExportGL2PS.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOExportPDF.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOFDS.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOFLUENTCFF.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOGeoJSON.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOGeometry.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOH5Rage.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOH5part.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOHDF.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOIOSS.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOImage.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOImport.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOInfovis.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOLANLX3D.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOLSDyna.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOLegacy.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOMINC.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOMotionFX.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOMovie.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIONetCDF.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOOMF.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOOggTheora.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOPIO.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOPLY.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOParallel.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOParallelExodus.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOParallelLSDyna.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOParallelXML.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOSQL.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOSegY.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOTRUCHAS.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOTecplotTable.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOVPIC.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOVeraOut.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOVideo.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOXML.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOXMLParser.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkIOXdmf2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkImagingColor.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkImagingCore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkImagingFourier.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkImagingGeneral.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkImagingHybrid.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkImagingMath.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkImagingMorphological.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkImagingOpenGL2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkImagingSources.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkImagingStatistics.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkImagingStencil.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkInfovisCore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkInfovisLayout.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkInteractionImage.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkInteractionStyle.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkInteractionWidgets.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkParallelCore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkPythonContext2D.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingAnnotation.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingCellGrid.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingContext2D.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingContextOpenGL2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingCore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingExternal.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingFreeType.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingGL2PSOpenGL2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingGridAxes.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingHyperTreeGrid.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingImage.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingLICOpenGL2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingLOD.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingLabel.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingMatplotlib.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingOpenGL2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingParallel.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingSceneGraph.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingUI.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingVR.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingVRModels.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingVolume.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingVolumeAMR.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingVolumeOpenGL2.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkRenderingVtkJS.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkSerializationManager.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkTestingRendering.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkTestingSerialization.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkViewsContext2D.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkViewsCore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkViewsInfovis.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkWebCore.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkmodules.vtkWebGLExporter.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-vtkpython.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-wavefile.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-weasyprint.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-web3.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-webassets.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-webrtcvad.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-websockets.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-webview.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-win32com.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-wordcloud.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-workflow.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-wx.lib.activex.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-wx.lib.pubsub.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-wx.xrc.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-xarray.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-xml.dom.html.HTMLDocument.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-xml.sax.saxexts.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-xmldiff.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-xmlschema.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-xsge_gui.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-xyzservices.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-yapf_third_party.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-z3c.rml.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-zarr.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-zeep.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-zmq.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/__pycache__/hook-zoneinfo.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/stdhooks/hook-BTrees.py,sha256=7H9uPnxAIrlAlMRCpdB5R3EbW-A5LIwzQAGRqvYG3-s,581
+_pyinstaller_hooks_contrib/stdhooks/hook-CTkMessagebox.py,sha256=02LmjIn8U1VELdrxTS0a35PutAP4nKF8ZR99WfIwxvE,663
+_pyinstaller_hooks_contrib/stdhooks/hook-Crypto.py,sha256=ImifI41XPN7GRu8DXatzHp4gC0mcFeIYIjnsgNRABq4,2320
+_pyinstaller_hooks_contrib/stdhooks/hook-Cryptodome.py,sha256=a_fbq7kjC1Zz7qjX5UDYFww7jXZ_Np0PVRE9wY1rCHI,1441
+_pyinstaller_hooks_contrib/stdhooks/hook-HtmlTestRunner.py,sha256=thy5tcQy3lL8tYq_PVJKeqXH1XkOQwlz2xMYvNPDVHc,598
+_pyinstaller_hooks_contrib/stdhooks/hook-IPython.py,sha256=kKCfeaEb5xK2cfzsL0APdYiWOM-j3X2oPLtpOS1XaFY,1358
+_pyinstaller_hooks_contrib/stdhooks/hook-OpenGL.py,sha256=W-blhzRK3eicSxqRQ4tviS9svMs1nIX2DcML0fxeEgU,2153
+_pyinstaller_hooks_contrib/stdhooks/hook-OpenGL_accelerate.py,sha256=5yYETP_dLQwMiTaJMdPxTZPl7gqnVL11gyFcQkoTIf4,761
+_pyinstaller_hooks_contrib/stdhooks/hook-PyTaskbar.py,sha256=hu3r-jyXMpgGe5d6oT4WTKHsadgxvdkCMPRJt3r-JBw,516
+_pyinstaller_hooks_contrib/stdhooks/hook-Xlib.py,sha256=5xU-W0ViBe9fJzkCn9N0hwXQcotayyIJeJEhiDLFNGU,520
+_pyinstaller_hooks_contrib/stdhooks/hook-_mssql.py,sha256=V_j3fb9LsniyK2lWFHnpYLU_s2B2hIk0wEcFQbmye44,446
+_pyinstaller_hooks_contrib/stdhooks/hook-_mysql.py,sha256=7xdzIT7I98Sskkr4khJDGFqdl9wzr7BykdwZWDwGWgE,544
+_pyinstaller_hooks_contrib/stdhooks/hook-accessible_output2.py,sha256=Ua9KkGnbwt-vZqVBIDTQyI-CWRnonhz1RrxTUMrV8HQ,606
+_pyinstaller_hooks_contrib/stdhooks/hook-adbutils.py,sha256=QF2KWHkLivI_UaZLavIRYXdG_x4QnFmX5Wg10vF86Pw,1068
+_pyinstaller_hooks_contrib/stdhooks/hook-adios.py,sha256=3QjwQJxqlXbxDFZLE5V6KxlB5wKe7EWnQ4CPdeGiork,514
+_pyinstaller_hooks_contrib/stdhooks/hook-afmformats.py,sha256=GigubbKoElF8fyK11_ZjoWl_qATq29-o27GczSDAxNg,582
+_pyinstaller_hooks_contrib/stdhooks/hook-aliyunsdkcore.py,sha256=69Q48xGmEUNWohujaq8wgrzl5u-9Jf_EAWF0QblmYeU,520
+_pyinstaller_hooks_contrib/stdhooks/hook-altair.py,sha256=bt3IHynMXZPiD_Lgo_o4WkJ7YcaVfJx6fqGte1nSsOw,514
+_pyinstaller_hooks_contrib/stdhooks/hook-amazonproduct.py,sha256=l0CZhE6sGsuQNSW5B4pXkS0ggLPhf3HbpqSAqAsDL2o,1063
+_pyinstaller_hooks_contrib/stdhooks/hook-anyio.py,sha256=_JkaNd7mliBObKBivEGOJr7PME8fj0x-k7v4v-vfyps,652
+_pyinstaller_hooks_contrib/stdhooks/hook-apkutils.py,sha256=K8lJbqgw9hCldFTx-Gc7f133bqRQKD0FGmWYKEWL0dk,516
+_pyinstaller_hooks_contrib/stdhooks/hook-appdirs.py,sha256=zyPFyUQeR2msS9V_jCqkHlbxKEI4F7fwcenRR_-_VPo,736
+_pyinstaller_hooks_contrib/stdhooks/hook-appy.pod.py,sha256=zXYSVcOaM1Rd5-7XHbdhXcPkXdp2F_Q-2haf-ePtTPM,584
+_pyinstaller_hooks_contrib/stdhooks/hook-apscheduler.py,sha256=JYZ3WCI-UvxHxlkub7BPtcgAC7rIvnmZu_lv8ug4SfE,958
+_pyinstaller_hooks_contrib/stdhooks/hook-argon2.py,sha256=uL9MNx-TVv7xkU6Yna7ZAut_lpmhfU3JtlxqXZPeCz8,455
+_pyinstaller_hooks_contrib/stdhooks/hook-astor.py,sha256=39fA7fjiii_16lKjKfIloHL_XBLZmiLY51EiVLDsdUc,513
+_pyinstaller_hooks_contrib/stdhooks/hook-astroid.py,sha256=c3vLz5R9gpXH1LMgGmgK2M4AyO6GNbjh5F2l9W4wM64,2096
+_pyinstaller_hooks_contrib/stdhooks/hook-astropy.py,sha256=VHGCBTgpzR91qWHyY6RJYvRhpc7dgAGjHLu6WiaHVUM,1744
+_pyinstaller_hooks_contrib/stdhooks/hook-astropy_iers_data.py,sha256=V_rB5H1YPNN8lDpMgItXXPjc5XGLdhm76U0L7I52mZw,581
+_pyinstaller_hooks_contrib/stdhooks/hook-av.py,sha256=j-tpSaAvpyiixxF98-WM-hdVm2kH1dFFDbJwv_4tvtY,2082
+_pyinstaller_hooks_contrib/stdhooks/hook-avro.py,sha256=RRQmqN-5RXPobRHPHO5vNnv-ZPzeQ-0lRoWknxWEkK4,981
+_pyinstaller_hooks_contrib/stdhooks/hook-azurerm.py,sha256=r9O9s3r438qfrR_gFEipp4DzoiVzdxVclosv53Vum0Y,838
+_pyinstaller_hooks_contrib/stdhooks/hook-backports.py,sha256=r0UIln-d8ep_5CTIr1dfV3mHd8SnbJfKgoBVhUbcSp8,905
+_pyinstaller_hooks_contrib/stdhooks/hook-backports.zoneinfo.py,sha256=99A9LN6khAbUAQfey6FaTHtdGZEaaOjavxwawAzbTdo,595
+_pyinstaller_hooks_contrib/stdhooks/hook-bacon.py,sha256=lqd0CnY45BUEVurtqc1VV92ltGnOjjTKfErgLeeBW-w,1675
+_pyinstaller_hooks_contrib/stdhooks/hook-bcrypt.py,sha256=hhNZqKFF5qODocZJ5lBRFdDtJdRBYoiryhtOoSn0jbc,505
+_pyinstaller_hooks_contrib/stdhooks/hook-bitsandbytes.py,sha256=beL5R1Usy2HHrDwKOP1aTmIX4OziLCxX_L2eFQEyorM,1116
+_pyinstaller_hooks_contrib/stdhooks/hook-black.py,sha256=fYKUojxgzW3poA0oBrNVZfgW40hLHLU7V8asr5kejZs,1036
+_pyinstaller_hooks_contrib/stdhooks/hook-bleak.py,sha256=Zm9WX0NmPZPbdTh-6pXhO0GFqvKFzXoGBarYngpXk0M,702
+_pyinstaller_hooks_contrib/stdhooks/hook-blib2to3.py,sha256=F07Geust97rFb8Y691HoPnSda0n1xZIwdHgguSNuXx0,1315
+_pyinstaller_hooks_contrib/stdhooks/hook-blspy.py,sha256=KCo9qWmcFhveIvngEgyNALozIAVKp-9DyaE7hs6F9rw,1407
+_pyinstaller_hooks_contrib/stdhooks/hook-bokeh.py,sha256=-8OUbeppabAY3qVGLWtJC0tqMbgq0W1yvBnKCU4pD4w,922
+_pyinstaller_hooks_contrib/stdhooks/hook-boto.py,sha256=JUGaLqkuSl8u7bO5UlEBoC0T3semsBxQlpr_yDxokUM,786
+_pyinstaller_hooks_contrib/stdhooks/hook-boto3.py,sha256=pI5miSDkHOUA9qHlh4-0lD8odMRD09NS-rLCXU0r-xQ,999
+_pyinstaller_hooks_contrib/stdhooks/hook-botocore.py,sha256=N3hZC_AoVGhB03Pk-nVmM5ezpXtrfaVaEPYwPLZ6sJ8,1067
+_pyinstaller_hooks_contrib/stdhooks/hook-branca.py,sha256=fYU2gaKNBRbG399Vif6CR61fPnDXkr1mzyihcG6cSqM,514
+_pyinstaller_hooks_contrib/stdhooks/hook-cairocffi.py,sha256=xFSRmFXxpK5g4cSfEyUHNMZiJZ-YQ1gzujICk056ch8,1596
+_pyinstaller_hooks_contrib/stdhooks/hook-cairosvg.py,sha256=LtlVNSqrF7mVxHZSYPY1n_8zZUqNhRYG-FuvRgAxkgQ,1303
+_pyinstaller_hooks_contrib/stdhooks/hook-capstone.py,sha256=aaFGgiFLPyUBTtsUQdU6bfzWNTDt6OfzhcaEJloxxrE,562
+_pyinstaller_hooks_contrib/stdhooks/hook-cassandra.py,sha256=-VhGeIvcKJJi8Okp3_cGGKBjStNr8iAB7H-8i1lqr8Q,832
+_pyinstaller_hooks_contrib/stdhooks/hook-celpy.py,sha256=k7jxOzOFwfwXI7cHslOivG6MSuQOWAqv5cwk7bejuts,979
+_pyinstaller_hooks_contrib/stdhooks/hook-certifi.py,sha256=kCFePXDxRwHIQdgFe4DeV-RhS-n33EGeApVuetO9omA,735
+_pyinstaller_hooks_contrib/stdhooks/hook-cf_units.py,sha256=13FWN2RadSk-yJuUkyjGUwqu9yP1xuJzWff5jKWmUS0,591
+_pyinstaller_hooks_contrib/stdhooks/hook-cftime.py,sha256=3rVzaTYOkzhwKOYGO5hpzKJt2dM45hPIUlJTMz01DA4,605
+_pyinstaller_hooks_contrib/stdhooks/hook-charset_normalizer.py,sha256=B9lqK-U2QxEjzf1zUUdZmiXRi9satc2xBGtvp5vIb-0,586
+_pyinstaller_hooks_contrib/stdhooks/hook-cloudpickle.py,sha256=HIrogozsv_bflq62cOENJ80BwrRzgZ2TH2r4zx5oPbA,776
+_pyinstaller_hooks_contrib/stdhooks/hook-cloudscraper.py,sha256=DUQsQhydlJBLnrJ5lLTvxA3CHKXZr4jfPkw1EhRlN04,520
+_pyinstaller_hooks_contrib/stdhooks/hook-clr.py,sha256=87Qo-3XISv-yZehZNPlcgpTRGKWPnrSHgrOGNa8r_Xw,2492
+_pyinstaller_hooks_contrib/stdhooks/hook-clr_loader.py,sha256=r6shf_xCOoGitgm3mje_tmpvOyCuPzZHmRpG9QPAMRs,954
+_pyinstaller_hooks_contrib/stdhooks/hook-cmocean.py,sha256=vwCbQwhokfcEO9Mt1jVSY952Nnxlv-QNort_Hj5v0AA,529
+_pyinstaller_hooks_contrib/stdhooks/hook-compliance_checker.py,sha256=wM6-xACzS3QuiXcXbNNvCqN_yx66bQu5hAWLirMYk-U,988
+_pyinstaller_hooks_contrib/stdhooks/hook-comtypes.client.py,sha256=iN0OgoMpMvIk1b3_ax9IdFyjKD3DSVDC4n3f3Dm7iwk,683
+_pyinstaller_hooks_contrib/stdhooks/hook-countrycode.py,sha256=1hqqPNPpQxOw78iFqOjkPv0JhpOD9_eiGZQRmuoNF5Y,519
+_pyinstaller_hooks_contrib/stdhooks/hook-countryinfo.py,sha256=z_QVmMe89k1f5n4R23mUQi2wUxiCdKvpU9LlKEGmQ_0,565
+_pyinstaller_hooks_contrib/stdhooks/hook-cryptography.py,sha256=vhZ3Wqx_mlgUAWLfPrguxMJ2CHd_r1M3zJob9TBwz3A,5831
+_pyinstaller_hooks_contrib/stdhooks/hook-cumm.py,sha256=bxNUkipmKzc2LxRMwmJ5uhFfHlPB0NqkRz91giSV4iQ,553
+_pyinstaller_hooks_contrib/stdhooks/hook-customtkinter.py,sha256=po89SWrZ1MnlliL1rpaiOdrdR7SZ3sYgeNA-IKdOCpE,520
+_pyinstaller_hooks_contrib/stdhooks/hook-cv2.py,sha256=2D7U2s8858uZk64zKFEIVLAylkjcSKj0no6T362aBMU,8117
+_pyinstaller_hooks_contrib/stdhooks/hook-cx_Oracle.py,sha256=_UwEKqFgJmFfipDEBw9_L6ZFTTkHvaPBfzNhLAREhEo,449
+_pyinstaller_hooks_contrib/stdhooks/hook-cytoolz.itertoolz.py,sha256=Sd_M-AavngziR768WUNTDA0MqQJR2-_u-6ZXbrgWy8s,614
+_pyinstaller_hooks_contrib/stdhooks/hook-dash.py,sha256=JrWymJXOyzHaHHkVoezeLA-pSqKshptuwtJE_eG0AhE,512
+_pyinstaller_hooks_contrib/stdhooks/hook-dash_bootstrap_components.py,sha256=6D7QdcZoxz-g_8Tkunk8TI5i37TY2sDTkDgdAQp4jI0,533
+_pyinstaller_hooks_contrib/stdhooks/hook-dash_core_components.py,sha256=wc5HQi5SGVkduizRW334gtF_oK3G6rBRRC-lnz4gGw4,528
+_pyinstaller_hooks_contrib/stdhooks/hook-dash_html_components.py,sha256=7GCOEhBFjj-T8qLzN6h5KkkrkSXC-t9K1ih303pkQ-0,528
+_pyinstaller_hooks_contrib/stdhooks/hook-dash_renderer.py,sha256=wSmHKr_Kxi8V072QfEYaau1AhnfaXJfdrNsyprRVZLY,521
+_pyinstaller_hooks_contrib/stdhooks/hook-dash_table.py,sha256=GEeJRc0W2nl0YYmCmqMQIuRgexUErPSNqnfLoMmUg1o,518
+_pyinstaller_hooks_contrib/stdhooks/hook-dash_uploader.py,sha256=TqkZRZUpSBqwoYQn4zutn2sg6relzM5-TZFwXATTT9s,521
+_pyinstaller_hooks_contrib/stdhooks/hook-dask.py,sha256=SF-5aAJ6ylzD4Oa1v5QKf57htHCoLOF7DKtGpTfpwxM,752
+_pyinstaller_hooks_contrib/stdhooks/hook-datasets.py,sha256=L508elVV7ax33mODkIR3zrkCnahihoH7UIjheGAzCkM,557
+_pyinstaller_hooks_contrib/stdhooks/hook-dateparser.py,sha256=ldq5qjE9whHtZNwzNHVb1A604O8hS4L58ee4NMBwrTs,706
+_pyinstaller_hooks_contrib/stdhooks/hook-dateparser.utils.strptime.py,sha256=wp34VFRBNFRL5WE99cFNe7IH56n11ydsToVj4JLh6gE,608
+_pyinstaller_hooks_contrib/stdhooks/hook-dateutil.py,sha256=aXwJvtYyPpM_xF0b1NqGu2wx54teQsYkgI4XIoD9vP4,516
+_pyinstaller_hooks_contrib/stdhooks/hook-dbus_fast.py,sha256=fWCWWH1HVQcSttJs75snPaUJQGDJ3S01oMnr-hJjnJk,601
+_pyinstaller_hooks_contrib/stdhooks/hook-dclab.py,sha256=CfGdIi5A3LiYpmq36m3cSwk2by3PeZJO-jvZRgM7XhU,567
+_pyinstaller_hooks_contrib/stdhooks/hook-detectron2.py,sha256=L508elVV7ax33mODkIR3zrkCnahihoH7UIjheGAzCkM,557
+_pyinstaller_hooks_contrib/stdhooks/hook-discid.py,sha256=qh4NpkcK8iGOaZTlDaFzSZs1_vn77ZxJAr_cEVleoRg,1424
+_pyinstaller_hooks_contrib/stdhooks/hook-distorm3.py,sha256=2_5Bog4d91cSmurO9g3LOgHkeYr293elZ4-EJjKjGu8,736
+_pyinstaller_hooks_contrib/stdhooks/hook-distributed.py,sha256=YG2IqwyFFYWeaqhUi6v1pRK9IYGnELEd9wREBYRbhcM,1502
+_pyinstaller_hooks_contrib/stdhooks/hook-dns.rdata.py,sha256=4qJuSXX7pXMEfAKtLA4nfzOY_wglG_AHV3JIKUEZQK4,577
+_pyinstaller_hooks_contrib/stdhooks/hook-docutils.py,sha256=92774IR5j_D9YEL2lFNB31k01Y5jCZg2iqsazEoAxps,798
+_pyinstaller_hooks_contrib/stdhooks/hook-docx.py,sha256=KMXfmjt7AnJoeTS6hfhNBJUggZMti1liAl4kD5hpQxk,512
+_pyinstaller_hooks_contrib/stdhooks/hook-docx2pdf.py,sha256=FKJp5FKPzgSsZFu8YxdNrKwMSbk-6vZvT2hma02vaS0,624
+_pyinstaller_hooks_contrib/stdhooks/hook-duckdb.py,sha256=mE5KYVjqkLFlwxCAtVq9N-b6jrv9FIhkDLZtWoi7_ng,958
+_pyinstaller_hooks_contrib/stdhooks/hook-dynaconf.py,sha256=Ss3Gq19q0S9mbBRWVNH6k0_JgFMz-ZXUA68QNYmOUbw,569
+_pyinstaller_hooks_contrib/stdhooks/hook-easyocr.py,sha256=Y_Q-FawbXomqbqHzMxPF8yqo-8c-6dyCx4_rGrUXyjw,793
+_pyinstaller_hooks_contrib/stdhooks/hook-eccodeslib.py,sha256=DMHQ55Z7t_4WPqGeHhwZvFQcemrVel__jLBvxwTYkZ8,794
+_pyinstaller_hooks_contrib/stdhooks/hook-eckitlib.py,sha256=R7VJXNt1Wkrq8kBCZWNjUhPxZvr3rEYH9CJ1di_F05M,560
+_pyinstaller_hooks_contrib/stdhooks/hook-eel.py,sha256=AacHCZd4184RbnUFOLTYbkmKkJEQkGr3LdMqn1UXiBc,548
+_pyinstaller_hooks_contrib/stdhooks/hook-emoji.py,sha256=ABtuKzCZqaE2RUdf2NcLnV16L7DQABJ692aOfvANj2E,513
+_pyinstaller_hooks_contrib/stdhooks/hook-enchant.py,sha256=6mswnI2jCHY18DS5J4wnmHvrDAGKr8yBhBHzCe4j1uY,2851
+_pyinstaller_hooks_contrib/stdhooks/hook-eng_to_ipa.py,sha256=YDRMsxwI9VzlZn69TwuYiMC4jv-7elcnO3IEYFnRw2E,518
+_pyinstaller_hooks_contrib/stdhooks/hook-ens.py,sha256=3vC3d_ENo5JdDSq2ajWKfnR5WKC2OJQOdPJqjtn7sLA,511
+_pyinstaller_hooks_contrib/stdhooks/hook-enzyme.parsers.ebml.core.py,sha256=yS_g1AxOW2-R-1xKtBK0Q9EC_D9ylhVBrirH9tJ0-zY,722
+_pyinstaller_hooks_contrib/stdhooks/hook-eth_abi.py,sha256=NHm7ncjWCD_l2XdP6vBaxz5y516U_IL1P4YevtTtuRM,505
+_pyinstaller_hooks_contrib/stdhooks/hook-eth_account.py,sha256=wjvWKcrTK2fWp6S4pEm-o8NYc3g9mCbHVZuU035zFrc,509
+_pyinstaller_hooks_contrib/stdhooks/hook-eth_hash.py,sha256=lzNsLR5kuz2sXXxkym0HTko_393jucPnFCQDQd_g7zg,814
+_pyinstaller_hooks_contrib/stdhooks/hook-eth_keyfile.py,sha256=CYTnYWvRKUwVEjUTF1-O8gA3_uqKOHZpZJryaFVSFPc,509
+_pyinstaller_hooks_contrib/stdhooks/hook-eth_keys.py,sha256=4r5kmLTtARNZza-JoJP1rLL2RExMrwbxrTtxBsLIIQg,667
+_pyinstaller_hooks_contrib/stdhooks/hook-eth_rlp.py,sha256=kQWMVCiyc4htFsk1JySBkj74Q0QqrSjcD-C-C_xn5yI,643
+_pyinstaller_hooks_contrib/stdhooks/hook-eth_typing.py,sha256=c6ywwe1EhToKTbCbGmUGK6RUTD8oVwP5DGM6rl5JKPI,586
+_pyinstaller_hooks_contrib/stdhooks/hook-eth_utils.network.py,sha256=1dmUGrCLFa_xkiF5fNDYUom4SjnnI2t9yd5XSXl32Lw,517
+_pyinstaller_hooks_contrib/stdhooks/hook-eth_utils.py,sha256=ORE3BzSrHBDzqMjFR88iTm5VOvL7EPOjgLgP3caXoPU,507
+_pyinstaller_hooks_contrib/stdhooks/hook-exchangelib.py,sha256=PjUxCRbRboGbLZzFeehWOhPzr0jO11AYstKtsFQvRkw,447
+_pyinstaller_hooks_contrib/stdhooks/hook-fabric.py,sha256=H87in7hd-RG6PfQTmEulm_mG0sbs5rG3-H8gWfct96A,733
+_pyinstaller_hooks_contrib/stdhooks/hook-fairscale.py,sha256=c_35rJ4w0apax7S0Pnkz7gN0oM3fmbGYhhp1eo9rfHk,557
+_pyinstaller_hooks_contrib/stdhooks/hook-faker.py,sha256=6MMBGNG0oZC4wiq4FnFxqRimXOoNUHDeO8QCxNqdbfg,685
+_pyinstaller_hooks_contrib/stdhooks/hook-falcon.py,sha256=qOelGQSufRVtgZNH0DFMQtPFAl-9UbYXkgWIEIB74qg,1194
+_pyinstaller_hooks_contrib/stdhooks/hook-fastai.py,sha256=L508elVV7ax33mODkIR3zrkCnahihoH7UIjheGAzCkM,557
+_pyinstaller_hooks_contrib/stdhooks/hook-fastparquet.py,sha256=y3QWOzrz-Ra8H18SWDujD9dozbkzXR8BPesRWReYN-U,1469
+_pyinstaller_hooks_contrib/stdhooks/hook-fckitlib.py,sha256=5h4PvGmxi3l7kz1nI4CCWAkTfYMHiCATThUVyUwy78w,560
+_pyinstaller_hooks_contrib/stdhooks/hook-ffpyplayer.py,sha256=WD4t4z-SQHZAe-bqIKVEwrWbIUhxQNn6io5PnPWL6UY,741
+_pyinstaller_hooks_contrib/stdhooks/hook-fiona.py,sha256=IjYbiaUeeKB_gq4lPM6OJDLAnXjLyiIyW5jp3cNZ_JA,860
+_pyinstaller_hooks_contrib/stdhooks/hook-flask_compress.py,sha256=UMHjLHHYDtnW50Y_MtQUZqJX0-cimZJsJsA3El6ZUJc,512
+_pyinstaller_hooks_contrib/stdhooks/hook-flask_restx.py,sha256=KnTudaPgYyQXgmDtjYQUJ_lVkUc9hvZOLNNO_Fa_LHo,546
+_pyinstaller_hooks_contrib/stdhooks/hook-flex.py,sha256=q7mHzzXLkNUYRZNJRz-60lvuPtHYoPYd3MUxue5Lh5E,551
+_pyinstaller_hooks_contrib/stdhooks/hook-flirpy.py,sha256=xmI3ET8t0j3rVUbN_4foknfB1W9QGFRZq0l6pa3u4h8,650
+_pyinstaller_hooks_contrib/stdhooks/hook-fmpy.py,sha256=ZLsw9nwYplOC9AZpYRS08WYech5yNW3LdYmbL1-oTqE,799
+_pyinstaller_hooks_contrib/stdhooks/hook-folium.py,sha256=J81aLD-9FBtrnO1XhRpZUQ6qNoRpvBkByYa45Xs_FbI,547
+_pyinstaller_hooks_contrib/stdhooks/hook-freetype.py,sha256=t1qrKUdxYInJIt0pplH-vsvLyt-YUJsbLobgPN0dGq4,584
+_pyinstaller_hooks_contrib/stdhooks/hook-frictionless.py,sha256=tIdhDA-X4DobBTA9otBiWtKQWqB6q2n6VxQfBi_sEcE,714
+_pyinstaller_hooks_contrib/stdhooks/hook-fsspec.py,sha256=D-Q1uGwCc0rfHHgaRueYp3HOHo0wu2r80f1B4-cZn5w,522
+_pyinstaller_hooks_contrib/stdhooks/hook-fvcore.nn.py,sha256=L508elVV7ax33mODkIR3zrkCnahihoH7UIjheGAzCkM,557
+_pyinstaller_hooks_contrib/stdhooks/hook-gadfly.py,sha256=9mUNliNadIqvXXvQth9EPB6LdBfPWSbMYwumdy9m8NA,449
+_pyinstaller_hooks_contrib/stdhooks/hook-gbulb.py,sha256=QMzeWRQmulGUFSBGcyfjxTP3iDz_sf5ItOVyiENGCN4,574
+_pyinstaller_hooks_contrib/stdhooks/hook-gcloud.py,sha256=mkGLaUpDMCXtOuO8d07Hb2aDM7sOIfWFXeqZA_U0SQA,792
+_pyinstaller_hooks_contrib/stdhooks/hook-geopandas.py,sha256=f48s1JU_xMkNmMqP_SC1mFsEP_wDmh6T3N0jWd6vGBE,536
+_pyinstaller_hooks_contrib/stdhooks/hook-gitlab.py,sha256=aG2RH2UnKEwxnWNRbC5qpiOF7_K0CC56TOS-lDaXtl0,735
+_pyinstaller_hooks_contrib/stdhooks/hook-globus_sdk.py,sha256=YWmI0DfOYarlVc2z5jXBnCrobomNIt8-qFN3hBt7yK4,639
+_pyinstaller_hooks_contrib/stdhooks/hook-gmplot.py,sha256=3ushmjY5pSdT1NogR2UQ7Gx6ICcBNCyvuoKb3-vSXsQ,519
+_pyinstaller_hooks_contrib/stdhooks/hook-gmsh.py,sha256=LDtlKdCjMuk5pCq-BC962k9LFvfDMpUy5y8GSNj0t98,999
+_pyinstaller_hooks_contrib/stdhooks/hook-gooey.py,sha256=bqarqbH4UYL6HayuYlxlwpdbupmsX6bh6wiaH_Bf0YQ,589
+_pyinstaller_hooks_contrib/stdhooks/hook-google.api_core.py,sha256=2bn_nmbQSXYrIryWoWSiQKZc_n366zmRGaygkb5CLF8,513
+_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.bigquery.py,sha256=HC9mpFSO_64lDE0NPt1x6jJ-8jDjQSJD5R8sclQ0bB8,616
+_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.core.py,sha256=KS3LQpaY_QdbB7dukd9-A4_XwlfNpZAAu7eFnABVHe8,515
+_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.kms_v1.py,sha256=63WBtHUc0Cmd5jaGGuDXpC7nfvMjy6B8GGs4Kr4hfHQ,709
+_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.pubsub_v1.py,sha256=NBN0AvXonoi8gVC7mbO9GcEkpgqvTJusw77cf8x9d58,517
+_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.speech.py,sha256=IDmBkM2IXW9stcNaPEZmdpo8zCyNJN_lARhDx3USKYE,517
+_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.storage.py,sha256=IPIqFK6fbDn1pfBoZz9Qblh3fd9yzFvv7tmEgcB52AM,518
+_pyinstaller_hooks_contrib/stdhooks/hook-google.cloud.translate.py,sha256=qEs34x4eIHlMbgXEYlF_lWsoS7WueJT4MuaVRrU3P3A,520
+_pyinstaller_hooks_contrib/stdhooks/hook-googleapiclient.model.py,sha256=E-iDIuZc6ZVAdREtV3N3HLpytuL6I8ZQEtiUanbYlCo,852
+_pyinstaller_hooks_contrib/stdhooks/hook-grapheme.py,sha256=qZDgWdsOXerr29TAVkT6Kf74WnAWL_4Sln-09f-t_tA,516
+_pyinstaller_hooks_contrib/stdhooks/hook-graphql_query.py,sha256=KJUnT5Mw7j2bRecW2sRQ6qCRtUUuzF9r6wJ5lqWb-Ow,623
+_pyinstaller_hooks_contrib/stdhooks/hook-great_expectations.py,sha256=lGEsG7c8SCYYqTTkIq5-lFH5y8HXumf0XiE6wnj7J1k,526
+_pyinstaller_hooks_contrib/stdhooks/hook-gribapi.py,sha256=8tqxBIbvrTJP0iv1pd5v0M1XaJ5n-AxJ3VKhoQIDdqw,3977
+_pyinstaller_hooks_contrib/stdhooks/hook-grpc.py,sha256=LOSNA9INFfZNN3ExRQgVuof--iX63covoc_Qak_Vf8M,512
+_pyinstaller_hooks_contrib/stdhooks/hook-gst._gst.py,sha256=pUwgQGZvZcqc0B17mKrQkjO9HK6LJVvT2bOESNH0CaU,1324
+_pyinstaller_hooks_contrib/stdhooks/hook-gtk.py,sha256=fsCK_gJ-Gr3wQwp6KKA3Schnp5M7fCaHVKW_17aSEXU,667
+_pyinstaller_hooks_contrib/stdhooks/hook-h3.py,sha256=l02ffSxT6gn8TGL-Gy6Ckp7S3wwHTZNWggBm8NALNWw,633
+_pyinstaller_hooks_contrib/stdhooks/hook-h5py.py,sha256=1wcUIIsyjZ5A4O4bgvPOHGY6myx-o5kbFrihtWtQn7o,599
+_pyinstaller_hooks_contrib/stdhooks/hook-hdf5plugin.py,sha256=VXWPfqygkI3MEqgtYwMId1y9stV1hw2cgxzKdClYIPI,583
+_pyinstaller_hooks_contrib/stdhooks/hook-hexbytes.py,sha256=xNwjMe8uKcWA38uvakQD2Ai82Fpnlq2U00vFSEqXRUE,646
+_pyinstaller_hooks_contrib/stdhooks/hook-httplib2.py,sha256=jfXcSWs7-Y6rZnTzMdn8EeWZ2gIrQ853PjJS0Q5EUkU,588
+_pyinstaller_hooks_contrib/stdhooks/hook-humanize.py,sha256=jrrLXtdJHGahTfb9PJ87bYvF_NWeQIeNCdv03Tsq_rs,785
+_pyinstaller_hooks_contrib/stdhooks/hook-hydra.py,sha256=OS29zE6K1PfxfIjqhjrVB0gEBMIGuBItM1PfIrJpfiA,1627
+_pyinstaller_hooks_contrib/stdhooks/hook-ijson.py,sha256=3aBT5U_9srfc87VKclEFjnhfspLFqARnBtVS4eQ4GiE,530
+_pyinstaller_hooks_contrib/stdhooks/hook-imageio.py,sha256=vJhTwA3FFwJtM2PpBYs8KbE61ZMZ2EmAY_5aVoybPvo,793
+_pyinstaller_hooks_contrib/stdhooks/hook-imageio_ffmpeg.py,sha256=2-sPmk5OXOCJM2n4_OFPLLTsjwVdLc5Gm9TPfG-Oyno,905
+_pyinstaller_hooks_contrib/stdhooks/hook-iminuit.py,sha256=N5CFLEfIobQAEBX8QDaC5dXmmRiKeW6hoQiZw1H8oN4,843
+_pyinstaller_hooks_contrib/stdhooks/hook-intake.py,sha256=x2Vcz2aS__G_OpNM_1LxfmNVHaljB8tdsLut2cZyeLg,539
+_pyinstaller_hooks_contrib/stdhooks/hook-iso639.py,sha256=1EpKUHp9Is6cXqKg_xZGt2WXD6YzXDvkhvwp1UIEWzQ,546
+_pyinstaller_hooks_contrib/stdhooks/hook-itk.py,sha256=zKRK27k3FbTapA4qND2cRBTpuZLomDytNapCoprjQzA,784
+_pyinstaller_hooks_contrib/stdhooks/hook-jaraco.text.py,sha256=fyTyuTGQtSohmuztyrpqnhNMypIpuDqydCfDgjxgNYw,586
+_pyinstaller_hooks_contrib/stdhooks/hook-jedi.py,sha256=UV5c9XwxrJbidPDmA6XsOxTvz80t2ApH7gwfpB7rw-c,584
+_pyinstaller_hooks_contrib/stdhooks/hook-jieba.py,sha256=0jVycYYGjL1l5VhuzqOuNbrqtH4r8NCsUM2NEazptZ4,513
+_pyinstaller_hooks_contrib/stdhooks/hook-jinja2.py,sha256=FFEjO4CoqIlIFVGrdE1dczGexwhjtpUM3rfI3iMj9rE,452
+_pyinstaller_hooks_contrib/stdhooks/hook-jinxed.py,sha256=4Gb2axZd_-IZOsehrDA77EU3UiJgSinNt3AZ8TqHyZg,498
+_pyinstaller_hooks_contrib/stdhooks/hook-jira.py,sha256=MmTbxQc6MyvmGkkVeCHW2I3LrTu5A9LqYiErBBQnnIc,617
+_pyinstaller_hooks_contrib/stdhooks/hook-jsonpath_rw_ext.py,sha256=g9VVlyJm5vG6WfOFL39F4cAOpzoFQRbeQbLgw9l6Zvg,513
+_pyinstaller_hooks_contrib/stdhooks/hook-jsonrpcserver.py,sha256=uWOOdTGQqG3DvJNXrH5RieeiXp-EiCIyEmj6c4TMSTU,608
+_pyinstaller_hooks_contrib/stdhooks/hook-jsonschema.py,sha256=qmhcVRvyD_Zp18NsI53HIDfG25LdT7Aumw7W4n37Uqs,828
+_pyinstaller_hooks_contrib/stdhooks/hook-jsonschema_specifications.py,sha256=kDKzf09IHlbHzq2Ks4Tl40iN6WrxQfWPjpn3DYnWseI,532
+_pyinstaller_hooks_contrib/stdhooks/hook-jupyterlab.py,sha256=TU3o0IgEU9y9fyv5PsHzsKiadmXvvTxHyLYcLYzUQhk,518
+_pyinstaller_hooks_contrib/stdhooks/hook-kaleido.py,sha256=VQMvkWK3B1bSOmaKUZuSx_BHyAhMW2goRmZzEqGHYas,515
+_pyinstaller_hooks_contrib/stdhooks/hook-khmernltk.py,sha256=9RQud3NQliAQCtgo8hwQaS1Z5TKAc1he4zQ6bfeYMk8,554
+_pyinstaller_hooks_contrib/stdhooks/hook-kinterbasdb.py,sha256=cztOr2aUEqQ8d5qpQpuEAridpYruESuhfxBWSlJ6QoE,843
+_pyinstaller_hooks_contrib/stdhooks/hook-langchain.py,sha256=gG7VV_ksX97KUoxJtmnIB-gs54R3mUry2a-Bms3USIQ,673
+_pyinstaller_hooks_contrib/stdhooks/hook-langchain_classic.py,sha256=FvWDZToqOv6BWMUnKlyK8HEpkEM129F2rqrEn-xt0mY,525
+_pyinstaller_hooks_contrib/stdhooks/hook-langcodes.py,sha256=7hkFTGFSzn0DxY4NV1UEKodps6H6r4bYXUTojIFfhX4,517
+_pyinstaller_hooks_contrib/stdhooks/hook-langdetect.py,sha256=Qz0siDS9evVsqD3_OP2AgNpCz80qZ-hbfWUXs1ELtI4,518
+_pyinstaller_hooks_contrib/stdhooks/hook-laonlp.py,sha256=ZdENgKj_FFxnJfMoylOOouTn9UO2ifsamzT_PaWm-C0,514
+_pyinstaller_hooks_contrib/stdhooks/hook-lark.py,sha256=zQzLT5Uu5jzKTDvGu377iTWbzW77LhJV_W-vDcnmHI0,512
+_pyinstaller_hooks_contrib/stdhooks/hook-ldfparser.py,sha256=EIwxRlqMm2cOBgY6l1kgiJu_mTCX5lAryYty-I4FkZ0,527
+_pyinstaller_hooks_contrib/stdhooks/hook-lensfunpy.py,sha256=mPlp2664ax5tALxpyFiMsl_IQMBb746yMUD4bi8cS1I,665
+_pyinstaller_hooks_contrib/stdhooks/hook-libaudioverse.py,sha256=Y0tna0zcvXUUd5GFAhPWtPYv7wdrrcFt84HPecw-Sm8,598
+_pyinstaller_hooks_contrib/stdhooks/hook-librosa.py,sha256=rGNfBzWJENA4pBcL2r7-mtkQo9itqSu3JMyBfPpP5Yg,1178
+_pyinstaller_hooks_contrib/stdhooks/hook-lightgbm.py,sha256=70sAQmPVTOmG4N2tlwoCx8IAJi4u9L7ETQtFJzST2gI,937
+_pyinstaller_hooks_contrib/stdhooks/hook-lightning.py,sha256=7t0rY7UaocV5G_o09y1tNygCuilGCVX7XMG0sUfqEWw,834
+_pyinstaller_hooks_contrib/stdhooks/hook-limits.py,sha256=KvoW_h8Y_wcVkE_vlFIasuZ4S94kSKYdSlm1Ixg3_KI,514
+_pyinstaller_hooks_contrib/stdhooks/hook-linear_operator.py,sha256=amNNgp4raSBDaxNePyQVBov8_HzAhRflS66FWxljFQ0,542
+_pyinstaller_hooks_contrib/stdhooks/hook-lingua.py,sha256=gesRIVvBsRj3D4FWRY0jyMsQXR9uWs-mxWD3lruevdc,514
+_pyinstaller_hooks_contrib/stdhooks/hook-litestar.py,sha256=xJ3Y0Fj2sbkjFUhXiZIpUUsP9X81Z0bw7iGQ03Xif6o,531
+_pyinstaller_hooks_contrib/stdhooks/hook-llvmlite.py,sha256=B3-ddCSih9fqn8mbdY23YoENrC8s7rNw8WrMiSWgYmA,705
+_pyinstaller_hooks_contrib/stdhooks/hook-logilab.py,sha256=yb-uN2Rg-1ihtwse8jrTjHIMjNU6nmj1bEA4wIrPFNg,939
+_pyinstaller_hooks_contrib/stdhooks/hook-lxml.etree.py,sha256=XF1VE0AnAth1M-K6uYgtMCeFxfamSy7SLC4dH5-iee8,481
+_pyinstaller_hooks_contrib/stdhooks/hook-lxml.isoschematron.py,sha256=sKerEc6cSSX7CkkMWKfLRYHd-mu_iH0iQUrsp_MZXpM,608
+_pyinstaller_hooks_contrib/stdhooks/hook-lxml.objectify.py,sha256=MZX0zqo3_F6E4k0MS2A0iNF6QMGVD9fHhd2Ma0cXv9g,452
+_pyinstaller_hooks_contrib/stdhooks/hook-lxml.py,sha256=luxF2PUPGJFBDZY6Y486XEfhPowPSgzB_AKE-H7Xgig,673
+_pyinstaller_hooks_contrib/stdhooks/hook-lz4.py,sha256=FtaB7EdUUQc85tIhSDLhdTqauinP4RoyaqtQDbacmyk,553
+_pyinstaller_hooks_contrib/stdhooks/hook-magic.py,sha256=tBNg4y0dohfsfx2au3pHY8Sa56zkwRiqd2QdNY2P8o8,630
+_pyinstaller_hooks_contrib/stdhooks/hook-mako.codegen.py,sha256=jxcMKzHiK-n92wy4pA1WNbvZi-j6Icsu6RRU_wI1_z4,608
+_pyinstaller_hooks_contrib/stdhooks/hook-mariadb.py,sha256=8VjEMveHwCNh0SmJhs3IF5BpdrC-vq-oCsf59E4Hilk,1102
+_pyinstaller_hooks_contrib/stdhooks/hook-markdown.py,sha256=GuzXwF811hd-X4plC2JpxsnPZ8_iiXhDp0UcODyDaDg,957
+_pyinstaller_hooks_contrib/stdhooks/hook-mecab.py,sha256=TmOaHmDsVqUhHWqIJs9dKGL-T3AECAVLkGx8KjLj0y0,557
+_pyinstaller_hooks_contrib/stdhooks/hook-metpy.py,sha256=C-jKRq46CqsM8RDxDWvqgJzzjutzdVmbG1QyZZtzsWE,763
+_pyinstaller_hooks_contrib/stdhooks/hook-migrate.py,sha256=wzhAF5oPLYG2SBnK4h_4Rvd-x3hxJvCXYgdZlTutYTE,743
+_pyinstaller_hooks_contrib/stdhooks/hook-mimesis.py,sha256=njbgWuTJAA7W-l-EtiUU6G7xaRO3yP6ifjLJ1n1aScc,616
+_pyinstaller_hooks_contrib/stdhooks/hook-minecraft_launcher_lib.py,sha256=N6mf05sx3DX6pD1brbLuH6ftqMvA4fd_vi97FzBX3ec,529
+_pyinstaller_hooks_contrib/stdhooks/hook-mistune.py,sha256=9_blbpnB___kQ7gGpnJevHCjuGOVG3COt2-r-lgEpds,766
+_pyinstaller_hooks_contrib/stdhooks/hook-mnemonic.py,sha256=7XNJhrD_xeQb-2GX0kc_SeWMpMqIDHs8QV6u6NDGXD8,516
+_pyinstaller_hooks_contrib/stdhooks/hook-monai.py,sha256=P6KfEOWbPSQAjG9v81gKtZN4uz_PAGBMoOIB9eGEEfE,557
+_pyinstaller_hooks_contrib/stdhooks/hook-moviepy.audio.fx.all.py,sha256=JV9JNs53PuDR0Cxs0f2HjdJeqpHPEscnVfAXjJyks3w,682
+_pyinstaller_hooks_contrib/stdhooks/hook-moviepy.video.fx.all.py,sha256=cV4zBHk-_Lv5KX6unZirO_6JaqOSZpCciO0WTAEM19M,682
+_pyinstaller_hooks_contrib/stdhooks/hook-mpl_toolkits.basemap.py,sha256=ON-rPY8kO_IASnjpEeDaHrQXkUmXpzIP03GX-xOyzY8,1283
+_pyinstaller_hooks_contrib/stdhooks/hook-msoffcrypto.py,sha256=6PhHu099kv6aw1SizJFkUvQjyd8uOwHXdrx4jOmFQV4,573
+_pyinstaller_hooks_contrib/stdhooks/hook-nacl.py,sha256=Yl9cJzIOFKxTpmPJQhZZC_0dU3N-wpcumgXftncw_x4,1029
+_pyinstaller_hooks_contrib/stdhooks/hook-names.py,sha256=xT5qJlRMFOoftJfxVTlzamWQDBBp4iS0o8MxVLXPH6Y,610
+_pyinstaller_hooks_contrib/stdhooks/hook-nanite.py,sha256=1WAm5zr93zGp-9tCkSAjAHrn_Ip20EGOWvkCE9KhODc,570
+_pyinstaller_hooks_contrib/stdhooks/hook-narwhals.py,sha256=sYgEMI_ha4CAZPMyWj7HiVxgar6--LcAXEaGJCu9y3I,1032
+_pyinstaller_hooks_contrib/stdhooks/hook-nbconvert.py,sha256=hjVfkj9XSy6Cb0oqjXPUMDsOPXFFw0J-WbWVVe5Sf48,663
+_pyinstaller_hooks_contrib/stdhooks/hook-nbdime.py,sha256=KRxL0qDNvWCeYVcaBJZkNiQlxiY8uhbitRVs0-b3PNo,514
+_pyinstaller_hooks_contrib/stdhooks/hook-nbformat.py,sha256=pODKrbD5E56BvJ1igFFFI0zGhNX94ariUckS-FzTyJg,516
+_pyinstaller_hooks_contrib/stdhooks/hook-nbt.py,sha256=uVSdxM8DzSAXrm-Vj4ZUbjbSA1DxAC-O17wx33sXVIM,488
+_pyinstaller_hooks_contrib/stdhooks/hook-ncclient.py,sha256=272a8onLx4TVwQOLgkACgxdB3IFqWSO3gMeTtY75Hy8,862
+_pyinstaller_hooks_contrib/stdhooks/hook-netCDF4.py,sha256=eIijhYxEiYtuOJ7k7kdlfNDb5Jm49UWx7f-Y39m4M-8,1658
+_pyinstaller_hooks_contrib/stdhooks/hook-nicegui.py,sha256=524GQTVLj0ZoMMm1vwEMuJH3PBRkoy4w4ZOucNbGNjw,514
+_pyinstaller_hooks_contrib/stdhooks/hook-niquests.py,sha256=qQNb1Gd8UCy4j-V2gX8tHpcFKzIvqtEEVatwzRojK8U,524
+_pyinstaller_hooks_contrib/stdhooks/hook-nltk.py,sha256=muSBoO_ynOKyiAgrrxFG8TEbw8c7PwIz2rRzHYMPg14,808
+_pyinstaller_hooks_contrib/stdhooks/hook-nnpy.py,sha256=ZKFpMzgVuMehm_cGLWb8ABTE0ZEJEmNuCTjEhnn87Zo,503
+_pyinstaller_hooks_contrib/stdhooks/hook-notebook.py,sha256=1wUrdtvTqXi6Q7kBNOnavWY4LIGVbRMPDVjZ3KlQu24,1046
+_pyinstaller_hooks_contrib/stdhooks/hook-numba.py,sha256=-9ZYW0PvNjK752jaHhL69QzBZQ8-6RsgwRG0vh6gVQw,2538
+_pyinstaller_hooks_contrib/stdhooks/hook-numbers_parser.py,sha256=TkQrE6nvV-DR2pDjUWPqlBRJ2w-e2oGP6CFqrmyGMkk,586
+_pyinstaller_hooks_contrib/stdhooks/hook-numcodecs.py,sha256=epxIagI-urh6piNRlzP4ZKo-7i822K9JsDh_5OJAYKA,778
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cublas.py,sha256=rvXPfMIVmWjQZMd-d-fXV-m2XnIG4ACHlYPwBk18CfM,686
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_cupti.py,sha256=rvXPfMIVmWjQZMd-d-fXV-m2XnIG4ACHlYPwBk18CfM,686
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_nvcc.py,sha256=hWVCA2qKLcvnp84nUA7SmbrAwL4Iu-coalThGBKhaRU,1287
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_nvrtc.py,sha256=rvXPfMIVmWjQZMd-d-fXV-m2XnIG4ACHlYPwBk18CfM,686
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cuda_runtime.py,sha256=rvXPfMIVmWjQZMd-d-fXV-m2XnIG4ACHlYPwBk18CfM,686
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cudnn.py,sha256=rvXPfMIVmWjQZMd-d-fXV-m2XnIG4ACHlYPwBk18CfM,686
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cufft.py,sha256=rvXPfMIVmWjQZMd-d-fXV-m2XnIG4ACHlYPwBk18CfM,686
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.curand.py,sha256=rvXPfMIVmWjQZMd-d-fXV-m2XnIG4ACHlYPwBk18CfM,686
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cusolver.py,sha256=rvXPfMIVmWjQZMd-d-fXV-m2XnIG4ACHlYPwBk18CfM,686
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.cusparse.py,sha256=rvXPfMIVmWjQZMd-d-fXV-m2XnIG4ACHlYPwBk18CfM,686
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.nccl.py,sha256=rvXPfMIVmWjQZMd-d-fXV-m2XnIG4ACHlYPwBk18CfM,686
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.nvjitlink.py,sha256=rvXPfMIVmWjQZMd-d-fXV-m2XnIG4ACHlYPwBk18CfM,686
+_pyinstaller_hooks_contrib/stdhooks/hook-nvidia.nvtx.py,sha256=rvXPfMIVmWjQZMd-d-fXV-m2XnIG4ACHlYPwBk18CfM,686
+_pyinstaller_hooks_contrib/stdhooks/hook-office365.py,sha256=eOajWAQm3b8-4Du-ow8MGOVhUfTZYzGBdwEX7GIXu60,679
+_pyinstaller_hooks_contrib/stdhooks/hook-onnxruntime.py,sha256=98X6Ba4datHVWvkqHP-9facA_acVjYqCjW2560W8eQ8,576
+_pyinstaller_hooks_contrib/stdhooks/hook-opencc.py,sha256=P9mLJiUtD-dnFuBX3KzoDyRIXdN-XqduXGiGGCJkLOo,514
+_pyinstaller_hooks_contrib/stdhooks/hook-openpyxl.py,sha256=m6WoCKU1nco__-gW-a03SOSXYM12bcTTf-Pz8gCWMk8,637
+_pyinstaller_hooks_contrib/stdhooks/hook-opentelemetry.py,sha256=Qkoy-y7-PzJgEKCEIwr1W60AjEmjxbGAKFeKUdKTsPk,1290
+_pyinstaller_hooks_contrib/stdhooks/hook-orjson.py,sha256=bqnlukfGNV4oD4XL5VoW6l8F4LXic9e5lh22Ji1dLsE,621
+_pyinstaller_hooks_contrib/stdhooks/hook-osgeo.py,sha256=Y9uwC6ERLExngFNyXW0uX6NrKzGBukgsy2bqeh4eF_s,2910
+_pyinstaller_hooks_contrib/stdhooks/hook-pandas_flavor.py,sha256=8Ha2pO4RdxQekAcLIqswFl2jx5Ysn9jG0OBSp88p08w,795
+_pyinstaller_hooks_contrib/stdhooks/hook-panel.py,sha256=tYSkJ7c75X9hRmlBOwnDvxjlrQiyxqHpTsDZGucy-SI,654
+_pyinstaller_hooks_contrib/stdhooks/hook-parsedatetime.py,sha256=9Q3zkAIr6WKW_ORQ8eiM37v00-9PP1qbEf_HI8r1y_4,844
+_pyinstaller_hooks_contrib/stdhooks/hook-parso.py,sha256=wytvf2FAJOYVr41XBBoBhSdHwBqmVRcW6NX48YLSPDY,635
+_pyinstaller_hooks_contrib/stdhooks/hook-passlib.py,sha256=4-RQEZow_YmJAMN_fMe_fTzE1d7cIDnX5OAHLxF02vo,744
+_pyinstaller_hooks_contrib/stdhooks/hook-paste.exceptions.reporter.py,sha256=Kqn35mVCmW_jp942jhkjQ-OYdkz5QkT3RJV6I9eF7YM,594
+_pyinstaller_hooks_contrib/stdhooks/hook-patoolib.py,sha256=ZcP0tnJlIh_PFJlXWc0oNfXAn_npLl5dD0YqkSOOrKo,665
+_pyinstaller_hooks_contrib/stdhooks/hook-patsy.py,sha256=vWNbnyzAJzVMrZSsHTNBr7XZCOLGVFapdM4im0v73P8,456
+_pyinstaller_hooks_contrib/stdhooks/hook-pdfminer.py,sha256=bI8JBQn7-RAcINnPIZWULYjWs-SQhoIWbAV0et_SQN8,516
+_pyinstaller_hooks_contrib/stdhooks/hook-pendulum.py,sha256=jboGCmxlO7DfRGK9JJ19KUH4nMjGTU5uz5Gc-c5xRls,795
+_pyinstaller_hooks_contrib/stdhooks/hook-phonenumbers.py,sha256=zjjxVuQCGUftbsnXuuA1UaihlDt1_4sHVEsAu-GnElU,682
+_pyinstaller_hooks_contrib/stdhooks/hook-pingouin.py,sha256=8DnNfY_Hfpv-pwXzQqyk5bJuLJcYHPE6kph_G7eSuDc,516
+_pyinstaller_hooks_contrib/stdhooks/hook-pint.py,sha256=kZVeEtqKYXlqGtt_sfT7NFeg7jsCnilyujbfV6U-vhY,558
+_pyinstaller_hooks_contrib/stdhooks/hook-pinyin.py,sha256=g0iSA9JlUm0TPCC4CxaTOJpiNW0gl6Izc2xKZqcgh4g,738
+_pyinstaller_hooks_contrib/stdhooks/hook-platformdirs.py,sha256=NCEoeP_XKX5yxCjDwT0cPohcZ3-xPMZnLCQRFsuTJRI,839
+_pyinstaller_hooks_contrib/stdhooks/hook-plotly.py,sha256=gckQo3y7N0rAndLU1RZzqaMRgMgdBc06eSTUeIwpEfQ,702
+_pyinstaller_hooks_contrib/stdhooks/hook-pointcept.py,sha256=Zog524ito99K6tRiZqps5bP0mmTIvUeQGPeZJ0c6Lbg,503
+_pyinstaller_hooks_contrib/stdhooks/hook-pptx.py,sha256=Z2S-ITYXrEEQgfhj1anvOnAaQrrKtMhz4nB1jJaO9gw,522
+_pyinstaller_hooks_contrib/stdhooks/hook-prettytable.py,sha256=JJbRvqaWj8lZJLCHGKGIyg6uft87C0cqPL-hJ18o8ik,662
+_pyinstaller_hooks_contrib/stdhooks/hook-psutil.py,sha256=q3PHBjQWaW_9uvMbKNBTdXRAENKM5HX0m0xE_WtHOy8,1662
+_pyinstaller_hooks_contrib/stdhooks/hook-psychopy.py,sha256=TjcAifKGMUmn7Up5o251n0-7F4igd34jO_tI7D1QjMc,584
+_pyinstaller_hooks_contrib/stdhooks/hook-psycopg2.py,sha256=AYhLOAtcetLs0m_cjJQjnOmhUCTM3GeNL0R14rXTxC0,453
+_pyinstaller_hooks_contrib/stdhooks/hook-psycopg_binary.py,sha256=ePa-0aWcG6kEm_8DlACS3Ic9cgNE2tW0Bpv2SdBb0c0,606
+_pyinstaller_hooks_contrib/stdhooks/hook-publicsuffix2.py,sha256=1JAim_QMHt74gn2JCxPjXz7qjEiXR9y9vsowb0vuSFE,521
+_pyinstaller_hooks_contrib/stdhooks/hook-pubsub.core.py,sha256=6HrYFNpinML13-6r8Qha6CuCKXpXu7rgIJxQ_gND4Xo,580
+_pyinstaller_hooks_contrib/stdhooks/hook-puremagic.py,sha256=0Xvb0WRlPB4nOCV7LffKg6S6NSOsGKuOKpGSkva-HpM,517
+_pyinstaller_hooks_contrib/stdhooks/hook-py.py,sha256=U7XDI-qn1L8VoSivgpyuNbHwyw2nijYIknmWEqGpm68,524
+_pyinstaller_hooks_contrib/stdhooks/hook-pyarrow.py,sha256=kYm4XaJ8GQFn4lsxzO1tqeDtPb8JgYvDDe8EW5wDiTg,727
+_pyinstaller_hooks_contrib/stdhooks/hook-pycountry.py,sha256=CfZlViBOJLtbWhY4s-_8P3qRA_M1dOtiwh4ECDNS_c8,691
+_pyinstaller_hooks_contrib/stdhooks/hook-pycparser.py,sha256=P43K-yDI8XmmxcchKI8KLTyr44hI4tK21FzQzL9qf1A,875
+_pyinstaller_hooks_contrib/stdhooks/hook-pycrfsuite.py,sha256=RWHkauAGHZ7-Xed0GNGnI8VXBnruXi1zrAHvfUKkD00,501
+_pyinstaller_hooks_contrib/stdhooks/hook-pydantic.py,sha256=SRZASmNbASrMbhNdCaKAi9knQ7RB8nUIZYYiwgL4bco,2053
+_pyinstaller_hooks_contrib/stdhooks/hook-pydicom.py,sha256=8OdvGBM_OgIG7LmOt-ghu4yRMxITkuTJoldEH0rEzI0,3170
+_pyinstaller_hooks_contrib/stdhooks/hook-pydivert.py,sha256=fTOz2ZV8ds9hMxjxpkRWnO3Hu1Rp-TklQn_i5l3BQ6w,530
+_pyinstaller_hooks_contrib/stdhooks/hook-pyecharts.py,sha256=Lt86zZIVjROkmjVmJFISftxVU8x6sX7Xfd2fCNjuYRc,516
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-io.py,sha256=FZcuwojyp_ohP2hlcfOPaKMnIn6z1sdYpUdG2Ttuus4,540
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-ods.py,sha256=wm2aZ2uH2cyFeQkmOuxmAm-Rb38buqrybqSJJ1Wu_yY,542
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-ods3.py,sha256=ElPK-BsVkzZyYovwRr6STzP9zwPv8vNQtKdcgII7y2w,545
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-odsr.py,sha256=H8f3KuemVMIhd4jiDnF7Yqm8tV_rMX_-Rji1d2soHGU,541
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-xls.py,sha256=4R0j_zrp_f3Fsso9a4VEnCDUV4yj5Jn-bbVEYdJps8s,542
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-xlsx.py,sha256=8Ciw7Xgcn9jrXjFge_c2miroB9-Tbl4uKm8TFpzB_t0,545
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel-xlsxw.py,sha256=fdUqkVzW8lVNPZl-hZLWB-V0W84IsFilxDWxJuG0KDY,548
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel.py,sha256=O4AxWgjHAqEY0qwDEHI7oRyadmkCJvvlcr51W0FH1Uo,1270
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_io.py,sha256=dvm5ED0pqFM8Nm_qXTiOiazK1Yy4lKLFpApozAchnf4,1026
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_ods.py,sha256=Iz0fWJ_yu-bUcOReVdlIONX10AK2tS9eulAFMXRdwqY,604
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_ods3.py,sha256=Jq2vUOuWLH6eGgSsaQ2FUGe2SBnhpRU2Mw4n1zoezO8,587
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_odsr.py,sha256=nrT8jVqP6XMJsvkjsz9CvR29mGfBHE57iCfCZk7u0k8,562
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_xls.py,sha256=oKb4_uAhN4lD2HIkCZ6Y7nZTq6Vrm0ASNguxzvqrQZ4,582
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_xlsx.py,sha256=4f6MoRb5lv6q2v1Ep6aZH_fzbHhqOKYV88-63Kc-1Og,589
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcel_xlsxw.py,sha256=Q6nFCXD_8M4n6eP6c6bDKZ9FMgHdmlcwUWseprA1RWw,571
+_pyinstaller_hooks_contrib/stdhooks/hook-pyexcelerate.Writer.py,sha256=L_KxyR2a27d0hjtK_L5Xt6Bh8CSXwsrDCJmwN5SRrxc,520
+_pyinstaller_hooks_contrib/stdhooks/hook-pygraphviz.py,sha256=dvaQJYk0_aWbi8BXObjN7WjzA-G64dEzHEWuiq8cksE,6227
+_pyinstaller_hooks_contrib/stdhooks/hook-pygwalker.py,sha256=riOBNf_TUoNdah7wNAPg0YOZ9ruzexvYN5_DhTW_uuQ,517
+_pyinstaller_hooks_contrib/stdhooks/hook-pylibmagic.py,sha256=HCi2VRbUeBRFHbu3aZaQVpdH4CLjt6Mg55MT5r29AtU,638
+_pyinstaller_hooks_contrib/stdhooks/hook-pylint.py,sha256=7CGgOElk4-j1dUFSYvdgkDhnaWA64NyPklA59tJYCxE,2797
+_pyinstaller_hooks_contrib/stdhooks/hook-pylsl.py,sha256=qoZGPIxR5X1YYvohqhi7wQwHTPFJZY9tzLHp0ZFJPxQ,1356
+_pyinstaller_hooks_contrib/stdhooks/hook-pymediainfo.py,sha256=SZHmXlXI3hg6WQI1DB0SQ2CgMdvC4R_lKXITC28JdSc,1720
+_pyinstaller_hooks_contrib/stdhooks/hook-pymorphy3.py,sha256=WiiMapatPQ-tMqu9uJMqb-YrZgz4-z9UzCuGIH-hFuk,882
+_pyinstaller_hooks_contrib/stdhooks/hook-pymssql.py,sha256=lvxXSQPWOjXk01HpxQD4vuz_NWRLu7dHVzdBBFObd4Q,702
+_pyinstaller_hooks_contrib/stdhooks/hook-pynng.py,sha256=PT-I3kcGNXn_bKm-9FnSwSSvmzAcxnlMuYeSrFJYflg,504
+_pyinstaller_hooks_contrib/stdhooks/hook-pynput.py,sha256=Bst5K7rJ2x6zu7RH9Rw2o3bt9OH6zKcdCSvkjLxiVVs,522
+_pyinstaller_hooks_contrib/stdhooks/hook-pyodbc.py,sha256=O4xxP-3UYj1U-F5brNgHUJqrLZ1xEhi8dmyewtdjAQg,800
+_pyinstaller_hooks_contrib/stdhooks/hook-pyopencl.py,sha256=BYmdmFmWfLvTCwYfoU5R6te6ZLiOIOowt3lCFf90vSI,636
+_pyinstaller_hooks_contrib/stdhooks/hook-pypdfium2.py,sha256=nfQw_jrlpyjGS1qLiM0rUqg96qSmVo3Bm-mqSEDvvKo,543
+_pyinstaller_hooks_contrib/stdhooks/hook-pypdfium2_raw.py,sha256=9h06-jdvkwxHgQQsA7C8eVuKATFO1bxtiY3d7O3H7kM,664
+_pyinstaller_hooks_contrib/stdhooks/hook-pypemicro.py,sha256=AAcRqmDT99-Hf6qOx-oYpVz5ikMSSrdmTHNIPlw0fRE,1537
+_pyinstaller_hooks_contrib/stdhooks/hook-pyphen.py,sha256=TOIIizX9zsR8Yxne30gn3kVD3-_SR3yLbIdDeRrRNm0,514
+_pyinstaller_hooks_contrib/stdhooks/hook-pyppeteer.py,sha256=tQBftDHjR6UE8hLS9TOhdfZ2CtYj3pQA7RPQICnEq2Y,569
+_pyinstaller_hooks_contrib/stdhooks/hook-pyproj.py,sha256=fElcGMR97s1w0DtwbVQwaRHl4XlRy5amsLnJQb--DaA,3015
+_pyinstaller_hooks_contrib/stdhooks/hook-pypsexec.py,sha256=1dsJpXxQSf_ax1ZG404Gt_lugYsZnp4sccNDC9ARs2k,663
+_pyinstaller_hooks_contrib/stdhooks/hook-pypylon.py,sha256=0lVseKKn8a_oAJSD2gKmk1BB8c2JV0JzPLpV29-lQr4,2502
+_pyinstaller_hooks_contrib/stdhooks/hook-pyqtgraph.py,sha256=TV_83_49-Ct7JMDLTWZ40lhUkBu2JgrVeh9ViyDKvVY,2724
+_pyinstaller_hooks_contrib/stdhooks/hook-pyshark.py,sha256=QiK5ngnGJgd-4Ej9bSCfLm6C0T59nR2Wcmv9W4T3OGk,894
+_pyinstaller_hooks_contrib/stdhooks/hook-pysnmp.py,sha256=VTFu70OKNnuxQf5BgFoQfRNKhHIYpsYBBq3Um61cBpk,620
+_pyinstaller_hooks_contrib/stdhooks/hook-pystray.py,sha256=zwrmSkRqcqCTB0LorfBeohRhK6z83Gn6mtHkn8stjHk,645
+_pyinstaller_hooks_contrib/stdhooks/hook-pytest.py,sha256=KswRiZA4mc6ntcoRZP1uuWCvWjeOMH3EyXlUR1HIk6U,530
+_pyinstaller_hooks_contrib/stdhooks/hook-pythainlp.py,sha256=LjYyaZ6bippZB_FaEhfO98ZoMuMq2ts4tJNM-oFOX0M,517
+_pyinstaller_hooks_contrib/stdhooks/hook-pythoncom.py,sha256=8BNoI-XzdFcMMYZGhtgJlKQafkLCPNEcNkYvklCl-oA,1310
+_pyinstaller_hooks_contrib/stdhooks/hook-pyttsx.py,sha256=Dc_k1cOMrTiyUD2ykczvMjFnKsxqnsRyoubp6AZuK0U,680
+_pyinstaller_hooks_contrib/stdhooks/hook-pyttsx3.py,sha256=tSKAGe5li3ZNgXmD8uBAOklK2gXZsb8N_g0DmDwXz3Q,953
+_pyinstaller_hooks_contrib/stdhooks/hook-pyviz_comms.py,sha256=tIouDRIPXMthfkbl92nPp_WoiV95hgkvX2fJmNt6Q_M,519
+_pyinstaller_hooks_contrib/stdhooks/hook-pyvjoy.py,sha256=z_5pzdhljTAIqXr6ZUAU90yetm9XsismXM8fJACXJOE,520
+_pyinstaller_hooks_contrib/stdhooks/hook-pywintypes.py,sha256=P1c320OpZ0aYBcuvJYuyn6GXs9rR9SXYlifElNhGg3A,1312
+_pyinstaller_hooks_contrib/stdhooks/hook-pywt.py,sha256=h66LHiEystMScItTwayt9BVAbxTKtRaHh9eAJn3yVbU,875
+_pyinstaller_hooks_contrib/stdhooks/hook-qtmodern.py,sha256=YsxMuexOuumpdDaxGJHm72B3Ir1g4QYFhQaaGcMPiTc,539
+_pyinstaller_hooks_contrib/stdhooks/hook-radicale.py,sha256=fiBeBFdZEF4SOsmex1KuBzxk8wuIPbXvSAYtw9Z333k,566
+_pyinstaller_hooks_contrib/stdhooks/hook-raven.py,sha256=ZMjvs_bMMzL6ivmkMYd4JaH1GQjySXFvMWY2FKo_QMQ,474
+_pyinstaller_hooks_contrib/stdhooks/hook-rawpy.py,sha256=Unn3Dmi-1DO6PEsP1V1fc4msZKjlfdRfRJ1lHuhW430,549
+_pyinstaller_hooks_contrib/stdhooks/hook-rdflib.py,sha256=rZILYAIHxVLRb8Yoo-OrCwOxgpnXa0mIUtAt7NQdn1w,530
+_pyinstaller_hooks_contrib/stdhooks/hook-redmine.py,sha256=WB6xvPntTEPCgr0OObGvIrA2-tJf_Pj6VPOg-haG_Lw,459
+_pyinstaller_hooks_contrib/stdhooks/hook-regex.py,sha256=NbwTOxbeaB2odUSDRMfG_A3MlsE4gBK5-87xXDDVoLE,450
+_pyinstaller_hooks_contrib/stdhooks/hook-reportlab.lib.utils.py,sha256=pZqRNQOrita5omAC5_nSskyAAu3p4JpsgQ1aqPYyKlE,495
+_pyinstaller_hooks_contrib/stdhooks/hook-reportlab.pdfbase._fontdata.py,sha256=tEXZopdzGoV68mBgXZiDFEj2X2BoIBc6q7QcGI-4glY,754
+_pyinstaller_hooks_contrib/stdhooks/hook-resampy.py,sha256=vAXcFQNF7T3C_Noq2d7BhhWh4M2rUMR-w7m0WsA631w,596
+_pyinstaller_hooks_contrib/stdhooks/hook-rlp.py,sha256=MZaRLPT-yxpVpYHmPSn6QKZDesyZrgWvjOQSiF-s0qs,631
+_pyinstaller_hooks_contrib/stdhooks/hook-rpy2.py,sha256=jw3x7MFzZ1W4JmLG3ee-mJAfeHONVj0OfD6P0XMD9sQ,526
+_pyinstaller_hooks_contrib/stdhooks/hook-rtree.py,sha256=H7e24Ulm4tZEDisBv50Y2NDyrSvekdmduxrcyA-77dQ,1982
+_pyinstaller_hooks_contrib/stdhooks/hook-ruamel.yaml.py,sha256=LHylLWoNGTZVF8CtxQMjnx3SXEJZ6AZX9Fv7FZHQyeQ,1698
+_pyinstaller_hooks_contrib/stdhooks/hook-rubicon.py,sha256=QMzeWRQmulGUFSBGcyfjxTP3iDz_sf5ItOVyiENGCN4,574
+_pyinstaller_hooks_contrib/stdhooks/hook-sacremoses.py,sha256=lm66cE71dKrvqLJJA-yJ3vtuxH7kcb8ptroAEfdQRJ8,518
+_pyinstaller_hooks_contrib/stdhooks/hook-sam2.py,sha256=o-8rFNsAQ-LCbWOO5bq_Dwt43RhQp1E5lzvZX9C7zOA,1368
+_pyinstaller_hooks_contrib/stdhooks/hook-saml2.py,sha256=S1UqQSq4qsJqr731S_pQ3n78vZ0sD5HLl8j6WyjqfQk,1138
+_pyinstaller_hooks_contrib/stdhooks/hook-schwifty.py,sha256=KR8NXP6rWyt7QlUpDSwT1YFM9SbTpzZAsv8FCqXdNQ8,566
+_pyinstaller_hooks_contrib/stdhooks/hook-seedir.py,sha256=IHIIi5YRBlRmixBGQkKG20hTbxCFFSAmTn5PKoSDyxI,514
+_pyinstaller_hooks_contrib/stdhooks/hook-selectolax.py,sha256=-Em9_LQNQJcIGbrVqs5UipDyY7m_wJHsExoax_Cjyy8,518
+_pyinstaller_hooks_contrib/stdhooks/hook-selenium.py,sha256=evaqzJ9MoXzbS0RaUGyta7C75YOLm0pL2FbqrOL0sV8,516
+_pyinstaller_hooks_contrib/stdhooks/hook-sentry_sdk.py,sha256=RRHQjGatbPphkfgBXH6ZRC663uVEDtVUR4YQqnf0ivo,1555
+_pyinstaller_hooks_contrib/stdhooks/hook-setuptools_scm.py,sha256=AKzhxS_poloeTW3P1AqpfEhv1Pj22ObVPlcmMKVxTcE,638
+_pyinstaller_hooks_contrib/stdhooks/hook-shapely.py,sha256=fQvQRdyiAm1SROvypkgHUqM3XHyrYcAlrBB1ogzBbTA,4815
+_pyinstaller_hooks_contrib/stdhooks/hook-shotgun_api3.py,sha256=PWWJA_bTQulDDZ_SlJknhwMmBJMlA0syMN7ty4CqKfA,837
+_pyinstaller_hooks_contrib/stdhooks/hook-simplemma.py,sha256=1bBXLPhsKhWION7Yao22LQTMQJ4Yo0LWKX0cFjBSONg,517
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.color.py,sha256=f3Gggsi95Q8Mzr4dV_WECbSmvWMeQ4YZptkzNf-5wlE,885
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.data.py,sha256=wDeAlllX4ohrXZQMMPFDhXqwSQKaJszi_X0fLhh4FOw,882
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.draw.py,sha256=BdsCh5CYIlUmB9TU0q6LRo0vNfkiP9Ikl1CGOrrf02g,882
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.exposure.py,sha256=RvZnk0miH3VeMCjXcPk7PMjgyaD2-Ts5WomfA6l2DkQ,894
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.feature.py,sha256=hGjCqKixqNQWSNeh3YbWL9Pgeu-Oj_jo66r6OfSz6vA,1348
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.filters.py,sha256=Wf1FoAwOOSEJN338XePFGQQQEY2mDsnLn1djfXmyJa8,1224
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.future.py,sha256=A1Ozf_BsbVh9FeNY7M7RPYlPmQqq5XqaG1nnDscjmEE,888
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.graph.py,sha256=W6E_UbfmgCvsf7xFVLnjNWRbEnWQCXFIKrylJ19af0M,1012
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.io.py,sha256=gvA5t2GkyzSTDe475c7TWJMxH0ZwcIVZtBFypufVTHU,692
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.measure.py,sha256=kBIwSn8bHZkyBx4e_kmbIfEhBDpM56-TUMds2NrIotM,891
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.metrics.py,sha256=UXc7fYHmZtjSjigpNpRWNXd8n5PlrttGpNf-6FJhCd8,891
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.morphology.py,sha256=rNY8kBmId9ZjqErQCtjcaVM5z7NAV7GX5-6zDe-ejPk,708
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.py,sha256=X1D4G1ifc2NJYgEP8BJv7_HbibSIh_zU_mi02Tz2Ro8,699
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.registration.py,sha256=fPIIIOtwjCrTjtrFx-Gm43gQRQ3hIt07j5B0ukkPnZ8,906
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.restoration.py,sha256=L8Sl7-uEt0w0fkMFuj_F9Br5t3rPmeTC9Gl5tOTB1kE,903
+_pyinstaller_hooks_contrib/stdhooks/hook-skimage.transform.py,sha256=JzT1ZOZSYF9AIE0GqofIDqeJAzeZqR8ueOtWH4USQ2A,1160
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.cluster.py,sha256=oP45i7CNTVbV24F7lcW1SENbY3FkL-r_g-ZfsRhPo3g,646
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.cupy.py,sha256=sFbfr1npuVKj8m3urWg95FaEfloU47nqJUaqlKJZxNc,737
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.dask.array.py,sha256=VfN-qayjdhLHAvTNQWhl6OK-0JfrkNMuUE-16RG4zrY,749
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.numpy.py,sha256=LSXc_clKE0IwZFjASpNDX0gHWnzAFZXofFZ0Q5U4Eyw,739
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.externals.array_api_compat.torch.py,sha256=g7zj1_tPoYPOG-BX4LfBoblxwYiDAJ81h36KpT2mE54,739
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.linear_model.py,sha256=CwIAWIFg3WAB9h77Cy606FOWJ8M1PwM84APlOi6wP7o,681
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.metrics.cluster.py,sha256=q77JZ2N5g2JAdJ9KZc1M6VmghFFJEZix9QCIppRyvpo,1059
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.metrics.pairwise.py,sha256=Y-mMC21KcFLZl8tBlFZk0Rhxh3RAF7uBZa9_XC3yBT4,695
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.metrics.py,sha256=jMbCX7-k2My3roYB8InOM8MW80_7TYJtaOsR5CVW41I,836
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.neighbors.py,sha256=QqEsYvxvqhtkraAZCGeJyqV9vmv6N6Gzf4PVJLQiXxY,1256
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.py,sha256=IBTUfO-Z5Sa2mw2iCEMKGd_0-kDpDXSTlXo-BqiuS4Q,563
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.tree.py,sha256=CDM3BloR4zKzilWpYZsKx122Q6h4DZ6UFuo-j3Qv3cM,619
+_pyinstaller_hooks_contrib/stdhooks/hook-sklearn.utils.py,sha256=8YJzItmY0OiXrJzS8TvgtZu-ftxIlRssCczworboFTs,749
+_pyinstaller_hooks_contrib/stdhooks/hook-skyfield.py,sha256=6oKXVPWHwEbqV_RrMOxL1t7PGZ7hiBhH4ChjG3CdXfY,515
+_pyinstaller_hooks_contrib/stdhooks/hook-slixmpp.py,sha256=oQkL_3sMJ5PVQJbYP4xCnybIW50WvDCnGXefOVot4ug,532
+_pyinstaller_hooks_contrib/stdhooks/hook-sound_lib.py,sha256=Kq3QihOuvNPWwy_6A9aWUAaL7WNzpNuilXKztVEFKLk,579
+_pyinstaller_hooks_contrib/stdhooks/hook-sounddevice.py,sha256=FGwJDIZkgFIbMiS0PvT6nu3aXDX08tzTqLgx3tGbP-A,2274
+_pyinstaller_hooks_contrib/stdhooks/hook-soundfile.py,sha256=0LjHvLYMaqRFdwj-ejmNPKe00TfXa2n4JzSf9WtMdz4,2205
+_pyinstaller_hooks_contrib/stdhooks/hook-spacy.py,sha256=0mBcrUsC6yf2Ojn6U8H6qxv91pQu6pMthpYt0KHa8Jk,660
+_pyinstaller_hooks_contrib/stdhooks/hook-speech_recognition.py,sha256=piGWZuxa_PXxTEyPOFb7iyFzJxiG6n3Tt_-zPm1kaug,661
+_pyinstaller_hooks_contrib/stdhooks/hook-spiceypy.py,sha256=Ed6LYIhF6poAcCSPyb5rvhVjUFkdl9qw0qxyn73JJDU,625
+_pyinstaller_hooks_contrib/stdhooks/hook-spnego.py,sha256=ehk5wUbK8Xj-Oh75VyPssmzZSeK7QcFo2wNFZ8RaJW8,522
+_pyinstaller_hooks_contrib/stdhooks/hook-srsly.msgpack._packer.py,sha256=WXdQwncBqLpuxfcR_i-OySkzAtlkbAepvX82vMnfQ7M,596
+_pyinstaller_hooks_contrib/stdhooks/hook-sspilib.raw.py,sha256=d4vicope-Y7s4BjCk9I6lrsYm9MUc5_NDa3tiyATOlg,861
+_pyinstaller_hooks_contrib/stdhooks/hook-statsmodels.tsa.statespace.py,sha256=z1YSRSV5BtzND932WFgwB70XFU2yz0-lK5vxIJpCKLQ,619
+_pyinstaller_hooks_contrib/stdhooks/hook-stdnum.py,sha256=KOp6fIP-1UYDUQvQTtjsfDf85sTfouUh9XDP28TTGdg,589
+_pyinstaller_hooks_contrib/stdhooks/hook-storm.database.py,sha256=Enp0r3QnP011rR4Lo6Jmh_7tuKeX-FO9wF-b2rF_Gfo,559
+_pyinstaller_hooks_contrib/stdhooks/hook-sudachipy.py,sha256=mznzdDeOa49mGSqNMjmIlWHgTI0tabQ1Xy-8IbS6ks8,1088
+_pyinstaller_hooks_contrib/stdhooks/hook-sunpy.py,sha256=WdRTp2-VH2zgM8lhXbeL4H08MWVyfHh8lVee5RPSZiA,810
+_pyinstaller_hooks_contrib/stdhooks/hook-sv_ttk.py,sha256=gkQBskWzIY9vj5JaCgIZbFGsiBPWtd2KRXiUzWOLY5g,564
+_pyinstaller_hooks_contrib/stdhooks/hook-swagger_spec_validator.py,sha256=CZxq9j5qkkuVAjSQWQwRRaIJT9GGa978Q9F57erq4HY,530
+_pyinstaller_hooks_contrib/stdhooks/hook-tableauhyperapi.py,sha256=AumaK0lkQrfiCsG9p6t5L7RGWme6OJ5b579vugQVF4k,530
+_pyinstaller_hooks_contrib/stdhooks/hook-tables.py,sha256=IOnpCJdV4hWIz1is97IDMSC1prG4c2wkIsyB1WikmxI,1471
+_pyinstaller_hooks_contrib/stdhooks/hook-tcod.py,sha256=d30d6w3skLxkY1O-4qgWOcITPbiXKN-Af3tp9gqAYpk,675
+_pyinstaller_hooks_contrib/stdhooks/hook-tensorflow.py,sha256=Z1TQ81Ip2GVDrhd9n94y4paKIS8Mazp4f1vd2t3AA1Y,8080
+_pyinstaller_hooks_contrib/stdhooks/hook-text_unidecode.py,sha256=aiKF9Adg3AERYMKQfnGu4NIjXvkd9cabMbn7EWbnZaU,823
+_pyinstaller_hooks_contrib/stdhooks/hook-textdistance.py,sha256=VMB0NOWxX-wm0iaN7LZu7DDNl-oZeYPOLkq99bQynyY,602
+_pyinstaller_hooks_contrib/stdhooks/hook-thinc.backends.numpy_ops.py,sha256=fQe7iRyYKHzh2O51Rhqla_wQTDD0qPh4MwS70SuBGwA,620
+_pyinstaller_hooks_contrib/stdhooks/hook-thinc.py,sha256=kv4x4ewqLapioW9Iyt4pgZAklPqYH2buCl0bU6l4q94,682
+_pyinstaller_hooks_contrib/stdhooks/hook-timezonefinder.py,sha256=gFfA4F9ImepBorXt9onYcWoaNCv-PSrjUrkS8H-Vt8w,522
+_pyinstaller_hooks_contrib/stdhooks/hook-timm.py,sha256=L508elVV7ax33mODkIR3zrkCnahihoH7UIjheGAzCkM,557
+_pyinstaller_hooks_contrib/stdhooks/hook-tinycss2.py,sha256=ke7JomKRtbpoKSoOAbqBsVs7KBbMyqNc9LdKPsy8940,718
+_pyinstaller_hooks_contrib/stdhooks/hook-tkinterdnd2.py,sha256=q8CySMlcznBRNvC6IthGv9P8qwyBIB9VlY3Wi5W8GG4,3411
+_pyinstaller_hooks_contrib/stdhooks/hook-tkinterweb.py,sha256=3mc9WHsQwEcicMdXTN5u8AO7vsj-0fbiReCKFfpPDHc,551
+_pyinstaller_hooks_contrib/stdhooks/hook-tkinterweb_tkhtml.py,sha256=ZHUoCgUifUymB0UYlWeBt9rTgZiN253vE9IpxOV5nHo,664
+_pyinstaller_hooks_contrib/stdhooks/hook-toga.py,sha256=zhwG5bPJ07O8bEWwHoLLXWTMRfkfH5HpmtgGh54ncZ0,1533
+_pyinstaller_hooks_contrib/stdhooks/hook-toga_cocoa.py,sha256=lRTBxt7K5mDBr0Vg9_cKtlWjYwo3aYkuxYZYUGQBFgI,695
+_pyinstaller_hooks_contrib/stdhooks/hook-toga_gtk.py,sha256=BLhknKuw1taIhpChywxds5YAaErt3p1QEbMaD_LW5N0,698
+_pyinstaller_hooks_contrib/stdhooks/hook-toga_winforms.py,sha256=ZdedhJzay8JBOpHFkh886uhqkbVceUtZCQ42a0PcIIQ,1676
+_pyinstaller_hooks_contrib/stdhooks/hook-torch.py,sha256=csC2k9H5LKRcGSkGdGfZ4d_lP1qCyWgi_95eJ7hnMOc,9318
+_pyinstaller_hooks_contrib/stdhooks/hook-torchao.py,sha256=Zog524ito99K6tRiZqps5bP0mmTIvUeQGPeZJ0c6Lbg,503
+_pyinstaller_hooks_contrib/stdhooks/hook-torchaudio.py,sha256=uiHAOGQ-3-ObT97AVxv0z0QlpbjFJbNE2Q0gYNADXGM,867
+_pyinstaller_hooks_contrib/stdhooks/hook-torchtext.py,sha256=CzTfNYupWeGaRRfSIL2eJY0aDBhQv1QXtJbWA-NEDN0,864
+_pyinstaller_hooks_contrib/stdhooks/hook-torchvision.io.image.py,sha256=gY1Lyzi4FXkXgunJsO1tu0L1mF57K7UYEJRbUv5ty8A,544
+_pyinstaller_hooks_contrib/stdhooks/hook-torchvision.py,sha256=4b1nEXZqf2wF3NQmnxHSAzjKdVg5_v7vdXqQZBnDqcY,750
+_pyinstaller_hooks_contrib/stdhooks/hook-trame.py,sha256=wfWJdueXwSbtg5ltTooMVKIScckp4MJfAMjQUSrggZI,449
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_client.py,sha256=VzWxVdG9C6_5R0VSNK13fbi6UEpiqrho26uU8y4jgFc,537
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_code.py,sha256=lBe5ZK_X8AjASCPIV9APv5YGX2ISWvBnbIkjg_FfNw0,538
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_components.py,sha256=54f4hYedYKygfRWKPdagVKWHUW_Rln9hYUsz1bIV-lc,541
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_datagrid.py,sha256=_YgeTfiZm-HByd8G1_DIb70yXdgKiDXyROaDXBiXHs8,539
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_deckgl.py,sha256=Jv0w7wuGjC3AuQ4sgLGtA3Eiijda2D_i8eFFkgyRuB8,537
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_formkit.py,sha256=ryM4qXa18QDuBdWffklfR-B3-FUs5N_x1l1LVJxcIus,541
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_grid.py,sha256=za_pkjIroAH_VjdYywXdSsA4uP8yAHIMT84UYkmUlm8,538
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_iframe.py,sha256=EIAhF1ARh2m19WvQIIkzkKbmAWrVzqLcxp97qd5fZ-8,537
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_keycloak.py,sha256=BrfdnSqBj2xwebMRwxiFtnBK6bpl99ytdZWv_mS5YLo,539
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_leaflet.py,sha256=A5HftRWLEo-4JxANDRf1qyYdzQ9UMjkT9ZQAITqhK4k,541
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_markdown.py,sha256=F6U1hYfdc76jU4Mw64o8DNSsbDzputARvHW3_NpMRwQ,542
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_matplotlib.py,sha256=y2zdoreEfcZ12d7K8tZdtMrnkT8m5-JS5pi5_4JVHI0,544
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_mesh_streamer.py,sha256=MM0sW1v0nCpXywQ4j6ioy9RK6cxS5Yg-0eY7zZxua0c,568
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_plotly.py,sha256=Jus__aRsqdUEyLe96VsAKggn3eNEqL2SvDV8R6kB7ao,537
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_pvui.py,sha256=t-k_oh-jEQ7WZYxWp5mrF_zdbjlDb5K-f9b26p6OTFU,535
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_quasar.py,sha256=yGPS7wYndn26rud-Qry0HxMvB3N7mYgoBv5CbQe7JBI,540
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_rca.py,sha256=Vz-h_WumdIelMNLG31vWUO7fSjEM2O2zG2Je7Mg5Jkk,534
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_router.py,sha256=u1wTcmw6sfgWMyEX3pkj7_4PVkuL9VQsFE98IkB1X0I,537
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_simput.py,sha256=e7XVwnoMR-grO51ir3iX0ToTOB7M31oqp7EAv5TNb5M,537
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_tauri.py,sha256=c-qQLEenEVzwFl9CJvGioTnf-9OHQhL-4SUD_iAlgf8,536
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_tweakpane.py,sha256=1yTKF43c-bwM5GNUiP5pg-7dZoLi2MicTGiIy6djgAo,543
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_vega.py,sha256=8m8NgpnnfQDKB96FSLkVdVFBXrut8EVFN6p_d74KK0s,535
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_vtk.py,sha256=rQzWSHqHjITxVctPZCcvupmNUrP6qWO5KvfapQ59Jug,599
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_vtk3d.py,sha256=C50pnto4_ZHuYoNnwUbQwxKPnVbLUgAbGVEzdm3QCYY,536
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_vtklocal.py,sha256=MJ4b692GnZ8xeLf7U3MfA_8UhnPH6m8WU3vv1V0C1WI,563
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_vuetify.py,sha256=uzrIK50-q9-ElD4iGi7r9hCUshtntdpdJgSWCFMTORo,538
+_pyinstaller_hooks_contrib/stdhooks/hook-trame_xterm.py,sha256=bv8OYRBotPrbovDdbRAIm__Byask8Gl-WNn3S6nqFT8,536
+_pyinstaller_hooks_contrib/stdhooks/hook-transformers.py,sha256=O37StBG92hU4-oxQie0_G7z2CqPdQgT7gaNJYoYl7mY,1440
+_pyinstaller_hooks_contrib/stdhooks/hook-travertino.py,sha256=Fn1askoaMKmMpSF2sPoq1k_q3ntXv5Q_5SzRB3ZtqDc,732
+_pyinstaller_hooks_contrib/stdhooks/hook-trimesh.py,sha256=8rZOJcrZzvQP1dcNFbFiIGNciMNcN8nfQ5l8A962ct0,630
+_pyinstaller_hooks_contrib/stdhooks/hook-triton.py,sha256=qH3Ag8ZV_2ntt-_kDNku4I0wJVDrt4sSIiY-cXnxcak,2146
+_pyinstaller_hooks_contrib/stdhooks/hook-ttkthemes.py,sha256=r3b6GzZQ5Kr9JLCK8NOmodZkBl_lbYA8yuiPohVEzDA,1822
+_pyinstaller_hooks_contrib/stdhooks/hook-ttkwidgets.py,sha256=vS1Xdgi8Q-m9qhK97u1T111pBEPm2HVgmbWi7byqTr0,1288
+_pyinstaller_hooks_contrib/stdhooks/hook-tzdata.py,sha256=OsSahzrcY_SuaoZB6gXT7HtkWSJGb_c_h76du4talxk,826
+_pyinstaller_hooks_contrib/stdhooks/hook-tzwhere.py,sha256=qNPXs2MAeH5Y0FWDCOXoplHp5FI-GIRkI62yFvUzN5A,515
+_pyinstaller_hooks_contrib/stdhooks/hook-u1db.py,sha256=ftGC2v2SEPsypYXY934pYN8H_dvOoEbafKaeiNP06n4,876
+_pyinstaller_hooks_contrib/stdhooks/hook-ultralytics.py,sha256=LoDbFbjOrzRzEpViEzZ1ZPb4DVk_h3QNjsPSex_hgys,717
+_pyinstaller_hooks_contrib/stdhooks/hook-umap.py,sha256=Df75m78IePhWxlordune2qRC_UmgTLDvrlQyePr5HMI,508
+_pyinstaller_hooks_contrib/stdhooks/hook-unidecode.py,sha256=t86yg_WZ0An4pjHIVQ_Mnnvn8u74LKZmNEsnPd2CiAo,812
+_pyinstaller_hooks_contrib/stdhooks/hook-uniseg.py,sha256=vBDFt52WHwaVWhSJGmBxlPR8Iuvjo9iVvw8l5xSrv_I,581
+_pyinstaller_hooks_contrib/stdhooks/hook-urllib3.py,sha256=j92BNOqwhPQYqyFs12KoYGyILwIKM09NYch2q6Ls36k,793
+_pyinstaller_hooks_contrib/stdhooks/hook-urllib3_future.py,sha256=SnwwUzQZWPU-nVDjP9GkOV3_LmHJGJLkUVBh7t7ZEqM,610
+_pyinstaller_hooks_contrib/stdhooks/hook-usb.py,sha256=oHb1tcivipqchTKh0oq7eNUFVjjYdAjb3x0ylyPhkTs,3457
+_pyinstaller_hooks_contrib/stdhooks/hook-uuid6.py,sha256=YiEa093qjJ65XTUppoO6nKFxzp6h7Wds7OZsAjWIwOA,659
+_pyinstaller_hooks_contrib/stdhooks/hook-uvicorn.py,sha256=rPwThXcBdALtt0PQ2_kCG77QhiFTsLPVVvRHnO-zPdE,523
+_pyinstaller_hooks_contrib/stdhooks/hook-uvloop.py,sha256=klDycjXcNetKquOPOWYx2VedfVovgHE4sT0d24EsG6Q,663
+_pyinstaller_hooks_contrib/stdhooks/hook-vaderSentiment.py,sha256=oLtl1Fxlp5BBvcPvnY350FlkKJ_xe6TNDt6e20-CwQk,522
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkAcceleratorsVTKmCore.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkAcceleratorsVTKmDataModel.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkAcceleratorsVTKmFilters.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkChartsCore.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonColor.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonComputationalGeometry.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonDataModel.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonExecutionModel.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonMath.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonMisc.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonPython.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonSystem.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkCommonTransforms.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkDomainsChemistry.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkDomainsChemistryOpenGL2.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersAMR.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersCellGrid.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersCore.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersExtraction.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersFlowPaths.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeneral.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeneric.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeometry.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersGeometryPreview.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersHybrid.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersHyperTree.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersImaging.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersModeling.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallel.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallelDIY2.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallelImaging.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersParallelStatistics.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersPoints.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersProgrammable.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersPython.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersReduction.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersSMP.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersSelection.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersSources.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersStatistics.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTemporal.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTensor.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTexture.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersTopology.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkFiltersVerdict.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkGeovisCore.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOAMR.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOAsynchronous.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOAvmesh.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCGNSReader.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCONVERGECFD.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCellGrid.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCesium3DTiles.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOChemistry.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCityGML.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOCore.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOERF.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOEnSight.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOEngys.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExodus.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExport.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExportGL2PS.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOExportPDF.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOFDS.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOFLUENTCFF.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOGeoJSON.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOGeometry.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOH5Rage.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOH5part.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOHDF.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOIOSS.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOImage.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOImport.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOInfovis.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOLANLX3D.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOLSDyna.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOLegacy.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOMINC.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOMotionFX.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOMovie.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIONetCDF.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOOMF.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOOggTheora.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOPIO.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOPLY.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallel.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallelExodus.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallelLSDyna.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOParallelXML.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOSQL.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOSegY.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOTRUCHAS.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOTecplotTable.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOVPIC.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOVeraOut.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOVideo.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOXML.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOXMLParser.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkIOXdmf2.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingColor.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingCore.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingFourier.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingGeneral.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingHybrid.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingMath.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingMorphological.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingOpenGL2.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingSources.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingStatistics.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkImagingStencil.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInfovisCore.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInfovisLayout.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInteractionImage.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInteractionStyle.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkInteractionWidgets.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkParallelCore.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkPythonContext2D.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingAnnotation.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingCellGrid.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingContext2D.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingContextOpenGL2.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingCore.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingExternal.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingFreeType.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingGL2PSOpenGL2.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingGridAxes.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingHyperTreeGrid.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingImage.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingLICOpenGL2.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingLOD.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingLabel.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingMatplotlib.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingOpenGL2.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingParallel.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingSceneGraph.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingUI.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVR.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVRModels.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVolume.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVolumeAMR.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVolumeOpenGL2.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkRenderingVtkJS.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkSerializationManager.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkTestingRendering.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkTestingSerialization.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkViewsContext2D.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkViewsCore.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkViewsInfovis.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkWebCore.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkmodules.vtkWebGLExporter.py,sha256=J1N88HYngy-2UiuN2rcUtIM7tT6piNyX6daU6i9GWyI,560
+_pyinstaller_hooks_contrib/stdhooks/hook-vtkpython.py,sha256=XY14rmVQKna1LvNhqszoImb0sW0UKuVZzYm_kOocjbs,949
+_pyinstaller_hooks_contrib/stdhooks/hook-wavefile.py,sha256=F-rA6wwxPPP-Ri15hEjDUVZ5uZ57uNt9rkNawmNaEuw,591
+_pyinstaller_hooks_contrib/stdhooks/hook-weasyprint.py,sha256=YQOd1AX1lmOr8rHwKcuuhzClJ4DlEFf8MZcsG5bAwI8,3915
+_pyinstaller_hooks_contrib/stdhooks/hook-web3.py,sha256=0XtNeiUKBz-SpHYaij3g_1KatWh3fIxJWyQrbK1Dg68,502
+_pyinstaller_hooks_contrib/stdhooks/hook-webassets.py,sha256=-9vQAQ_Dd_-zwabZSkNxn-vcCBbIDNp6mHKXT2jRhKk,539
+_pyinstaller_hooks_contrib/stdhooks/hook-webrtcvad.py,sha256=-Hhm45kE1oYpZ9c00GJfMdd46Isxh7IqXh58oircRcA,507
+_pyinstaller_hooks_contrib/stdhooks/hook-websockets.py,sha256=PklUXHU4iZxvFsnOgGdRyDFRxc15MCUSYIukc5L6vrA,568
+_pyinstaller_hooks_contrib/stdhooks/hook-webview.py,sha256=gcMHLFaKnsJuT08WGHbNeUOG0CabbQkggLursppRF40,698
+_pyinstaller_hooks_contrib/stdhooks/hook-win32com.py,sha256=0qR38kqHPFVAVKNhoCf7J-Oiui5gMM4myOTnZ5iEARI,644
+_pyinstaller_hooks_contrib/stdhooks/hook-wordcloud.py,sha256=nxDRIYdgKiB4QAoHBWRH5NFIqIaGVn560YWDI3Wnj1Y,517
+_pyinstaller_hooks_contrib/stdhooks/hook-workflow.py,sha256=l-HbGtVerjzReiLC0yrcyU0jsif_-NS7X2_f4_oxxII,506
+_pyinstaller_hooks_contrib/stdhooks/hook-wx.lib.activex.py,sha256=2ulQkghVbnvMxfynUZqGnRvpmplAYbOW08g578JY9Ik,581
+_pyinstaller_hooks_contrib/stdhooks/hook-wx.lib.pubsub.py,sha256=DIywUIZkoSM9VOqolMahmlcy8S3wdo4EOA6SxAawetE,582
+_pyinstaller_hooks_contrib/stdhooks/hook-wx.xrc.py,sha256=G1iIeRh7Kfa1W6dkewEK28s1zAgLWP8RN9nYnNVbPbU,455
+_pyinstaller_hooks_contrib/stdhooks/hook-xarray.py,sha256=LMjkQzvZN96S9PQOUKYguyWOyAFqFOakIWYONg9sW_g,1137
+_pyinstaller_hooks_contrib/stdhooks/hook-xml.dom.html.HTMLDocument.py,sha256=ABU_wswgSp07v_Bi_5mba8z1m3UpQHFl-xL7ihogAvs,3146
+_pyinstaller_hooks_contrib/stdhooks/hook-xml.sax.saxexts.py,sha256=406w-Anp5EylNFApwQ0bnbuIyMpiU1jU4BfdSGuPl-4,990
+_pyinstaller_hooks_contrib/stdhooks/hook-xmldiff.py,sha256=4Ko0wHSSSsmBPntpyr22NzY1ZAbB546go6Vxmjwst68,550
+_pyinstaller_hooks_contrib/stdhooks/hook-xmlschema.py,sha256=l59u4QIkdzmcIMj27GLW1puTVMNIdr8e96ur3viCYmk,644
+_pyinstaller_hooks_contrib/stdhooks/hook-xsge_gui.py,sha256=NJ70wLfuoi-jyCD-mDR1NAP01mhSr0AT3qwuvkZT8dU,587
+_pyinstaller_hooks_contrib/stdhooks/hook-xyzservices.py,sha256=6cgNAv3RLgNsQYF91Y61ai3EfJCaz2f6Htcn-Dsm9Wo,519
+_pyinstaller_hooks_contrib/stdhooks/hook-yapf_third_party.py,sha256=JwB1RswTKDKzdIVFe3qmt30Y6DHsMu2N7vzd6U8GY-g,524
+_pyinstaller_hooks_contrib/stdhooks/hook-z3c.rml.py,sha256=phkXTZu8hR1Y7GfFnbGw6Zcj2yVwRvbqvpx1fNR6KAQ,959
+_pyinstaller_hooks_contrib/stdhooks/hook-zarr.py,sha256=zWPBJVBVDThAZiSovPwuvsxY7UFy2lI2OKWPo49e6B8,502
+_pyinstaller_hooks_contrib/stdhooks/hook-zeep.py,sha256=Ds1kPuoCIJmioNWV91MI76TUO5al5QBlfHW_4Hu2ubI,612
+_pyinstaller_hooks_contrib/stdhooks/hook-zmq.py,sha256=B_VFStoRQzFF5tej6d6keZ1TGNCsEedH56FmdKkRqVk,2725
+_pyinstaller_hooks_contrib/stdhooks/hook-zoneinfo.py,sha256=99A9LN6khAbUAQfey6FaTHtdGZEaaOjavxwawAzbTdo,595
+_pyinstaller_hooks_contrib/utils/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
+_pyinstaller_hooks_contrib/utils/__pycache__/__init__.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/utils/__pycache__/nvidia_cuda.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/utils/__pycache__/vtkmodules.cpython-312.pyc,,
+_pyinstaller_hooks_contrib/utils/nvidia_cuda.py,sha256=gJO659n9CBpaGi6zYgFl1cdHHPvN125IaWWBC3yR9Qc,3009
+_pyinstaller_hooks_contrib/utils/vtkmodules.py,sha256=PjefsJ_eXA0P04g2lQDenK5kb-YrTxenMNJMAbzb-lM,19604
+pyinstaller_hooks_contrib-2025.10.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+pyinstaller_hooks_contrib-2025.10.dist-info/METADATA,sha256=wE6PN2oDJaWPd_c2bqvVTQyx84hmr8uzn9TEvbYZmqI,16078
+pyinstaller_hooks_contrib-2025.10.dist-info/RECORD,,
+pyinstaller_hooks_contrib-2025.10.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pyinstaller_hooks_contrib-2025.10.dist-info/entry_points.txt,sha256=FsM9QtmkHCPo9b23sWrxVW7Fv4awouh1WnBDFJpxJPs,69
+pyinstaller_hooks_contrib-2025.10.dist-info/licenses/LICENSE,sha256=kdC6r_AHcwOOcsCh_J1dLThwa3ornATzQpZgj5MbnNA,27666
+pyinstaller_hooks_contrib-2025.10.dist-info/top_level.txt,sha256=iLfKgsga5bLZMSkoWpHxWt6tDjcPVCvGsJgvwfMYcnA,27
diff --git a/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/WHEEL b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/WHEEL
new file mode 100644
index 0000000..e7fa31b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/entry_points.txt b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/entry_points.txt
new file mode 100644
index 0000000..a8c18cf
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/entry_points.txt
@@ -0,0 +1,2 @@
+[pyinstaller40]
+hook-dirs = _pyinstaller_hooks_contrib:get_hook_dirs
diff --git a/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/licenses/LICENSE b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/licenses/LICENSE
new file mode 100644
index 0000000..99bef9e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/licenses/LICENSE
@@ -0,0 +1,521 @@
+============================================
+PyInstaller Community Hooks: License details
+============================================
+
+This software is made available under the terms of the licenses found below.
+Contributions to the Community Hooks are made under the terms of the license
+that covers that type of hook/file. (See below)
+
+
+Standard hooks and files
+------------------------
+
+The PyInstaller Community Hooks are licensed under the terms of the GNU General
+Public License as published by the Free Software Foundation; either version 2 of
+the License, or (at your option) any later version (SPDX GPL-2.0-or-later).
+These are all hooks/files except runtime hooks (see below). The terms of GPL 2.0
+are found in the section titled *GNU General Public License* below.
+
+
+Runtime hooks
+-------------
+
+These are runtime hooks, bundled with complete pyinstaller executables. These
+files are licensed under the Apache-2.0 whose terms are found in the section
+titled *Apache License 2.0*.
+
+These reside in "_pyinstaller_hooks_contrib/rthooks".
+
+
+GNU General Public License
+--------------------------
+
+https://gnu.org/licenses/gpl-2.0.html
+
+
+		    GNU GENERAL PUBLIC LICENSE
+		       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+ 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+			    Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Library General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+		    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) Accompany it with the complete corresponding machine-readable
+    source code, which must be distributed under the terms of Sections
+    1 and 2 above on a medium customarily used for software interchange; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable.  However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+  5. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+  7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded.  In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the 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 Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation.  If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission.  For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this.  Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+			    NO WARRANTY
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+		     END OF TERMS AND CONDITIONS
+
+
+Apache License 2.0
+++++++++++++++++++
+
+                                 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.
diff --git a/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/top_level.txt
new file mode 100644
index 0000000..3d4a9b3
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/pyinstaller_hooks_contrib-2025.10.dist-info/top_level.txt
@@ -0,0 +1 @@
+_pyinstaller_hooks_contrib
diff --git a/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/METADATA
new file mode 100644
index 0000000..f125370
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/METADATA
@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: setuptools
+Version: 80.9.0
+Summary: Easily download, build, install, upgrade, and uninstall Python packages
+Author-email: Python Packaging Authority 
+License-Expression: MIT
+Project-URL: Source, https://github.com/pypa/setuptools
+Project-URL: Documentation, https://setuptools.pypa.io/
+Project-URL: Changelog, https://setuptools.pypa.io/en/stable/history.html
+Keywords: CPAN PyPI distutils eggs package management
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Archiving :: Packaging
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest!=8.1.*,>=6; extra == "test"
+Requires-Dist: virtualenv>=13.0.0; extra == "test"
+Requires-Dist: wheel>=0.44.0; extra == "test"
+Requires-Dist: pip>=19.1; extra == "test"
+Requires-Dist: packaging>=24.2; extra == "test"
+Requires-Dist: jaraco.envs>=2.2; extra == "test"
+Requires-Dist: pytest-xdist>=3; extra == "test"
+Requires-Dist: jaraco.path>=3.7.2; extra == "test"
+Requires-Dist: build[virtualenv]>=1.0.3; extra == "test"
+Requires-Dist: filelock>=3.4.0; extra == "test"
+Requires-Dist: ini2toml[lite]>=0.14; extra == "test"
+Requires-Dist: tomli-w>=1.0.0; extra == "test"
+Requires-Dist: pytest-timeout; extra == "test"
+Requires-Dist: pytest-perf; sys_platform != "cygwin" and extra == "test"
+Requires-Dist: jaraco.develop>=7.21; (python_version >= "3.9" and sys_platform != "cygwin") and extra == "test"
+Requires-Dist: pytest-home>=0.5; extra == "test"
+Requires-Dist: pytest-subprocess; extra == "test"
+Requires-Dist: pyproject-hooks!=1.1; extra == "test"
+Requires-Dist: jaraco.test>=5.5; extra == "test"
+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"
+Requires-Dist: pygments-github-lexers==0.0.5; extra == "doc"
+Requires-Dist: sphinx-favicon; extra == "doc"
+Requires-Dist: sphinx-inline-tabs; extra == "doc"
+Requires-Dist: sphinx-reredirects; extra == "doc"
+Requires-Dist: sphinxcontrib-towncrier; extra == "doc"
+Requires-Dist: sphinx-notfound-page<2,>=1; extra == "doc"
+Requires-Dist: pyproject-hooks!=1.1; extra == "doc"
+Requires-Dist: towncrier<24.7; extra == "doc"
+Provides-Extra: ssl
+Provides-Extra: certs
+Provides-Extra: core
+Requires-Dist: packaging>=24.2; extra == "core"
+Requires-Dist: more_itertools>=8.8; extra == "core"
+Requires-Dist: jaraco.text>=3.7; extra == "core"
+Requires-Dist: importlib_metadata>=6; python_version < "3.10" and extra == "core"
+Requires-Dist: tomli>=2.0.1; python_version < "3.11" and extra == "core"
+Requires-Dist: wheel>=0.43.0; extra == "core"
+Requires-Dist: platformdirs>=4.2.2; extra == "core"
+Requires-Dist: jaraco.functools>=4; extra == "core"
+Requires-Dist: more_itertools; extra == "core"
+Provides-Extra: check
+Requires-Dist: pytest-checkdocs>=2.4; extra == "check"
+Requires-Dist: pytest-ruff>=0.2.1; sys_platform != "cygwin" and extra == "check"
+Requires-Dist: ruff>=0.8.0; sys_platform != "cygwin" and extra == "check"
+Provides-Extra: cover
+Requires-Dist: pytest-cov; extra == "cover"
+Provides-Extra: enabler
+Requires-Dist: pytest-enabler>=2.2; extra == "enabler"
+Provides-Extra: type
+Requires-Dist: pytest-mypy; extra == "type"
+Requires-Dist: mypy==1.14.*; extra == "type"
+Requires-Dist: importlib_metadata>=7.0.2; python_version < "3.10" and extra == "type"
+Requires-Dist: jaraco.develop>=7.21; sys_platform != "cygwin" and extra == "type"
+Dynamic: license-file
+
+.. |pypi-version| image:: https://img.shields.io/pypi/v/setuptools.svg
+   :target: https://pypi.org/project/setuptools
+
+.. |py-version| image:: https://img.shields.io/pypi/pyversions/setuptools.svg
+
+.. |test-badge| image:: https://github.com/pypa/setuptools/actions/workflows/main.yml/badge.svg
+   :target: https://github.com/pypa/setuptools/actions?query=workflow%3A%22tests%22
+   :alt: tests
+
+.. |ruff-badge| 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
+
+.. |docs-badge| image:: https://img.shields.io/readthedocs/setuptools/latest.svg
+   :target: https://setuptools.pypa.io
+
+.. |skeleton-badge| image:: https://img.shields.io/badge/skeleton-2025-informational
+   :target: https://blog.jaraco.com/skeleton
+
+.. |codecov-badge| image:: https://img.shields.io/codecov/c/github/pypa/setuptools/master.svg?logo=codecov&logoColor=white
+   :target: https://codecov.io/gh/pypa/setuptools
+
+.. |tidelift-badge| image:: https://tidelift.com/badges/github/pypa/setuptools?style=flat
+   :target: https://tidelift.com/subscription/pkg/pypi-setuptools?utm_source=pypi-setuptools&utm_medium=readme
+
+.. |discord-badge| image:: https://img.shields.io/discord/803025117553754132
+   :target: https://discord.com/channels/803025117553754132/815945031150993468
+   :alt: Discord
+
+|pypi-version| |py-version| |test-badge| |ruff-badge| |docs-badge| |skeleton-badge| |codecov-badge| |discord-badge|
+
+See the `Quickstart `_
+and the `User's Guide `_ for
+instructions on how to use Setuptools.
+
+Questions and comments should be directed to `GitHub Discussions
+`_.
+Bug reports and especially tested patches may be
+submitted directly to the `bug tracker
+`_.
+
+
+Code of Conduct
+===============
+
+Everyone interacting in the setuptools project's codebases, issue trackers,
+chat rooms, and fora is expected to follow the
+`PSF Code of Conduct `_.
+
+
+For Enterprise
+==============
+
+Available as part of the Tidelift Subscription.
+
+Setuptools 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 `_.
diff --git a/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/RECORD
new file mode 100644
index 0000000..e30c39a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/RECORD
@@ -0,0 +1,868 @@
+_distutils_hack/__init__.py,sha256=34HmvLo07j45Uvd2VR-2aRQ7lJD91sTK6zJgn5fphbQ,6755
+_distutils_hack/__pycache__/__init__.cpython-312.pyc,,
+_distutils_hack/__pycache__/override.cpython-312.pyc,,
+_distutils_hack/override.py,sha256=Eu_s-NF6VIZ4Cqd0tbbA5wtWky2IZPNd8et6GLt1mzo,44
+distutils-precedence.pth,sha256=JjjOniUA5XKl4N5_rtZmHrVp0baW_LoHsN0iPaX10iQ,151
+pkg_resources/__init__.py,sha256=uxrWmKF3lxsG4q6ojHlu4tB8j8Kw9jqx_SNMyDKP5q4,126219
+pkg_resources/__pycache__/__init__.cpython-312.pyc,,
+pkg_resources/api_tests.txt,sha256=XEdvy4igHHrq2qNHNMHnlfO6XSQKNqOyLHbl6QcpfAI,12595
+pkg_resources/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pkg_resources/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pkg_resources/tests/__pycache__/__init__.cpython-312.pyc,,
+pkg_resources/tests/__pycache__/test_find_distributions.cpython-312.pyc,,
+pkg_resources/tests/__pycache__/test_integration_zope_interface.cpython-312.pyc,,
+pkg_resources/tests/__pycache__/test_markers.cpython-312.pyc,,
+pkg_resources/tests/__pycache__/test_pkg_resources.cpython-312.pyc,,
+pkg_resources/tests/__pycache__/test_resources.cpython-312.pyc,,
+pkg_resources/tests/__pycache__/test_working_set.cpython-312.pyc,,
+pkg_resources/tests/data/my-test-package-source/__pycache__/setup.cpython-312.pyc,,
+pkg_resources/tests/data/my-test-package-source/setup.cfg,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pkg_resources/tests/data/my-test-package-source/setup.py,sha256=1VobhAZbMb7M9mfhb_NE8PwDsvukoWLs9aUAS0pYhe8,105
+pkg_resources/tests/data/my-test-package-zip/my-test-package.zip,sha256=AYRcQ39GVePPnMT8TknP1gdDHyJnXhthESmpAjnzSCI,1809
+pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/PKG-INFO,sha256=JvWv9Io2PAuYwEEw2fBW4Qc5YvdbkscpKX1kmLzsoHk,187
+pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/SOURCES.txt,sha256=4ClkH8eTovZrdVrJFsVuxdbMEF--lBVSuKonDAPE5Jc,208
+pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/dependency_links.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+pkg_resources/tests/data/my-test-package_zipped-egg/my_test_package-1.0-py3.7.egg,sha256=ZTlMGxjRGiKDNkiA2c75jbQH2TWIteP00irF9gvczbo,843
+pkg_resources/tests/test_find_distributions.py,sha256=U91cov5L1COAIWLNq3Xy4plU7_MnOE1WtXMu6iV2waM,1972
+pkg_resources/tests/test_integration_zope_interface.py,sha256=nzVoK557KZQN0V3DIQ1sVeaCOgt4Kpl-CODAWsO7pmc,1652
+pkg_resources/tests/test_markers.py,sha256=0orKg7UMDf7fnuNQvRMOc-EF9EAP_JTQnk4mtGgbW50,241
+pkg_resources/tests/test_pkg_resources.py,sha256=5Mt4bJQhLCL8j8cC46Uv32Np2Xc1TTxLGawIfET55Fk,17111
+pkg_resources/tests/test_resources.py,sha256=K0LqMAUGpRQ9pUb9K0vyI7GesvtlQvTH074m-E2VQlo,31252
+pkg_resources/tests/test_working_set.py,sha256=lRtGJWIixSwSMSbjHgRxeJEQiLMRXcz3xzJL2qL7eXY,8602
+setuptools-80.9.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools-80.9.0.dist-info/METADATA,sha256=f4kMqNvBa2O1aMiTEu1qf58KedCyt_PIO_eWrD2TBhU,6572
+setuptools-80.9.0.dist-info/RECORD,,
+setuptools-80.9.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+setuptools-80.9.0.dist-info/entry_points.txt,sha256=zkgthpf_Fa9NVE9p6FKT3Xk9DR1faAcRU4coggsV7jA,2449
+setuptools-80.9.0.dist-info/licenses/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023
+setuptools-80.9.0.dist-info/top_level.txt,sha256=d9yL39v_W7qmKDDSH6sT4bE0j_Ls1M3P161OGgdsm4g,41
+setuptools/__init__.py,sha256=7duacBaImxzrUa0OghIz8lVgaJ1fIw7-uL2v16vY_SE,9004
+setuptools/__pycache__/__init__.cpython-312.pyc,,
+setuptools/__pycache__/_core_metadata.cpython-312.pyc,,
+setuptools/__pycache__/_discovery.cpython-312.pyc,,
+setuptools/__pycache__/_entry_points.cpython-312.pyc,,
+setuptools/__pycache__/_imp.cpython-312.pyc,,
+setuptools/__pycache__/_importlib.cpython-312.pyc,,
+setuptools/__pycache__/_itertools.cpython-312.pyc,,
+setuptools/__pycache__/_normalization.cpython-312.pyc,,
+setuptools/__pycache__/_path.cpython-312.pyc,,
+setuptools/__pycache__/_reqs.cpython-312.pyc,,
+setuptools/__pycache__/_scripts.cpython-312.pyc,,
+setuptools/__pycache__/_shutil.cpython-312.pyc,,
+setuptools/__pycache__/_static.cpython-312.pyc,,
+setuptools/__pycache__/archive_util.cpython-312.pyc,,
+setuptools/__pycache__/build_meta.cpython-312.pyc,,
+setuptools/__pycache__/depends.cpython-312.pyc,,
+setuptools/__pycache__/discovery.cpython-312.pyc,,
+setuptools/__pycache__/dist.cpython-312.pyc,,
+setuptools/__pycache__/errors.cpython-312.pyc,,
+setuptools/__pycache__/extension.cpython-312.pyc,,
+setuptools/__pycache__/glob.cpython-312.pyc,,
+setuptools/__pycache__/installer.cpython-312.pyc,,
+setuptools/__pycache__/launch.cpython-312.pyc,,
+setuptools/__pycache__/logging.cpython-312.pyc,,
+setuptools/__pycache__/modified.cpython-312.pyc,,
+setuptools/__pycache__/monkey.cpython-312.pyc,,
+setuptools/__pycache__/msvc.cpython-312.pyc,,
+setuptools/__pycache__/namespaces.cpython-312.pyc,,
+setuptools/__pycache__/unicode_utils.cpython-312.pyc,,
+setuptools/__pycache__/version.cpython-312.pyc,,
+setuptools/__pycache__/warnings.cpython-312.pyc,,
+setuptools/__pycache__/wheel.cpython-312.pyc,,
+setuptools/__pycache__/windows_support.cpython-312.pyc,,
+setuptools/_core_metadata.py,sha256=T7Tjp-WSoN881adev3R1wzXCPnkDHqbC2MgylN1yjS8,11978
+setuptools/_discovery.py,sha256=HxEpgYQ8zUaLOOSp8JIA4y2Mdvn9ysVxspPT-ppfzM4,836
+setuptools/_distutils/__init__.py,sha256=xGYuhWwLG07J0Q49BVnEjPy6wyDcd6veJMDJX7ljlyM,359
+setuptools/_distutils/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/_log.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/_macos_compat.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/_modified.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/_msvccompiler.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/archive_util.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/ccompiler.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/cmd.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/core.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/cygwinccompiler.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/debug.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/dep_util.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/dir_util.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/dist.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/errors.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/extension.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/fancy_getopt.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/file_util.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/filelist.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/log.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/spawn.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/sysconfig.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/text_file.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/unixccompiler.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/util.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/version.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/versionpredicate.cpython-312.pyc,,
+setuptools/_distutils/__pycache__/zosccompiler.cpython-312.pyc,,
+setuptools/_distutils/_log.py,sha256=i-lNTTcXS8TmWITJ6DODGvtW5z5tMattJQ76h8rZxQU,42
+setuptools/_distutils/_macos_compat.py,sha256=JzUGhF4E5yIITHbUaPobZEWjGHdrrcNV63z86S4RjBc,239
+setuptools/_distutils/_modified.py,sha256=RF1n1CexyDYV3lvGbeXS0s-XCJVboDOIUbA8wEQqYTY,3211
+setuptools/_distutils/_msvccompiler.py,sha256=9PSfSHxvJnHnQL6Sqz4Xcz7iaBIT62p6BheQzGsSlwo,335
+setuptools/_distutils/archive_util.py,sha256=Qw2z-Pt-NV8lNUQrzjs3XDGWCWHMPnqHLyt8TiD2XEA,8884
+setuptools/_distutils/ccompiler.py,sha256=FKVjqzGJ7c-FtouNjhLiaMPm5LKMZHHAruXf8LU216c,524
+setuptools/_distutils/cmd.py,sha256=hXtaRaH7QBnfNOIqEvCt47iwZzD9MVvBdhhdQctHsxM,22186
+setuptools/_distutils/command/__init__.py,sha256=GfFAzbBqk1qxSH4BdaKioKS4hRRnD44BAmwEN85C4u8,386
+setuptools/_distutils/command/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/_framework_compat.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/bdist.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/bdist_dumb.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/bdist_rpm.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/build.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/build_clib.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/build_ext.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/build_py.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/build_scripts.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/check.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/clean.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/config.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/install.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/install_data.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/install_egg_info.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/install_headers.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/install_lib.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/install_scripts.cpython-312.pyc,,
+setuptools/_distutils/command/__pycache__/sdist.cpython-312.pyc,,
+setuptools/_distutils/command/_framework_compat.py,sha256=0iZdSJYzGRWCCvzRDKE-R0-_yaAYvFMd1ylXb2eYXug,1609
+setuptools/_distutils/command/bdist.py,sha256=jWtk61R7fWNUUNxJV0thTZzU5n80L3Ay1waSiP9kiLA,5854
+setuptools/_distutils/command/bdist_dumb.py,sha256=Hx1jAqoZNxYIy4N5TLzUp6J5fi8Ls18py7UlLNFhO2E,4631
+setuptools/_distutils/command/bdist_rpm.py,sha256=nxcXXv5a7B-1ntWu4DbGmCtES4EBINrJaBQcRNAYCJI,21785
+setuptools/_distutils/command/build.py,sha256=SpHlagf0iNaKVyIhxDfhPFZ8X1-LAWOCQACy-yt2K0w,5923
+setuptools/_distutils/command/build_clib.py,sha256=aMqZcUfCbOAu_xr-A9iW-Q9YZHzpDGLRTezOgMQJmSQ,7777
+setuptools/_distutils/command/build_ext.py,sha256=zrrsu9HXnzV6bXYbJuZCK4SwVZMjKnl4pG1o3bNcxtc,32710
+setuptools/_distutils/command/build_py.py,sha256=Vfq-INemoMbg6f003BTy_Ufp8bjOZhmFIhpKMcfXLgs,16696
+setuptools/_distutils/command/build_scripts.py,sha256=emMEOONkNLPC-AMjKy45UksUlY1wk06esOGThpwidIM,5135
+setuptools/_distutils/command/check.py,sha256=yoNe2MPY4JcTM7rwoIQdfZ75q5Ri058I2coi-Gq9CjM,4946
+setuptools/_distutils/command/clean.py,sha256=dQAacOabwBXU9JoZ-1GFusq3eFltDaeXJFSYncqGbvE,2644
+setuptools/_distutils/command/config.py,sha256=qrrfz6NEQORmbqiY2XlvCDWYhsbLyxZXJsURKfYN_kw,12724
+setuptools/_distutils/command/install.py,sha256=-JenB-mua4hc2RI_-W8F9PnP_J-OaFO7E0PJGKxLo1o,30072
+setuptools/_distutils/command/install_data.py,sha256=GzBlUWWKubTYJlP-L0auUriq9cL-5RKOcoyHTttKj0Q,2875
+setuptools/_distutils/command/install_egg_info.py,sha256=ffiLoU1ivQJ8q2_WL7ZygZbUcOsgdFLKL7otEIJWWkI,2868
+setuptools/_distutils/command/install_headers.py,sha256=5ciKCj8c3XKsYNKdkdMvnypaUCKcoWCDeeZij3fD-Z4,1272
+setuptools/_distutils/command/install_lib.py,sha256=2s9-m5-b1qKm51F28lB5L39Z6vv_GHMlv9dNBSupok0,8588
+setuptools/_distutils/command/install_scripts.py,sha256=M0pPdiaqB7TGmqTMujpGGeiL0Iq_CTeGjMFtrmDmwzM,2002
+setuptools/_distutils/command/sdist.py,sha256=cRIF6Ht1hJ6ayOOFVycMFBUNxjo94e_rFYPx4Hi8Ahc,19151
+setuptools/_distutils/compat/__init__.py,sha256=J20aXGjJ86Rg41xFLIWlcWCgZ9edMdJ9vvdNEQ87vPQ,522
+setuptools/_distutils/compat/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_distutils/compat/__pycache__/numpy.cpython-312.pyc,,
+setuptools/_distutils/compat/__pycache__/py39.cpython-312.pyc,,
+setuptools/_distutils/compat/numpy.py,sha256=UFgneZw9w97g4c-yGoAIOyLxUOWQ-fPRIhhfMs7_Ouc,167
+setuptools/_distutils/compat/py39.py,sha256=hOsD6lwZLqZoMnacNJ3P6nUA-LJQhEpVtYTzVH0o96M,1964
+setuptools/_distutils/compilers/C/__pycache__/base.cpython-312.pyc,,
+setuptools/_distutils/compilers/C/__pycache__/cygwin.cpython-312.pyc,,
+setuptools/_distutils/compilers/C/__pycache__/errors.cpython-312.pyc,,
+setuptools/_distutils/compilers/C/__pycache__/msvc.cpython-312.pyc,,
+setuptools/_distutils/compilers/C/__pycache__/unix.cpython-312.pyc,,
+setuptools/_distutils/compilers/C/__pycache__/zos.cpython-312.pyc,,
+setuptools/_distutils/compilers/C/base.py,sha256=XR1rBCStCquqm7QOYXD41-LfvsFcPpGxrwxeXzJyn_w,54876
+setuptools/_distutils/compilers/C/cygwin.py,sha256=DUlwQSb55aj7OdcmcddrmCmVEjEaxIiJ5hHUO3GBPNs,11844
+setuptools/_distutils/compilers/C/errors.py,sha256=sKOVzJajMUmNdfywo9UM_QQGsKFcclDhtI5TlCiXMLc,573
+setuptools/_distutils/compilers/C/msvc.py,sha256=elzG8v9jN5QytLMwLCdUdSuZ3eZ3R98VUvnm9Y2PBCA,21404
+setuptools/_distutils/compilers/C/tests/__pycache__/test_base.cpython-312.pyc,,
+setuptools/_distutils/compilers/C/tests/__pycache__/test_cygwin.cpython-312.pyc,,
+setuptools/_distutils/compilers/C/tests/__pycache__/test_mingw.cpython-312.pyc,,
+setuptools/_distutils/compilers/C/tests/__pycache__/test_msvc.cpython-312.pyc,,
+setuptools/_distutils/compilers/C/tests/__pycache__/test_unix.cpython-312.pyc,,
+setuptools/_distutils/compilers/C/tests/test_base.py,sha256=rdhHc56bhXtm5NnN9BSHwr6c69UqzMItZQzlw2AsdMc,2706
+setuptools/_distutils/compilers/C/tests/test_cygwin.py,sha256=UgV2VgUXj3VulcbDc0UBWfEyJDx42tgSwS4LzHix3mY,2701
+setuptools/_distutils/compilers/C/tests/test_mingw.py,sha256=hCmwyywISpRoyOySbFHBL4TprWRV0mUWDKmOLO8XBXE,1900
+setuptools/_distutils/compilers/C/tests/test_msvc.py,sha256=DlGjmZ1mBSMXIgmlu80BKc7V-EJOZuYucwJwFh5dn28,4151
+setuptools/_distutils/compilers/C/tests/test_unix.py,sha256=AyadWw1fR-UeDl2TvIbYBzOJVHkpE_oRRQ3JTJWqaEA,14642
+setuptools/_distutils/compilers/C/unix.py,sha256=YH-y9g_pjBFjaJyHJQkDEBQ7q4D20I2-cWJNdgw-Yho,16531
+setuptools/_distutils/compilers/C/zos.py,sha256=vnNeWLRZkdIkdZ-YyBnL8idTUfcCOn0tLMW5OBJ0ScU,6586
+setuptools/_distutils/core.py,sha256=GEHKaFC48T3o-_SmH4864GvKyx1IgbVC6ISIPVlx7a4,9364
+setuptools/_distutils/cygwinccompiler.py,sha256=mG_cU8SVZ4amD_VtF5vH6BXP0-kghGsDPbDSXrQ963c,594
+setuptools/_distutils/debug.py,sha256=N6MrTAqK6l9SVk6tWweR108PM8Ol7qNlfyV-nHcLhsY,139
+setuptools/_distutils/dep_util.py,sha256=xN75p6ZpHhMiHEc-rpL2XilJQynHnDNiafHteaZ4tjU,349
+setuptools/_distutils/dir_util.py,sha256=DXPUlfVVGsg9B-Jgg4At_j9T7vM60OgwNXkQHqTo7-I,7236
+setuptools/_distutils/dist.py,sha256=gW598UE0WMkzXQQ31Nr-8L7MPw0oIOz5OSSRzYZlwrM,55794
+setuptools/_distutils/errors.py,sha256=PPE2oDRh5y9Q1beKK9rhdvDaCzQhi4HCXs4KcqfqgZY,3092
+setuptools/_distutils/extension.py,sha256=Foyu4gULcPqm1_U9zrYYHxNk4NqglXv1rbsOk_QrSds,11155
+setuptools/_distutils/fancy_getopt.py,sha256=PjdO-bWCW0imV_UN-MGEw9R2GP2OiE8pHjITgmTAY3Q,17895
+setuptools/_distutils/file_util.py,sha256=YFQL_pD3hLuER9II_H6-hDC_YIGEookdd4wedLuiTW0,7978
+setuptools/_distutils/filelist.py,sha256=MBeSRJmPcKmDv8ooZgSU4BiQPZ0Khwv8l_jhD50XycI,15337
+setuptools/_distutils/log.py,sha256=VyBs5j7z4-K6XTEEBThUc9HyMpoPLGtQpERqbz5ylww,1200
+setuptools/_distutils/spawn.py,sha256=zseCh9sEifyp0I5Vg719JNIASlROJ2ehXqQnHlpt89Q,4086
+setuptools/_distutils/sysconfig.py,sha256=KeI8OHbMuEzHJ8Q0cBez9KZny8iRy6Z6Y0AkMz1jlsU,19728
+setuptools/_distutils/tests/__init__.py,sha256=j-IoPZEtQv3EOPuqNTwalr6GLyRjzCC-OOaNvZzmHsI,1485
+setuptools/_distutils/tests/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/support.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_archive_util.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_bdist.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_bdist_dumb.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_bdist_rpm.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_build.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_build_clib.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_build_ext.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_build_py.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_build_scripts.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_check.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_clean.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_cmd.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_config_cmd.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_core.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_dir_util.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_dist.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_extension.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_file_util.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_filelist.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_install.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_install_data.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_install_headers.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_install_lib.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_install_scripts.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_log.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_modified.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_sdist.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_spawn.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_sysconfig.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_text_file.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_util.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_version.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/test_versionpredicate.cpython-312.pyc,,
+setuptools/_distutils/tests/__pycache__/unix_compat.cpython-312.pyc,,
+setuptools/_distutils/tests/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_distutils/tests/compat/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_distutils/tests/compat/__pycache__/py39.cpython-312.pyc,,
+setuptools/_distutils/tests/compat/py39.py,sha256=t0GBTM-30jX-9zCfkwlNBFtzzabemx6065mJ0d9_VRw,1026
+setuptools/_distutils/tests/support.py,sha256=tjsYsyxvpTK4NrkCseh2ujvDIGV0Mf_b5SI5fP2T0yM,4099
+setuptools/_distutils/tests/test_archive_util.py,sha256=jozimSwPBF-JoJfN_vDaiVGZp66BNcWZGh34FlW57DQ,11787
+setuptools/_distutils/tests/test_bdist.py,sha256=xNHxUsLlHsZQRwkzLb_iSD24s-9Mk-NX2ffBWwOyPyc,1396
+setuptools/_distutils/tests/test_bdist_dumb.py,sha256=QF05MHNhPOdZyh88Xpw8KsO64s7pRFkl8KL-RoV4XK0,2247
+setuptools/_distutils/tests/test_bdist_rpm.py,sha256=Hdm-pwWgyaoGdGbEcGZa8cRhGU45y8gHK8umOanTjik,3932
+setuptools/_distutils/tests/test_build.py,sha256=JJY5XpOZco25ZY0pstxl-iI8mHsWP0ujf5o8aOtuZYY,1742
+setuptools/_distutils/tests/test_build_clib.py,sha256=Mo1ZFb4C1VXBYOGvnallwN7YCnTtr24akLDO8Zi4CsY,4331
+setuptools/_distutils/tests/test_build_ext.py,sha256=QFO9qYVhWWdJu17HXc4x9RMnLZlhk0lAHi9HVppbuX4,22545
+setuptools/_distutils/tests/test_build_py.py,sha256=NsfmRrojOHBXNMqWR_mp5g4PLTgjhD7iZFUffGZFIdw,6882
+setuptools/_distutils/tests/test_build_scripts.py,sha256=cD-FRy-oX55sXRX5Ez5xQCaeHrWajyKc4Xuwv2fe48w,2880
+setuptools/_distutils/tests/test_check.py,sha256=hHSV07qf7YoSxGsTbbsUQ9tssZz5RRNdbrY1s2SwaFI,6226
+setuptools/_distutils/tests/test_clean.py,sha256=hPH6jfIpGFUrvWbF1txkiNVSNaAxt2wq5XjV499zO4E,1240
+setuptools/_distutils/tests/test_cmd.py,sha256=bgRB79mitoOKR1OiyZHnCogvGxt3pWkxeTqIC04lQWQ,3254
+setuptools/_distutils/tests/test_config_cmd.py,sha256=Zs6WX0IfxDvmuC19XzuVNnYCnTr9Y-hl73TAmDSBN4Y,2664
+setuptools/_distutils/tests/test_core.py,sha256=L7XKVAxa-MGoAZeANopnuK9fRKneYhkSQpgw8XQvcF8,3829
+setuptools/_distutils/tests/test_dir_util.py,sha256=E84lC-k4riVUwURyWaQ0Jqx2ui2-io-0RuJa3M7qkJs,4500
+setuptools/_distutils/tests/test_dist.py,sha256=a6wlc5fQJd5qQ6HOndzcupNhjTxvj6-_JLtpuYvaP1M,18793
+setuptools/_distutils/tests/test_extension.py,sha256=-YejLgZCuycFrOBd64pVH0JvwMc9NwhzHvQxvvjXHqk,3670
+setuptools/_distutils/tests/test_file_util.py,sha256=livjnl3FkilQlrB2rFdFQq9nvjEVZHynNya0bfzv_b4,3522
+setuptools/_distutils/tests/test_filelist.py,sha256=rJwkqCUfkGDgWlD22TozsT8ycbupMHB8DXqThzwT1T4,10766
+setuptools/_distutils/tests/test_install.py,sha256=TfCB0ykhIxydIC2Q4SuTAZzSHvteMHgrBL9whoSgK9Q,8618
+setuptools/_distutils/tests/test_install_data.py,sha256=vKq3K97k0hBAnOg38nmwEdf7cEDVr9rTVyCeJolgb4A,2464
+setuptools/_distutils/tests/test_install_headers.py,sha256=PVAYpo_tYl980Qf64DPOmmSvyefIHdU06f7VsJeZykE,936
+setuptools/_distutils/tests/test_install_lib.py,sha256=qri6Rl-maNTQrNDV8DbeXNl0hjsfRIKiI4rfZLrmWBI,3612
+setuptools/_distutils/tests/test_install_scripts.py,sha256=KE3v0cDkFW-90IOID-OmZZGM2mhy-ZkEuuW7UXS2SHw,1600
+setuptools/_distutils/tests/test_log.py,sha256=isFtOufloCyEdZaQOV7cVUr46GwtdVMj43mGBB5XH7k,323
+setuptools/_distutils/tests/test_modified.py,sha256=h1--bOWmtJo1bpVV6uRhdnS9br71CBiNDM1MDwSGpug,4221
+setuptools/_distutils/tests/test_sdist.py,sha256=cfzUhlCA418-1vH9ta3IBs26c_jUBbkJoFOK5GnAyNk,15062
+setuptools/_distutils/tests/test_spawn.py,sha256=eS8w9D7bTxyFLSyRahJWeuh8Kc1F8RWWiY_dSG5B5Bc,4803
+setuptools/_distutils/tests/test_sysconfig.py,sha256=lxM8LsUi1TomjDV4HoYK8u5nUoBkeNL60Uq8PY1DcwU,11986
+setuptools/_distutils/tests/test_text_file.py,sha256=WQWSB5AfdBDZaMA8BFgipJPnsJb_2SKMfL90fSkRVtw,3460
+setuptools/_distutils/tests/test_util.py,sha256=H9zlZ4z4Vh4TfjNYDBsxP7wguQLpxCfJYyOcm1yZU3c,7988
+setuptools/_distutils/tests/test_version.py,sha256=ahfg_mP8wRy1sgwY-_Px5hrjgf6_upTIpnCgpR4yWRk,2750
+setuptools/_distutils/tests/test_versionpredicate.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_distutils/tests/unix_compat.py,sha256=z-op6C2iVdX1aq5BIBR7cqOxijKE97alNwJqHNdLpoI,386
+setuptools/_distutils/text_file.py,sha256=z4dkOJBr9Bo2LG0TNqm8sD63LEEaKSSP0J0bWBrFG3c,12101
+setuptools/_distutils/unixccompiler.py,sha256=1bXJWH4fiu_A2WfriHzf88xjllQTXnnjUkZdRKs9cWU,212
+setuptools/_distutils/util.py,sha256=Njfnqk60zMdkiAjRnGcTWX3t49-obHapOlbNvyIl02I,18094
+setuptools/_distutils/version.py,sha256=vImT5-ECXkQ21oKL0XYFiTqK6NyM09cpzBNoA_34CQU,12619
+setuptools/_distutils/versionpredicate.py,sha256=qBWQ6wTj12ODytoTmIydefIY2jb4uY1sdbgbuLn-IJM,5205
+setuptools/_distutils/zosccompiler.py,sha256=svdiXZ2kdcwKrJKfhUhib03y8gz7aGZKukXH3I7YkBc,58
+setuptools/_entry_points.py,sha256=10TjbzfGdqWGH06lQuPPGDDci-OnXoIzrfpIWba5AZw,2468
+setuptools/_imp.py,sha256=YY1EjZEN-0zYci1cxO10B_adAEOr7i8eK8JoCc9Ierc,2435
+setuptools/_importlib.py,sha256=aKIjcK0HKXNz2D-XTrxaixGn_juTkONwmu3dcheMOF0,223
+setuptools/_itertools.py,sha256=jWRfsIrpC7myooz3hDURj9GtvpswZeKXg2HakmEhNjo,657
+setuptools/_normalization.py,sha256=-SxdhisW3W1JKzqKYxd3XeHyRjIj3J9EVRkt3aL8nKY,5747
+setuptools/_path.py,sha256=2Bv1q9_Hrd4oizKwcH3pv_05YVR6meovQE6ZtyD45yI,2976
+setuptools/_reqs.py,sha256=RRX-qYsz_fy6K66XchCHcIszK3bSAtU6aO1s3ZaLV14,1380
+setuptools/_scripts.py,sha256=5TrIWDVOuO3cRcfzcZAUBKPRH7K4svQRdQLZKKiD1bQ,11247
+setuptools/_shutil.py,sha256=IQQ1gcPX4X_wPilYGJGxChyMCqG43VOejoQZTIrCTY8,1578
+setuptools/_static.py,sha256=GTR79gESF1_JaK4trLkpDrEuCeEtPlwQW0MRv7VNQX4,4855
+setuptools/_vendor/__pycache__/typing_extensions.cpython-312.pyc,,
+setuptools/_vendor/autocommand-2.2.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/autocommand-2.2.2.dist-info/LICENSE,sha256=reeNBJgtaZctREqOFKlPh6IzTdOFXMgDSOqOJAqg3y0,7634
+setuptools/_vendor/autocommand-2.2.2.dist-info/METADATA,sha256=OADZuR3O6iBlpu1ieTgzYul6w4uOVrk0P0BO5TGGAJk,15006
+setuptools/_vendor/autocommand-2.2.2.dist-info/RECORD,sha256=giu6ZrQVJvpUcYa4AiH4XaUNZSvuVJPb_l0UCFES8MM,1308
+setuptools/_vendor/autocommand-2.2.2.dist-info/WHEEL,sha256=2wepM1nk4DS4eFpYrW1TTqPcoGNfHhhO_i5m4cOimbo,92
+setuptools/_vendor/autocommand-2.2.2.dist-info/top_level.txt,sha256=AzfhgKKS8EdAwWUTSF8mgeVQbXOY9kokHB6kSqwwqu0,12
+setuptools/_vendor/autocommand/__init__.py,sha256=zko5Rnvolvb-UXjCx_2ArPTGBWwUK5QY4LIQIKYR7As,1037
+setuptools/_vendor/autocommand/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/autocommand/__pycache__/autoasync.cpython-312.pyc,,
+setuptools/_vendor/autocommand/__pycache__/autocommand.cpython-312.pyc,,
+setuptools/_vendor/autocommand/__pycache__/automain.cpython-312.pyc,,
+setuptools/_vendor/autocommand/__pycache__/autoparse.cpython-312.pyc,,
+setuptools/_vendor/autocommand/__pycache__/errors.cpython-312.pyc,,
+setuptools/_vendor/autocommand/autoasync.py,sha256=AMdyrxNS4pqWJfP_xuoOcImOHWD-qT7x06wmKN1Vp-U,5680
+setuptools/_vendor/autocommand/autocommand.py,sha256=hmkEmQ72HtL55gnURVjDOnsfYlGd5lLXbvT4KG496Qw,2505
+setuptools/_vendor/autocommand/automain.py,sha256=A2b8i754Mxc_DjU9WFr6vqYDWlhz0cn8miu8d8EsxV8,2076
+setuptools/_vendor/autocommand/autoparse.py,sha256=WVWmZJPcbzUKXP40raQw_0HD8qPJ2V9VG1eFFmmnFxw,11642
+setuptools/_vendor/autocommand/errors.py,sha256=7aa3roh9Herd6nIKpQHNWEslWE8oq7GiHYVUuRqORnA,886
+setuptools/_vendor/backports.tarfile-1.2.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/backports.tarfile-1.2.0.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023
+setuptools/_vendor/backports.tarfile-1.2.0.dist-info/METADATA,sha256=ghXFTq132dxaEIolxr3HK1mZqm9iyUmaRANZQSr6WlE,2020
+setuptools/_vendor/backports.tarfile-1.2.0.dist-info/RECORD,sha256=JYofHISeEXUGmlWl1s41ev3QTjTNXeJwk-Ss7HqdLOE,1360
+setuptools/_vendor/backports.tarfile-1.2.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/backports.tarfile-1.2.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+setuptools/_vendor/backports.tarfile-1.2.0.dist-info/top_level.txt,sha256=cGjaLMOoBR1FK0ApojtzWVmViTtJ7JGIK_HwXiEsvtU,10
+setuptools/_vendor/backports/__init__.py,sha256=iOEMwnlORWezdO8-2vxBIPSR37D7JGjluZ8f55vzxls,81
+setuptools/_vendor/backports/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/backports/tarfile/__init__.py,sha256=Pwf2qUIfB0SolJPCKcx3vz3UEu_aids4g4sAfxy94qg,108491
+setuptools/_vendor/backports/tarfile/__main__.py,sha256=Yw2oGT1afrz2eBskzdPYL8ReB_3liApmhFkN2EbDmc4,59
+setuptools/_vendor/backports/tarfile/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/backports/tarfile/__pycache__/__main__.cpython-312.pyc,,
+setuptools/_vendor/backports/tarfile/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/backports/tarfile/compat/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/backports/tarfile/compat/__pycache__/py38.cpython-312.pyc,,
+setuptools/_vendor/backports/tarfile/compat/py38.py,sha256=iYkyt_gvWjLzGUTJD9TuTfMMjOk-ersXZmRlvQYN2qE,568
+setuptools/_vendor/importlib_metadata-8.0.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/importlib_metadata-8.0.0.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+setuptools/_vendor/importlib_metadata-8.0.0.dist-info/METADATA,sha256=anuQ7_7h4J1bSEzfcjIBakPi2cyVQ7y7jklLHsBeH1k,4648
+setuptools/_vendor/importlib_metadata-8.0.0.dist-info/RECORD,sha256=DY08buueu-hsrH1ghhVSQzwynanqUSSLYdAr4uXmQDA,2518
+setuptools/_vendor/importlib_metadata-8.0.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/importlib_metadata-8.0.0.dist-info/WHEEL,sha256=mguMlWGMX-VHnMpKOjjQidIo1ssRlCFu4a4mBpz1s2M,91
+setuptools/_vendor/importlib_metadata-8.0.0.dist-info/top_level.txt,sha256=CO3fD9yylANiXkrMo4qHLV_mqXL2sC5JFKgt1yWAT-A,19
+setuptools/_vendor/importlib_metadata/__init__.py,sha256=tZNB-23h8Bixi9uCrQqj9Yf0aeC--Josdy3IZRIQeB0,33798
+setuptools/_vendor/importlib_metadata/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/importlib_metadata/__pycache__/_adapters.cpython-312.pyc,,
+setuptools/_vendor/importlib_metadata/__pycache__/_collections.cpython-312.pyc,,
+setuptools/_vendor/importlib_metadata/__pycache__/_compat.cpython-312.pyc,,
+setuptools/_vendor/importlib_metadata/__pycache__/_functools.cpython-312.pyc,,
+setuptools/_vendor/importlib_metadata/__pycache__/_itertools.cpython-312.pyc,,
+setuptools/_vendor/importlib_metadata/__pycache__/_meta.cpython-312.pyc,,
+setuptools/_vendor/importlib_metadata/__pycache__/_text.cpython-312.pyc,,
+setuptools/_vendor/importlib_metadata/__pycache__/diagnose.cpython-312.pyc,,
+setuptools/_vendor/importlib_metadata/_adapters.py,sha256=rIhWTwBvYA1bV7i-5FfVX38qEXDTXFeS5cb5xJtP3ks,2317
+setuptools/_vendor/importlib_metadata/_collections.py,sha256=CJ0OTCHIjWA0ZIVS4voORAsn2R4R2cQBEtPsZEJpASY,743
+setuptools/_vendor/importlib_metadata/_compat.py,sha256=73QKrN9KNoaZzhbX5yPCCZa-FaALwXe8TPlDR72JgBU,1314
+setuptools/_vendor/importlib_metadata/_functools.py,sha256=PsY2-4rrKX4RVeRC1oGp1lB1pmC9eKN88_f-bD9uOoA,2895
+setuptools/_vendor/importlib_metadata/_itertools.py,sha256=cvr_2v8BRbxcIl5x5ldfqdHjhI8Yi8s8yk50G_nm6jQ,2068
+setuptools/_vendor/importlib_metadata/_meta.py,sha256=nxZ7C8GVlcBFAKWyVOn_dn7ot_twBcbm1NmvjIetBHI,1801
+setuptools/_vendor/importlib_metadata/_text.py,sha256=HCsFksZpJLeTP3NEk_ngrAeXVRRtTrtyh9eOABoRP4A,2166
+setuptools/_vendor/importlib_metadata/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/importlib_metadata/compat/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/importlib_metadata/compat/__pycache__/py311.cpython-312.pyc,,
+setuptools/_vendor/importlib_metadata/compat/__pycache__/py39.cpython-312.pyc,,
+setuptools/_vendor/importlib_metadata/compat/py311.py,sha256=uqm-K-uohyj1042TH4a9Er_I5o7667DvulcD-gC_fSA,608
+setuptools/_vendor/importlib_metadata/compat/py39.py,sha256=cPkMv6-0ilK-0Jw_Tkn0xYbOKJZc4WJKQHow0c2T44w,1102
+setuptools/_vendor/importlib_metadata/diagnose.py,sha256=nkSRMiowlmkhLYhKhvCg9glmt_11Cox-EmLzEbqYTa8,379
+setuptools/_vendor/importlib_metadata/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/inflect-7.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/inflect-7.3.1.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023
+setuptools/_vendor/inflect-7.3.1.dist-info/METADATA,sha256=ZgMNY0WAZRs-U8wZiV2SMfjSKqBrMngXyDMs_CAwMwg,21079
+setuptools/_vendor/inflect-7.3.1.dist-info/RECORD,sha256=XXg0rBuiYSxoAQUP3lenuYsPNqz4jDwtTzdv2JEbMJE,943
+setuptools/_vendor/inflect-7.3.1.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91
+setuptools/_vendor/inflect-7.3.1.dist-info/top_level.txt,sha256=m52ujdp10CqT6jh1XQxZT6kEntcnv-7Tl7UiGNTzWZA,8
+setuptools/_vendor/inflect/__init__.py,sha256=Jxy1HJXZiZ85kHeLAhkmvz6EMTdFqBe-duvt34R6IOc,103796
+setuptools/_vendor/inflect/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/inflect/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/inflect/compat/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/inflect/compat/__pycache__/py38.cpython-312.pyc,,
+setuptools/_vendor/inflect/compat/py38.py,sha256=oObVfVnWX9_OpnOuEJn1mFbJxVhwyR5epbiTNXDDaso,160
+setuptools/_vendor/inflect/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/jaraco.collections-5.1.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/jaraco.collections-5.1.0.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023
+setuptools/_vendor/jaraco.collections-5.1.0.dist-info/METADATA,sha256=IMUaliNsA5X1Ox9MXUWOagch5R4Wwb_3M7erp29dBtg,3933
+setuptools/_vendor/jaraco.collections-5.1.0.dist-info/RECORD,sha256=HptivXDkpfom6VlMu4CGD_7KPev-6Hc9rvp3TNJZygY,873
+setuptools/_vendor/jaraco.collections-5.1.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/jaraco.collections-5.1.0.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91
+setuptools/_vendor/jaraco.collections-5.1.0.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7
+setuptools/_vendor/jaraco.context-5.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/jaraco.context-5.3.0.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023
+setuptools/_vendor/jaraco.context-5.3.0.dist-info/METADATA,sha256=xDtguJej0tN9iEXCUvxEJh2a7xceIRVBEakBLSr__tY,4020
+setuptools/_vendor/jaraco.context-5.3.0.dist-info/RECORD,sha256=VRl7iKeEQyl7stgnp1uq50CzOJYlHYcoNdS0x17C9X4,641
+setuptools/_vendor/jaraco.context-5.3.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+setuptools/_vendor/jaraco.context-5.3.0.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7
+setuptools/_vendor/jaraco.functools-4.0.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/jaraco.functools-4.0.1.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023
+setuptools/_vendor/jaraco.functools-4.0.1.dist-info/METADATA,sha256=i4aUaQDX-jjdEQK5wevhegyx8JyLfin2HyvaSk3FHso,2891
+setuptools/_vendor/jaraco.functools-4.0.1.dist-info/RECORD,sha256=YyqnwE98S8wBwCevW5vHb-iVj0oYEDW5V6O9MBS6JIs,843
+setuptools/_vendor/jaraco.functools-4.0.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+setuptools/_vendor/jaraco.functools-4.0.1.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7
+setuptools/_vendor/jaraco.text-3.12.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/jaraco.text-3.12.1.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023
+setuptools/_vendor/jaraco.text-3.12.1.dist-info/METADATA,sha256=AzWdm6ViMfDOPoQMfLWn2zgBQSGJScyqeN29TcuWXVI,3658
+setuptools/_vendor/jaraco.text-3.12.1.dist-info/RECORD,sha256=gW2UV0HcokYJk4jKPu10_AZnrLqjb3C1WbJJTDl5sfY,1500
+setuptools/_vendor/jaraco.text-3.12.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/jaraco.text-3.12.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+setuptools/_vendor/jaraco.text-3.12.1.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7
+setuptools/_vendor/jaraco/__pycache__/context.cpython-312.pyc,,
+setuptools/_vendor/jaraco/collections/__init__.py,sha256=Pc1-SqjWm81ad1P0-GttpkwO_LWlnaY6gUq8gcKh2v0,26640
+setuptools/_vendor/jaraco/collections/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/jaraco/collections/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/jaraco/context.py,sha256=REoLIxDkO5MfEYowt_WoupNCRoxBS5v7YX2PbW8lIcs,9552
+setuptools/_vendor/jaraco/functools/__init__.py,sha256=hEAJaS2uSZRuF_JY4CxCHIYh79ZpxaPp9OiHyr9EJ1w,16642
+setuptools/_vendor/jaraco/functools/__init__.pyi,sha256=gk3dsgHzo5F_U74HzAvpNivFAPCkPJ1b2-yCd62dfnw,3878
+setuptools/_vendor/jaraco/functools/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/jaraco/functools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/jaraco/text/Lorem ipsum.txt,sha256=N_7c_79zxOufBY9HZ3yzMgOkNv-TkOTTio4BydrSjgs,1335
+setuptools/_vendor/jaraco/text/__init__.py,sha256=Y2YUqXR_orUoDaY4SkPRe6ZZhb5HUHB_Ah9RCNsVyho,16250
+setuptools/_vendor/jaraco/text/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/jaraco/text/__pycache__/layouts.cpython-312.pyc,,
+setuptools/_vendor/jaraco/text/__pycache__/show-newlines.cpython-312.pyc,,
+setuptools/_vendor/jaraco/text/__pycache__/strip-prefix.cpython-312.pyc,,
+setuptools/_vendor/jaraco/text/__pycache__/to-dvorak.cpython-312.pyc,,
+setuptools/_vendor/jaraco/text/__pycache__/to-qwerty.cpython-312.pyc,,
+setuptools/_vendor/jaraco/text/layouts.py,sha256=HTC8aSTLZ7uXipyOXapRMC158juecjK6RVwitfmZ9_w,643
+setuptools/_vendor/jaraco/text/show-newlines.py,sha256=WGQa65e8lyhb92LUOLqVn6KaCtoeVgVws6WtSRmLk6w,904
+setuptools/_vendor/jaraco/text/strip-prefix.py,sha256=NfVXV8JVNo6nqcuYASfMV7_y4Eo8zMQqlCOGvAnRIVw,412
+setuptools/_vendor/jaraco/text/to-dvorak.py,sha256=1SNcbSsvISpXXg-LnybIHHY-RUFOQr36zcHkY1pWFqw,119
+setuptools/_vendor/jaraco/text/to-qwerty.py,sha256=s4UMQUnPwFn_dB5uZC27BurHOQcYondBfzIpVL5pEzw,119
+setuptools/_vendor/more_itertools-10.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/more_itertools-10.3.0.dist-info/LICENSE,sha256=CfHIyelBrz5YTVlkHqm4fYPAyw_QB-te85Gn4mQ8GkY,1053
+setuptools/_vendor/more_itertools-10.3.0.dist-info/METADATA,sha256=BFO90O-fLNiVQMpj7oIS5ztzgJUUQZ3TA32P5HH3N-A,36293
+setuptools/_vendor/more_itertools-10.3.0.dist-info/RECORD,sha256=d8jnPgGNwP1-ntbICwWkQEVF9kH7CFIgzkKzaLWao9M,1259
+setuptools/_vendor/more_itertools-10.3.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/more_itertools-10.3.0.dist-info/WHEEL,sha256=rSgq_JpHF9fHR1lx53qwg_1-2LypZE_qmcuXbVUq948,81
+setuptools/_vendor/more_itertools/__init__.py,sha256=dtAbGjTDmn_ghiU5YXfhyDy0phAlXVdt5klZA5fUa-Q,149
+setuptools/_vendor/more_itertools/__init__.pyi,sha256=5B3eTzON1BBuOLob1vCflyEb2lSd6usXQQ-Cv-hXkeA,43
+setuptools/_vendor/more_itertools/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/more_itertools/__pycache__/more.cpython-312.pyc,,
+setuptools/_vendor/more_itertools/__pycache__/recipes.cpython-312.pyc,,
+setuptools/_vendor/more_itertools/more.py,sha256=1E5kzFncRKTDw0cYv1yRXMgDdunstLQd1QStcnL6U90,148370
+setuptools/_vendor/more_itertools/more.pyi,sha256=iXXeqt48Nxe8VGmIWpkVXuKpR2FYNuu2DU8nQLWCCu0,21484
+setuptools/_vendor/more_itertools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/more_itertools/recipes.py,sha256=WedhhfhGVgr6zii8fIbGJVmRTw0ZKRiLKnYBDGJv4nY,28591
+setuptools/_vendor/more_itertools/recipes.pyi,sha256=T_mdGpcFdfrP3JSWbwzYP9JyNV-Go-7RPfpxfftAWlA,4617
+setuptools/_vendor/packaging-24.2.dist-info/INSTALLER,sha256=5hhM4Q4mYTT9z6QB6PGpUAW81PGNFrYrdXMj4oM_6ak,2
+setuptools/_vendor/packaging-24.2.dist-info/LICENSE,sha256=ytHvW9NA1z4HS6YU0m996spceUDD2MNIUuZcSQlobEg,197
+setuptools/_vendor/packaging-24.2.dist-info/LICENSE.APACHE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174
+setuptools/_vendor/packaging-24.2.dist-info/LICENSE.BSD,sha256=tw5-m3QvHMb5SLNMFqo5_-zpQZY2S8iP8NIYDwAo-sU,1344
+setuptools/_vendor/packaging-24.2.dist-info/METADATA,sha256=ohH86s6k5mIfQxY2TS0LcSfADeOFa4BiCC-bxZV-pNs,3204
+setuptools/_vendor/packaging-24.2.dist-info/RECORD,sha256=Y4DrXM0KY0ArfzhbAEa1LYFPwW3WEgEeL4iCqXe-A-M,2009
+setuptools/_vendor/packaging-24.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/packaging-24.2.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82
+setuptools/_vendor/packaging/__init__.py,sha256=dk4Ta_vmdVJxYHDcfyhvQNw8V3PgSBomKNXqg-D2JDY,494
+setuptools/_vendor/packaging/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/_manylinux.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/_parser.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/_structures.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/markers.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/metadata.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/requirements.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/tags.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/utils.cpython-312.pyc,,
+setuptools/_vendor/packaging/__pycache__/version.cpython-312.pyc,,
+setuptools/_vendor/packaging/_elffile.py,sha256=cflAQAkE25tzhYmq_aCi72QfbT_tn891tPzfpbeHOwE,3306
+setuptools/_vendor/packaging/_manylinux.py,sha256=vl5OCoz4kx80H5rwXKeXWjl9WNISGmr4ZgTpTP9lU9c,9612
+setuptools/_vendor/packaging/_musllinux.py,sha256=p9ZqNYiOItGee8KcZFeHF_YcdhVwGHdK6r-8lgixvGQ,2694
+setuptools/_vendor/packaging/_parser.py,sha256=s_TvTvDNK0NrM2QB3VKThdWFM4Nc0P6JnkObkl3MjpM,10236
+setuptools/_vendor/packaging/_structures.py,sha256=q3eVNmbWJGG_S0Dit_S3Ao8qQqz_5PYTXFAKBZe5yr4,1431
+setuptools/_vendor/packaging/_tokenizer.py,sha256=J6v5H7Jzvb-g81xp_2QACKwO7LxHQA6ikryMU7zXwN8,5273
+setuptools/_vendor/packaging/licenses/__init__.py,sha256=1x5M1nEYjcgwEbLt0dXwz2ukjr18DiCzC0sraQqJ-Ww,5715
+setuptools/_vendor/packaging/licenses/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/packaging/licenses/__pycache__/_spdx.cpython-312.pyc,,
+setuptools/_vendor/packaging/licenses/_spdx.py,sha256=oAm1ztPFwlsmCKe7lAAsv_OIOfS1cWDu9bNBkeu-2ns,48398
+setuptools/_vendor/packaging/markers.py,sha256=c89TNzB7ZdGYhkovm6PYmqGyHxXlYVaLW591PHUNKD8,10561
+setuptools/_vendor/packaging/metadata.py,sha256=YJibM7GYe4re8-0a3OlXmGS-XDgTEoO4tlBt2q25Bng,34762
+setuptools/_vendor/packaging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/packaging/requirements.py,sha256=gYyRSAdbrIyKDY66ugIDUQjRMvxkH2ALioTmX3tnL6o,2947
+setuptools/_vendor/packaging/specifiers.py,sha256=GG1wPNMcL0fMJO68vF53wKMdwnfehDcaI-r9NpTfilA,40074
+setuptools/_vendor/packaging/tags.py,sha256=CFqrJzAzc2XNGexerH__T-Y5Iwq7WbsYXsiLERLWxY0,21014
+setuptools/_vendor/packaging/utils.py,sha256=0F3Hh9OFuRgrhTgGZUl5K22Fv1YP2tZl1z_2gO6kJiA,5050
+setuptools/_vendor/packaging/version.py,sha256=olfyuk_DPbflNkJ4wBWetXQ17c74x3DB501degUv7DY,16676
+setuptools/_vendor/platformdirs-4.2.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/platformdirs-4.2.2.dist-info/METADATA,sha256=zmsie01G1MtXR0wgIv5XpVeTO7idr0WWvfmxKsKWuGk,11429
+setuptools/_vendor/platformdirs-4.2.2.dist-info/RECORD,sha256=TCEddtQu1A78Os_Mhm2JEqcYr7yit-UYSUQjZtbpn-g,1642
+setuptools/_vendor/platformdirs-4.2.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/platformdirs-4.2.2.dist-info/WHEEL,sha256=zEMcRr9Kr03x1ozGwg5v9NQBKn3kndp6LSoSlVg-jhU,87
+setuptools/_vendor/platformdirs-4.2.2.dist-info/licenses/LICENSE,sha256=KeD9YukphQ6G6yjD_czwzv30-pSHkBHP-z0NS-1tTbY,1089
+setuptools/_vendor/platformdirs/__init__.py,sha256=EMGE8qeHRR9CzDFr8kL3tA8hdZZniYjXBVZd0UGTWK0,22225
+setuptools/_vendor/platformdirs/__main__.py,sha256=HnsUQHpiBaiTxwcmwVw-nFaPdVNZtQIdi1eWDtI-MzI,1493
+setuptools/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc,,
+setuptools/_vendor/platformdirs/__pycache__/android.cpython-312.pyc,,
+setuptools/_vendor/platformdirs/__pycache__/api.cpython-312.pyc,,
+setuptools/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc,,
+setuptools/_vendor/platformdirs/__pycache__/unix.cpython-312.pyc,,
+setuptools/_vendor/platformdirs/__pycache__/version.cpython-312.pyc,,
+setuptools/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc,,
+setuptools/_vendor/platformdirs/android.py,sha256=xZXY9Jd46WOsxT2U6-5HsNtDZ-IQqxcEUrBLl3hYk4o,9016
+setuptools/_vendor/platformdirs/api.py,sha256=QBYdUac2eC521ek_y53uD1Dcq-lJX8IgSRVd4InC6uc,8996
+setuptools/_vendor/platformdirs/macos.py,sha256=wftsbsvq6nZ0WORXSiCrZNkRHz_WKuktl0a6mC7MFkI,5580
+setuptools/_vendor/platformdirs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/platformdirs/unix.py,sha256=Cci9Wqt35dAMsg6HT9nRGHSBW5obb0pR3AE1JJnsCXg,10643
+setuptools/_vendor/platformdirs/version.py,sha256=r7F76tZRjgQKzrpx_I0_ZMQOMU-PS7eGnHD7zEK3KB0,411
+setuptools/_vendor/platformdirs/windows.py,sha256=IFpiohUBwxPtCzlyKwNtxyW4Jk8haa6W8o59mfrDXVo,10125
+setuptools/_vendor/tomli-2.0.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/tomli-2.0.1.dist-info/LICENSE,sha256=uAgWsNUwuKzLTCIReDeQmEpuO2GSLCte6S8zcqsnQv4,1072
+setuptools/_vendor/tomli-2.0.1.dist-info/METADATA,sha256=zPDceKmPwJGLWtZykrHixL7WVXWmJGzZ1jyRT5lCoPI,8875
+setuptools/_vendor/tomli-2.0.1.dist-info/RECORD,sha256=DLn5pFGh42WsVLTIhmLh2gy1SnLRalJY-wq_-dPhwCI,999
+setuptools/_vendor/tomli-2.0.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/tomli-2.0.1.dist-info/WHEEL,sha256=jPMR_Dzkc4X4icQtmz81lnNY_kAsfog7ry7qoRvYLXw,81
+setuptools/_vendor/tomli/__init__.py,sha256=JhUwV66DB1g4Hvt1UQCVMdfCu-IgAV8FXmvDU9onxd4,396
+setuptools/_vendor/tomli/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/tomli/__pycache__/_parser.cpython-312.pyc,,
+setuptools/_vendor/tomli/__pycache__/_re.cpython-312.pyc,,
+setuptools/_vendor/tomli/__pycache__/_types.cpython-312.pyc,,
+setuptools/_vendor/tomli/_parser.py,sha256=g9-ENaALS-B8dokYpCuzUFalWlog7T-SIYMjLZSWrtM,22633
+setuptools/_vendor/tomli/_re.py,sha256=dbjg5ChZT23Ka9z9DHOXfdtSpPwUfdgMXnj8NOoly-w,2943
+setuptools/_vendor/tomli/_types.py,sha256=-GTG2VUqkpxwMqzmVO4F7ybKddIbAnuAHXfmWQcTi3Q,254
+setuptools/_vendor/tomli/py.typed,sha256=8PjyZ1aVoQpRVvt71muvuq5qE-jTFZkK-GLHkhdebmc,26
+setuptools/_vendor/typeguard-4.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/typeguard-4.3.0.dist-info/LICENSE,sha256=YWP3mH37ONa8MgzitwsvArhivEESZRbVUu8c1DJH51g,1130
+setuptools/_vendor/typeguard-4.3.0.dist-info/METADATA,sha256=z2dcHAp0TwhYCFU5Deh8x31nazElgujUz9tbuP0pjSE,3717
+setuptools/_vendor/typeguard-4.3.0.dist-info/RECORD,sha256=SKUZWVgkeDUidUKM7s1473fXmsna55bjmi6vJUAoJVI,2402
+setuptools/_vendor/typeguard-4.3.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+setuptools/_vendor/typeguard-4.3.0.dist-info/entry_points.txt,sha256=qp7NQ1aLtiSgMQqo6gWlfGpy0IIXzoMJmeQTLpzqFZQ,48
+setuptools/_vendor/typeguard-4.3.0.dist-info/top_level.txt,sha256=4z28AhuDodwRS_c1J_l8H51t5QuwfTseskYzlxp6grs,10
+setuptools/_vendor/typeguard/__init__.py,sha256=Onh4w38elPCjtlcU3JY9k3h70NjsxXIkAflmQn-Z0FY,2071
+setuptools/_vendor/typeguard/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/typeguard/__pycache__/_checkers.cpython-312.pyc,,
+setuptools/_vendor/typeguard/__pycache__/_config.cpython-312.pyc,,
+setuptools/_vendor/typeguard/__pycache__/_decorators.cpython-312.pyc,,
+setuptools/_vendor/typeguard/__pycache__/_exceptions.cpython-312.pyc,,
+setuptools/_vendor/typeguard/__pycache__/_functions.cpython-312.pyc,,
+setuptools/_vendor/typeguard/__pycache__/_importhook.cpython-312.pyc,,
+setuptools/_vendor/typeguard/__pycache__/_memo.cpython-312.pyc,,
+setuptools/_vendor/typeguard/__pycache__/_pytest_plugin.cpython-312.pyc,,
+setuptools/_vendor/typeguard/__pycache__/_suppression.cpython-312.pyc,,
+setuptools/_vendor/typeguard/__pycache__/_transformer.cpython-312.pyc,,
+setuptools/_vendor/typeguard/__pycache__/_union_transformer.cpython-312.pyc,,
+setuptools/_vendor/typeguard/__pycache__/_utils.cpython-312.pyc,,
+setuptools/_vendor/typeguard/_checkers.py,sha256=JRrgKicdOEfIBoNEtegYCEIlhpad-a1u1Em7GCj0WCI,31360
+setuptools/_vendor/typeguard/_config.py,sha256=nIz8QwDa-oFO3L9O8_6srzlmd99pSby2wOM4Wb7F_B0,2846
+setuptools/_vendor/typeguard/_decorators.py,sha256=v6dsIeWvPhExGLP_wXF-RmDUyjZf_Ak28g7gBJ_v0-0,9033
+setuptools/_vendor/typeguard/_exceptions.py,sha256=ZIPeiV-FBd5Emw2EaWd2Fvlsrwi4ocwT2fVGBIAtHcQ,1121
+setuptools/_vendor/typeguard/_functions.py,sha256=ibgSAKa5ptIm1eR9ARG0BSozAFJPFNASZqhPVyQeqig,10393
+setuptools/_vendor/typeguard/_importhook.py,sha256=ugjCDvFcdWMU7UugqlJG91IpVNpEIxtRr-99s0h1k7M,6389
+setuptools/_vendor/typeguard/_memo.py,sha256=1juQV_vxnD2JYKbSrebiQuj4oKHz6n67v9pYA-CCISg,1303
+setuptools/_vendor/typeguard/_pytest_plugin.py,sha256=-fcSqkv54rIfIF8pDavY5YQPkj4OX8GMt_lL7CQSD4I,4416
+setuptools/_vendor/typeguard/_suppression.py,sha256=VQfzxcwIbu3if0f7VBkKM7hkYOA7tNFw9a7jMBsmMg4,2266
+setuptools/_vendor/typeguard/_transformer.py,sha256=9Ha7_QhdwoUni_6hvdY-hZbuEergowHrNL2vzHIakFY,44937
+setuptools/_vendor/typeguard/_union_transformer.py,sha256=v_42r7-6HuRX2SoFwnyJ-E5PlxXpVeUJPJR1-HU9qSo,1354
+setuptools/_vendor/typeguard/_utils.py,sha256=5HhO1rPn5f1M6ymkVAEv7Xmlz1cX-j0OnTMlyHqqrR8,5270
+setuptools/_vendor/typeguard/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/typing_extensions-4.12.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/typing_extensions-4.12.2.dist-info/LICENSE,sha256=Oy-B_iHRgcSZxZolbI4ZaEVdZonSaaqFNzv7avQdo78,13936
+setuptools/_vendor/typing_extensions-4.12.2.dist-info/METADATA,sha256=BeUQIa8cnYbrjWx-N8TOznM9UGW5Gm2DicVpDtRA8W0,3018
+setuptools/_vendor/typing_extensions-4.12.2.dist-info/RECORD,sha256=dxAALYGXHmMqpqL8M9xddKr118quIgQKZdPjFQOwXuk,571
+setuptools/_vendor/typing_extensions-4.12.2.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+setuptools/_vendor/typing_extensions.py,sha256=gwekpyG9DVG3lxWKX4ni8u7nk3We5slG98mA9F3DJQw,134451
+setuptools/_vendor/wheel-0.45.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/wheel-0.45.1.dist-info/LICENSE.txt,sha256=MMI2GGeRCPPo6h0qZYx8pBe9_IkcmO8aifpP8MmChlQ,1107
+setuptools/_vendor/wheel-0.45.1.dist-info/METADATA,sha256=mKz84H7m7jsxJyzeIcTVORiTb0NPMV39KvOIYhGgmjA,2313
+setuptools/_vendor/wheel-0.45.1.dist-info/RECORD,sha256=1jnxrHyZPDcVvULyfGFhiba4Z5L9_RsXr9dxcNbhaYQ,4900
+setuptools/_vendor/wheel-0.45.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/wheel-0.45.1.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82
+setuptools/_vendor/wheel-0.45.1.dist-info/entry_points.txt,sha256=rTY1BbkPHhkGMm4Q3F0pIzJBzW2kMxoG1oriffvGdA0,104
+setuptools/_vendor/wheel/__init__.py,sha256=mrxMnvdXACur_LWegbUfh5g5ysWZrd63UJn890wvGNk,59
+setuptools/_vendor/wheel/__main__.py,sha256=NkMUnuTCGcOkgY0IBLgBCVC_BGGcWORx2K8jYGS12UE,455
+setuptools/_vendor/wheel/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/wheel/__pycache__/__main__.cpython-312.pyc,,
+setuptools/_vendor/wheel/__pycache__/_bdist_wheel.cpython-312.pyc,,
+setuptools/_vendor/wheel/__pycache__/_setuptools_logging.cpython-312.pyc,,
+setuptools/_vendor/wheel/__pycache__/bdist_wheel.cpython-312.pyc,,
+setuptools/_vendor/wheel/__pycache__/macosx_libfile.cpython-312.pyc,,
+setuptools/_vendor/wheel/__pycache__/metadata.cpython-312.pyc,,
+setuptools/_vendor/wheel/__pycache__/util.cpython-312.pyc,,
+setuptools/_vendor/wheel/__pycache__/wheelfile.cpython-312.pyc,,
+setuptools/_vendor/wheel/_bdist_wheel.py,sha256=UghCQjSH_pVfcZh6oRjzSw_TQhcf3anSx1OkiLSL82M,21694
+setuptools/_vendor/wheel/_setuptools_logging.py,sha256=-5KC-lne0ilOUWIDfOkqapUWGMFZhuKYDIavIZiB5kM,781
+setuptools/_vendor/wheel/bdist_wheel.py,sha256=tpf9WufiSO1RuEMg5oPhIfSG8DMziCZ_4muCKF69Cqo,1107
+setuptools/_vendor/wheel/cli/__init__.py,sha256=Npq6_jKi03dhIcRnmbuFhwviVJxwO0tYEnEhWMv9cJo,4402
+setuptools/_vendor/wheel/cli/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/wheel/cli/__pycache__/convert.cpython-312.pyc,,
+setuptools/_vendor/wheel/cli/__pycache__/pack.cpython-312.pyc,,
+setuptools/_vendor/wheel/cli/__pycache__/tags.cpython-312.pyc,,
+setuptools/_vendor/wheel/cli/__pycache__/unpack.cpython-312.pyc,,
+setuptools/_vendor/wheel/cli/convert.py,sha256=Bi0ntEXb9nTllCxWeTRQ4j-nPs3szWSEKipG_GgnMkQ,12634
+setuptools/_vendor/wheel/cli/pack.py,sha256=CAFcHdBVulvsHYJlndKVO7KMI9JqBTZz5ii0PKxxCOs,3103
+setuptools/_vendor/wheel/cli/tags.py,sha256=lHw-LaWrkS5Jy_qWcw-6pSjeNM6yAjDnqKI3E5JTTCU,4760
+setuptools/_vendor/wheel/cli/unpack.py,sha256=Y_J7ynxPSoFFTT7H0fMgbBlVErwyDGcObgme5MBuz58,1021
+setuptools/_vendor/wheel/macosx_libfile.py,sha256=k1x7CE3LPtOVGqj6NXQ1nTGYVPaeRrhVzUG_KPq3zDs,16572
+setuptools/_vendor/wheel/metadata.py,sha256=JC4p7jlQZu2bUTAQ2fevkqLjg_X6gnNyRhLn6OUO1tc,6171
+setuptools/_vendor/wheel/util.py,sha256=aL7aibHwYUgfc8WlolL5tXdkV4DatbJxZHb1kwHFJAU,423
+setuptools/_vendor/wheel/vendored/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/wheel/vendored/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/LICENSE,sha256=ytHvW9NA1z4HS6YU0m996spceUDD2MNIUuZcSQlobEg,197
+setuptools/_vendor/wheel/vendored/packaging/LICENSE.APACHE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174
+setuptools/_vendor/wheel/vendored/packaging/LICENSE.BSD,sha256=tw5-m3QvHMb5SLNMFqo5_-zpQZY2S8iP8NIYDwAo-sU,1344
+setuptools/_vendor/wheel/vendored/packaging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/_elffile.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/_manylinux.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/_musllinux.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/_parser.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/_structures.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/_tokenizer.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/markers.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/requirements.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/specifiers.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/tags.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/utils.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/__pycache__/version.cpython-312.pyc,,
+setuptools/_vendor/wheel/vendored/packaging/_elffile.py,sha256=hbmK8OD6Z7fY6hwinHEUcD1by7czkGiNYu7ShnFEk2k,3266
+setuptools/_vendor/wheel/vendored/packaging/_manylinux.py,sha256=P7sdR5_7XBY09LVYYPhHmydMJIIwPXWsh4olk74Uuj4,9588
+setuptools/_vendor/wheel/vendored/packaging/_musllinux.py,sha256=z1s8To2hQ0vpn_d-O2i5qxGwEK8WmGlLt3d_26V7NeY,2674
+setuptools/_vendor/wheel/vendored/packaging/_parser.py,sha256=4tT4emSl2qTaU7VTQE1Xa9o1jMPCsBezsYBxyNMUN-s,10347
+setuptools/_vendor/wheel/vendored/packaging/_structures.py,sha256=q3eVNmbWJGG_S0Dit_S3Ao8qQqz_5PYTXFAKBZe5yr4,1431
+setuptools/_vendor/wheel/vendored/packaging/_tokenizer.py,sha256=alCtbwXhOFAmFGZ6BQ-wCTSFoRAJ2z-ysIf7__MTJ_k,5292
+setuptools/_vendor/wheel/vendored/packaging/markers.py,sha256=_TSPI1BhJYO7Bp9AzTmHQxIqHEVXaTjmDh9G-w8qzPA,8232
+setuptools/_vendor/wheel/vendored/packaging/requirements.py,sha256=dgoBeVprPu2YE6Q8nGfwOPTjATHbRa_ZGLyXhFEln6Q,2933
+setuptools/_vendor/wheel/vendored/packaging/specifiers.py,sha256=IWSt0SrLSP72heWhAC8UL0eGvas7XIQHjqiViVfmPKE,39778
+setuptools/_vendor/wheel/vendored/packaging/tags.py,sha256=fedHXiOHkBxNZTXotXv8uXPmMFU9ae-TKBujgYHigcA,18950
+setuptools/_vendor/wheel/vendored/packaging/utils.py,sha256=XgdmP3yx9-wQEFjO7OvMj9RjEf5JlR5HFFR69v7SQ9E,5268
+setuptools/_vendor/wheel/vendored/packaging/version.py,sha256=PFJaYZDxBgyxkfYhH3SQw4qfE9ICCWrTmitvq14y3bs,16234
+setuptools/_vendor/wheel/vendored/vendor.txt,sha256=Z2ENjB1i5prfez8CdM1Sdr3c6Zxv2rRRolMpLmBncAE,16
+setuptools/_vendor/wheel/wheelfile.py,sha256=USCttNlJwafxt51YYFFKG7jnxz8dfhbyqAZL6jMTA9s,8411
+setuptools/_vendor/zipp-3.19.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+setuptools/_vendor/zipp-3.19.2.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023
+setuptools/_vendor/zipp-3.19.2.dist-info/METADATA,sha256=UIrk_kMIHGSwsKKChYizqMw0MMZpPRZ2ZiVpQAsN_bE,3575
+setuptools/_vendor/zipp-3.19.2.dist-info/RECORD,sha256=8xby4D_ZrefrvAsVRwaEjiu4_VaLkJNRCfDY484rm_4,1039
+setuptools/_vendor/zipp-3.19.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/zipp-3.19.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+setuptools/_vendor/zipp-3.19.2.dist-info/top_level.txt,sha256=iAbdoSHfaGqBfVb2XuR9JqSQHCoOsOtG6y9C_LSpqFw,5
+setuptools/_vendor/zipp/__init__.py,sha256=QuI1g00G4fRAcGt-HqbV0oWIkmSgedCGGYsHHYzNa8A,13412
+setuptools/_vendor/zipp/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/zipp/__pycache__/glob.cpython-312.pyc,,
+setuptools/_vendor/zipp/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/zipp/compat/__pycache__/__init__.cpython-312.pyc,,
+setuptools/_vendor/zipp/compat/__pycache__/py310.cpython-312.pyc,,
+setuptools/_vendor/zipp/compat/py310.py,sha256=eZpkW0zRtunkhEh8jjX3gCGe22emoKCBJw72Zt4RkhA,219
+setuptools/_vendor/zipp/glob.py,sha256=etWpnfEoRyfUvrUsi6sTiGmErvPwe6HzY6pT8jg_lUI,3082
+setuptools/archive_util.py,sha256=Tl_64hSTtc4y8x7xa98rFVUbG24oArpjzLAYGYP2_sI,7356
+setuptools/build_meta.py,sha256=3cHAWucJaLA9DU5OfCbKkkteTDiQ5bB4LokfTRMgJT4,19968
+setuptools/cli-32.exe,sha256=MqzBvFQxFsviz_EMuGd3LfLyVP8mNMhwrvC0bEtpb9s,11776
+setuptools/cli-64.exe,sha256=u7PeVwdinmpgoMI4zUd7KPB_AGaYL9qVP6b87DkHOko,14336
+setuptools/cli-arm64.exe,sha256=uafQjaiA36yLz1SOuksG-1m28JsX0zFIoPZhgyiSbGE,13824
+setuptools/cli.exe,sha256=MqzBvFQxFsviz_EMuGd3LfLyVP8mNMhwrvC0bEtpb9s,11776
+setuptools/command/__init__.py,sha256=wdSrlNR0P6nCz9_oFtCAiAkeFJMsZa1jPcpXT53f0SM,803
+setuptools/command/__pycache__/__init__.cpython-312.pyc,,
+setuptools/command/__pycache__/_requirestxt.cpython-312.pyc,,
+setuptools/command/__pycache__/alias.cpython-312.pyc,,
+setuptools/command/__pycache__/bdist_egg.cpython-312.pyc,,
+setuptools/command/__pycache__/bdist_rpm.cpython-312.pyc,,
+setuptools/command/__pycache__/bdist_wheel.cpython-312.pyc,,
+setuptools/command/__pycache__/build.cpython-312.pyc,,
+setuptools/command/__pycache__/build_clib.cpython-312.pyc,,
+setuptools/command/__pycache__/build_ext.cpython-312.pyc,,
+setuptools/command/__pycache__/build_py.cpython-312.pyc,,
+setuptools/command/__pycache__/develop.cpython-312.pyc,,
+setuptools/command/__pycache__/dist_info.cpython-312.pyc,,
+setuptools/command/__pycache__/easy_install.cpython-312.pyc,,
+setuptools/command/__pycache__/editable_wheel.cpython-312.pyc,,
+setuptools/command/__pycache__/egg_info.cpython-312.pyc,,
+setuptools/command/__pycache__/install.cpython-312.pyc,,
+setuptools/command/__pycache__/install_egg_info.cpython-312.pyc,,
+setuptools/command/__pycache__/install_lib.cpython-312.pyc,,
+setuptools/command/__pycache__/install_scripts.cpython-312.pyc,,
+setuptools/command/__pycache__/rotate.cpython-312.pyc,,
+setuptools/command/__pycache__/saveopts.cpython-312.pyc,,
+setuptools/command/__pycache__/sdist.cpython-312.pyc,,
+setuptools/command/__pycache__/setopt.cpython-312.pyc,,
+setuptools/command/__pycache__/test.cpython-312.pyc,,
+setuptools/command/_requirestxt.py,sha256=ItYMTJGh_i5TlQstX_nFopqEhkC4PJFadBL2Zd3V670,4228
+setuptools/command/alias.py,sha256=rDdrMt32DS6qf3K7tjZZyHD_dMKrm77AXcAtx-nBQ0I,2380
+setuptools/command/bdist_egg.py,sha256=JmtKoIbiwgEHcJBkbc7zyXCZcAF851t6ek18gme-60Q,16948
+setuptools/command/bdist_rpm.py,sha256=LyqI49w48SKk0FmuHsE9MLzX1SuXjL7YMNbZMFZqFII,1435
+setuptools/command/bdist_wheel.py,sha256=SknYPVwhrRPfXudmO_gvqNHHHhzSfU8cEmFtQomQ9xI,22247
+setuptools/command/build.py,sha256=eI7STMERGGZEpzk1tvJN8p9IOjAAXMcGLzljv2mwI3M,6052
+setuptools/command/build_clib.py,sha256=AbgpPIF_3qL8fZr3JIebI-WHTMTBiMfrFkVQz8K40G4,4528
+setuptools/command/build_ext.py,sha256=Wddi6ho4MnVh84qqZUNqTvjKLqeoWe6cbwdJOUitXCc,18465
+setuptools/command/build_py.py,sha256=DCbjvB18kkL-xUK5rvlzm0C6twTeOxNhyvJDxxa7fII,15539
+setuptools/command/develop.py,sha256=1dsb2lkjcPQQAlQNVVlfPIJUBZ9di0l5bs4l83g9-9Y,1610
+setuptools/command/dist_info.py,sha256=HU752iLLmmYMHbsDBgz2ubRjkgJobugOp8H71LzzDys,3450
+setuptools/command/easy_install.py,sha256=XrN5cV51mfzbCDoapZ6iT8nCzaLpumdwJYRKeMHEjCQ,780
+setuptools/command/editable_wheel.py,sha256=MXyQx41gwu3d1raYSZGgzCVp5kkVtlCKftZKvTma3wY,34836
+setuptools/command/egg_info.py,sha256=GXyvq5E8huO4g-FDoNzf3MHjeXfxzPoS0Hkvbta_zc8,25878
+setuptools/command/install.py,sha256=4x2hiNgBGQrFEXKuPBQMrb8ecSwIfYF4TYHZQLjPVAg,5066
+setuptools/command/install_egg_info.py,sha256=3I9IPCH7D59Sh-6aVYz-h6wwyxq-wkxrKwKg3nDdJqs,2075
+setuptools/command/install_lib.py,sha256=9n1_U83eHcERL_a_rv_LhHCkhXlLdqyZ4SdBow-9qcE,4319
+setuptools/command/install_scripts.py,sha256=JmDGngHzCO2Y1j4maFNdHB_ILhGPhk-b5KhxsZwUwiQ,2490
+setuptools/command/launcher manifest.xml,sha256=xlLbjWrB01tKC0-hlVkOKkiSPbzMml2eOPtJ_ucCnbE,628
+setuptools/command/rotate.py,sha256=XNd_BEEOWAJHW1FcLTMUWWl4QB6zAuk7b8VWQg3FHos,2187
+setuptools/command/saveopts.py,sha256=Np0PVb7SD7oTbu9Z9sosS7D-CkkIkU7x4glu5Es1tjA,692
+setuptools/command/sdist.py,sha256=5ZiA8yfdNfl-kLTnfPAht1yKnS1o_HrSFphsJd-9foU,7369
+setuptools/command/setopt.py,sha256=xZF2RCc4ABvE9eHHAzF50-fkQg3au8fcRUVVGd58k3U,5100
+setuptools/command/test.py,sha256=k7xcq7D7bEehgxarbw-dW3AtmGZORqz8HjKR6FGJ3jk,1343
+setuptools/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/compat/__pycache__/__init__.cpython-312.pyc,,
+setuptools/compat/__pycache__/py310.cpython-312.pyc,,
+setuptools/compat/__pycache__/py311.cpython-312.pyc,,
+setuptools/compat/__pycache__/py312.cpython-312.pyc,,
+setuptools/compat/__pycache__/py39.cpython-312.pyc,,
+setuptools/compat/py310.py,sha256=JwjQZ3cNTizfpDLNl9GLsUGzBr-tVlMPxmMYVDTlhiI,344
+setuptools/compat/py311.py,sha256=e6tJAFwZEP82hmMBl10HYeSypelo_Ti2wTjKZVKLwOE,790
+setuptools/compat/py312.py,sha256=vYKVtdrdOTsO_R90dJkEXsFwfMJFuIFJflhIgHrjJ-Y,366
+setuptools/compat/py39.py,sha256=BJMtnkfcqyTfccqjYQxfoRtU2nTnWaEESBVkshTiXqY,493
+setuptools/config/NOTICE,sha256=Ld3wiBgpejuJ1D2V_2WdjahXQRCMkTbfo6TYVsBiO9g,493
+setuptools/config/__init__.py,sha256=aiPnL9BJn1O6MfmuNXyn8W2Lp8u9qizRVqwPiOdPIjY,1499
+setuptools/config/__pycache__/__init__.cpython-312.pyc,,
+setuptools/config/__pycache__/_apply_pyprojecttoml.cpython-312.pyc,,
+setuptools/config/__pycache__/expand.cpython-312.pyc,,
+setuptools/config/__pycache__/pyprojecttoml.cpython-312.pyc,,
+setuptools/config/__pycache__/setupcfg.cpython-312.pyc,,
+setuptools/config/_apply_pyprojecttoml.py,sha256=SUyTw7A2btZ1lBuWKN5o42-Diyv95eGTiYJ3rZOnGSc,19120
+setuptools/config/_validate_pyproject/NOTICE,sha256=XTANv6ZDE4sBO3WsnK7uWR-VG4sO4kKIw0zNkmxHgMg,18737
+setuptools/config/_validate_pyproject/__init__.py,sha256=dnp6T7ePP1R5z4OuC7Fd2dkFlIrtIfizUfvpGJP6nz0,1042
+setuptools/config/_validate_pyproject/__pycache__/__init__.cpython-312.pyc,,
+setuptools/config/_validate_pyproject/__pycache__/error_reporting.cpython-312.pyc,,
+setuptools/config/_validate_pyproject/__pycache__/extra_validations.cpython-312.pyc,,
+setuptools/config/_validate_pyproject/__pycache__/fastjsonschema_exceptions.cpython-312.pyc,,
+setuptools/config/_validate_pyproject/__pycache__/fastjsonschema_validations.cpython-312.pyc,,
+setuptools/config/_validate_pyproject/__pycache__/formats.cpython-312.pyc,,
+setuptools/config/_validate_pyproject/error_reporting.py,sha256=meldD7nBQdolQhvG-43r1Ue-gU1n7ORAJR86vh3Rrvk,11813
+setuptools/config/_validate_pyproject/extra_validations.py,sha256=-GUG5S--ijY8WfXbdXPoHl6ywGsyEF9dtDpenSoJPHg,2858
+setuptools/config/_validate_pyproject/fastjsonschema_exceptions.py,sha256=w749JgqKi8clBFcObdcbZVqsmF4oJ_QByhZ1SGbUFNw,1612
+setuptools/config/_validate_pyproject/fastjsonschema_validations.py,sha256=FihD5ZcM6p77BPZ04CGqh3BEwVNoPMKJZJAyuJpkAU0,354682
+setuptools/config/_validate_pyproject/formats.py,sha256=TETokJBK9hjl-cVg1olsojkJwLxfP7_chgJQNmzAB98,13564
+setuptools/config/distutils.schema.json,sha256=Tcp32kRnhwORGw_9p6GEi08lj2h15tQRzOYBbzGmcBU,972
+setuptools/config/expand.py,sha256=JNAktRCsyyRB-rQodbPnCucmLWqcYvzCDC8Ebn2Z7xM,16041
+setuptools/config/pyprojecttoml.py,sha256=YMu5PdbJJI5azp6kR_boM1mflf5nqOA-InF4s6LnLgw,18320
+setuptools/config/setupcfg.py,sha256=VZDkwE7DYv45SbadJD8CwKrDtiXvjgllL8PYSvoRCyg,26575
+setuptools/config/setuptools.schema.json,sha256=dZBRuSEnZkatoVlt1kVwG8ocTeRdO7BD0xvOWKH54PY,16071
+setuptools/depends.py,sha256=jKYfjmt_2ZQYVghb8L9bU7LJ6erHJ5ze-K_fKV1BMXk,5965
+setuptools/discovery.py,sha256=-42c3XhwzkfodDKKP50C2YBzr11fncAgmUzBdBRb0-Q,21258
+setuptools/dist.py,sha256=jrLGf-4udZjoZyULuGrXEPzgFDVq1CHCfGsqjTq52Gg,44887
+setuptools/errors.py,sha256=gY2x2PIaIgy01yRANRC-zcCwxDCqCScgJoCOZFe0yio,3024
+setuptools/extension.py,sha256=KCnv9p3tgm0ZVqtgE451fyILsm4hCyvOiUtOu787D-4,6683
+setuptools/glob.py,sha256=AC_B33DY8g-CHELxDsJrtwFrpiucSAZsakPFdSOQzhc,6062
+setuptools/gui-32.exe,sha256=hdrh6V13hF8stZvKw9Sv50u-TJGpvMW_SnHNQxBNvnw,11776
+setuptools/gui-64.exe,sha256=NHG2FA6txkEid9u-_j_vjDRaDxpZd2CGuAo2GMOoPjs,14336
+setuptools/gui-arm64.exe,sha256=5pT0dDQFyLWSb_RX22_n8aEt7HwWqcOGR4TT9OB64Jc,13824
+setuptools/gui.exe,sha256=hdrh6V13hF8stZvKw9Sv50u-TJGpvMW_SnHNQxBNvnw,11776
+setuptools/installer.py,sha256=veio-PDCseWN0J1E_1gjvVLkcIhPpQLlEKpSaA03WWk,5093
+setuptools/launch.py,sha256=IBb5lEv69CyuZ9ewIrmKlXh154kdLmP29LKfTMkximE,820
+setuptools/logging.py,sha256=W16iHJ1HcCXYQ0RxyrEfJ83FT4175tCtoYg-E6uSpVI,1261
+setuptools/modified.py,sha256=ZwbfBfCFP88ltvbv_dJDz-t1LsQjnM-JUpgZnnQZjjM,568
+setuptools/monkey.py,sha256=FwMWl2n1v2bHbeqBy-o9g8yUNaAkYFbszCbXe9d5Za8,3717
+setuptools/msvc.py,sha256=vmM0qL4rIzrtD9pia9ZEwtqZ4LbbrgL0dU0EANVYRm8,41631
+setuptools/namespaces.py,sha256=2GGqYY1BNDEhMtBc1rHTv7klgmNVRdksJeW-L1f--ys,3171
+setuptools/script (dev).tmpl,sha256=RUzQzCQUaXtwdLtYHWYbIQmOaES5Brqq1FvUA_tu-5I,218
+setuptools/script.tmpl,sha256=WGTt5piezO27c-Dbx6l5Q4T3Ff20A5z7872hv3aAhYY,138
+setuptools/tests/__init__.py,sha256=AnBfls2iJbTDQzmMKeLRt-9lxhaOHUVOZEgXv89Uwvs,335
+setuptools/tests/__pycache__/__init__.cpython-312.pyc,,
+setuptools/tests/__pycache__/contexts.cpython-312.pyc,,
+setuptools/tests/__pycache__/environment.cpython-312.pyc,,
+setuptools/tests/__pycache__/fixtures.cpython-312.pyc,,
+setuptools/tests/__pycache__/mod_with_constant.cpython-312.pyc,,
+setuptools/tests/__pycache__/namespaces.cpython-312.pyc,,
+setuptools/tests/__pycache__/script-with-bom.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_archive_util.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_bdist_deprecations.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_bdist_egg.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_bdist_wheel.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_build.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_build_clib.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_build_ext.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_build_meta.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_build_py.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_config_discovery.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_core_metadata.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_depends.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_develop.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_dist.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_dist_info.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_distutils_adoption.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_editable_install.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_egg_info.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_extern.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_find_packages.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_find_py_modules.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_glob.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_install_scripts.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_logging.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_manifest.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_namespaces.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_scripts.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_sdist.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_setopt.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_setuptools.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_shutil_wrapper.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_unicode_utils.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_virtualenv.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_warnings.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_wheel.cpython-312.pyc,,
+setuptools/tests/__pycache__/test_windows_wrappers.cpython-312.pyc,,
+setuptools/tests/__pycache__/text.cpython-312.pyc,,
+setuptools/tests/__pycache__/textwrap.cpython-312.pyc,,
+setuptools/tests/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/tests/compat/__pycache__/__init__.cpython-312.pyc,,
+setuptools/tests/compat/__pycache__/py39.cpython-312.pyc,,
+setuptools/tests/compat/py39.py,sha256=eUy7_F-6KRTOIKl-veshUu6I0EdTSdBZMh0EV0lZ1-g,135
+setuptools/tests/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/tests/config/__pycache__/__init__.cpython-312.pyc,,
+setuptools/tests/config/__pycache__/test_apply_pyprojecttoml.cpython-312.pyc,,
+setuptools/tests/config/__pycache__/test_expand.cpython-312.pyc,,
+setuptools/tests/config/__pycache__/test_pyprojecttoml.cpython-312.pyc,,
+setuptools/tests/config/__pycache__/test_pyprojecttoml_dynamic_deps.cpython-312.pyc,,
+setuptools/tests/config/__pycache__/test_setupcfg.cpython-312.pyc,,
+setuptools/tests/config/downloads/__init__.py,sha256=9ixnDEdyL_arKbUzfuiJftAj9bGxKz8M9alOFZMjx9Y,1827
+setuptools/tests/config/downloads/__pycache__/__init__.cpython-312.pyc,,
+setuptools/tests/config/downloads/__pycache__/preload.cpython-312.pyc,,
+setuptools/tests/config/downloads/preload.py,sha256=sIGGZpY3cmMpMwiJYYYYHG2ifZJkvJgEotRFtiulV1I,450
+setuptools/tests/config/setupcfg_examples.txt,sha256=cAbVvCbkFZuTUL6xRRzRgqyB0rLvJTfvw3D30glo2OE,1912
+setuptools/tests/config/test_apply_pyprojecttoml.py,sha256=l6nE4d8WLU_eSWRic7VSoqeKv9Bi7CZGHcEuB2ehk2w,28807
+setuptools/tests/config/test_expand.py,sha256=S0oT6JvgA_oujR4YS4RUuf5gmOt1CTQV66RQDzV8xd4,8933
+setuptools/tests/config/test_pyprojecttoml.py,sha256=0LefSljUhA6MqtJ5AVzLhomqZcYiFKdu_1ckDeMT1LY,12406
+setuptools/tests/config/test_pyprojecttoml_dynamic_deps.py,sha256=9W73-yLhZJmvCiO4rTiQoBpZT5wNA90Xbd5n2HCshd4,3271
+setuptools/tests/config/test_setupcfg.py,sha256=ZvN-O-2Dgon1adp6oM6il8JWdgT9y196fRvqESU5ELI,33427
+setuptools/tests/contexts.py,sha256=Ozdfc2KydF9x9wODUsdun800myLuP27uxoeT06Gbk7M,3166
+setuptools/tests/environment.py,sha256=95_UtTaRiuvwYC9eXKEHbn02kDtZysvZq3UZJmPUj1I,3102
+setuptools/tests/fixtures.py,sha256=aPewdPHlKHRAsMo9H828c3ZC8l3OJqgyfRYwpLBvgCk,11705
+setuptools/tests/indexes/test_links_priority/external.html,sha256=eL9euOuE93JKZdqlXxBOlHbKwIuNuIdq7GBRpsaPMcU,92
+setuptools/tests/indexes/test_links_priority/simple/foobar/index.html,sha256=DD-TKr7UU4zAjHHz4VexYDNSAzR27levSh1c-k3ZdLE,174
+setuptools/tests/integration/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/tests/integration/__pycache__/__init__.cpython-312.pyc,,
+setuptools/tests/integration/__pycache__/helpers.cpython-312.pyc,,
+setuptools/tests/integration/__pycache__/test_pbr.cpython-312.pyc,,
+setuptools/tests/integration/__pycache__/test_pip_install_sdist.cpython-312.pyc,,
+setuptools/tests/integration/helpers.py,sha256=3PHcS9SCA-fwVJmUP2ad5NQOttJAETI5Nnoc_xroO5k,2522
+setuptools/tests/integration/test_pbr.py,sha256=2eKuklFNmpnBgA_eEhYPBr6rLLG2Xm4MY6PlcmzZgGU,432
+setuptools/tests/integration/test_pip_install_sdist.py,sha256=SFbvuYF_hDzt6OtsQ5GjFNnxmoJ_eElfvpYsiyyGJ-g,8256
+setuptools/tests/mod_with_constant.py,sha256=X_Kj80M55w1tmQ4f7uZY91ZTALo4hKVT6EHxgYocUMQ,22
+setuptools/tests/namespaces.py,sha256=HPcI3nR5MCFWXpaADIJ1fwKxymcQgBkuw87Ic5PUSAQ,2774
+setuptools/tests/script-with-bom.py,sha256=hRRgIizEULGiG_ZTNoMY46HhKhxpWfy5FGcD6Qbh5fc,18
+setuptools/tests/test_archive_util.py,sha256=buuKdY8XkW26Pe3IKAoBRGHG0MDumnuNoPg2WsAQzIg,845
+setuptools/tests/test_bdist_deprecations.py,sha256=75Xq3gYn79LIIyusEltbHan0bEgAt2e_CaL7KLS8-KQ,775
+setuptools/tests/test_bdist_egg.py,sha256=6PaYN1F3JDbIh1uK0urv7yJFcx98z5dn9SOJ8Mv91l8,1957
+setuptools/tests/test_bdist_wheel.py,sha256=dZ9a7OT_UyRvLnoCi2KGEIbtzhEQjM3YutYMA6ZCezs,23083
+setuptools/tests/test_build.py,sha256=wJgMz2hwHADcLFg-nXrwRVhus7hjmAeEGgrpIQwCGnA,798
+setuptools/tests/test_build_clib.py,sha256=bX51XRAf4uO7IuHFpjePnoK8mE74N2gsoeEqF-ofgws,3123
+setuptools/tests/test_build_ext.py,sha256=e4ZSxsYPB5zq1KSqGEuATZ0t0PJQzMhjjkKJ-hIjcgc,10099
+setuptools/tests/test_build_meta.py,sha256=kvi0Bn4p9DBVme3zyWQsn3QgB9oPdq8S15agj1m69L0,33289
+setuptools/tests/test_build_py.py,sha256=gobME_Cvzf6Ugxq70iWfXekb_xyyT61khwjFq8zkwfw,14186
+setuptools/tests/test_config_discovery.py,sha256=FqV-lOtkqaI-ayzU2zocSdD5TaRAgCZnixNDilKA6FQ,22580
+setuptools/tests/test_core_metadata.py,sha256=vbVJ5_Lsx_hsO_GdB6nQEXJRjA2ydx6_qSbr5LpheAA,20881
+setuptools/tests/test_depends.py,sha256=yQBXoQbNQlJit6mbRVoz6Bb553f3sNrq02lZimNz5XY,424
+setuptools/tests/test_develop.py,sha256=MHYL_YDqNMU5jhKkjsBUGKMGCkrva8CFR8dRc6kkYKE,3072
+setuptools/tests/test_dist.py,sha256=_IYleHR9YVqzV-nLq_JqSup6DNeUdPzuQ0EXhp009Uk,8893
+setuptools/tests/test_dist_info.py,sha256=F_xTXc5TGhjiujtGukFt6wNstqpTW7sVQtUnL1IX7yo,4988
+setuptools/tests/test_distutils_adoption.py,sha256=_eynrOfyEqXFEmjUJhzpe8GXPyTUPvNSObs4qAAmBy8,5987
+setuptools/tests/test_editable_install.py,sha256=Tg4kunvwYoDLYsfvSkggneUgpKQferUDx3EEvvdfmwE,42619
+setuptools/tests/test_egg_info.py,sha256=R7nT27YhVz9oSuDyimAGerWglkbRWiMSPBs5FzcSnBM,44941
+setuptools/tests/test_extern.py,sha256=rpKU6oCcksumLwf5TeKlDluFQ0TUfbPwTLQbpxcFrCU,296
+setuptools/tests/test_find_packages.py,sha256=CTLAcTzWGWBLCcd2aAsUVkvO3ibrlqexFBdDKOWPoq8,7819
+setuptools/tests/test_find_py_modules.py,sha256=zQjuhIG5TQN2SJPix9ARo4DL_w84Ln8QsHDUjjbrtAQ,2404
+setuptools/tests/test_glob.py,sha256=P3JvpH-kXQ4BZ3zvRF-zKxOgwyWzwIaQIz0WHdxS0kk,887
+setuptools/tests/test_install_scripts.py,sha256=scIrJ6a_ssKqg4vIBNaUjmAKHEYLUUZ9WKnPeKnE6gc,3433
+setuptools/tests/test_logging.py,sha256=zlE5DlldukC7Jc54FNvDV_7ux3ErAkrfrN5CSsnNOUQ,2099
+setuptools/tests/test_manifest.py,sha256=eMg65pIA52DizB6mpktSU-b8CjwaNCS5MSgL_V1LrFI,18562
+setuptools/tests/test_namespaces.py,sha256=Y6utoe5PHHqL_DlgawqB9F8XpsUDPvvw1sQMenK04e0,4515
+setuptools/tests/test_scripts.py,sha256=_ra506yQF7n72ROUDcz2r3CTsGsawO1m-1oqA9EQCfw,379
+setuptools/tests/test_sdist.py,sha256=RYLvPa_nfyC1ZmoinzqMzJynTDG4RtPYC19_0LU6pvs,32872
+setuptools/tests/test_setopt.py,sha256=3VxxM4ATfP-P4AGnDjoWCnHr5-i9CSEQTFYU1-FTnvI,1365
+setuptools/tests/test_setuptools.py,sha256=_eIhqKf45-OtHqxRf20KndOZJlJdS0PuFLXBO3M-LN8,9008
+setuptools/tests/test_shutil_wrapper.py,sha256=g15E11PtZxG-InB2BWNFyH-svObXx2XcMhgMLJPuFnc,641
+setuptools/tests/test_unicode_utils.py,sha256=xWfEEl8jkQCt9othUTXJfFmdyATAFggJs2tTxjbumbw,316
+setuptools/tests/test_virtualenv.py,sha256=g-njC_9JTAs1YVx_1dGJ_Q6RlInO4qKVu9-XAgNb6TY,3730
+setuptools/tests/test_warnings.py,sha256=zwR2zcnCeCeDqILZlJOPAcuyPHoDvGu1OtOVYiLMk74,3347
+setuptools/tests/test_wheel.py,sha256=I709mQO4YCztxI2L8x7bu_rE818vC9SXHR8qtZPwZW8,18752
+setuptools/tests/test_windows_wrappers.py,sha256=wBjXN3iGldkzRGTgKTrx99xqUqwPJ0V-ldyiB1pWD-g,7868
+setuptools/tests/text.py,sha256=a12197pMVTvB6FAWQ0ujT8fIQiLIWJlFAl1UCaDUDfg,123
+setuptools/tests/textwrap.py,sha256=FNNNq_MiaEJx88PnsbJQIRxmj1qmgcAOCXXRsODPJN4,98
+setuptools/unicode_utils.py,sha256=ukMGh8pEAw6F_Ezb-K5D3c-078RgA_GcF0oW6lg4lSs,3189
+setuptools/version.py,sha256=WJCeUuyq74Aok2TeK9-OexZOu8XrlQy7-y0BEuWNovQ,161
+setuptools/warnings.py,sha256=oY0Se5eOqje_FEyjTgonUc0XGwgsrI5cgm1kkwulz_w,3796
+setuptools/wheel.py,sha256=_JuhinWmlQwBHJrdIh1yfhrDS7GFMacCiJiOY3H5gwA,9477
+setuptools/windows_support.py,sha256=wW4IYLM1Bv7Z1MaauP2xmPjyy-wkmQnXdyvXscAf9fw,726
diff --git a/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/WHEEL
new file mode 100644
index 0000000..e7fa31b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/entry_points.txt b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/entry_points.txt
new file mode 100644
index 0000000..0db0a6c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/entry_points.txt
@@ -0,0 +1,51 @@
+[distutils.commands]
+alias = setuptools.command.alias:alias
+bdist_egg = setuptools.command.bdist_egg:bdist_egg
+bdist_rpm = setuptools.command.bdist_rpm:bdist_rpm
+bdist_wheel = setuptools.command.bdist_wheel:bdist_wheel
+build = setuptools.command.build:build
+build_clib = setuptools.command.build_clib:build_clib
+build_ext = setuptools.command.build_ext:build_ext
+build_py = setuptools.command.build_py:build_py
+develop = setuptools.command.develop:develop
+dist_info = setuptools.command.dist_info:dist_info
+easy_install = setuptools.command.easy_install:easy_install
+editable_wheel = setuptools.command.editable_wheel:editable_wheel
+egg_info = setuptools.command.egg_info:egg_info
+install = setuptools.command.install:install
+install_egg_info = setuptools.command.install_egg_info:install_egg_info
+install_lib = setuptools.command.install_lib:install_lib
+install_scripts = setuptools.command.install_scripts:install_scripts
+rotate = setuptools.command.rotate:rotate
+saveopts = setuptools.command.saveopts:saveopts
+sdist = setuptools.command.sdist:sdist
+setopt = setuptools.command.setopt:setopt
+
+[distutils.setup_keywords]
+dependency_links = setuptools.dist:assert_string_list
+eager_resources = setuptools.dist:assert_string_list
+entry_points = setuptools.dist:check_entry_points
+exclude_package_data = setuptools.dist:check_package_data
+extras_require = setuptools.dist:check_extras
+include_package_data = setuptools.dist:assert_bool
+install_requires = setuptools.dist:check_requirements
+namespace_packages = setuptools.dist:check_nsp
+package_data = setuptools.dist:check_package_data
+packages = setuptools.dist:check_packages
+python_requires = setuptools.dist:check_specifier
+setup_requires = setuptools.dist:check_requirements
+use_2to3 = setuptools.dist:invalid_unless_false
+zip_safe = setuptools.dist:assert_bool
+
+[egg_info.writers]
+PKG-INFO = setuptools.command.egg_info:write_pkg_info
+dependency_links.txt = setuptools.command.egg_info:overwrite_arg
+eager_resources.txt = setuptools.command.egg_info:overwrite_arg
+entry_points.txt = setuptools.command.egg_info:write_entries
+namespace_packages.txt = setuptools.command.egg_info:overwrite_arg
+requires.txt = setuptools.command.egg_info:write_requirements
+top_level.txt = setuptools.command.egg_info:write_toplevel_names
+
+[setuptools.finalize_distribution_options]
+keywords = setuptools.dist:Distribution._finalize_setup_keywords
+parent_finalize = setuptools.dist:_Distribution.finalize_options
diff --git a/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/licenses/LICENSE b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/licenses/LICENSE
new file mode 100644
index 0000000..1bb5a44
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/licenses/LICENSE
@@ -0,0 +1,17 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/top_level.txt
new file mode 100644
index 0000000..b5ac107
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/top_level.txt
@@ -0,0 +1,3 @@
+_distutils_hack
+pkg_resources
+setuptools
diff --git a/venv/lib/python3.12/site-packages/setuptools/__init__.py b/venv/lib/python3.12/site-packages/setuptools/__init__.py
new file mode 100644
index 0000000..f1b9bfe
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/__init__.py
@@ -0,0 +1,248 @@
+"""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 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
+
+__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)
+
+    @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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_core_metadata.py b/venv/lib/python3.12/site-packages/setuptools/_core_metadata.py
new file mode 100644
index 0000000..a52d5cf
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_core_metadata.py
@@ -0,0 +1,337 @@
+"""
+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": `:`
+        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
+}
diff --git a/venv/lib/python3.12/site-packages/setuptools/_discovery.py b/venv/lib/python3.12/site-packages/setuptools/_discovery.py
new file mode 100644
index 0000000..d1b4a0e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_discovery.py
@@ -0,0 +1,33 @@
+import functools
+import operator
+
+import packaging.requirements
+
+
+# from coherent.build.discovery
+def extras_from_dep(dep):
+    try:
+        markers = packaging.requirements.Requirement(dep).marker._markers
+    except AttributeError:
+        markers = ()
+    return set(
+        marker[2].value
+        for marker in markers
+        if isinstance(marker, tuple) and marker[0].value == 'extra'
+    )
+
+
+def extras_from_deps(deps):
+    """
+    >>> extras_from_deps(['requests'])
+    set()
+    >>> extras_from_deps(['pytest; extra == "test"'])
+    {'test'}
+    >>> sorted(extras_from_deps([
+    ...     'requests',
+    ...     'pytest; extra == "test"',
+    ...     'pytest-cov; extra == "test"',
+    ...     'sphinx; extra=="doc"']))
+    ['doc', 'test']
+    """
+    return functools.reduce(operator.or_, map(extras_from_dep, deps), set())
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/__init__.py
new file mode 100644
index 0000000..e374d5c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/__init__.py
@@ -0,0 +1,14 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/_log.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/_log.py
new file mode 100644
index 0000000..0148f15
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/_log.py
@@ -0,0 +1,3 @@
+import logging
+
+log = logging.getLogger()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/_macos_compat.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/_macos_compat.py
new file mode 100644
index 0000000..76ecb96
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/_macos_compat.py
@@ -0,0 +1,12 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/_modified.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/_modified.py
new file mode 100644
index 0000000..f64cab7
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/_modified.py
@@ -0,0 +1,95 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/_msvccompiler.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/_msvccompiler.py
new file mode 100644
index 0000000..d07c86e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/_msvccompiler.py
@@ -0,0 +1,16 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/archive_util.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/archive_util.py
new file mode 100644
index 0000000..d860f55
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/archive_util.py
@@ -0,0 +1,294 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/ccompiler.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/ccompiler.py
new file mode 100644
index 0000000..58bc6a5
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/ccompiler.py
@@ -0,0 +1,26 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/cmd.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/cmd.py
new file mode 100644
index 0000000..241621b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/cmd.py
@@ -0,0 +1,554 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/__init__.py
new file mode 100644
index 0000000..0f8a169
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/__init__.py
@@ -0,0 +1,23 @@
+"""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',
+]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/_framework_compat.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/_framework_compat.py
new file mode 100644
index 0000000..00d34bc
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/_framework_compat.py
@@ -0,0 +1,54 @@
+"""
+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'
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/bdist.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/bdist.py
new file mode 100644
index 0000000..07811aa
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/bdist.py
@@ -0,0 +1,167 @@
+"""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./dumb", "build/bdist./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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_dumb.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_dumb.py
new file mode 100644
index 0000000..ccad66f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_dumb.py
@@ -0,0 +1,141 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_rpm.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_rpm.py
new file mode 100644
index 0000000..357b4e8
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_rpm.py
@@ -0,0 +1,598 @@
+"""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 \") "
+            "[default: maintainer or author from setup script]",
+        ),
+        (
+            'packager=',
+            None,
+            "RPM packager (eg. \"Jane Doe \") [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. 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build.py
new file mode 100644
index 0000000..6a8303a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build.py
@@ -0,0 +1,156 @@
+"""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.' 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."
+        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),
+    ]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build_clib.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build_clib.py
new file mode 100644
index 0000000..8b65b3d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build_clib.py
@@ -0,0 +1,201 @@
+"""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
+            )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build_ext.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build_ext.py
new file mode 100644
index 0000000..ec45b44
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build_ext.py
@@ -0,0 +1,812 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build_py.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build_py.py
new file mode 100644
index 0000000..a20b076
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build_py.py
@@ -0,0 +1,407 @@
+"""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,
+            )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build_scripts.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build_scripts.py
new file mode 100644
index 0000000..b86ee6e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/build_scripts.py
@@ -0,0 +1,160 @@
+"""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 = "#!" + self.executable + 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})"
+            )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/check.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/check.py
new file mode 100644
index 0000000..58a823d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/check.py
@@ -0,0 +1,152 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/clean.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/clean.py
new file mode 100644
index 0000000..23427ab
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/clean.py
@@ -0,0 +1,77 @@
+"""distutils.command.clean
+
+Implements the Distutils 'clean' command."""
+
+# contributed by Bastian Kleineidam , 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. 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/config.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/config.py
new file mode 100644
index 0000000..c825765
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/config.py
@@ -0,0 +1,358 @@
+"""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.
+        """
+        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'))
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install.py
new file mode 100644
index 0000000..dc17e56
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install.py
@@ -0,0 +1,805 @@
+"""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),
+    ]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_data.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_data.py
new file mode 100644
index 0000000..4ad186e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_data.py
@@ -0,0 +1,94 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_egg_info.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_egg_info.py
new file mode 100644
index 0000000..230e94a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_egg_info.py
@@ -0,0 +1,91 @@
+"""
+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('-', '_')
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_headers.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_headers.py
new file mode 100644
index 0000000..97af137
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_headers.py
@@ -0,0 +1,46 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_lib.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_lib.py
new file mode 100644
index 0000000..2aababf
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_lib.py
@@ -0,0 +1,238 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_scripts.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_scripts.py
new file mode 100644
index 0000000..92e8694
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/install_scripts.py
@@ -0,0 +1,62 @@
+"""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 []
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/command/sdist.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/sdist.py
new file mode 100644
index 0000000..b3bf0c3
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/command/sdist.py
@@ -0,0 +1,521 @@
+"""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('#')
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compat/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compat/__init__.py
new file mode 100644
index 0000000..2c43729
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compat/__init__.py
@@ -0,0 +1,18 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compat/numpy.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compat/numpy.py
new file mode 100644
index 0000000..73eca7a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compat/numpy.py
@@ -0,0 +1,2 @@
+# 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compat/py39.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compat/py39.py
new file mode 100644
index 0000000..1b436d7
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compat/py39.py
@@ -0,0 +1,66 @@
+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)
+)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/base.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/base.py
new file mode 100644
index 0000000..5efd2a3
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/base.py
@@ -0,0 +1,1394 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/cygwin.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/cygwin.py
new file mode 100644
index 0000000..bfabbb3
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/cygwin.py
@@ -0,0 +1,340 @@
+"""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.
+"""
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/errors.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/errors.py
new file mode 100644
index 0000000..0132859
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/errors.py
@@ -0,0 +1,24 @@
+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."""
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/msvc.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/msvc.py
new file mode 100644
index 0000000..6db062a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/msvc.py
@@ -0,0 +1,614 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_base.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_base.py
new file mode 100644
index 0000000..a762e2b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_base.py
@@ -0,0 +1,83 @@
+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  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]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_cygwin.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_cygwin.py
new file mode 100644
index 0000000..9adf6b8
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_cygwin.py
@@ -0,0 +1,76 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_mingw.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_mingw.py
new file mode 100644
index 0000000..dc45687
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_mingw.py
@@ -0,0 +1,48 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_msvc.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_msvc.py
new file mode 100644
index 0000000..eca8319
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_msvc.py
@@ -0,0 +1,136 @@
+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"
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_unix.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_unix.py
new file mode 100644
index 0000000..35b6b0e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_unix.py
@@ -0,0 +1,413 @@
+"""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"')
+    def test_cxx_commands_used_are_correct(self):
+        def gcv(v):
+            if v == 'LDSHARED':
+                return 'ccache gcc-4.2 -bundle -undefined dynamic_lookup'
+            elif v == 'LDCXXSHARED':
+                return 'ccache g++-4.2 -bundle -undefined dynamic_lookup'
+            elif v == 'CXX':
+                return 'ccache g++-4.2'
+            elif v == 'CC':
+                return 'ccache gcc-4.2'
+            return ''
+
+        def gcvs(*args, _orig=sysconfig.get_config_vars):
+            if args:
+                return list(map(sysconfig.get_config_var, args))
+            return _orig()  # pragma: no cover
+
+        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,
+        ):
+            # override environment overrides in case they're specified by CI
+            del env['CXX']
+            del env['LDCXXSHARED']
+
+            sysconfig.customize_compiler(self.cc)
+            assert self.cc.linker_so_cxx[0:2] == ['ccache', 'g++-4.2']
+            assert self.cc.linker_exe_cxx[0:2] == ['ccache', 'g++-4.2']
+            self.cc.link(None, [], 'a.out', target_lang='c++')
+            call_args = mock_spawn.call_args[0][0]
+            expected = ['ccache', 'g++-4.2', '-bundle', '-undefined', 'dynamic_lookup']
+            assert call_args[:5] == expected
+
+            self.cc.link_executable([], 'a.out', target_lang='c++')
+            call_args = mock_spawn.call_args[0][0]
+            expected = ['ccache', 'g++-4.2', '-o', self.cc.executable_filename('a.out')]
+            assert call_args[:4] == expected
+
+            env['LDCXXSHARED'] = 'wrapper g++-4.2 -bundle -undefined dynamic_lookup'
+            env['CXX'] = 'wrapper g++-4.2'
+            sysconfig.customize_compiler(self.cc)
+            assert self.cc.linker_so_cxx[0:2] == ['wrapper', 'g++-4.2']
+            assert self.cc.linker_exe_cxx[0:2] == ['wrapper', 'g++-4.2']
+            self.cc.link(None, [], 'a.out', target_lang='c++')
+            call_args = mock_spawn.call_args[0][0]
+            expected = ['wrapper', 'g++-4.2', '-bundle', '-undefined', 'dynamic_lookup']
+            assert call_args[:5] == expected
+
+            self.cc.link_executable([], 'a.out', target_lang='c++')
+            call_args = mock_spawn.call_args[0][0]
+            expected = [
+                'wrapper',
+                'g++-4.2',
+                '-o',
+                self.cc.executable_filename('a.out'),
+            ]
+            assert call_args[:4] == expected
+
+    @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'
+        )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/unix.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/unix.py
new file mode 100644
index 0000000..1231b32
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/unix.py
@@ -0,0 +1,422 @@
+"""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
+                target_cxx = target_lang == "c++"
+                linker = (
+                    (self.linker_exe_cxx if target_cxx else self.linker_exe)
+                    if building_exe
+                    else (self.linker_so_cxx if target_cxx else self.linker_so)
+                )[:]
+
+                if target_cxx 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_cxx)
+
+                    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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/zos.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/zos.py
new file mode 100644
index 0000000..82d017f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/zos.py
@@ -0,0 +1,230 @@
+"""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,
+        )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/core.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/core.py
new file mode 100644
index 0000000..bd62546
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/core.py
@@ -0,0 +1,289 @@
+"""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 ()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/cygwinccompiler.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/cygwinccompiler.py
new file mode 100644
index 0000000..de89e3c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/cygwinccompiler.py
@@ -0,0 +1,31 @@
+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.
+"""
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/debug.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/debug.py
new file mode 100644
index 0000000..daf1660
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/debug.py
@@ -0,0 +1,5 @@
+import os
+
+# If DISTUTILS_DEBUG is anything other than the empty string, we run in
+# debug mode.
+DEBUG = os.environ.get('DISTUTILS_DEBUG')
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/dep_util.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/dep_util.py
new file mode 100644
index 0000000..09a8a2e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/dep_util.py
@@ -0,0 +1,14 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/dir_util.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/dir_util.py
new file mode 100644
index 0000000..d978260
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/dir_util.py
@@ -0,0 +1,244 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/dist.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/dist.py
new file mode 100644
index 0000000..37b788d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/dist.py
@@ -0,0 +1,1386 @@
+"""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 -"),
+        ('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]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/errors.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/errors.py
new file mode 100644
index 0000000..409d21f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/errors.py
@@ -0,0 +1,108 @@
+"""
+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."""
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/extension.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/extension.py
new file mode 100644
index 0000000..f514112
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/extension.py
@@ -0,0 +1,258 @@
+"""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
+    #    ... [ ...] [ ...] [ ...]
+    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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/fancy_getopt.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/fancy_getopt.py
new file mode 100644
index 0000000..1a1d3a0
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/fancy_getopt.py
@@ -0,0 +1,471 @@
+"""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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/file_util.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/file_util.py
new file mode 100644
index 0000000..0acc8cb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/file_util.py
@@ -0,0 +1,236 @@
+"""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 , 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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/filelist.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/filelist.py
new file mode 100644
index 0000000..70dc0fd
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/filelist.py
@@ -0,0 +1,431 @@
+"""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   ..."
+                )
+            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 = 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 = 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'((?= 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/spawn.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/spawn.py
new file mode 100644
index 0000000..973668f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/spawn.py
@@ -0,0 +1,134 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/sysconfig.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/sysconfig.py
new file mode 100644
index 0000000..7ddc869
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/sysconfig.py
@@ -0,0 +1,598 @@
+"""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:        
+"""
+
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/__init__.py
new file mode 100644
index 0000000..5a8ab06
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/__init__.py
@@ -0,0 +1,42 @@
+"""
+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]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/compat/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/compat/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/compat/py39.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/compat/py39.py
new file mode 100644
index 0000000..aca3939
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/compat/py39.py
@@ -0,0 +1,40 @@
+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,
+    )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/support.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/support.py
new file mode 100644
index 0000000..9cd2b8a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/support.py
@@ -0,0 +1,134 @@
+"""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.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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_archive_util.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_archive_util.py
new file mode 100644
index 0000000..3e4ed75
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_archive_util.py
@@ -0,0 +1,353 @@
+"""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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist.py
new file mode 100644
index 0000000..d5696fc
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist.py
@@ -0,0 +1,47 @@
+"""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'
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_dumb.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_dumb.py
new file mode 100644
index 0000000..1fc51d2
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_dumb.py
@@ -0,0 +1,78 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_rpm.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_rpm.py
new file mode 100644
index 0000000..7505143
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_rpm.py
@@ -0,0 +1,127 @@
+"""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'))
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build.py
new file mode 100644
index 0000000..f7fe69a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build.py
@@ -0,0 +1,49 @@
+"""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.
+        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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_clib.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_clib.py
new file mode 100644
index 0000000..f76f26b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_clib.py
@@ -0,0 +1,134 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_ext.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_ext.py
new file mode 100644
index 0000000..dab0507
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_ext.py
@@ -0,0 +1,628 @@
+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 
+
+                    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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_py.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_py.py
new file mode 100644
index 0000000..b316ed4
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_py.py
@@ -0,0 +1,196 @@
+"""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
+        )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_scripts.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_scripts.py
new file mode 100644
index 0000000..3582f69
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_scripts.py
@@ -0,0 +1,96 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_check.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_check.py
new file mode 100644
index 0000000..b672b1f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_check.py
@@ -0,0 +1,194 @@
+"""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 ")
+            metadata = {
+                'url': 'xxx',
+                kind + '_email': 'Name ',
+                '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})
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_clean.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_clean.py
new file mode 100644
index 0000000..cc78f30
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_clean.py
@@ -0,0 +1,45 @@
+"""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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_cmd.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_cmd.py
new file mode 100644
index 0000000..76e8f59
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_cmd.py
@@ -0,0 +1,107 @@
+"""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'
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_config_cmd.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_config_cmd.py
new file mode 100644
index 0000000..ebee2ef
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_config_cmd.py
@@ -0,0 +1,87 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_core.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_core.py
new file mode 100644
index 0000000..bad3fb7
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_core.py
@@ -0,0 +1,130 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dir_util.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dir_util.py
new file mode 100644
index 0000000..326cb34
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dir_util.py
@@ -0,0 +1,139 @@
+"""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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dist.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dist.py
new file mode 100644
index 0000000..2c5beeb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dist.py
@@ -0,0 +1,552 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_extension.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_extension.py
new file mode 100644
index 0000000..5e8e768
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_extension.py
@@ -0,0 +1,117 @@
+"""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'"
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_file_util.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_file_util.py
new file mode 100644
index 0000000..a75d4a0
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_file_util.py
@@ -0,0 +1,95 @@
+"""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'
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_filelist.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_filelist.py
new file mode 100644
index 0000000..130e6fb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_filelist.py
@@ -0,0 +1,336 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install.py
new file mode 100644
index 0000000..b3ffb2e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install.py
@@ -0,0 +1,245 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_data.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_data.py
new file mode 100644
index 0000000..c800f86
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_data.py
@@ -0,0 +1,74 @@
+"""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))
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_headers.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_headers.py
new file mode 100644
index 0000000..2c74f06
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_headers.py
@@ -0,0 +1,33 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_lib.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_lib.py
new file mode 100644
index 0000000..f685a57
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_lib.py
@@ -0,0 +1,110 @@
+"""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]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_scripts.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_scripts.py
new file mode 100644
index 0000000..868b1c2
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_scripts.py
@@ -0,0 +1,52 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_log.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_log.py
new file mode 100644
index 0000000..d67779f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_log.py
@@ -0,0 +1,12 @@
+"""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']
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_modified.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_modified.py
new file mode 100644
index 0000000..e35cec2
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_modified.py
@@ -0,0 +1,126 @@
+"""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'))
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sdist.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sdist.py
new file mode 100644
index 0000000..6b1a376
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sdist.py
@@ -0,0 +1,470 @@
+"""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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_spawn.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_spawn.py
new file mode 100644
index 0000000..3b9fc92
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_spawn.py
@@ -0,0 +1,141 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sysconfig.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sysconfig.py
new file mode 100644
index 0000000..43d77c2
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sysconfig.py
@@ -0,0 +1,319 @@
+"""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())
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_text_file.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_text_file.py
new file mode 100644
index 0000000..f511156
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_text_file.py
@@ -0,0 +1,127 @@
+"""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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_util.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_util.py
new file mode 100644
index 0000000..00c9743
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_util.py
@@ -0,0 +1,243 @@
+"""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"
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_version.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_version.py
new file mode 100644
index 0000000..b68f097
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_version.py
@@ -0,0 +1,80 @@
+"""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}'
+            )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_versionpredicate.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/test_versionpredicate.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/unix_compat.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/unix_compat.py
new file mode 100644
index 0000000..a5d9ee4
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/tests/unix_compat.py
@@ -0,0 +1,17 @@
+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")
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/text_file.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/text_file.py
new file mode 100644
index 0000000..89d9048
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/text_file.py
@@ -0,0 +1,286 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/unixccompiler.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/unixccompiler.py
new file mode 100644
index 0000000..20b8ce6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/unixccompiler.py
@@ -0,0 +1,9 @@
+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')
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/util.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/util.py
new file mode 100644
index 0000000..6dbe049
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/util.py
@@ -0,0 +1,518 @@
+"""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'))
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/version.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/version.py
new file mode 100644
index 0000000..2223ee9
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/version.py
@@ -0,0 +1,348 @@
+#
+# 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/versionpredicate.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/versionpredicate.py
new file mode 100644
index 0000000..fe31b0e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/versionpredicate.py
@@ -0,0 +1,175 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_distutils/zosccompiler.py b/venv/lib/python3.12/site-packages/setuptools/_distutils/zosccompiler.py
new file mode 100644
index 0000000..e49630a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_distutils/zosccompiler.py
@@ -0,0 +1,3 @@
+from .compilers.C import zos
+
+zOSCCompiler = zos.Compiler
diff --git a/venv/lib/python3.12/site-packages/setuptools/_entry_points.py b/venv/lib/python3.12/site-packages/setuptools/_entry_points.py
new file mode 100644
index 0000000..cd5dd2c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_entry_points.py
@@ -0,0 +1,94 @@
+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.
+
+    This function is deprecated in favor of importlib_metadata 8.7 and
+    Python 3.14 importlib.metadata, which validates entry points on
+    construction.
+    """
+    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))
diff --git a/venv/lib/python3.12/site-packages/setuptools/_imp.py b/venv/lib/python3.12/site-packages/setuptools/_imp.py
new file mode 100644
index 0000000..f1d9f29
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_imp.py
@@ -0,0 +1,87 @@
+"""
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_importlib.py b/venv/lib/python3.12/site-packages/setuptools/_importlib.py
new file mode 100644
index 0000000..ce0fd52
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_importlib.py
@@ -0,0 +1,9 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_itertools.py b/venv/lib/python3.12/site-packages/setuptools/_itertools.py
new file mode 100644
index 0000000..d6ca841
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_itertools.py
@@ -0,0 +1,23 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_normalization.py b/venv/lib/python3.12/site-packages/setuptools/_normalization.py
new file mode 100644
index 0000000..fb89323
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_normalization.py
@@ -0,0 +1,177 @@
+"""
+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(?:[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'
+    """
+    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'
+    """
+    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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_path.py b/venv/lib/python3.12/site-packages/setuptools/_path.py
new file mode 100644
index 0000000..2b78022
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_path.py
@@ -0,0 +1,93 @@
+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 _cygwin_patch(filename: StrPath):  # pragma: nocover
+    """
+    Contrary to POSIX 2008, on Cygwin, getcwd (3) contains
+    symlink components. Using
+    os.path.abspath() works around this limitation. A fix in os.getcwd()
+    would probably better, in Cygwin even more so, except
+    that this seems to be by design...
+    """
+    return os.path.abspath(filename) if sys.platform == 'cygwin' else filename
+
+
+def normpath(filename: StrPath) -> str:
+    """Normalize a file/dir name for comparison purposes."""
+    return os.path.normcase(os.path.realpath(os.path.normpath(_cygwin_patch(filename))))
+
+
+@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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_reqs.py b/venv/lib/python3.12/site-packages/setuptools/_reqs.py
new file mode 100644
index 0000000..7be56cb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_reqs.py
@@ -0,0 +1,42 @@
+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]
+    """
+    Parse requirements.
+    """
+    return map(parser, parse_strings(strs))
diff --git a/venv/lib/python3.12/site-packages/setuptools/_scripts.py b/venv/lib/python3.12/site-packages/setuptools/_scripts.py
new file mode 100644
index 0000000..88bf02f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_scripts.py
@@ -0,0 +1,361 @@
+from __future__ import annotations
+
+import os
+import re
+import shlex
+import shutil
+import struct
+import subprocess
+import sys
+import textwrap
+from collections.abc import Iterable
+from typing import TYPE_CHECKING, TypedDict
+
+from ._importlib import metadata, resources
+
+if TYPE_CHECKING:
+    from typing_extensions import Self
+
+from .warnings import SetuptoolsWarning
+
+from distutils.command.build_scripts import first_line_re
+from distutils.util import get_platform
+
+
+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'
+
+
+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 distribution is not an importlib.metadata.Distribution, assume
+        # it's a pkg_resources.Distribution and transform it.
+        if not hasattr(dist, 'entry_points'):
+            SetuptoolsWarning.emit("Unsupported distribution encountered.")
+            dist = metadata.Distribution.at(dist.egg_info)
+
+        if header is None:
+            header = cls.get_header()
+        spec = f'{dist.name}=={dist.version}'
+        for type_ in 'console', 'gui':
+            group = f'{type_}_scripts'
+            for ep in dist.entry_points.select(group=group):
+                name = ep.name
+                cls._ensure_safe_name(ep.name)
+                script_text = cls.template % locals()
+                args = cls._get_script_args(type_, ep.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 resources.files('setuptools').joinpath(launcher_fn).read_bytes()
+
+
+def load_launcher_manifest(name):
+    res = resources.files(__name__).joinpath('launcher manifest.xml')
+    return res.read_text(encoding='utf-8') % vars()
+
+
+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 is_64bit():
+    return struct.calcsize("P") == 8
+
+
+def isascii(s):
+    try:
+        s.encode('ascii')
+    except UnicodeError:
+        return False
+    return True
diff --git a/venv/lib/python3.12/site-packages/setuptools/_shutil.py b/venv/lib/python3.12/site-packages/setuptools/_shutil.py
new file mode 100644
index 0000000..660459a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_shutil.py
@@ -0,0 +1,59 @@
+"""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)
+
+
+def current_umask():
+    tmp = os.umask(0o022)
+    os.umask(tmp)
+    return tmp
diff --git a/venv/lib/python3.12/site-packages/setuptools/_static.py b/venv/lib/python3.12/site-packages/setuptools/_static.py
new file mode 100644
index 0000000..af35862
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_static.py
@@ -0,0 +1,188 @@
+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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/LICENSE
new file mode 100644
index 0000000..b49c3af
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/LICENSE
@@ -0,0 +1,166 @@
+GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. 
+ 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.
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/METADATA
new file mode 100644
index 0000000..32214fb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/METADATA
@@ -0,0 +1,420 @@
+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
+
+[![PyPI version](https://badge.fury.io/py/autocommand.svg)](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 `_ and `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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/RECORD
new file mode 100644
index 0000000..e6e12ea
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/RECORD
@@ -0,0 +1,18 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/WHEEL
new file mode 100644
index 0000000..57e3d84
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.38.4)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/top_level.txt
new file mode 100644
index 0000000..dda5158
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+autocommand
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__init__.py
new file mode 100644
index 0000000..73fbfca
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__init__.py
@@ -0,0 +1,27 @@
+# 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 .
+
+# 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autoasync.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autoasync.py
new file mode 100644
index 0000000..688f7e0
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autoasync.py
@@ -0,0 +1,142 @@
+# 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 .
+
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autocommand.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autocommand.py
new file mode 100644
index 0000000..097e86d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autocommand.py
@@ -0,0 +1,70 @@
+# 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 .
+
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/automain.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/automain.py
new file mode 100644
index 0000000..6cc45db
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/automain.py
@@ -0,0 +1,59 @@
+# 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 .
+
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autoparse.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autoparse.py
new file mode 100644
index 0000000..0276a3f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autoparse.py
@@ -0,0 +1,333 @@
+# 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 .
+
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/errors.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/errors.py
new file mode 100644
index 0000000..2570607
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/autocommand/errors.py
@@ -0,0 +1,23 @@
+# 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 .
+
+
+class AutocommandError(Exception):
+    '''Base class for autocommand exceptions'''
+    pass
+
+# Individual modules will define errors specific to that module.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/LICENSE
new file mode 100644
index 0000000..1bb5a44
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/LICENSE
@@ -0,0 +1,17 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/METADATA
new file mode 100644
index 0000000..db0a2dc
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/METADATA
@@ -0,0 +1,46 @@
+Metadata-Version: 2.1
+Name: backports.tarfile
+Version: 1.2.0
+Summary: Backport of CPython tarfile module
+Author-email: "Jason R. Coombs" 
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/RECORD
new file mode 100644
index 0000000..536dc2f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/RECORD
@@ -0,0 +1,17 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/REQUESTED b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/REQUESTED
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/WHEEL
new file mode 100644
index 0000000..bab98d6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/top_level.txt
new file mode 100644
index 0000000..99d2be5
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+backports
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/__init__.py
new file mode 100644
index 0000000..0d1f7ed
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/__init__.py
@@ -0,0 +1 @@
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)  # type: ignore
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__init__.py
new file mode 100644
index 0000000..8c16881
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__init__.py
@@ -0,0 +1,2937 @@
+#-------------------------------------------------------------------
+# tarfile.py
+#-------------------------------------------------------------------
+# Copyright (C) 2002 Lars Gustaebel 
+# 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(" 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("= 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='',
+                        choices=_NAMED_FILTERS,
+                        help='Filter for extraction')
+
+    group = parser.add_mutually_exclusive_group(required=True)
+    group.add_argument('-l', '--list', metavar='',
+                       help='Show listing of a tarfile')
+    group.add_argument('-e', '--extract', nargs='+',
+                       metavar=('', ''),
+                       help='Extract tarfile into target dir')
+    group.add_argument('-c', '--create', nargs='+',
+                       metavar=('', ''),
+                       help='Create tarfile from sources')
+    group.add_argument('-t', '--test', metavar='',
+                       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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__main__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__main__.py
new file mode 100644
index 0000000..daf5509
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__main__.py
@@ -0,0 +1,5 @@
+from . import main
+
+
+if __name__ == '__main__':
+    main()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/py38.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/py38.py
new file mode 100644
index 0000000..20fbbfc
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/py38.py
@@ -0,0 +1,24 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/LICENSE
new file mode 100644
index 0000000..d645695
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/LICENSE
@@ -0,0 +1,202 @@
+
+                                 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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/METADATA
new file mode 100644
index 0000000..85513e8
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/METADATA
@@ -0,0 +1,129 @@
+Metadata-Version: 2.1
+Name: importlib_metadata
+Version: 8.0.0
+Summary: Read metadata from Python packages
+Author-email: "Jason R. Coombs" 
+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 `_
+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 `_
+for usage details.
+
+`Finder authors
+`_ 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 `_.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/RECORD
new file mode 100644
index 0000000..07b7dc5
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/RECORD
@@ -0,0 +1,32 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/REQUESTED b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/REQUESTED
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/WHEEL
new file mode 100644
index 0000000..edf4ec7
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (70.1.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/top_level.txt
new file mode 100644
index 0000000..bbb0754
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+importlib_metadata
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__init__.py
new file mode 100644
index 0000000..ed48135
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__init__.py
@@ -0,0 +1,1083 @@
+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
+    `_
+    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[\w.]+)\s*'
+        r'(:\s*(?P[\w.]+)\s*)?'
+        r'((?P\[.*\])\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''
+
+
+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 `_.
+        - RECORD: A record of files according to
+          `this recording spec `_.
+
+        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 `_.
+
+        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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_adapters.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_adapters.py
new file mode 100644
index 0000000..6223263
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_adapters.py
@@ -0,0 +1,83 @@
+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)))
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_collections.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_collections.py
new file mode 100644
index 0000000..cf0954e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_collections.py
@@ -0,0 +1,30 @@
+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)))
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_compat.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_compat.py
new file mode 100644
index 0000000..df312b1
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_compat.py
@@ -0,0 +1,57 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_functools.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_functools.py
new file mode 100644
index 0000000..71f66bd
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_functools.py
@@ -0,0 +1,104 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_itertools.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_itertools.py
new file mode 100644
index 0000000..d4ca9b9
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_itertools.py
@@ -0,0 +1,73 @@
+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,))
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_meta.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_meta.py
new file mode 100644
index 0000000..1927d0f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_meta.py
@@ -0,0 +1,67 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_text.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_text.py
new file mode 100644
index 0000000..c88cfbb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_text.py
@@ -0,0 +1,99 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/py311.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/py311.py
new file mode 100644
index 0000000..3a53274
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/py311.py
@@ -0,0 +1,22 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/py39.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/py39.py
new file mode 100644
index 0000000..1f15bd9
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/py39.py
@@ -0,0 +1,36 @@
+"""
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/diagnose.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/diagnose.py
new file mode 100644
index 0000000..e405471
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/diagnose.py
@@ -0,0 +1,21 @@
+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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/py.typed b/venv/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/LICENSE
new file mode 100644
index 0000000..1bb5a44
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/LICENSE
@@ -0,0 +1,17 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/METADATA
new file mode 100644
index 0000000..9a2097a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/METADATA
@@ -0,0 +1,591 @@
+Metadata-Version: 2.1
+Name: inflect
+Version: 7.3.1
+Summary: Correctly generate plurals, singular nouns, ordinals, indefinite articles
+Author-email: Paul Dyson 
+Maintainer-email: "Jason R. Coombs" 
+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 `_
+  parses identifiers like variable names into sets of words suitable for re-assembling
+  in another form.
+
+* `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 `_.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/RECORD
new file mode 100644
index 0000000..73ff576
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/RECORD
@@ -0,0 +1,13 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/WHEEL
new file mode 100644
index 0000000..564c672
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (70.2.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/top_level.txt
new file mode 100644
index 0000000..0fd75fa
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+inflect
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect/__init__.py
new file mode 100644
index 0000000..3eec27f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect/__init__.py
@@ -0,0 +1,3986 @@
+"""
+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 `_.
+
+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.+)( (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]}"
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/py38.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/py38.py
new file mode 100644
index 0000000..a2d01bd
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/py38.py
@@ -0,0 +1,7 @@
+import sys
+
+
+if sys.version_info > (3, 9):
+    from typing import Annotated
+else:  # pragma: no cover
+    from typing_extensions import Annotated  # noqa: F401
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect/py.typed b/venv/lib/python3.12/site-packages/setuptools/_vendor/inflect/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/LICENSE
new file mode 100644
index 0000000..1bb5a44
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/LICENSE
@@ -0,0 +1,17 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/METADATA
new file mode 100644
index 0000000..fe6ca5a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/METADATA
@@ -0,0 +1,85 @@
+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" 
+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 `_.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/RECORD
new file mode 100644
index 0000000..48b957e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/RECORD
@@ -0,0 +1,10 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/REQUESTED b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/REQUESTED
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/WHEEL
new file mode 100644
index 0000000..50e1e84
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (73.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/top_level.txt
new file mode 100644
index 0000000..f6205a5
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+jaraco
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/LICENSE
new file mode 100644
index 0000000..1bb5a44
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/LICENSE
@@ -0,0 +1,17 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/METADATA
new file mode 100644
index 0000000..a36f7c5
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/METADATA
@@ -0,0 +1,75 @@
+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 `_ 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 `_.
+- ``pushd`` is similar to pytest's ``monkeypatch.chdir`` or path's `default context `_, 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 `_.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/RECORD
new file mode 100644
index 0000000..09d191f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/RECORD
@@ -0,0 +1,8 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/WHEEL
new file mode 100644
index 0000000..bab98d6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/top_level.txt
new file mode 100644
index 0000000..f6205a5
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+jaraco
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/LICENSE
new file mode 100644
index 0000000..1bb5a44
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/LICENSE
@@ -0,0 +1,17 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/METADATA
new file mode 100644
index 0000000..c865140
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/METADATA
@@ -0,0 +1,64 @@
+Metadata-Version: 2.1
+Name: jaraco.functools
+Version: 4.0.1
+Summary: Functools like those found in stdlib
+Author-email: "Jason R. Coombs" 
+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 `_.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/RECORD
new file mode 100644
index 0000000..ef3bc21
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/RECORD
@@ -0,0 +1,10 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/WHEEL
new file mode 100644
index 0000000..bab98d6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/top_level.txt
new file mode 100644
index 0000000..f6205a5
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+jaraco
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/LICENSE
new file mode 100644
index 0000000..1bb5a44
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/LICENSE
@@ -0,0 +1,17 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/METADATA
new file mode 100644
index 0000000..0258a38
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/METADATA
@@ -0,0 +1,95 @@
+Metadata-Version: 2.1
+Name: jaraco.text
+Version: 3.12.1
+Summary: Module for text manipulation
+Author-email: "Jason R. Coombs" 
+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 `_.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/RECORD
new file mode 100644
index 0000000..19e2d84
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/RECORD
@@ -0,0 +1,20 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/REQUESTED b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/REQUESTED
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/WHEEL
new file mode 100644
index 0000000..bab98d6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/top_level.txt
new file mode 100644
index 0000000..f6205a5
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+jaraco
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/__init__.py
new file mode 100644
index 0000000..0d501cf
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/__init__.py
@@ -0,0 +1,1091 @@
+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]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/py.typed b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/context.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/context.py
new file mode 100644
index 0000000..61b2713
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/context.py
@@ -0,0 +1,361 @@
+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
+    
+
+    >>> 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'
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.py
new file mode 100644
index 0000000..ca6c22f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.py
@@ -0,0 +1,633 @@
+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))
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.pyi b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.pyi
new file mode 100644
index 0000000..19191bf
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.pyi
@@ -0,0 +1,125 @@
+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]]: ...
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/py.typed b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/Lorem ipsum.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/Lorem ipsum.txt
new file mode 100644
index 0000000..986f944
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/Lorem ipsum.txt	
@@ -0,0 +1,2 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__init__.py
new file mode 100644
index 0000000..0fabd0c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__init__.py
@@ -0,0 +1,624 @@
+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.
+    
+    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 stormy day in paradise'))
+    A stormy day in paradise
+
+    >>> print(simple_html_strip('Somebody  tell the truth.'))
+    Somebody  tell the truth.
+
+    >>> print(simple_html_strip('What about
\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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/layouts.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/layouts.py
new file mode 100644
index 0000000..9636f0f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/layouts.py
@@ -0,0 +1,25 @@
+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))
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/show-newlines.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/show-newlines.py
new file mode 100644
index 0000000..e11d1ba
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/show-newlines.py
@@ -0,0 +1,33 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/strip-prefix.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/strip-prefix.py
new file mode 100644
index 0000000..761717a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/strip-prefix.py
@@ -0,0 +1,21 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-dvorak.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-dvorak.py
new file mode 100644
index 0000000..a6d5da8
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-dvorak.py
@@ -0,0 +1,6 @@
+import sys
+
+from . import layouts
+
+
+__name__ == '__main__' and layouts._translate_stream(sys.stdin, layouts.to_dvorak)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-qwerty.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-qwerty.py
new file mode 100644
index 0000000..abe2728
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-qwerty.py
@@ -0,0 +1,6 @@
+import sys
+
+from . import layouts
+
+
+__name__ == '__main__' and layouts._translate_stream(sys.stdin, layouts.to_qwerty)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/LICENSE
new file mode 100644
index 0000000..0a523be
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/LICENSE
@@ -0,0 +1,19 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/METADATA
new file mode 100644
index 0000000..fb41b0c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/METADATA
@@ -0,0 +1,266 @@
+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 
+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 `_,                                                                               |
+|                        | `ichunked `_,                                                                             |
+|                        | `chunked_even `_,                                                                     |
+|                        | `sliced `_,                                                                                 |
+|                        | `constrained_batches `_,                                                       |
+|                        | `distribute `_,                                                                         |
+|                        | `divide `_,                                                                                 |
+|                        | `split_at `_,                                                                             |
+|                        | `split_before `_,                                                                     |
+|                        | `split_after `_,                                                                       |
+|                        | `split_into `_,                                                                         |
+|                        | `split_when `_,                                                                         |
+|                        | `bucket `_,                                                                                 |
+|                        | `unzip `_,                                                                                   |
+|                        | `batched `_,                                                                               |
+|                        | `grouper `_,                                                                               |
+|                        | `partition `_,                                                                           |
+|                        | `transpose `_                                                                            |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Lookahead and lookback | `spy `_,                                                                                       |
+|                        | `peekable `_,                                                                             |
+|                        | `seekable `_                                                                              |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Windowing              | `windowed `_,                                                                             |
+|                        | `substrings `_,                                                                         |
+|                        | `substrings_indexes `_,                                                         |
+|                        | `stagger `_,                                                                               |
+|                        | `windowed_complete `_,                                                           |
+|                        | `pairwise `_,                                                                             |
+|                        | `triplewise `_,                                                                         |
+|                        | `sliding_window `_,                                                                 |
+|                        | `subslices `_                                                                            |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Augmenting             | `count_cycle `_,                                                                       |
+|                        | `intersperse `_,                                                                       |
+|                        | `padded `_,                                                                                 |
+|                        | `repeat_each `_,                                                                       |
+|                        | `mark_ends `_,                                                                           |
+|                        | `repeat_last `_,                                                                       |
+|                        | `adjacent `_,                                                                             |
+|                        | `groupby_transform `_,                                                           |
+|                        | `pad_none `_,                                                                             |
+|                        | `ncycles `_                                                                                |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Combining              | `collapse `_,                                                                             |
+|                        | `sort_together `_,                                                                   |
+|                        | `interleave `_,                                                                         |
+|                        | `interleave_longest `_,                                                         |
+|                        | `interleave_evenly `_,                                                           |
+|                        | `zip_offset `_,                                                                         |
+|                        | `zip_equal `_,                                                                           |
+|                        | `zip_broadcast `_,                                                                   |
+|                        | `flatten `_,                                                                               |
+|                        | `roundrobin `_,                                                                         |
+|                        | `prepend `_,                                                                               |
+|                        | `value_chain `_,                                                                       |
+|                        | `partial_product `_                                                                |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Summarizing            | `ilen `_,                                                                                     |
+|                        | `unique_to_each `_,                                                                 |
+|                        | `sample `_,                                                                                 |
+|                        | `consecutive_groups `_,                                                         |
+|                        | `run_length `_,                                                                         |
+|                        | `map_reduce `_,                                                                         |
+|                        | `join_mappings `_,                                                                   |
+|                        | `exactly_n `_,                                                                           |
+|                        | `is_sorted `_,                                                                           |
+|                        | `all_equal `_,                                                                           |
+|                        | `all_unique `_,                                                                         |
+|                        | `minmax `_,                                                                                 |
+|                        | `first_true `_,                                                                         |
+|                        | `quantify `_,                                                                             |
+|                        | `iequals `_                                                                                |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Selecting              | `islice_extended `_,                                                               |
+|                        | `first `_,                                                                                   |
+|                        | `last `_,                                                                                     |
+|                        | `one `_,                                                                                       |
+|                        | `only `_,                                                                                     |
+|                        | `strictly_n `_,                                                                         |
+|                        | `strip `_,                                                                                   |
+|                        | `lstrip `_,                                                                                 |
+|                        | `rstrip `_,                                                                                 |
+|                        | `filter_except `_,                                                                   |
+|                        | `map_except `_,                                                                         |
+|                        | `filter_map `_,                                                                         |
+|                        | `iter_suppress `_,                                                                   |
+|                        | `nth_or_last `_,                                                                       |
+|                        | `unique_in_window `_,                                                             |
+|                        | `before_and_after `_,                                                             |
+|                        | `nth `_,                                                                                       |
+|                        | `take `_,                                                                                     |
+|                        | `tail `_,                                                                                     |
+|                        | `unique_everseen `_,                                                               |
+|                        | `unique_justseen `_,                                                               |
+|                        | `unique `_,                                                                                 |
+|                        | `duplicates_everseen `_,                                                       |
+|                        | `duplicates_justseen `_,                                                       |
+|                        | `classify_unique `_,                                                               |
+|                        | `longest_common_prefix `_,                                                   |
+|                        | `takewhile_inclusive `_                                                        |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Math                   | `dft `_,                                                                                       |
+|                        | `idft `_,                                                                                     |
+|                        | `convolve `_,                                                                             |
+|                        | `dotproduct `_,                                                                         |
+|                        | `factor `_,                                                                                 |
+|                        | `matmul `_,                                                                                 |
+|                        | `polynomial_from_roots `_,                                                   |
+|                        | `polynomial_derivative `_,                                                   |
+|                        | `polynomial_eval `_,                                                               |
+|                        | `sieve `_,                                                                                   |
+|                        | `sum_of_squares `_,                                                                 |
+|                        | `totient `_                                                                                |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Combinatorics          | `distinct_permutations `_,                                                   |
+|                        | `distinct_combinations `_,                                                   |
+|                        | `circular_shifts `_,                                                               |
+|                        | `partitions `_,                                                                         |
+|                        | `set_partitions `_,                                                                 |
+|                        | `product_index `_,                                                                   |
+|                        | `combination_index `_,                                                           |
+|                        | `permutation_index `_,                                                           |
+|                        | `combination_with_replacement_index `_,                         |
+|                        | `gray_product  `_,                                                                    |
+|                        | `outer_product  `_,                                                                  |
+|                        | `powerset `_,                                                                             |
+|                        | `powerset_of_sets `_,                                                             |
+|                        | `random_product `_,                                                                 |
+|                        | `random_permutation `_,                                                         |
+|                        | `random_combination `_,                                                         |
+|                        | `random_combination_with_replacement `_,                       |
+|                        | `nth_product `_,                                                                       |
+|                        | `nth_permutation `_,                                                               |
+|                        | `nth_combination `_,                                                               |
+|                        | `nth_combination_with_replacement `_                              |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Wrapping               | `always_iterable `_,                                                               |
+|                        | `always_reversible `_,                                                           |
+|                        | `countable `_,                                                                           |
+|                        | `consumer `_,                                                                             |
+|                        | `with_iter `_,                                                                           |
+|                        | `iter_except `_                                                                        |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Others                 | `locate `_,                                                                                 |
+|                        | `rlocate `_,                                                                               |
+|                        | `replace `_,                                                                               |
+|                        | `numeric_range `_,                                                                   |
+|                        | `side_effect `_,                                                                       |
+|                        | `iterate `_,                                                                               |
+|                        | `difference `_,                                                                         |
+|                        | `make_decorator `_,                                                                 |
+|                        | `SequenceView `_,                                                                     |
+|                        | `time_limited `_,                                                                     |
+|                        | `map_if `_,                                                                                 |
+|                        | `iter_index `_,                                                                         |
+|                        | `consume `_,                                                                               |
+|                        | `tabulate `_,                                                                             |
+|                        | `repeatfunc `_,                                                                         |
+|                        | `reshape `_                                                                                |
+|                        | `doublestarmap `_                                                                    |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+
+
+Getting started
+===============
+
+To get started, install the library with `pip `_:
+
+.. code-block:: shell
+
+    pip install more-itertools
+
+The recipes from the `itertools docs `_
+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 `_.
+
+
+Links elsewhere
+===============
+
+Blog posts about ``more-itertools``:
+
+* `Yo, I heard you like decorators `__
+* `Tour of Python Itertools `__ (`Alternate `__)
+* `Real-World Python More Itertools `_
+
+
+Development
+===========
+
+``more-itertools`` is maintained by `@erikrose `_
+and `@bbayles `_, with help from `many others `_.
+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 `_.
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/RECORD
new file mode 100644
index 0000000..f15f3fc
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/RECORD
@@ -0,0 +1,16 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/REQUESTED b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/REQUESTED
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/WHEEL
new file mode 100644
index 0000000..db4a255
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.8.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.py
new file mode 100644
index 0000000..9c4662f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.py
@@ -0,0 +1,6 @@
+"""More routines for operating on iterables, beyond itertools"""
+
+from .more import *  # noqa
+from .recipes import *  # noqa
+
+__version__ = '10.3.0'
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.pyi b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.pyi
new file mode 100644
index 0000000..96f6e36
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.pyi
@@ -0,0 +1,2 @@
+from .more import *
+from .recipes import *
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.py
new file mode 100644
index 0000000..7b48190
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.py
@@ -0,0 +1,4806 @@
+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>> 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 `__ 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 `__
+    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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.pyi b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.pyi
new file mode 100644
index 0000000..e946023
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.pyi
@@ -0,0 +1,709 @@
+"""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]: ...
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/py.typed b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.py
new file mode 100644
index 0000000..b32fa95
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.py
@@ -0,0 +1,1046 @@
+"""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 "", line 1, in 
+        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 "", line 1, in 
+        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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.pyi b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.pyi
new file mode 100644
index 0000000..739acec
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.pyi
@@ -0,0 +1,136 @@
+"""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: ...
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/INSTALLER
new file mode 100644
index 0000000..5c69047
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+uv
\ No newline at end of file
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE
new file mode 100644
index 0000000..6f62d44
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE
@@ -0,0 +1,3 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.APACHE b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.APACHE
new file mode 100644
index 0000000..f433b1a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.APACHE
@@ -0,0 +1,177 @@
+
+                                 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.BSD b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.BSD
new file mode 100644
index 0000000..42ce7b7
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.BSD
@@ -0,0 +1,23 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/METADATA
new file mode 100644
index 0000000..1479c86
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/METADATA
@@ -0,0 +1,102 @@
+Metadata-Version: 2.3
+Name: packaging
+Version: 24.2
+Summary: Core utilities for Python packages
+Author-email: Donald Stufft 
+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 `_.
+
+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/
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/RECORD
new file mode 100644
index 0000000..678aa5a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/RECORD
@@ -0,0 +1,25 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/REQUESTED b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/REQUESTED
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/WHEEL
new file mode 100644
index 0000000..e3c6fee
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.10.1
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/__init__.py
new file mode 100644
index 0000000..d79f73c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/__init__.py
@@ -0,0 +1,15 @@
+# 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__}"
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_elffile.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_elffile.py
new file mode 100644
index 0000000..25f4282
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_elffile.py
@@ -0,0 +1,110 @@
+"""
+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 MSB.
+                (2, 1): ("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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_manylinux.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_manylinux.py
new file mode 100644
index 0000000..61339a6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_manylinux.py
@@ -0,0 +1,263 @@
+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[0-9]+)\.(?P[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}"
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_musllinux.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_musllinux.py
new file mode 100644
index 0000000..d2bf30b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_musllinux.py
@@ -0,0 +1,85 @@
+"""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      ")
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_parser.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_parser.py
new file mode 100644
index 0000000..c1238c0
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_parser.py
@@ -0,0 +1,354 @@
+"""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"
+        )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_structures.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_structures.py
new file mode 100644
index 0000000..90a6465
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_structures.py
@@ -0,0 +1,61 @@
+# 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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_tokenizer.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_tokenizer.py
new file mode 100644
index 0000000..89d0416
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/_tokenizer.py
@@ -0,0 +1,194 @@
+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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/__init__.py
new file mode 100644
index 0000000..569156d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/__init__.py
@@ -0,0 +1,145 @@
+#######################################################################################
+#
+# Adapted from:
+#  https://github.com/pypa/hatch/blob/5352e44/backend/src/hatchling/licenses/parse.py
+#
+# MIT License
+#
+# Copyright (c) 2017-present Ofek Lev 
+#
+# 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(" )", ")"),
+    )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/_spdx.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/_spdx.py
new file mode 100644
index 0000000..eac2227
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/_spdx.py
@@ -0,0 +1,759 @@
+
+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},
+}
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/markers.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/markers.py
new file mode 100644
index 0000000..fb7f49c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/markers.py
@@ -0,0 +1,331 @@
+# 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:
+            # [
+            #     (, ')>, ),
+            #     'and',
+            #     [
+            #         (, , ),
+            #         'or',
+            #         (, , )
+            #     ]
+            # ]
+        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""
+
+    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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/metadata.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/metadata.py
new file mode 100644
index 0000000..721f411
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/metadata.py
@@ -0,0 +1,863 @@
+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)"""
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/py.typed b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/requirements.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/requirements.py
new file mode 100644
index 0000000..4e068c9
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/requirements.py
@@ -0,0 +1,91 @@
+# 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""
+
+    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
+        )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/specifiers.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/specifiers.py
new file mode 100644
index 0000000..b30926a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/specifiers.py
@@ -0,0 +1,1020 @@
+# 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(~=|==|!=|<=|>=|<|>|===))
+        """
+    _version_regex_str = r"""
+        (?P
+            (?:
+                # 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.
+                (?=": "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')
+        =1.0.0')>
+        >>> Specifier('>=1.0.0', prereleases=False)
+        =1.0.0', prereleases=False)>
+        >>> Specifier('>=1.0.0', prereleases=True)
+        =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', ]
+        >>> 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')
+        =1.0.0')>
+        >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False)
+        =1.0.0', prereleases=False)>
+        >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True)
+        =1.0.0', prereleases=True)>
+        """
+        pre = (
+            f", prereleases={self.prereleases!r}"
+            if self._prereleases is not None
+            else ""
+        )
+
+        return f""
+
+    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'
+        =1.0.0')>
+        >>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1')
+        =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)
+        [, =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', ]
+        >>> 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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/tags.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/tags.py
new file mode 100644
index 0000000..f590340
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/tags.py
@@ -0,0 +1,617 @@
+# 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--
+    - cp-abi3-
+    - cp-none-
+    - cp-abi3-  # 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:
+    - --
+
+    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-
+    - -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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/utils.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/utils.py
new file mode 100644
index 0000000..2345095
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/utils.py
@@ -0,0 +1,163 @@
+# 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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/version.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/version.py
new file mode 100644
index 0000000..c9bbda2
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/packaging/version.py
@@ -0,0 +1,582 @@
+# 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')
+    
+
+    :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[0-9]+)!)?                           # epoch
+        (?P[0-9]+(?:\.[0-9]+)*)                  # release segment
+        (?P
                                          # pre-release
+            [-_\.]?
+            (?Palpha|a|beta|b|preview|pre|c|rc)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+        (?P                                         # post release
+            (?:-(?P[0-9]+))
+            |
+            (?:
+                [-_\.]?
+                (?Ppost|rev|r)
+                [-_\.]?
+                (?P[0-9]+)?
+            )
+        )?
+        (?P                                          # dev release
+            [-_\.]?
+            (?Pdev)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+    )
+    (?:\+(?P[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
+    
+    >>> v2
+    
+    >>> 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')
+        
+        """
+        return f""
+
+    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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/METADATA
new file mode 100644
index 0000000..ab51ef3
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/METADATA
@@ -0,0 +1,319 @@
+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 , Julian Berman , Ofek Lev , Ronny Pfannschmidt 
+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/
+
+If on Windows (at least English Win) that should be::
+
+    C:\Documents and Settings\\Application Data\Local Settings\\
+
+or possibly::
+
+    C:\Documents and Settings\\Application Data\\
+
+for `roaming profiles `_ but that is another story.
+
+On Linux (and other Unices), according to the `XDG Basedir Spec`_, it should be::
+
+    ~/.local/share/
+
+.. _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 `_ 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
+`_, this fork was
+created.
+
+Contributions are most welcome.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/RECORD
new file mode 100644
index 0000000..64c0c8e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/RECORD
@@ -0,0 +1,23 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/REQUESTED b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/REQUESTED
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/WHEEL
new file mode 100644
index 0000000..516596c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.24.2
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/licenses/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/licenses/LICENSE
new file mode 100644
index 0000000..f35fed9
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/licenses/LICENSE
@@ -0,0 +1,21 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__init__.py
new file mode 100644
index 0000000..3f7d949
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__init__.py
@@ -0,0 +1,627 @@
+"""
+Utilities for determining application-specific dirs.
+
+See  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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `multipath `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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",
+]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__main__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__main__.py
new file mode 100644
index 0000000..922c521
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__main__.py
@@ -0,0 +1,55 @@
+"""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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/android.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/android.py
new file mode 100644
index 0000000..afd3141
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/android.py
@@ -0,0 +1,249 @@
+"""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 `_.
+
+    Makes use of the `appname `, `version
+    `, `ensure_exists `.
+
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """:return: data directory tied to the user, e.g. ``/data/user///files/``"""
+        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///shared_prefs/``
+        """
+        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///cache/``"""
+        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///cache//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///cache//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",
+]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/api.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/api.py
new file mode 100644
index 0000000..c50caa6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/api.py
@@ -0,0 +1,292 @@
+"""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 ``.``.
+
+        """
+        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 `_).
+
+        """
+        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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/macos.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/macos.py
new file mode 100644
index 0000000..eb1ba5d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/macos.py
@@ -0,0 +1,130 @@
+"""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 `_.
+    Makes use of the `appname `,
+    `version `,
+    `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 `_, the directory
+          will be under the Homebrew prefix, e.g. ``/opt/homebrew/share/$appname/$version``.
+          If `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 `_, the directory
+          will be under the Homebrew prefix, e.g. ``/opt/homebrew/var/cache/$appname/$version``.
+          If `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",
+]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/py.typed b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/unix.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/unix.py
new file mode 100644
index 0000000..9500ade
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/unix.py
@@ -0,0 +1,275 @@
+"""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 `_.
+
+    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
+    `, `version `, `multipath
+    `, `opinion `, `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 ` 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 `
+         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",
+]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/version.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/version.py
new file mode 100644
index 0000000..6483ddc
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/version.py
@@ -0,0 +1,16 @@
+# 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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/windows.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/windows.py
new file mode 100644
index 0000000..d7bc960
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/windows.py
@@ -0,0 +1,272 @@
+"""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 `_.
+
+    Makes use of the `appname `, `appauthor
+    `, `version `, `roaming
+    `, `opinion `, `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",
+]
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/LICENSE
new file mode 100644
index 0000000..e859590
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/LICENSE
@@ -0,0 +1,21 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/METADATA
new file mode 100644
index 0000000..efd87ec
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/METADATA
@@ -0,0 +1,206 @@
+Metadata-Version: 2.1
+Name: tomli
+Version: 2.0.1
+Summary: A lil' TOML parser
+Keywords: toml
+Author-email: Taneli Hukkinen 
+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
+
+[![Build Status](https://github.com/hukkin/tomli/workflows/Tests/badge.svg?branch=master)](https://github.com/hukkin/tomli/actions?query=workflow%3ATests+branch%3Amaster+event%3Apush)
+[![codecov.io](https://codecov.io/gh/hukkin/tomli/branch/master/graph/badge.svg)](https://codecov.io/gh/hukkin/tomli)
+[![PyPI version](https://img.shields.io/pypi/v/tomli)](https://pypi.org/project/tomli)
+
+# Tomli
+
+> A lil' TOML parser
+
+**Table of Contents**  *generated with [mdformat-toc](https://github.com/hukkin/mdformat-toc)*
+
+
+
+- [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)
+
+
+
+## Intro
+
+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
+
+```bash
+pip install tomli
+```
+
+## Usage
+
+### Parse a TOML string
+
+```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
+
+```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
+
+```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
+
+```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
+
+### Why this parser?
+
+- 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?
+
+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?
+
+[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?
+
+| 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
+
+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).
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/RECORD
new file mode 100644
index 0000000..1db8063
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/RECORD
@@ -0,0 +1,15 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/REQUESTED b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/REQUESTED
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/WHEEL
new file mode 100644
index 0000000..c727d14
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.6.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/__init__.py
new file mode 100644
index 0000000..4c6ec97
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/__init__.py
@@ -0,0 +1,11 @@
+# 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__
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/_parser.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/_parser.py
new file mode 100644
index 0000000..f1bb0aa
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/_parser.py
@@ -0,0 +1,691 @@
+# 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/_re.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/_re.py
new file mode 100644
index 0000000..994bb74
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/_re.py
@@ -0,0 +1,107 @@
+# 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
+    (?:\.[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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/_types.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/_types.py
new file mode 100644
index 0000000..d949412
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/_types.py
@@ -0,0 +1,10 @@
+# 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/py.typed b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/py.typed
new file mode 100644
index 0000000..7632ecf
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/tomli/py.typed
@@ -0,0 +1 @@
+# Marker file for PEP 561
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/LICENSE
new file mode 100644
index 0000000..07806f8
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/LICENSE
@@ -0,0 +1,19 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/METADATA
new file mode 100644
index 0000000..6e5750b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/METADATA
@@ -0,0 +1,81 @@
+Metadata-Version: 2.1
+Name: typeguard
+Version: 4.3.0
+Summary: Run-time type checker for Python
+Author-email: Alex Grönholm 
+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 `_ 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/
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/RECORD
new file mode 100644
index 0000000..801e733
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/RECORD
@@ -0,0 +1,34 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/WHEEL
new file mode 100644
index 0000000..bab98d6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/entry_points.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/entry_points.txt
new file mode 100644
index 0000000..47c9d0b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/entry_points.txt
@@ -0,0 +1,2 @@
+[pytest11]
+typeguard = typeguard._pytest_plugin
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/top_level.txt
new file mode 100644
index 0000000..be5ec23
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+typeguard
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__init__.py
new file mode 100644
index 0000000..6781cad
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__init__.py
@@ -0,0 +1,48 @@
+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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_checkers.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_checkers.py
new file mode 100644
index 0000000..67dd5ad
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_checkers.py
@@ -0,0 +1,993 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_config.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_config.py
new file mode 100644
index 0000000..36efad5
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_config.py
@@ -0,0 +1,108 @@
+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[, ...]`` (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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_decorators.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_decorators.py
new file mode 100644
index 0000000..cf32533
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_decorators.py
@@ -0,0 +1,235 @@
+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 == "":
+        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 != ""]
+    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 `,
+    :func:`@staticmethod `,  and :class:`@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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_exceptions.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_exceptions.py
new file mode 100644
index 0000000..625437a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_exceptions.py
@@ -0,0 +1,42 @@
+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])
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_functions.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_functions.py
new file mode 100644
index 0000000..2849785
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_functions.py
@@ -0,0 +1,308 @@
+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())
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_importhook.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_importhook.py
new file mode 100644
index 0000000..8590540
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_importhook.py
@@ -0,0 +1,213 @@
+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] = "",
+    ) -> 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 ` 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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_memo.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_memo.py
new file mode 100644
index 0000000..1d0d80c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_memo.py
@@ -0,0 +1,48 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_pytest_plugin.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_pytest_plugin.py
new file mode 100644
index 0000000..7b2f494
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_pytest_plugin.py
@@ -0,0 +1,127 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_suppression.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_suppression.py
new file mode 100644
index 0000000..bbbfbfb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_suppression.py
@@ -0,0 +1,86 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_transformer.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_transformer.py
new file mode 100644
index 0000000..13ac363
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_transformer.py
@@ -0,0 +1,1229 @@
+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, "")
+
+        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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_union_transformer.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_union_transformer.py
new file mode 100644
index 0000000..19617e6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_union_transformer.py
@@ -0,0 +1,55 @@
+"""
+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, "", "eval")
+    UnionTransformer().visit(parsed)
+    fix_missing_locations(parsed)
+    return compile(parsed, "", "eval", flags=0)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_utils.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_utils.py
new file mode 100644
index 0000000..9bcc841
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_utils.py
@@ -0,0 +1,173 @@
+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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/py.typed b/venv/lib/python3.12/site-packages/setuptools/_vendor/typeguard/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/LICENSE
new file mode 100644
index 0000000..f26bcf4
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/LICENSE
@@ -0,0 +1,279 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/METADATA
new file mode 100644
index 0000000..f15e2b3
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/METADATA
@@ -0,0 +1,67 @@
+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" 
+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
+
+[![Chat at https://gitter.im/python/typing](https://badges.gitter.im/python/typing.svg)](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`.
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/RECORD
new file mode 100644
index 0000000..bc7b453
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/RECORD
@@ -0,0 +1,7 @@
+__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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/WHEEL
new file mode 100644
index 0000000..3b5e64b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.9.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions.py
new file mode 100644
index 0000000..dec429c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions.py
@@ -0,0 +1,3641 @@
+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 ""
+
+
+_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, )`.
+
+        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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/LICENSE.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/LICENSE.txt
new file mode 100644
index 0000000..a31470f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/LICENSE.txt
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2012 Daniel Holth  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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/METADATA
new file mode 100644
index 0000000..f645dcb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/METADATA
@@ -0,0 +1,66 @@
+Metadata-Version: 2.3
+Name: wheel
+Version: 0.45.1
+Summary: A built-package format for Python
+Keywords: wheel,packaging
+Author-email: Daniel Holth 
+Maintainer-email: Alex Grönholm 
+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
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/RECORD
new file mode 100644
index 0000000..c1535b6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/RECORD
@@ -0,0 +1,68 @@
+../../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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/REQUESTED b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/REQUESTED
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/WHEEL
new file mode 100644
index 0000000..e3c6fee
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.10.1
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/entry_points.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/entry_points.txt
new file mode 100644
index 0000000..06c9f69
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/entry_points.txt
@@ -0,0 +1,6 @@
+[console_scripts]
+wheel=wheel.cli:main
+
+[distutils.commands]
+bdist_wheel=wheel.bdist_wheel:bdist_wheel
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/__init__.py
new file mode 100644
index 0000000..3ab8f72
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/__init__.py
@@ -0,0 +1,3 @@
+from __future__ import annotations
+
+__version__ = "0.45.1"
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/__main__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/__main__.py
new file mode 100644
index 0000000..0be7453
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/__main__.py
@@ -0,0 +1,23 @@
+"""
+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())
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/_bdist_wheel.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/_bdist_wheel.py
new file mode 100644
index 0000000..88973eb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/_bdist_wheel.py
@@ -0,0 +1,613 @@
+"""
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/_setuptools_logging.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/_setuptools_logging.py
new file mode 100644
index 0000000..a1a2482
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/_setuptools_logging.py
@@ -0,0 +1,26 @@
+# 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
+    )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/bdist_wheel.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/bdist_wheel.py
new file mode 100644
index 0000000..dd7b862
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/bdist_wheel.py
@@ -0,0 +1,26 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__init__.py
new file mode 100644
index 0000000..6ba1217
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__init__.py
@@ -0,0 +1,155 @@
+"""
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/convert.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/convert.py
new file mode 100644
index 0000000..61d4775
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/convert.py
@@ -0,0 +1,332 @@
+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.+?)-(?P.+?)
+    (-(?Ppy\d\.\d+)
+     (-(?P.+?))?
+    )?.egg$""",
+    re.VERBOSE,
+)
+egg_info_re = re.compile(
+    r"""
+    ^(?P.+?)-(?P.+?)
+    (-(?Ppy\d\.\d+)
+    )?.egg-info/""",
+    re.VERBOSE,
+)
+wininst_re = re.compile(
+    r"\.(?Pwin32|win-amd64)(?:-(?Ppy\d\.\d))?\.exe$"
+)
+pyd_re = re.compile(r"\.(?P[a-z0-9]+)-(?Pwin32|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")
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/pack.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/pack.py
new file mode 100644
index 0000000..64469c0
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/pack.py
@@ -0,0 +1,85 @@
+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(?P.+?)-(?P\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)])
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/tags.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/tags.py
new file mode 100644
index 0000000..88da72e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/tags.py
@@ -0,0 +1,139 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/unpack.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/unpack.py
new file mode 100644
index 0000000..d48840e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/unpack.py
@@ -0,0 +1,30 @@
+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")
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/macosx_libfile.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/macosx_libfile.py
new file mode 100644
index 0000000..abdfc9e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/macosx_libfile.py
@@ -0,0 +1,482 @@
+"""
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/metadata.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/metadata.py
new file mode 100644
index 0000000..b8098fa
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/metadata.py
@@ -0,0 +1,183 @@
+"""
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/util.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/util.py
new file mode 100644
index 0000000..c928aa4
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/util.py
@@ -0,0 +1,17 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE
new file mode 100644
index 0000000..6f62d44
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE
@@ -0,0 +1,3 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.APACHE b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.APACHE
new file mode 100644
index 0000000..f433b1a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.APACHE
@@ -0,0 +1,177 @@
+
+                                 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.BSD b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.BSD
new file mode 100644
index 0000000..42ce7b7
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.BSD
@@ -0,0 +1,23 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_elffile.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_elffile.py
new file mode 100644
index 0000000..6fb19b3
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_elffile.py
@@ -0,0 +1,108 @@
+"""
+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 MSB.
+                (2, 1): ("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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_manylinux.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_manylinux.py
new file mode 100644
index 0000000..1f5f4ab
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_manylinux.py
@@ -0,0 +1,260 @@
+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[0-9]+)\.(?P[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}"
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_musllinux.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_musllinux.py
new file mode 100644
index 0000000..eb4251b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_musllinux.py
@@ -0,0 +1,83 @@
+"""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      ")
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_parser.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_parser.py
new file mode 100644
index 0000000..513686a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_parser.py
@@ -0,0 +1,356 @@
+"""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"
+        )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_structures.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_structures.py
new file mode 100644
index 0000000..90a6465
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_structures.py
@@ -0,0 +1,61 @@
+# 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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_tokenizer.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_tokenizer.py
new file mode 100644
index 0000000..dd0d648
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_tokenizer.py
@@ -0,0 +1,192 @@
+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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/markers.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/markers.py
new file mode 100644
index 0000000..c96d22a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/markers.py
@@ -0,0 +1,253 @@
+# 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:
+            # [
+            #     (, ')>, ),
+            #     'and',
+            #     [
+            #         (, , ),
+            #         'or',
+            #         (, , )
+            #     ]
+            # ]
+        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""
+
+    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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/requirements.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/requirements.py
new file mode 100644
index 0000000..bdc43a7
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/requirements.py
@@ -0,0 +1,90 @@
+# 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""
+
+    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
+        )
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/specifiers.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/specifiers.py
new file mode 100644
index 0000000..6d4066a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/specifiers.py
@@ -0,0 +1,1011 @@
+# 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(~=|==|!=|<=|>=|<|>|===))
+        """
+    _version_regex_str = r"""
+        (?P
+            (?:
+                # 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.
+                (?=": "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')
+        =1.0.0')>
+        >>> Specifier('>=1.0.0', prereleases=False)
+        =1.0.0', prereleases=False)>
+        >>> Specifier('>=1.0.0', prereleases=True)
+        =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', ]
+        >>> 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')
+        =1.0.0')>
+        >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False)
+        =1.0.0', prereleases=False)>
+        >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True)
+        =1.0.0', prereleases=True)>
+        """
+        pre = (
+            f", prereleases={self.prereleases!r}"
+            if self._prereleases is not None
+            else ""
+        )
+
+        return f""
+
+    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'
+        =1.0.0')>
+        >>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1')
+        =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)
+        [, =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', ]
+        >>> 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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/tags.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/tags.py
new file mode 100644
index 0000000..89f1926
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/tags.py
@@ -0,0 +1,571 @@
+# 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--
+    - cp-abi3-
+    - cp-none-
+    - cp-abi3-  # 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:
+    - --
+
+    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-
+    - -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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/utils.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/utils.py
new file mode 100644
index 0000000..c2c2f75
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/utils.py
@@ -0,0 +1,172 @@
+# 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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/version.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/version.py
new file mode 100644
index 0000000..cda8e99
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/version.py
@@ -0,0 +1,561 @@
+# 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')
+    
+
+    :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[0-9]+)!)?                           # epoch
+        (?P[0-9]+(?:\.[0-9]+)*)                  # release segment
+        (?P
                                          # pre-release
+            [-_\.]?
+            (?Palpha|a|beta|b|preview|pre|c|rc)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+        (?P                                         # post release
+            (?:-(?P[0-9]+))
+            |
+            (?:
+                [-_\.]?
+                (?Ppost|rev|r)
+                [-_\.]?
+                (?P[0-9]+)?
+            )
+        )?
+        (?P                                          # dev release
+            [-_\.]?
+            (?Pdev)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+    )
+    (?:\+(?P[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
+    
+    >>> v2
+    
+    >>> 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')
+        
+        """
+        return f""
+
+    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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/vendor.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/vendor.txt
new file mode 100644
index 0000000..1466610
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/vendor.txt
@@ -0,0 +1 @@
+packaging==24.0
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/wheelfile.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/wheelfile.py
new file mode 100644
index 0000000..0a0f459
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/wheel/wheelfile.py
@@ -0,0 +1,227 @@
+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(?P[^\s-]+?)-(?P[^\s-]+?))(-(?P\d[^\s-]*))?
+     -(?P[^\s-]+?)-(?P[^\s-]+?)-(?P\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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/INSTALLER b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/LICENSE b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/LICENSE
new file mode 100644
index 0000000..1bb5a44
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/LICENSE
@@ -0,0 +1,17 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/METADATA b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/METADATA
new file mode 100644
index 0000000..1399281
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/METADATA
@@ -0,0 +1,102 @@
+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" 
+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 `_.
+
+
+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 `_.
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/RECORD b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/RECORD
new file mode 100644
index 0000000..77c0283
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/RECORD
@@ -0,0 +1,15 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/REQUESTED b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/REQUESTED
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/WHEEL b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/WHEEL
new file mode 100644
index 0000000..bab98d6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/top_level.txt b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/top_level.txt
new file mode 100644
index 0000000..e82f676
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+zipp
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp/__init__.py
new file mode 100644
index 0000000..d65297b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp/__init__.py
@@ -0,0 +1,501 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/__init__.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/py310.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/py310.py
new file mode 100644
index 0000000..d5ca53e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/py310.py
@@ -0,0 +1,11 @@
+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
+)
diff --git a/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp/glob.py b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp/glob.py
new file mode 100644
index 0000000..69c41d7
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/_vendor/zipp/glob.py
@@ -0,0 +1,106 @@
+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[\[].*?[\]])|([\[][^\]]*$)', pattern)
diff --git a/venv/lib/python3.12/site-packages/setuptools/archive_util.py b/venv/lib/python3.12/site-packages/setuptools/archive_util.py
new file mode 100644
index 0000000..1a02010
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/archive_util.py
@@ -0,0 +1,219 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/build_meta.py b/venv/lib/python3.12/site-packages/setuptools/build_meta.py
new file mode 100644
index 0000000..8f2e930
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/build_meta.py
@@ -0,0 +1,548 @@
+"""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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/__init__.py b/venv/lib/python3.12/site-packages/setuptools/command/__init__.py
new file mode 100644
index 0000000..50e6c2f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/__init__.py
@@ -0,0 +1,21 @@
+# 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/_requirestxt.py b/venv/lib/python3.12/site-packages/setuptools/command/_requirestxt.py
new file mode 100644
index 0000000..9029b12
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/_requirestxt.py
@@ -0,0 +1,131 @@
+"""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())
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/alias.py b/venv/lib/python3.12/site-packages/setuptools/command/alias.py
new file mode 100644
index 0000000..b8d74af
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/alias.py
@@ -0,0 +1,77 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/bdist_egg.py b/venv/lib/python3.12/site-packages/setuptools/command/bdist_egg.py
new file mode 100644
index 0000000..b66020c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/bdist_egg.py
@@ -0,0 +1,477 @@
+"""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_platform, 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, importlib.resources as irs, importlib.util
+            with irs.as_file(irs.files(__name__).joinpath(%r)) as __file__:
+                __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 `sysconfig.get_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:
+            self.plat_name = get_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.+)\.(?P[^.]+)\.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
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/bdist_rpm.py b/venv/lib/python3.12/site-packages/setuptools/command/bdist_rpm.py
new file mode 100644
index 0000000..6dbb270
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/bdist_rpm.py
@@ -0,0 +1,42 @@
+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
+        ]
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/bdist_wheel.py b/venv/lib/python3.12/site-packages/setuptools/command/bdist_wheel.py
new file mode 100644
index 0000000..91ed001
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/bdist_wheel.py
@@ -0,0 +1,604 @@
+"""
+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}")
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/build.py b/venv/lib/python3.12/site-packages/setuptools/command/build.py
new file mode 100644
index 0000000..54cbb8d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/build.py
@@ -0,0 +1,135 @@
+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 ` 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"``.
+        """
+        ...
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/build_clib.py b/venv/lib/python3.12/site-packages/setuptools/command/build_clib.py
new file mode 100644
index 0000000..f376f4c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/build_clib.py
@@ -0,0 +1,103 @@
+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
+            )
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/build_ext.py b/venv/lib/python3.12/site-packages/setuptools/command/build_ext.py
new file mode 100644
index 0000000..af73fff
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/build_ext.py
@@ -0,0 +1,470 @@
+from __future__ import annotations
+
+import itertools
+import os
+import sys
+import textwrap
+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 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 = (
+                    textwrap.dedent(f"""
+                    def __bootstrap__():
+                       global __bootstrap__, __file__, __loader__
+                       import sys, os, importlib.resources as irs, importlib.util
+                    #rtld   import dl
+                       with irs.files(__name__).joinpath(
+                         {os.path.basename(ext._file_name)!r}) as __file__:
+                          del __bootstrap__
+                          if '__loader__' in globals():
+                              del __loader__
+                    #rtld      old_flags = sys.getdlopenflags()
+                          old_dir = os.getcwd()
+                          try:
+                            os.chdir(os.path.dirname(__file__))
+                    #rtld        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:
+                    #rtld        sys.setdlopenflags(old_flags)
+                            os.chdir(old_dir)
+                    __bootstrap__()
+                    """)
+                    .lstrip()
+                    .replace('#rtld', '#rtld' * (not have_rtld))
+                )
+                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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/build_py.py b/venv/lib/python3.12/site-packages/setuptools/command/build_py.py
new file mode 100644
index 0000000..2f6fcb7
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/build_py.py
@@ -0,0 +1,400 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/develop.py b/venv/lib/python3.12/site-packages/setuptools/command/develop.py
new file mode 100644
index 0000000..1f704fc
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/develop.py
@@ -0,0 +1,55 @@
+import site
+import subprocess
+import sys
+
+from setuptools import Command
+from setuptools.warnings import SetuptoolsDeprecationWarning
+
+
+class develop(Command):
+    """Set up package for development"""
+
+    user_options = [
+        ("install-dir=", "d", "install package to DIR"),
+        ('no-deps', 'N', "don't install dependencies"),
+        ('user', None, f"install in user site-package '{site.USER_SITE}'"),
+        ('prefix=', None, "installation prefix"),
+        ("index-url=", "i", "base URL of Python Package Index"),
+    ]
+    boolean_options = [
+        'no-deps',
+        'user',
+    ]
+
+    install_dir = None
+    no_deps = False
+    user = False
+    prefix = None
+    index_url = None
+
+    def run(self):
+        cmd = (
+            [sys.executable, '-m', 'pip', 'install', '-e', '.', '--use-pep517']
+            + ['--target', self.install_dir] * bool(self.install_dir)
+            + ['--no-deps'] * self.no_deps
+            + ['--user'] * self.user
+            + ['--prefix', self.prefix] * bool(self.prefix)
+            + ['--index-url', self.index_url] * bool(self.index_url)
+        )
+        subprocess.check_call(cmd)
+
+    def initialize_options(self):
+        DevelopDeprecationWarning.emit()
+
+    def finalize_options(self) -> None:
+        pass
+
+
+class DevelopDeprecationWarning(SetuptoolsDeprecationWarning):
+    _SUMMARY = "develop command is deprecated."
+    _DETAILS = """
+    Please avoid running ``setup.py`` and ``develop``.
+    Instead, use standards-based tools like pip or uv.
+    """
+    _SEE_URL = "https://github.com/pypa/setuptools/issues/917"
+    _DUE_DATE = 2025, 10, 31
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/dist_info.py b/venv/lib/python3.12/site-packages/setuptools/command/dist_info.py
new file mode 100644
index 0000000..dca01ff
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/dist_info.py
@@ -0,0 +1,103 @@
+"""
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/easy_install.py b/venv/lib/python3.12/site-packages/setuptools/command/easy_install.py
new file mode 100644
index 0000000..8765793
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/easy_install.py
@@ -0,0 +1,30 @@
+import os
+import sys
+import types
+
+from setuptools import Command
+
+from .. import _scripts, warnings
+
+
+class easy_install(Command):
+    """Stubbed command for temporary pbr compatibility."""
+
+
+def __getattr__(name):
+    attr = getattr(
+        types.SimpleNamespace(
+            ScriptWriter=_scripts.ScriptWriter,
+            sys_executable=os.environ.get(
+                "__PYVENV_LAUNCHER__", os.path.normpath(sys.executable)
+            ),
+        ),
+        name,
+    )
+    warnings.SetuptoolsDeprecationWarning.emit(
+        summary="easy_install module is deprecated",
+        details="Avoid accessing attributes of setuptools.command.easy_install.",
+        due_date=(2025, 10, 31),
+        see_url="https://github.com/pypa/setuptools/issues/4976",
+    )
+    return attr
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/editable_wheel.py b/venv/lib/python3.12/site-packages/setuptools/command/editable_wheel.py
new file mode 100644
index 0000000..c772570
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/editable_wheel.py
@@ -0,0 +1,908 @@
+"""
+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 py310, py312
+from ..discovery import find_package_path
+from ..dist import Distribution
+from ..warnings import InformationOnly, SetuptoolsDeprecationWarning
+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 as ex:
+            project = self.distribution.name or self.distribution.get_name()
+            py310.add_note(
+                ex,
+                f"An error occurred when building editable wheel for {project}.\n"
+                "See debugging tips in: "
+                "https://setuptools.pypa.io/en/latest/userguide/development_mode.html#debugging-tips",
+            )
+            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
+
+        # For portability, ensure scripts are built with #!python shebang
+        # pypa/setuptools#4863
+        build_scripts = dist.get_command_obj("build_scripts")
+        build_scripts.executable = 'python'
+
+        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."""
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/egg_info.py b/venv/lib/python3.12/site-packages/setuptools/command/egg_info.py
new file mode 100644
index 0000000..7e00ae2
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/egg_info.py
@@ -0,0 +1,718 @@
+"""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:
+            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."""
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/install.py b/venv/lib/python3.12/site-packages/setuptools/command/install.py
new file mode 100644
index 0000000..19ca601
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/install.py
@@ -0,0 +1,131 @@
+from __future__ import annotations
+
+import inspect
+import platform
+from collections.abc import Callable
+from typing import TYPE_CHECKING, Any, ClassVar
+
+from ..dist import Distribution
+from ..warnings import SetuptoolsDeprecationWarning, SetuptoolsWarning
+
+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",
+            due_date=(2025, 10, 31),
+        )
+
+        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
+
+    @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
+
+
+# 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/install_egg_info.py b/venv/lib/python3.12/site-packages/setuptools/command/install_egg_info.py
new file mode 100644
index 0000000..44f22cc
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/install_egg_info.py
@@ -0,0 +1,58 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/install_lib.py b/venv/lib/python3.12/site-packages/setuptools/command/install_lib.py
new file mode 100644
index 0000000..8e1e072
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/install_lib.py
@@ -0,0 +1,137 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/install_scripts.py b/venv/lib/python3.12/site-packages/setuptools/command/install_scripts.py
new file mode 100644
index 0000000..537181e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/install_scripts.py
@@ -0,0 +1,67 @@
+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 .. import _scripts
+        from .._importlib import metadata
+
+        ei_cmd = self.get_finalized_command("egg_info")
+        dist = metadata.Distribution.at(path=ei_cmd.egg_info)
+        bs_cmd = self.get_finalized_command('build_scripts')
+        exec_param = getattr(bs_cmd, 'executable', None)
+        writer = _scripts.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 .._shutil import attempt_chmod_verbose as 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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/launcher manifest.xml b/venv/lib/python3.12/site-packages/setuptools/command/launcher manifest.xml
new file mode 100644
index 0000000..5972a96
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/launcher manifest.xml	
@@ -0,0 +1,15 @@
+
+
+    
+    
+    
+        
+            
+                
+            
+        
+    
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/rotate.py b/venv/lib/python3.12/site-packages/setuptools/command/rotate.py
new file mode 100644
index 0000000..acdce07
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/rotate.py
@@ -0,0 +1,65 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/saveopts.py b/venv/lib/python3.12/site-packages/setuptools/command/saveopts.py
new file mode 100644
index 0000000..2a2cbce
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/saveopts.py
@@ -0,0 +1,21 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/sdist.py b/venv/lib/python3.12/site-packages/setuptools/command/sdist.py
new file mode 100644
index 0000000..1aed1d5
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/sdist.py
@@ -0,0 +1,217 @@
+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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/setopt.py b/venv/lib/python3.12/site-packages/setuptools/command/setopt.py
new file mode 100644
index 0000000..678a059
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/setopt.py
@@ -0,0 +1,141 @@
+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,
+        )
diff --git a/venv/lib/python3.12/site-packages/setuptools/command/test.py b/venv/lib/python3.12/site-packages/setuptools/command/test.py
new file mode 100644
index 0000000..341b11a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/command/test.py
@@ -0,0 +1,45 @@
+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")
diff --git a/venv/lib/python3.12/site-packages/setuptools/compat/__init__.py b/venv/lib/python3.12/site-packages/setuptools/compat/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/compat/py310.py b/venv/lib/python3.12/site-packages/setuptools/compat/py310.py
new file mode 100644
index 0000000..58a4d9f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/compat/py310.py
@@ -0,0 +1,20 @@
+import sys
+
+__all__ = ['tomllib']
+
+
+if sys.version_info >= (3, 11):
+    import tomllib
+else:  # pragma: no cover
+    import tomli as tomllib
+
+
+if sys.version_info >= (3, 11):
+
+    def add_note(ex, note):
+        ex.add_note(note)
+
+else:  # pragma: no cover
+
+    def add_note(ex, note):
+        vars(ex).setdefault('__notes__', []).append(note)
diff --git a/venv/lib/python3.12/site-packages/setuptools/compat/py311.py b/venv/lib/python3.12/site-packages/setuptools/compat/py311.py
new file mode 100644
index 0000000..52b58af
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/compat/py311.py
@@ -0,0 +1,27 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/compat/py312.py b/venv/lib/python3.12/site-packages/setuptools/compat/py312.py
new file mode 100644
index 0000000..b20c5f6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/compat/py312.py
@@ -0,0 +1,13 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/compat/py39.py b/venv/lib/python3.12/site-packages/setuptools/compat/py39.py
new file mode 100644
index 0000000..04a4abe
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/compat/py39.py
@@ -0,0 +1,9 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/NOTICE b/venv/lib/python3.12/site-packages/setuptools/config/NOTICE
new file mode 100644
index 0000000..0186451
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/NOTICE
@@ -0,0 +1,10 @@
+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/.
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/__init__.py b/venv/lib/python3.12/site-packages/setuptools/config/__init__.py
new file mode 100644
index 0000000..fcc7d00
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/__init__.py
@@ -0,0 +1,43 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/_apply_pyprojecttoml.py b/venv/lib/python3.12/site-packages/setuptools/config/_apply_pyprojecttoml.py
new file mode 100644
index 0000000..9088bc1
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/_apply_pyprojecttoml.py
@@ -0,0 +1,526 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/NOTICE b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/NOTICE
new file mode 100644
index 0000000..ac5464d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/NOTICE
@@ -0,0 +1,438 @@
+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.
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__init__.py b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__init__.py
new file mode 100644
index 0000000..4f612bd
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__init__.py
@@ -0,0 +1,34 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/error_reporting.py b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/error_reporting.py
new file mode 100644
index 0000000..3591231
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/error_reporting.py
@@ -0,0 +1,336 @@
+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]
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/extra_validations.py b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/extra_validations.py
new file mode 100644
index 0000000..789411d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/extra_validations.py
@@ -0,0 +1,82 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_exceptions.py b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_exceptions.py
new file mode 100644
index 0000000..d2dddd6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_exceptions.py
@@ -0,0 +1,51 @@
+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.
+    """
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_validations.py b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_validations.py
new file mode 100644
index 0000000..c69368a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_validations.py
@@ -0,0 +1,1412 @@
+# 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', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's 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', '`_.']}, 'license': {'description': '`Project 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', '`_.']}}, '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 `_.'}, '$$description': ['`Trove 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 `_.']}, 'gui-scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create GUI wrappers for the given', '`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', '`_.'], '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', '`_', 'and `setuptools docs', '`_', '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', '`_.', 'See also `the old Python docs _`.'], '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', '`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '`_', '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.']}, {'$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', '`_.'], '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', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's 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', '`_.']}, 'license': {'description': '`Project 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', '`_.']}}, '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 `_.'}, '$$description': ['`Trove 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 `_.']}, 'gui-scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create GUI wrappers for the given', '`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', '`_.'], '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', '`_', 'and `setuptools docs', '`_', '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', '`_.', 'See also `the old Python docs _`.'], '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', '`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '`_', '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.']}, {'$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', '`_.'], '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', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's 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', '`_.']}, 'license': {'description': '`Project 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', '`_.']}}, '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 `_.'}, '$$description': ['`Trove 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 `_.']}, 'gui-scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create GUI wrappers for the given', '`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', '`_.'], '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', '`_', 'and `setuptools docs', '`_', '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', '`_.', 'See also `the old Python docs _`.'], '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', '`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '`_', '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.']}, {'$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', '`_.'], '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', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's 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', '`_.']}, 'license': {'description': '`Project 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', '`_.']}}, '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 `_.'}, '$$description': ['`Trove 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 `_.']}, 'gui-scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create GUI wrappers for the given', '`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', '`_.'], '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', '`_', 'and `setuptools docs', '`_', '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', '`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '`_', '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.']}, {'$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', '`_.']}, {'$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', '`_.']}, {'$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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.']}, {'$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', '`_.']}, {'$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', '`_.']}, {'$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', '`_.']}, {'$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', '`_.']}, {'$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', '`_.']}, {'$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', '`_.']}, {'$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', '`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '`_', '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.']}, {'$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', '`_.']}, {'$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', '`_.']}, {'$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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.'], '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', '`_.', 'See also `the old Python docs _`.'], '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', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's 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', '`_.']}, 'license': {'description': '`Project 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', '`_.']}}, '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 `_.'}, '$$description': ['`Trove 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', '`_', 'and `setuptools docs', '`_', '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', '`_', 'and `setuptools docs', '`_', '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', '`_.'], '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', '`_', 'and `setuptools docs', '`_', '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', '`_', 'and `setuptools docs', '`_', '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', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's 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', '`_.']}, 'license': {'description': '`Project 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', '`_.']}}, '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 `_.'}, '$$description': ['`Trove 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', '`_', 'and `setuptools docs', '`_', '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', '`_', 'and `setuptools docs', '`_', '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', '`_.'], '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', '`_', 'and `setuptools docs', '`_', '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', '`_', 'and `setuptools docs', '`_', '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', '`_']}, 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', '`_', "with meaning similar to the one defined in `core metadata's 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', '`_.']}, 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', '`_.']}, 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', '`_.']}}, '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', '`_.']}}, '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', '`_.']}, 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 `_.', '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', '`_.']}}, '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 `_.'}, '$$description': ['`Trove 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 `_.'}, 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 `_.'}, 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', '`_.'], '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', '`_', 'and `setuptools docs', '`_', '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', '`_.'], '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', '`_', 'and `setuptools docs', '`_', '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', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's 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', '`_.']}, 'license': {'description': '`Project 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', '`_.']}}, '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 `_.'}, '$$description': ['`Trove 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', '`_', 'and `setuptools docs', '`_', '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', '`_', 'and `setuptools docs', '`_', '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', '`_.'], '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', '`_', 'and `setuptools docs', '`_', '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', '`_', 'and `setuptools docs', '`_', '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', '`_', 'and `setuptools docs', '`_', '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', '`_', 'and `setuptools docs', '`_', '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', '`_', 'and `setuptools docs', '`_', '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
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/formats.py b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/formats.py
new file mode 100644
index 0000000..1cf4a46
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/formats.py
@@ -0,0 +1,402 @@
+"""
+The functions in this module are used to validate schemas with the
+`format JSON Schema keyword
+`_.
+
+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[0-9]+)!)?                           # epoch
+        (?P[0-9]+(?:\.[0-9]+)*)                  # release segment
+        (?P
                                          # pre-release
+            [-_\.]?
+            (?Palpha|a|beta|b|preview|pre|c|rc)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+        (?P                                         # post release
+            (?:-(?P[0-9]+))
+            |
+            (?:
+                [-_\.]?
+                (?Ppost|rev|r)
+                [-_\.]?
+                (?P[0-9]+)?
+            )
+        )?
+        (?P                                          # dev release
+            [-_\.]?
+            (?Pdev)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+    )
+    (?:\+(?P[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 `
+    (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 `
+    (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 `
+        (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
+    ` (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 ``-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
+    `.
+    """
+    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
+    `.
+    """
+    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
+    `.
+    """
+    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
+        ` (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
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/distutils.schema.json b/venv/lib/python3.12/site-packages/setuptools/config/distutils.schema.json
new file mode 100644
index 0000000..93cd2e8
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/distutils.schema.json
@@ -0,0 +1,26 @@
+{
+  "$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",
+    "`_.",
+    "See also `the old Python docs _`."
+  ],
+
+  "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?"
+}
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/expand.py b/venv/lib/python3.12/site-packages/setuptools/config/expand.py
new file mode 100644
index 0000000..531f965
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/expand.py
@@ -0,0 +1,452 @@
+"""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())
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/pyprojecttoml.py b/venv/lib/python3.12/site-packages/setuptools/config/pyprojecttoml.py
new file mode 100644
index 0000000..fd6c596
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/pyprojecttoml.py
@@ -0,0 +1,468 @@
+"""
+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]?"
+    )
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/setupcfg.py b/venv/lib/python3.12/site-packages/setuptools/config/setupcfg.py
new file mode 100644
index 0000000..633aa9d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/setupcfg.py
@@ -0,0 +1,780 @@
+"""
+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 (";")
+        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"
diff --git a/venv/lib/python3.12/site-packages/setuptools/config/setuptools.schema.json b/venv/lib/python3.12/site-packages/setuptools/config/setuptools.schema.json
new file mode 100644
index 0000000..ec887b3
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/config/setuptools.schema.json
@@ -0,0 +1,433 @@
+{
+  "$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",
+    "`_",
+    "used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.",
+    "It considers only ``setuptools`` `parameters",
+    "`_",
+    "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",
+        "`_."
+      ],
+      "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",
+        "`_."
+      ],
+      "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",
+        "`_."
+      ],
+      "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",
+        "`_."
+      ],
+      "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",
+            "`_."
+          ]
+        },
+        {"$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",
+            "`_."
+          ],
+          "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"
+              ]
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/venv/lib/python3.12/site-packages/setuptools/depends.py b/venv/lib/python3.12/site-packages/setuptools/depends.py
new file mode 100644
index 0000000..e5223b7
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/depends.py
@@ -0,0 +1,185 @@
+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']
diff --git a/venv/lib/python3.12/site-packages/setuptools/discovery.py b/venv/lib/python3.12/site-packages/setuptools/discovery.py
new file mode 100644
index 0000000..c888399
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/discovery.py
@@ -0,0 +1,614 @@
+"""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}
diff --git a/venv/lib/python3.12/site-packages/setuptools/dist.py b/venv/lib/python3.12/site-packages/setuptools/dist.py
new file mode 100644
index 0000000..f06298c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/dist.py
@@ -0,0 +1,1119 @@
+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
+
+
+__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 ": 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]:
+        """
+        >>> getfixture('sample_project_cwd')
+        >>> list(Distribution._expand_patterns(['LICENSE.txt']))
+        ['LICENSE.txt']
+        >>> list(Distribution._expand_patterns(['pyproject.toml', 'LIC*']))
+        ['pyproject.toml', 'LICENSE.txt']
+        >>> list(Distribution._expand_patterns(['src/**/*.dat']))
+        ['src/sample/package_data.dat']
+        """
+        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"""
+        >>> getfixture('sample_project_cwd')
+        >>> Distribution._find_pattern("LICENSE.txt")
+        ['LICENSE.txt']
+        >>> 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[metadata.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."""
diff --git a/venv/lib/python3.12/site-packages/setuptools/errors.py b/venv/lib/python3.12/site-packages/setuptools/errors.py
new file mode 100644
index 0000000..990ecbf
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/errors.py
@@ -0,0 +1,67 @@
+"""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.
+    """
diff --git a/venv/lib/python3.12/site-packages/setuptools/extension.py b/venv/lib/python3.12/site-packages/setuptools/extension.py
new file mode 100644
index 0000000..76e03d9
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/extension.py
@@ -0,0 +1,177 @@
+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
+    ``.`` (with ```` derived from ``name`` and
+    ```` 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 `.
+
+    :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"""
diff --git a/venv/lib/python3.12/site-packages/setuptools/glob.py b/venv/lib/python3.12/site-packages/setuptools/glob.py
new file mode 100644
index 0000000..1dfff2c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/glob.py
@@ -0,0 +1,185 @@
+"""
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/installer.py b/venv/lib/python3.12/site-packages/setuptools/installer.py
new file mode 100644
index 0000000..2c26e3a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/installer.py
@@ -0,0 +1,155 @@
+from __future__ import annotations
+
+import glob
+import itertools
+import os
+import subprocess
+import sys
+import tempfile
+
+import packaging.requirements
+import packaging.utils
+
+from . import _reqs
+from ._importlib import metadata
+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 _present(req):
+    return any(_dist_matches_req(dist, req) for dist in metadata.distributions())
+
+
+def _fetch_build_eggs(dist, requires: _reqs._StrOrIter) -> list[metadata.Distribution]:
+    _DeprecatedInstaller.emit(stacklevel=3)
+    _warn_wheel_not_available(dist)
+
+    parsed_reqs = _reqs.parse(requires)
+
+    missing_reqs = itertools.filterfalse(_present, parsed_reqs)
+
+    needed_reqs = (
+        req for req in missing_reqs if not req.marker or req.marker.evaluate()
+    )
+    resolved_dists = [_fetch_build_egg_no_warn(dist, req) for req in needed_reqs]
+    for dist in resolved_dists:
+        # dist.locate_file('') is the directory containing EGG-INFO, where the importabl
+        # contents can be found.
+        sys.path.insert(0, str(dist.locate_file('')))
+    return resolved_dists
+
+
+def _dist_matches_req(egg_dist, req):
+    return (
+        packaging.utils.canonicalize_name(egg_dist.name)
+        == packaging.utils.canonicalize_name(req.name)
+        and egg_dist.version in req.specifier
+    )
+
+
+def _fetch_build_egg_no_warn(dist, req):  # noqa: C901  # is too complex (16)  # FIXME
+    # 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())
+    cached_dists = metadata.Distribution.discover(path=glob.glob(f'{eggs_dir}/*.egg'))
+    for egg_dist in cached_dists:
+        if _dist_matches_req(egg_dist, req):
+            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)
+        return metadata.Distribution.at(dist_location + '/EGG-INFO')
+
+
+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.
+    """
+    # create a copy to avoid mutating the input
+    req = packaging.requirements.Requirement(str(req))
+    req.marker = None
+    return req
+
+
+def _warn_wheel_not_available(dist):
+    try:
+        metadata.distribution('wheel')
+    except metadata.PackageNotFoundError:
+        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 = 2025, 10, 31
diff --git a/venv/lib/python3.12/site-packages/setuptools/launch.py b/venv/lib/python3.12/site-packages/setuptools/launch.py
new file mode 100644
index 0000000..0d16264
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/launch.py
@@ -0,0 +1,36 @@
+"""
+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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/logging.py b/venv/lib/python3.12/site-packages/setuptools/logging.py
new file mode 100644
index 0000000..532da89
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/logging.py
@@ -0,0 +1,40 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/modified.py b/venv/lib/python3.12/site-packages/setuptools/modified.py
new file mode 100644
index 0000000..6ba02fa
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/modified.py
@@ -0,0 +1,18 @@
+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']
diff --git a/venv/lib/python3.12/site-packages/setuptools/monkey.py b/venv/lib/python3.12/site-packages/setuptools/monkey.py
new file mode 100644
index 0000000..6ad1aba
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/monkey.py
@@ -0,0 +1,126 @@
+"""
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/msvc.py b/venv/lib/python3.12/site-packages/setuptools/msvc.py
new file mode 100644
index 0000000..313a781
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/msvc.py
@@ -0,0 +1,1536 @@
+"""
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/namespaces.py b/venv/lib/python3.12/site-packages/setuptools/namespaces.py
new file mode 100644
index 0000000..85ea2eb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/namespaces.py
@@ -0,0 +1,106 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/script (dev).tmpl b/venv/lib/python3.12/site-packages/setuptools/script (dev).tmpl
new file mode 100644
index 0000000..39a24b0
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/script (dev).tmpl	
@@ -0,0 +1,6 @@
+# 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'))
diff --git a/venv/lib/python3.12/site-packages/setuptools/script.tmpl b/venv/lib/python3.12/site-packages/setuptools/script.tmpl
new file mode 100644
index 0000000..ff5efbc
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/script.tmpl
@@ -0,0 +1,3 @@
+# EASY-INSTALL-SCRIPT: %(spec)r,%(script_name)r
+__requires__ = %(spec)r
+__import__('pkg_resources').run_script(%(spec)r, %(script_name)r)
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/__init__.py b/venv/lib/python3.12/site-packages/setuptools/tests/__init__.py
new file mode 100644
index 0000000..eb70bfb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/__init__.py
@@ -0,0 +1,13 @@
+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")
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/compat/__init__.py b/venv/lib/python3.12/site-packages/setuptools/tests/compat/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/compat/py39.py b/venv/lib/python3.12/site-packages/setuptools/tests/compat/py39.py
new file mode 100644
index 0000000..1fdb9da
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/compat/py39.py
@@ -0,0 +1,3 @@
+from jaraco.test.cpython import from_test_support, try_import
+
+os_helper = try_import('os_helper') or from_test_support('can_symlink')
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/config/__init__.py b/venv/lib/python3.12/site-packages/setuptools/tests/config/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/config/downloads/__init__.py b/venv/lib/python3.12/site-packages/setuptools/tests/config/downloads/__init__.py
new file mode 100644
index 0000000..00a1642
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/config/downloads/__init__.py
@@ -0,0 +1,59 @@
+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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/config/downloads/preload.py b/venv/lib/python3.12/site-packages/setuptools/tests/config/downloads/preload.py
new file mode 100644
index 0000000..8eeb5dd
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/config/downloads/preload.py
@@ -0,0 +1,18 @@
+"""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))
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/config/setupcfg_examples.txt b/venv/lib/python3.12/site-packages/setuptools/tests/config/setupcfg_examples.txt
new file mode 100644
index 0000000..6aab887
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/config/setupcfg_examples.txt
@@ -0,0 +1,22 @@
+# ====================================================================
+# 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/config/test_apply_pyprojecttoml.py b/venv/lib/python3.12/site-packages/setuptools/tests/config/test_apply_pyprojecttoml.py
new file mode 100644
index 0000000..489fd98
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/config/test_apply_pyprojecttoml.py
@@ -0,0 +1,772 @@
+"""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 , "John X. Ãørçeč" , '
+                'Γαμα קּ 東 '
+            ),
+            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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/config/test_expand.py b/venv/lib/python3.12/site-packages/setuptools/tests/config/test_expand.py
new file mode 100644
index 0000000..c5710ec
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/config/test_expand.py
@@ -0,0 +1,247 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml.py b/venv/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml.py
new file mode 100644
index 0000000..db40fcd
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml.py
@@ -0,0 +1,396 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml_dynamic_deps.py b/venv/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml_dynamic_deps.py
new file mode 100644
index 0000000..e42f28f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml_dynamic_deps.py
@@ -0,0 +1,109 @@
+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"]}
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/config/test_setupcfg.py b/venv/lib/python3.12/site-packages/setuptools/tests/config/test_setupcfg.py
new file mode 100644
index 0000000..61af990
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/config/test_setupcfg.py
@@ -0,0 +1,980 @@
+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/',
+        }
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/contexts.py b/venv/lib/python3.12/site-packages/setuptools/tests/contexts.py
new file mode 100644
index 0000000..3c931bb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/contexts.py
@@ -0,0 +1,131 @@
+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 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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/environment.py b/venv/lib/python3.12/site-packages/setuptools/tests/environment.py
new file mode 100644
index 0000000..ed5499e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/environment.py
@@ -0,0 +1,95 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/fixtures.py b/venv/lib/python3.12/site-packages/setuptools/tests/fixtures.py
new file mode 100644
index 0000000..27a1698
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/fixtures.py
@@ -0,0 +1,392 @@
+import contextlib
+import io
+import os
+import subprocess
+import sys
+import tarfile
+import time
+from pathlib import Path
+
+import jaraco.path
+import path
+import pytest
+
+from setuptools._normalization import safer_name
+
+from . import contexts, environment
+from .textwrap import DALS
+
+
+@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'
+
+
+@pytest.fixture
+def sample_project_cwd(sample_project):
+    with path.Path(sample_project):
+        yield
+
+
+# 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
+
+
+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 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 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.fixture
+def pbr_package(tmp_path, monkeypatch, venv):
+    files = {
+        "pyproject.toml": DALS(
+            """
+            [build-system]
+            requires = ["setuptools"]
+            build-backend = "setuptools.build_meta"
+            """
+        ),
+        "setup.py": DALS(
+            """
+            __import__('setuptools').setup(
+                pbr=True,
+                setup_requires=["pbr"],
+            )
+            """
+        ),
+        "setup.cfg": DALS(
+            """
+            [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"])
+    prefix = tmp_path / 'mypkg'
+    prefix.mkdir()
+    jaraco.path.build(files, prefix=prefix)
+    monkeypatch.setenv('PBR_VERSION', "0.42")
+    return prefix
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/external.html b/venv/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/external.html
new file mode 100644
index 0000000..92e4702
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/external.html
@@ -0,0 +1,3 @@
+
+bad old link
+
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/simple/foobar/index.html b/venv/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/simple/foobar/index.html
new file mode 100644
index 0000000..fefb028
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/simple/foobar/index.html
@@ -0,0 +1,4 @@
+
+foobar-0.1.tar.gz

+external homepage

+
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/integration/__init__.py b/venv/lib/python3.12/site-packages/setuptools/tests/integration/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/integration/helpers.py b/venv/lib/python3.12/site-packages/setuptools/tests/integration/helpers.py
new file mode 100644
index 0000000..77b196e
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/integration/helpers.py
@@ -0,0 +1,77 @@
+"""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())
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/integration/test_pbr.py b/venv/lib/python3.12/site-packages/setuptools/tests/integration/test_pbr.py
new file mode 100644
index 0000000..f89e5b8
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/integration/test_pbr.py
@@ -0,0 +1,20 @@
+import subprocess
+
+import pytest
+
+
+@pytest.mark.uses_network
+def test_pbr_integration(pbr_package, venv):
+    """Ensure pbr packages install."""
+    cmd = [
+        'python',
+        '-m',
+        'pip',
+        '-v',
+        'install',
+        '--no-build-isolation',
+        pbr_package,
+    ]
+    venv.run(cmd, stderr=subprocess.STDOUT)
+    out = venv.run(["python", "-c", "import mypkg.hello"])
+    assert "Hello world!" in out
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/integration/test_pip_install_sdist.py b/venv/lib/python3.12/site-packages/setuptools/tests/integration/test_pip_install_sdist.py
new file mode 100644
index 0000000..4e84f21
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/integration/test_pip_install_sdist.py
@@ -0,0 +1,223 @@
+# 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, "")
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/mod_with_constant.py b/venv/lib/python3.12/site-packages/setuptools/tests/mod_with_constant.py
new file mode 100644
index 0000000..ef755dd
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/mod_with_constant.py
@@ -0,0 +1 @@
+value = 'three, sir!'
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/namespaces.py b/venv/lib/python3.12/site-packages/setuptools/tests/namespaces.py
new file mode 100644
index 0000000..248db98
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/namespaces.py
@@ -0,0 +1,90 @@
+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')
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/script-with-bom.py b/venv/lib/python3.12/site-packages/setuptools/tests/script-with-bom.py
new file mode 100644
index 0000000..c074d26
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/script-with-bom.py
@@ -0,0 +1 @@
+result = 'passed'
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_archive_util.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_archive_util.py
new file mode 100644
index 0000000..e3efc62
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_archive_util.py
@@ -0,0 +1,36 @@
+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))
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_bdist_deprecations.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_bdist_deprecations.py
new file mode 100644
index 0000000..d9d67b0
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_bdist_deprecations.py
@@ -0,0 +1,28 @@
+"""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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_bdist_egg.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_bdist_egg.py
new file mode 100644
index 0000000..036167d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_bdist_egg.py
@@ -0,0 +1,73 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_bdist_wheel.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_bdist_wheel.py
new file mode 100644
index 0000000..2ab4e9c
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_bdist_wheel.py
@@ -0,0 +1,708 @@
+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č" , Γαμα קּ 東 
+            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 ",
+    }
+
+
+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č" , Γαμα קּ 東 
+
+
+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 
+
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_build.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_build.py
new file mode 100644
index 0000000..f0f1d9d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_build.py
@@ -0,0 +1,33 @@
+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")
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_build_clib.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_build_clib.py
new file mode 100644
index 0000000..b5315df
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_build_clib.py
@@ -0,0 +1,84 @@
+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]
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_build_ext.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_build_ext.py
new file mode 100644
index 0000000..c7b60ac
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_build_ext.py
@@ -0,0 +1,293 @@
+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}'
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_build_meta.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_build_meta.py
new file mode 100644
index 0000000..57162fd
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_build_meta.py
@@ -0,0 +1,959 @@
+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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_build_py.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_build_py.py
new file mode 100644
index 0000000..1e3a660
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_build_py.py
@@ -0,0 +1,480 @@
+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()
+    }
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_config_discovery.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_config_discovery.py
new file mode 100644
index 0000000..b5df820
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_config_discovery.py
@@ -0,0 +1,647 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_core_metadata.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_core_metadata.py
new file mode 100644
index 0000000..0d92511
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_core_metadata.py
@@ -0,0 +1,622 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_depends.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_depends.py
new file mode 100644
index 0000000..1714c04
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_depends.py
@@ -0,0 +1,15 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_develop.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_develop.py
new file mode 100644
index 0000000..354c51f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_develop.py
@@ -0,0 +1,112 @@
+"""develop tests"""
+
+import os
+import platform
+import subprocess
+import sys
+
+import pytest
+
+from setuptools._path import paths_on_pythonpath
+
+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 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",
+    )
+    @pytest.mark.uses_network
+    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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_dist.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_dist.py
new file mode 100644
index 0000000..552ee2d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_dist.py
@@ -0,0 +1,278 @@
+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 .fixtures 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(
+                    """
+                
+                {dist_sdist}

+                
+                """
+                ).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.name 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 "
+            " (got '*.msg')"
+        ),
+    ),
+    # Invalid value type (generators are single use)
+    (
+        {
+            'hello': (x for x in "generator"),
+        },
+        (
+            "\"values of 'package_data' dict\" must be of type "
+            " (got =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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_dist_info.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_dist_info.py
new file mode 100644
index 0000000..010018d
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_dist_info.py
@@ -0,0 +1,147 @@
+"""Test .dist-info style distributions."""
+
+import pathlib
+import re
+import shutil
+import subprocess
+import sys
+from functools import partial
+
+import pytest
+
+from setuptools.archive_util import unpack_archive
+
+from .textwrap import DALS
+
+read = partial(pathlib.Path.read_text, encoding="utf-8")
+
+
+class TestDistInfo:
+    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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_distutils_adoption.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_distutils_adoption.py
new file mode 100644
index 0000000..f99a588
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_distutils_adoption.py
@@ -0,0 +1,198 @@
+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"
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_editable_install.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_editable_install.py
new file mode 100644
index 0000000..225fc6a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_editable_install.py
@@ -0,0 +1,1263 @@
+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 (
+    _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
+
+
+@pytest.mark.uses_network
+def test_pbr_integration(pbr_package, venv, editable_opts):
+    """Ensure editable installs work with pbr, issue #3500"""
+    cmd = [
+        'python',
+        '-m',
+        'pip',
+        '-v',
+        'install',
+        '--editable',
+        pbr_package,
+        *editable_opts,
+    ]
+    venv.run(cmd, stderr=subprocess.STDOUT)
+    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)
+
+    with pytest.raises(SimulatedErr) as ctx:
+        cmd.run()
+    assert any('debugging-tips' in note for note in ctx.value.__notes__)
+
+
+@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("//", "/")
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_egg_info.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_egg_info.py
new file mode 100644
index 0000000..3653be0
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_egg_info.py
@@ -0,0 +1,1306 @@
+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 `.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 `.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 `.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"(Invalid object reference|Problems to parse)"
+        with pytest.raises((errors.OptionError, ValueError), 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]
+            assert "invalid-identifier" in str(ex.value)
+
+    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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_extern.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_extern.py
new file mode 100644
index 0000000..d7eb3c6
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_extern.py
@@ -0,0 +1,15 @@
+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()))
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_find_packages.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_find_packages.py
new file mode 100644
index 0000000..9fd9f8f
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_find_packages.py
@@ -0,0 +1,218 @@
+"""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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_find_py_modules.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_find_py_modules.py
new file mode 100644
index 0000000..8034b54
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_find_py_modules.py
@@ -0,0 +1,73 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_glob.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_glob.py
new file mode 100644
index 0000000..8d225a4
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_glob.py
@@ -0,0 +1,45 @@
+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))
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_install_scripts.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_install_scripts.py
new file mode 100644
index 0000000..e62a6b7
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_install_scripts.py
@@ -0,0 +1,89 @@
+"""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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_logging.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_logging.py
new file mode 100644
index 0000000..ea58001
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_logging.py
@@ -0,0 +1,76 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_manifest.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_manifest.py
new file mode 100644
index 0000000..903a528
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_manifest.py
@@ -0,0 +1,622 @@
+"""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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_namespaces.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_namespaces.py
new file mode 100644
index 0000000..a0f4120
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_namespaces.py
@@ -0,0 +1,138 @@
+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))
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_scripts.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_scripts.py
new file mode 100644
index 0000000..8641f7b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_scripts.py
@@ -0,0 +1,12 @@
+from setuptools import _scripts
+
+
+class TestWindowsScriptWriter:
+    def test_header(self):
+        hdr = _scripts.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('\\"')
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_sdist.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_sdist.py
new file mode 100644
index 0000000..19d8ddf
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_sdist.py
@@ -0,0 +1,984 @@
+"""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}"
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_setopt.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_setopt.py
new file mode 100644
index 0000000..ccf2561
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_setopt.py
@@ -0,0 +1,40 @@
+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
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_setuptools.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_setuptools.py
new file mode 100644
index 0000000..1d56e1a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_setuptools.py
@@ -0,0 +1,290 @@
+"""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
+    )
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_shutil_wrapper.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_shutil_wrapper.py
new file mode 100644
index 0000000..74ff7e9
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_shutil_wrapper.py
@@ -0,0 +1,23 @@
+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()
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_unicode_utils.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_unicode_utils.py
new file mode 100644
index 0000000..a24a9bd
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_unicode_utils.py
@@ -0,0 +1,10 @@
+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')
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_virtualenv.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_virtualenv.py
new file mode 100644
index 0000000..b02949b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_virtualenv.py
@@ -0,0 +1,113 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_warnings.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_warnings.py
new file mode 100644
index 0000000..41193d4
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_warnings.py
@@ -0,0 +1,106 @@
+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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_wheel.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_wheel.py
new file mode 100644
index 0000000..f914650
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_wheel.py
@@ -0,0 +1,690 @@
+"""wheel tests"""
+
+from __future__ import annotations
+
+import contextlib
+import glob
+import inspect
+import os
+import pathlib
+import stat
+import subprocess
+import sys
+import sysconfig
+import zipfile
+from typing import Any
+
+import pytest
+from jaraco import path
+from packaging.tags import parse_tag
+
+from setuptools._importlib import metadata
+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=sysconfig.get_python_version(),
+            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
+
+    (dist,) = metadata.Distribution.discover(path=[egg_path])
+
+    # pyright is nitpicky; fine to assume dist.metadata.__getitem__ will fail or return None
+    # (https://github.com/pypa/setuptools/pull/5006#issuecomment-2894774288)
+    assert dist.metadata['Name'] == project_name  # pyright: ignore  # noqa: PGH003
+    assert dist.metadata['Version'] == version  # pyright: ignore  # noqa: PGH003
+    assert dist.read_text('requires.txt') == requires_txt
+
+
+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='\n'
+        + 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_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"
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/test_windows_wrappers.py b/venv/lib/python3.12/site-packages/setuptools/tests/test_windows_wrappers.py
new file mode 100644
index 0000000..4f990eb
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/test_windows_wrappers.py
@@ -0,0 +1,258 @@
+"""
+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
+
+from setuptools._importlib import resources
+
+pytestmark = pytest.mark.skipif(sys.platform != 'win32', reason="Windows only")
+
+
+class WrapperTester:
+    @classmethod
+    def prep_script(cls, template):
+        python_exe = subprocess.list2cmdline([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 = resources.files('setuptools').joinpath(cls.wrapper_source).read_bytes()
+            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')
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/text.py b/venv/lib/python3.12/site-packages/setuptools/tests/text.py
new file mode 100644
index 0000000..e05cc63
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/text.py
@@ -0,0 +1,4 @@
+class Filenames:
+    unicode = 'smörbröd.py'
+    latin_1 = unicode.encode('latin-1')
+    utf_8 = unicode.encode('utf-8')
diff --git a/venv/lib/python3.12/site-packages/setuptools/tests/textwrap.py b/venv/lib/python3.12/site-packages/setuptools/tests/textwrap.py
new file mode 100644
index 0000000..5e39618
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/tests/textwrap.py
@@ -0,0 +1,6 @@
+import textwrap
+
+
+def DALS(s):
+    "dedent and left-strip"
+    return textwrap.dedent(s).lstrip()
diff --git a/venv/lib/python3.12/site-packages/setuptools/unicode_utils.py b/venv/lib/python3.12/site-packages/setuptools/unicode_utils.py
new file mode 100644
index 0000000..f502f5b
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/unicode_utils.py
@@ -0,0 +1,102 @@
+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...
diff --git a/venv/lib/python3.12/site-packages/setuptools/version.py b/venv/lib/python3.12/site-packages/setuptools/version.py
new file mode 100644
index 0000000..ec253c4
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/version.py
@@ -0,0 +1,6 @@
+from ._importlib import metadata
+
+try:
+    __version__ = metadata.version('setuptools') or '0.dev0+unknown'
+except Exception:
+    __version__ = '0.dev0+unknown'
diff --git a/venv/lib/python3.12/site-packages/setuptools/warnings.py b/venv/lib/python3.12/site-packages/setuptools/warnings.py
new file mode 100644
index 0000000..9646778
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/warnings.py
@@ -0,0 +1,110 @@
+"""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")
diff --git a/venv/lib/python3.12/site-packages/setuptools/wheel.py b/venv/lib/python3.12/site-packages/setuptools/wheel.py
new file mode 100644
index 0000000..124e01a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/wheel.py
@@ -0,0 +1,261 @@
+"""Wheels support."""
+
+import contextlib
+import email
+import functools
+import itertools
+import os
+import posixpath
+import re
+import zipfile
+
+from packaging.requirements import Requirement
+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 ._discovery import extras_from_deps
+from ._importlib import metadata
+from .unicode_utils import _read_utf8_with_fallback
+
+from distutils.util import get_platform
+
+WHEEL_NAME = re.compile(
+    r"""^(?P.+?)-(?P\d.*?)
+    ((-(?P\d.*?))?-(?P.+?)-(?P.+?)-(?P.+?)
+    )\.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):
+        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)
+        dist_info = os.path.join(destination_eggdir, dist_info)
+        install_requires, extras_require = Wheel._convert_requires(
+            destination_eggdir, dist_info
+        )
+        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 _convert_requires(destination_eggdir, dist_info):
+        md = metadata.Distribution.at(dist_info).metadata
+        deps = md.get_all('Requires-Dist') or []
+        reqs = list(map(Requirement, deps))
+
+        extras = extras_from_deps(deps)
+
+        # 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 = Requirement(str(req))
+            req.marker = None
+            return str(req)
+
+        def eval(req, **env):
+            return not req.marker or req.marker.evaluate(env)
+
+        def for_extra(req):
+            try:
+                markers = req.marker._markers
+            except AttributeError:
+                markers = ()
+            return set(
+                marker[2].value
+                for marker in markers
+                if isinstance(marker, tuple) and marker[0].value == 'extra'
+            )
+
+        install_requires = list(
+            map(raw_req, filter(eval, itertools.filterfalse(for_extra, reqs)))
+        )
+        extras_require = {
+            extra: list(
+                map(
+                    raw_req,
+                    (req for req in reqs if for_extra(req) and eval(req, extra=extra)),
+                )
+            )
+            for extra in extras
+        }
+        return install_requires, extras_require
+
+    @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)
diff --git a/venv/lib/python3.12/site-packages/setuptools/windows_support.py b/venv/lib/python3.12/site-packages/setuptools/windows_support.py
new file mode 100644
index 0000000..7a2b53a
--- /dev/null
+++ b/venv/lib/python3.12/site-packages/setuptools/windows_support.py
@@ -0,0 +1,30 @@
+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()