Add setuptools stubs (#5762)

stubs/setuptools/METADATA.toml

@@ -1 +1 @@
-version = "57.0"
+version = "57.4"

stubs/setuptools/setuptools/__init__.pyi

@@ -0,0 +1,77 @@
+from abc import abstractmethod
+from collections.abc import Iterable, Mapping
+from distutils.core import Command as _Command
+from typing import Any, Type
+
+from setuptools._deprecation_warning import SetuptoolsDeprecationWarning as SetuptoolsDeprecationWarning
+from setuptools.depends import Require as Require
+from setuptools.dist import Distribution as Distribution
+from setuptools.extension import Extension as Extension
+
+__version__: str
+
+class PackageFinder:
+    @classmethod
+    def find(cls, where: str = ..., exclude: Iterable[str] = ..., include: Iterable[str] = ...) -> list[str]: ...
+
+class PEP420PackageFinder(PackageFinder): ...
+
+find_packages = PackageFinder.find
+find_namespace_packages = PEP420PackageFinder.find
+
+def setup(
+    *,
+    name: str = ...,
+    version: str = ...,
+    description: str = ...,
+    long_description: str = ...,
+    author: str = ...,
+    author_email: str = ...,
+    maintainer: str = ...,
+    maintainer_email: str = ...,
+    url: str = ...,
+    download_url: str = ...,
+    packages: list[str] = ...,
+    py_modules: list[str] = ...,
+    scripts: list[str] = ...,
+    ext_modules: list[Extension] = ...,
+    classifiers: list[str] = ...,
+    distclass: Type[Distribution] = ...,
+    script_name: str = ...,
+    script_args: list[str] = ...,
+    options: Mapping[str, Any] = ...,
+    license: str = ...,
+    keywords: list[str] | str = ...,
+    platforms: list[str] | str = ...,
+    cmdclass: Mapping[str, Type[Command]] = ...,
+    data_files: list[tuple[str, list[str]]] = ...,
+    package_dir: Mapping[str, str] = ...,
+    obsoletes: list[str] = ...,
+    provides: list[str] = ...,
+    requires: list[str] = ...,
+    command_packages: list[str] = ...,
+    command_options: Mapping[str, Mapping[str, tuple[Any, Any]]] = ...,
+    package_data: Mapping[str, list[str]] = ...,
+    include_package_data: bool = ...,
+    libraries: list[str] = ...,
+    headers: list[str] = ...,
+    ext_package: str = ...,
+    include_dirs: list[str] = ...,
+    password: str = ...,
+    fullname: str = ...,
+    **attrs: Any,
+) -> None: ...
+
+class Command(_Command):
+    command_consumes_arguments: bool
+    def __init__(self, dist: Distribution, **kw: Any) -> None: ...
+    def ensure_string_list(self, option: str | list[str]) -> None: ...
+    def reinitialize_command(self, command: _Command | str, reinit_subcommands: int = ..., **kw: Any) -> _Command: ...
+    @abstractmethod
+    def initialize_options(self) -> None: ...
+    @abstractmethod
+    def finalize_options(self) -> None: ...
+    @abstractmethod
+    def run(self) -> None: ...
+
+class sic(str): ...

stubs/setuptools/setuptools/_deprecation_warning.pyi

@@ -0,0 +1 @@
+class SetuptoolsDeprecationWarning(Warning): ...

stubs/setuptools/setuptools/archive_util.pyi

@@ -0,0 +1,12 @@
+from distutils.errors import DistutilsError
+from typing import Any
+
+class UnrecognizedFormat(DistutilsError): ...
+
+def default_filter(src, dst): ...
+def unpack_archive(filename, extract_dir, progress_filter=..., drivers: Any | None = ...) -> None: ...
+def unpack_directory(filename, extract_dir, progress_filter=...) -> None: ...
+def unpack_zipfile(filename, extract_dir, progress_filter=...) -> None: ...
+def unpack_tarfile(filename, extract_dir, progress_filter=...): ...
+
+extraction_drivers: Any

stubs/setuptools/setuptools/build_meta.pyi

@@ -0,0 +1,30 @@
+from typing import Any
+
+from setuptools import dist
+
+class SetupRequirementsError(BaseException):
+    specifiers: Any
+    def __init__(self, specifiers) -> None: ...
+
+class Distribution(dist.Distribution):
+    def fetch_build_eggs(self, specifiers) -> None: ...
+    @classmethod
+    def patch(cls) -> None: ...
+
+class _BuildMetaBackend:
+    def run_setup(self, setup_script: str = ...) -> None: ...
+    def get_requires_for_build_wheel(self, config_settings: Any | None = ...): ...
+    def get_requires_for_build_sdist(self, config_settings: Any | None = ...): ...
+    def prepare_metadata_for_build_wheel(self, metadata_directory, config_settings: Any | None = ...): ...
+    def build_wheel(self, wheel_directory, config_settings: Any | None = ..., metadata_directory: Any | None = ...): ...
+    def build_sdist(self, sdist_directory, config_settings: Any | None = ...): ...
+
+class _BuildMetaLegacyBackend(_BuildMetaBackend):
+    def run_setup(self, setup_script: str = ...) -> None: ...
+
+get_requires_for_build_wheel: Any
+get_requires_for_build_sdist: Any
+prepare_metadata_for_build_wheel: Any
+build_wheel: Any
+build_sdist: Any
+__legacy__: Any

stubs/setuptools/setuptools/command/alias.pyi

@@ -0,0 +1,18 @@
+from typing import Any
+
+from setuptools.command.setopt import option_base
+
+def shquote(arg): ...
+
+class alias(option_base):
+    description: str
+    command_consumes_arguments: bool
+    user_options: Any
+    boolean_options: Any
+    args: Any
+    remove: Any
+    def initialize_options(self) -> None: ...
+    def finalize_options(self) -> None: ...
+    def run(self) -> None: ...
+
+def format_alias(name, aliases): ...

stubs/setuptools/setuptools/command/bdist_egg.pyi

@@ -0,0 +1,48 @@
+from typing import Any
+
+from setuptools import Command
+
+def strip_module(filename): ...
+def sorted_walk(dir) -> None: ...
+def write_stub(resource, pyfile) -> None: ...
+
+class bdist_egg(Command):
+    description: str
+    user_options: Any
+    boolean_options: Any
+    bdist_dir: Any
+    plat_name: Any
+    keep_temp: int
+    dist_dir: Any
+    skip_build: int
+    egg_output: Any
+    exclude_source_files: Any
+    def initialize_options(self) -> None: ...
+    egg_info: Any
+    def finalize_options(self) -> None: ...
+    def do_install_data(self) -> None: ...
+    def get_outputs(self): ...
+    def call_command(self, cmdname, **kw): ...
+    stubs: Any
+    def run(self) -> None: ...
+    def zap_pyfiles(self) -> None: ...
+    def zip_safe(self): ...
+    def gen_header(self): ...
+    def copy_metadata_to(self, target_dir) -> None: ...
+    def get_ext_outputs(self): ...
+
+NATIVE_EXTENSIONS: Any
+
+def walk_egg(egg_dir) -> None: ...
+def analyze_egg(egg_dir, stubs): ...
+def write_safety_flag(egg_dir, safe) -> None: ...
+
+safety_flags: Any
+
+def scan_module(egg_dir, base, name, stubs): ...
+def iter_symbols(code) -> None: ...
+def can_scan(): ...
+
+INSTALL_DIRECTORY_ATTRS: Any
+
+def make_zipfile(zip_filename, base_dir, verbose: int = ..., dry_run: int = ..., compress: bool = ..., mode: str = ...): ...

stubs/setuptools/setuptools/command/bdist_rpm.pyi

@@ -0,0 +1,4 @@
+import distutils.command.bdist_rpm as orig
+
+class bdist_rpm(orig.bdist_rpm):
+    def run(self) -> None: ...

stubs/setuptools/setuptools/command/build_clib.pyi

@@ -0,0 +1,4 @@
+import distutils.command.build_clib as orig
+
+class build_clib(orig.build_clib):
+    def build_libraries(self, libraries) -> None: ...

stubs/setuptools/setuptools/command/build_ext.pyi

@@ -0,0 +1,44 @@
+from distutils.command.build_ext import build_ext as _build_ext
+from typing import Any
+
+have_rtld: bool
+use_stubs: bool
+libtype: str
+
+def if_dl(s): ...
+def get_abi3_suffix(): ...
+
+class build_ext(_build_ext):
+    inplace: Any
+    def run(self) -> None: ...
+    def copy_extensions_to_source(self) -> None: ...
+    def get_ext_filename(self, fullname): ...
+    shlib_compiler: Any
+    shlibs: Any
+    ext_map: Any
+    def initialize_options(self) -> None: ...
+    extensions: Any
+    def finalize_options(self) -> None: ...
+    def setup_shlib_compiler(self) -> None: ...
+    def get_export_symbols(self, ext): ...
+    compiler: Any
+    def build_extension(self, ext) -> None: ...
+    def links_to_dynamic(self, ext): ...
+    def get_outputs(self): ...
+    def write_stub(self, output_dir, ext, compile: bool = ...) -> None: ...
+
+def link_shared_object(
+    self,
+    objects,
+    output_libname,
+    output_dir: Any | None = ...,
+    libraries: Any | None = ...,
+    library_dirs: Any | None = ...,
+    runtime_library_dirs: Any | None = ...,
+    export_symbols: Any | None = ...,
+    debug: int = ...,
+    extra_preargs: Any | None = ...,
+    extra_postargs: Any | None = ...,
+    build_temp: Any | None = ...,
+    target_lang: Any | None = ...,
+) -> None: ...

stubs/setuptools/setuptools/command/build_py.pyi

@@ -0,0 +1,27 @@
+import distutils.command.build_py as orig
+from typing import Any
+
+from setuptools.lib2to3_ex import Mixin2to3
+
+def make_writable(target) -> None: ...
+
+class build_py(orig.build_py, Mixin2to3):
+    package_data: Any
+    exclude_package_data: Any
+    def finalize_options(self) -> None: ...
+    def run(self) -> None: ...
+    data_files: Any
+    def __getattr__(self, attr): ...
+    def build_module(self, module, module_file, package): ...
+    def find_data_files(self, package, src_dir): ...
+    def build_package_data(self) -> None: ...
+    manifest_files: Any
+    def analyze_manifest(self) -> None: ...
+    def get_data_files(self) -> None: ...
+    def check_package(self, package, package_dir): ...
+    packages_checked: Any
+    def initialize_options(self) -> None: ...
+    def get_package_dir(self, package): ...
+    def exclude_data_files(self, package, src_dir, files): ...
+
+def assert_relative(path): ...

stubs/setuptools/setuptools/command/develop.pyi

@@ -0,0 +1,31 @@
+from typing import Any
+
+from setuptools import namespaces
+from setuptools.command.easy_install import easy_install
+
+class develop(namespaces.DevelopInstaller, easy_install):
+    description: str
+    user_options: Any
+    boolean_options: Any
+    command_consumes_arguments: bool
+    multi_version: bool
+    def run(self) -> None: ...  # type: ignore
+    uninstall: Any
+    egg_path: Any
+    setup_path: Any
+    always_copy_from: str
+    def initialize_options(self) -> None: ...
+    args: Any
+    egg_link: Any
+    egg_base: Any
+    dist: Any
+    def finalize_options(self) -> None: ...
+    def install_for_development(self) -> None: ...
+    def uninstall_link(self) -> None: ...
+    def install_egg_scripts(self, dist): ...
+    def install_wrapper_scripts(self, dist): ...
+
+class VersionlessRequirement:
+    def __init__(self, dist) -> None: ...
+    def __getattr__(self, name): ...
+    def as_requirement(self): ...

stubs/setuptools/setuptools/command/dist_info.pyi

@@ -0,0 +1,10 @@
+from distutils.core import Command
+from typing import Any
+
+class dist_info(Command):
+    description: str
+    user_options: Any
+    egg_base: Any
+    def initialize_options(self) -> None: ...
+    def finalize_options(self) -> None: ...
+    def run(self) -> None: ...

stubs/setuptools/setuptools/command/easy_install.pyi

@@ -0,0 +1,150 @@
+from typing import Any, List
+
+from pkg_resources import Environment
+from setuptools import Command, SetuptoolsDeprecationWarning
+
+def samefile(p1, p2): ...
+
+class easy_install(Command):
+    description: str
+    command_consumes_arguments: bool
+    user_options: Any
+    boolean_options: Any
+    negative_opt: Any
+    create_index: Any
+    user: int
+    zip_ok: Any
+    install_dir: Any
+    index_url: Any
+    find_links: Any
+    build_directory: Any
+    args: Any
+    optimize: Any
+    upgrade: Any
+    editable: Any
+    root: Any
+    version: Any
+    install_purelib: Any
+    install_platlib: Any
+    install_headers: Any
+    install_lib: Any
+    install_scripts: Any
+    install_data: Any
+    install_base: Any
+    install_platbase: Any
+    install_userbase: Any
+    install_usersite: Any
+    no_find_links: Any
+    package_index: Any
+    pth_file: Any
+    site_dirs: Any
+    installed_projects: Any
+    verbose: Any
+    def initialize_options(self) -> None: ...
+    def delete_blockers(self, blockers) -> None: ...
+    config_vars: Any
+    script_dir: Any
+    all_site_dirs: Any
+    shadow_path: Any
+    local_index: Any
+    outputs: Any
+    def finalize_options(self) -> None: ...
+    def expand_basedirs(self) -> None: ...
+    def expand_dirs(self) -> None: ...
+    def run(self, show_deprecation: bool = ...) -> None: ...
+    def pseudo_tempname(self): ...
+    def warn_deprecated_options(self) -> None: ...
+    def check_site_dir(self) -> None: ...
+    def cant_write_to_target(self) -> None: ...
+    def check_pth_processing(self): ...
+    def install_egg_scripts(self, dist) -> None: ...
+    def add_output(self, path) -> None: ...
+    def not_editable(self, spec) -> None: ...
+    def check_editable(self, spec) -> None: ...
+    def easy_install(self, spec, deps: bool = ...): ...
+    def install_item(self, spec, download, tmpdir, deps, install_needed: bool = ...): ...
+    def select_scheme(self, name) -> None: ...
+    def process_distribution(self, requirement, dist, deps: bool = ..., *info) -> None: ...
+    def should_unzip(self, dist): ...
+    def maybe_move(self, spec, dist_filename, setup_base): ...
+    def install_wrapper_scripts(self, dist) -> None: ...
+    def install_script(self, dist, script_name, script_text, dev_path: Any | None = ...) -> None: ...
+    def write_script(self, script_name, contents, mode: str = ..., blockers=...) -> None: ...
+    def install_eggs(self, spec, dist_filename, tmpdir): ...
+    def egg_distribution(self, egg_path): ...
+    def install_egg(self, egg_path, tmpdir): ...
+    def install_exe(self, dist_filename, tmpdir): ...
+    def exe_to_egg(self, dist_filename, egg_tmp): ...
+    def install_wheel(self, wheel_path, tmpdir): ...
+    def installation_report(self, req, dist, what: str = ...): ...
+    def report_editable(self, spec, setup_script): ...
+    def run_setup(self, setup_script, setup_base, args) -> None: ...
+    def build_and_install(self, setup_script, setup_base): ...
+    def update_pth(self, dist) -> None: ...
+    def unpack_progress(self, src, dst): ...
+    def unpack_and_compile(self, egg_path, destination): ...
+    def byte_compile(self, to_compile) -> None: ...
+    def create_home_path(self) -> None: ...
+    INSTALL_SCHEMES: Any
+    DEFAULT_SCHEME: Any
+
+def extract_wininst_cfg(dist_filename): ...
+def get_exe_prefixes(exe_filename): ...
+
+class PthDistributions(Environment):
+    dirty: bool
+    filename: Any
+    sitedirs: Any
+    basedir: Any
+    def __init__(self, filename, sitedirs=...) -> None: ...
+    def save(self) -> None: ...
+    def add(self, dist) -> None: ...
+    def remove(self, dist) -> None: ...
+    def make_relative(self, path): ...
+
+class RewritePthDistributions(PthDistributions):
+    prelude: Any
+    postlude: Any
+
+class CommandSpec(List[str]):
+    options: Any
+    split_args: Any
+    @classmethod
+    def best(cls): ...
+    @classmethod
+    def from_param(cls, param): ...
+    @classmethod
+    def from_environment(cls): ...
+    @classmethod
+    def from_string(cls, string): ...
+    def install_options(self, script_text) -> None: ...
+    def as_header(self): ...
+
+class WindowsCommandSpec(CommandSpec):
+    split_args: Any
+
+class ScriptWriter:
+    template: Any
+    command_spec_class: Any
+    @classmethod
+    def get_script_args(cls, dist, executable: Any | None = ..., wininst: bool = ...): ...
+    @classmethod
+    def get_script_header(cls, script_text, executable: Any | None = ..., wininst: bool = ...): ...
+    @classmethod
+    def get_args(cls, dist, header: Any | None = ...) -> None: ...
+    @classmethod
+    def get_writer(cls, force_windows): ...
+    @classmethod
+    def best(cls): ...
+    @classmethod
+    def get_header(cls, script_text: str = ..., executable: Any | None = ...): ...
+
+class WindowsScriptWriter(ScriptWriter):
+    command_spec_class: Any
+    @classmethod
+    def get_writer(cls): ...
+    @classmethod
+    def best(cls): ...
+
+class WindowsExecutableLauncherWriter(WindowsScriptWriter): ...
+class EasyInstallDeprecationWarning(SetuptoolsDeprecationWarning): ...

stubs/setuptools/setuptools/command/egg_info.pyi

@@ -0,0 +1,83 @@
+from distutils.filelist import FileList as _FileList
+from typing import Any
+
+from setuptools import Command, SetuptoolsDeprecationWarning
+from setuptools.command.sdist import sdist
+
+def translate_pattern(glob): ...
+
+class InfoCommon:
+    tag_build: Any
+    tag_date: Any
+    @property
+    def name(self): ...
+    def tagged_version(self): ...
+    def tags(self): ...
+    vtags: Any
+
+class egg_info(InfoCommon, Command):
+    description: str
+    user_options: Any
+    boolean_options: Any
+    negative_opt: Any
+    egg_base: Any
+    egg_name: Any
+    egg_info: Any
+    egg_version: Any
+    broken_egg_info: bool
+    def initialize_options(self) -> None: ...
+    @property
+    def tag_svn_revision(self) -> None: ...
+    @tag_svn_revision.setter
+    def tag_svn_revision(self, value) -> None: ...
+    def save_version_info(self, filename) -> None: ...
+    def finalize_options(self) -> None: ...
+    def write_or_delete_file(self, what, filename, data, force: bool = ...) -> None: ...
+    def write_file(self, what, filename, data) -> None: ...
+    def delete_file(self, filename) -> None: ...
+    def run(self) -> None: ...
+    filelist: Any
+    def find_sources(self) -> None: ...
+    def check_broken_egg_info(self) -> None: ...
+
+class FileList(_FileList):
+    def process_template_line(self, line) -> None: ...
+    def include(self, pattern): ...
+    def exclude(self, pattern): ...
+    def recursive_include(self, dir, pattern): ...
+    def recursive_exclude(self, dir, pattern): ...
+    def graft(self, dir): ...
+    def prune(self, dir): ...
+    def global_include(self, pattern): ...
+    def global_exclude(self, pattern): ...
+    def append(self, item) -> None: ...
+    def extend(self, paths) -> None: ...
+
+class manifest_maker(sdist):
+    template: str
+    use_defaults: int
+    prune: int
+    manifest_only: int
+    force_manifest: int
+    def initialize_options(self) -> None: ...
+    def finalize_options(self) -> None: ...
+    filelist: Any
+    def run(self) -> None: ...
+    def write_manifest(self) -> None: ...
+    def warn(self, msg) -> None: ...
+    def add_defaults(self) -> None: ...
+    def add_license_files(self) -> None: ...
+    def prune_file_list(self) -> None: ...
+
+def write_file(filename, contents) -> None: ...
+def write_pkg_info(cmd, basename, filename) -> None: ...
+def warn_depends_obsolete(cmd, basename, filename) -> None: ...
+def write_requirements(cmd, basename, filename) -> None: ...
+def write_setup_requirements(cmd, basename, filename) -> None: ...
+def write_toplevel_names(cmd, basename, filename) -> None: ...
+def overwrite_arg(cmd, basename, filename) -> None: ...
+def write_arg(cmd, basename, filename, force: bool = ...) -> None: ...
+def write_entries(cmd, basename, filename) -> None: ...
+def get_pkg_info_revision(): ...
+
+class EggInfoDeprecationWarning(SetuptoolsDeprecationWarning): ...

stubs/setuptools/setuptools/command/install.pyi

@@ -0,0 +1,16 @@
+import distutils.command.install as orig
+from typing import Any
+
+class install(orig.install):
+    user_options: Any
+    boolean_options: Any
+    new_commands: Any
+    old_and_unmanageable: Any
+    single_version_externally_managed: Any
+    def initialize_options(self) -> None: ...
+    def finalize_options(self) -> None: ...
+    path_file: Any
+    extra_dirs: str
+    def handle_extra_path(self): ...
+    def run(self): ...
+    def do_egg_install(self) -> None: ...

stubs/setuptools/setuptools/command/install_egg_info.pyi

@@ -0,0 +1,16 @@
+from typing import Any
+
+from setuptools import Command, namespaces
+
+class install_egg_info(namespaces.Installer, Command):
+    description: str
+    user_options: Any
+    install_dir: Any
+    def initialize_options(self) -> None: ...
+    source: Any
+    target: Any
+    outputs: Any
+    def finalize_options(self) -> None: ...
+    def run(self) -> None: ...
+    def get_outputs(self): ...
+    def copytree(self): ...

stubs/setuptools/setuptools/command/install_lib.pyi

@@ -0,0 +1,9 @@
+import distutils.command.install_lib as orig
+
+class install_lib(orig.install_lib):
+    def run(self) -> None: ...
+    def get_exclusions(self): ...
+    def copy_tree(
+        self, infile, outfile, preserve_mode: int = ..., preserve_times: int = ..., preserve_symlinks: int = ..., level: int = ...
+    ): ...
+    def get_outputs(self): ...

stubs/setuptools/setuptools/command/install_scripts.pyi

@@ -0,0 +1,9 @@
+import distutils.command.install_scripts as orig
+from typing import Any
+
+class install_scripts(orig.install_scripts):
+    no_ep: bool
+    def initialize_options(self) -> None: ...
+    outfiles: Any
+    def run(self) -> None: ...
+    def write_script(self, script_name, contents, mode: str = ..., *ignored) -> None: ...

stubs/setuptools/setuptools/command/py36compat.pyi

@@ -0,0 +1,5 @@
+import sys
+
+class sdist_add_defaults:
+    if sys.version_info < (3, 7):
+        def add_defaults(self) -> None: ...

stubs/setuptools/setuptools/command/register.pyi

@@ -0,0 +1,4 @@
+import distutils.command.register as orig
+
+class register(orig.register):
+    def run(self) -> None: ...

stubs/setuptools/setuptools/command/rotate.pyi

@@ -0,0 +1,14 @@
+from typing import Any
+
+from setuptools import Command
+
+class rotate(Command):
+    description: str
+    user_options: Any
+    boolean_options: Any
+    match: Any
+    dist_dir: Any
+    keep: Any
+    def initialize_options(self) -> None: ...
+    def finalize_options(self) -> None: ...
+    def run(self) -> None: ...

stubs/setuptools/setuptools/command/saveopts.pyi

@@ -0,0 +1,5 @@
+from setuptools.command.setopt import option_base
+
+class saveopts(option_base):
+    description: str
+    def run(self) -> None: ...

stubs/setuptools/setuptools/command/sdist.pyi

@@ -0,0 +1,19 @@
+import distutils.command.sdist as orig
+from typing import Any
+
+from .py36compat import sdist_add_defaults
+
+def walk_revctrl(dirname: str = ...) -> None: ...
+
+class sdist(sdist_add_defaults, orig.sdist):
+    user_options: Any
+    negative_opt: Any
+    README_EXTENSIONS: Any
+    READMES: Any
+    filelist: Any
+    def run(self) -> None: ...
+    def initialize_options(self) -> None: ...
+    def make_distribution(self) -> None: ...
+    def check_readme(self) -> None: ...
+    def make_release_tree(self, base_dir, files) -> None: ...
+    def read_manifest(self) -> None: ...

stubs/setuptools/setuptools/command/setopt.pyi

@@ -0,0 +1,30 @@
+from abc import abstractmethod
+from typing import Any
+
+from setuptools import Command
+
+def config_file(kind: str = ...): ...
+def edit_config(filename, settings, dry_run: bool = ...) -> None: ...
+
+class option_base(Command):
+    user_options: Any
+    boolean_options: Any
+    global_config: Any
+    user_config: Any
+    filename: Any
+    def initialize_options(self) -> None: ...
+    def finalize_options(self) -> None: ...
+    @abstractmethod
+    def run(self) -> None: ...
+
+class setopt(option_base):
+    description: str
+    user_options: Any
+    boolean_options: Any
+    command: Any
+    option: Any
+    set_value: Any
+    remove: Any
+    def initialize_options(self) -> None: ...
+    def finalize_options(self) -> None: ...
+    def run(self) -> None: ...

stubs/setuptools/setuptools/command/test.pyi

@@ -0,0 +1,40 @@
+from _typeshed import Self
+from types import ModuleType
+from typing import Any, Callable, Generic, TypeVar, overload
+from unittest import TestLoader, TestSuite
+
+from setuptools import Command
+
+_T = TypeVar("_T")
+
+class ScanningLoader(TestLoader):
+    def __init__(self) -> None: ...
+    def loadTestsFromModule(self, module: ModuleType, pattern: Any | None = ...) -> list[TestSuite]: ...  # type: ignore
+
+class NonDataProperty(Generic[_T]):
+    fget: Callable[..., _T]
+    def __init__(self, fget: Callable[..., _T]) -> None: ...
+    @overload
+    def __get__(self: Self, obj: None, objtype: object = ...) -> Self: ...
+    @overload
+    def __get__(self, obj: Any, objtype: object = ...) -> _T: ...
+
+class test(Command):
+    description: str
+    user_options: Any
+    test_suite: Any
+    test_module: Any
+    test_loader: Any
+    test_runner: Any
+    def initialize_options(self) -> None: ...
+    def finalize_options(self) -> None: ...
+    # TODO: uncomment once https://github.com/python/mypy/pull/10884 is released
+    # def test_args(self): ...
+    def with_project_on_sys_path(self, func) -> None: ...
+    def project_on_sys_path(self, include_dists=...): ...
+    @staticmethod
+    def paths_on_pythonpath(paths) -> None: ...
+    @staticmethod
+    def install_dists(dist): ...
+    def run(self) -> None: ...
+    def run_tests(self) -> None: ...

stubs/setuptools/setuptools/command/upload.pyi

@@ -0,0 +1,4 @@
+from distutils.command import upload as orig
+
+class upload(orig.upload):
+    def run(self) -> None: ...

stubs/setuptools/setuptools/command/upload_docs.pyi

@@ -0,0 +1,18 @@
+from typing import Any, ClassVar
+
+from .upload import upload
+
+class upload_docs(upload):
+    DEFAULT_REPOSITORY: ClassVar[str]
+    description: ClassVar[str]
+    user_options: ClassVar[list[tuple[str, str | None, str]]]
+    boolean_options: ClassVar[list[str]]
+    def has_sphinx(self): ...
+    sub_commands: Any
+    upload_dir: Any
+    target_dir: Any
+    def initialize_options(self) -> None: ...
+    def finalize_options(self) -> None: ...
+    def create_zipfile(self, filename) -> None: ...
+    def run(self) -> None: ...
+    def upload_file(self, filename) -> None: ...  # type: ignore

stubs/setuptools/setuptools/config.pyi

@@ -0,0 +1,44 @@
+from typing import Any
+
+class StaticModule:
+    def __init__(self, name) -> None: ...
+    def __getattr__(self, attr): ...
+
+def patch_path(path) -> None: ...
+def read_configuration(filepath, find_others: bool = ..., ignore_option_errors: bool = ...): ...
+def configuration_to_dict(handlers): ...
+def parse_configuration(distribution, command_options, ignore_option_errors: bool = ...): ...
+
+class ConfigHandler:
+    section_prefix: Any
+    aliases: Any
+    ignore_option_errors: Any
+    target_obj: Any
+    sections: Any
+    set_options: Any
+    def __init__(self, target_obj, options, ignore_option_errors: bool = ...) -> None: ...
+    @property
+    def parsers(self) -> None: ...
+    def __setitem__(self, option_name, value) -> None: ...
+    def parse_section(self, section_options) -> None: ...
+    def parse(self) -> None: ...
+
+class ConfigMetadataHandler(ConfigHandler):
+    section_prefix: str
+    aliases: Any
+    strict_mode: bool
+    package_dir: Any
+    def __init__(self, target_obj, options, ignore_option_errors: bool = ..., package_dir: Any | None = ...) -> None: ...
+    @property
+    def parsers(self): ...
+
+class ConfigOptionsHandler(ConfigHandler):
+    section_prefix: str
+    @property
+    def parsers(self): ...
+    def parse_section_packages__find(self, section_options): ...
+    def parse_section_entry_points(self, section_options) -> None: ...
+    def parse_section_package_data(self, section_options) -> None: ...
+    def parse_section_exclude_package_data(self, section_options) -> None: ...
+    def parse_section_extras_require(self, section_options) -> None: ...
+    def parse_section_data_files(self, section_options) -> None: ...

stubs/setuptools/setuptools/dep_util.pyi

@@ -0,0 +1 @@
+def newer_pairwise_group(sources_groups, targets): ...

stubs/setuptools/setuptools/depends.pyi

@@ -0,0 +1,14 @@
+from typing import Any
+
+class Require:
+    def __init__(
+        self, name, requested_version, module, homepage: str = ..., attribute: Any | None = ..., format: Any | None = ...
+    ) -> None: ...
+    def full_name(self): ...
+    def version_ok(self, version): ...
+    def get_version(self, paths: Any | None = ..., default: str = ...): ...
+    def is_present(self, paths: Any | None = ...): ...
+    def is_current(self, paths: Any | None = ...): ...
+
+def get_module_constant(module, symbol, default: int = ..., paths: Any | None = ...): ...
+def extract_constant(code, symbol, default: int = ...): ...

stubs/setuptools/setuptools/dist.pyi

@@ -0,0 +1,35 @@
+from distutils.core import Distribution as _Distribution
+from typing import Any
+
+from setuptools import SetuptoolsDeprecationWarning
+
+class Distribution(_Distribution):
+    def patch_missing_pkg_info(self, attrs) -> None: ...
+    package_data: Any
+    dist_files: Any
+    src_root: Any
+    dependency_links: Any
+    setup_requires: Any
+    def __init__(self, attrs: Any | None = ...) -> None: ...
+    def warn_dash_deprecation(self, opt, section): ...
+    def make_option_lowercase(self, opt, section): ...
+    def parse_config_files(self, filenames: Any | None = ..., ignore_option_errors: bool = ...) -> None: ...
+    def fetch_build_eggs(self, requires): ...
+    def finalize_options(self): ...
+    def get_egg_cache_dir(self): ...
+    def fetch_build_egg(self, req): ...
+    def get_command_class(self, command): ...
+    def print_commands(self): ...
+    def get_command_list(self): ...
+    def include(self, **attrs) -> None: ...
+    packages: Any
+    py_modules: Any
+    ext_modules: Any
+    def exclude_package(self, package) -> None: ...
+    def has_contents_for(self, package): ...
+    def exclude(self, **attrs) -> None: ...
+    def get_cmdline_options(self): ...
+    def iter_distribution_names(self) -> None: ...
+    def handle_display_options(self, option_order): ...
+
+class DistDeprecationWarning(SetuptoolsDeprecationWarning): ...

stubs/setuptools/setuptools/errors.pyi

@@ -0,0 +1,3 @@
+from distutils.errors import DistutilsError
+
+class RemovedCommandError(DistutilsError, RuntimeError): ...

stubs/setuptools/setuptools/extension.pyi

@@ -0,0 +1,10 @@
+from distutils.core import Extension as _Extension
+from typing import Any
+
+have_pyrex: Any
+
+class Extension(_Extension):
+    py_limited_api: Any
+    def __init__(self, name, sources, *args, **kw) -> None: ...
+
+class Library(Extension): ...

stubs/setuptools/setuptools/extern/__init__.pyi

@@ -0,0 +1,16 @@
+from typing import Any
+
+class VendorImporter:
+    root_name: Any
+    vendored_names: Any
+    vendor_pkg: Any
+    def __init__(self, root_name, vendored_names=..., vendor_pkg: Any | None = ...) -> None: ...
+    @property
+    def search_path(self) -> None: ...
+    def load_module(self, fullname): ...
+    def create_module(self, spec): ...
+    def exec_module(self, module) -> None: ...
+    def find_spec(self, fullname, path: Any | None = ..., target: Any | None = ...): ...
+    def install(self) -> None: ...
+
+names: Any

stubs/setuptools/setuptools/glob.pyi

@@ -0,0 +1,3 @@
+def glob(pathname, recursive: bool = ...): ...
+def iglob(pathname, recursive: bool = ...): ...
+def escape(pathname): ...

stubs/setuptools/setuptools/installer.pyi

@@ -0,0 +1,2 @@
+def fetch_build_egg(dist, req): ...
+def strip_marker(req): ...

stubs/setuptools/setuptools/launch.pyi

@@ -0,0 +1 @@
+def run() -> None: ...

stubs/setuptools/setuptools/lib2to3_ex.pyi

@@ -0,0 +1,10 @@
+from distutils.util import Mixin2to3 as _Mixin2to3
+from lib2to3.refactor import RefactoringTool
+
+class DistutilsRefactoringTool(RefactoringTool):
+    def log_error(self, msg, *args, **kw) -> None: ...  # type: ignore
+    def log_message(self, msg, *args) -> None: ...
+    def log_debug(self, msg, *args) -> None: ...
+
+class Mixin2to3(_Mixin2to3):
+    def run_2to3(self, files, doctests: bool = ...) -> None: ...

stubs/setuptools/setuptools/monkey.pyi

@@ -0,0 +1,6 @@
+def get_unpatched(item): ...
+def get_unpatched_class(cls): ...
+def patch_all() -> None: ...
+def patch_func(replacement, target_mod, func_name) -> None: ...
+def get_unpatched_function(candidate): ...
+def patch_for_msvc_specialized_compiler(): ...

stubs/setuptools/setuptools/msvc.pyi

@@ -0,0 +1,145 @@
+from typing import Any
+
+class winreg:
+    HKEY_USERS: Any
+    HKEY_CURRENT_USER: Any
+    HKEY_LOCAL_MACHINE: Any
+    HKEY_CLASSES_ROOT: Any
+
+def msvc9_find_vcvarsall(version): ...
+def msvc9_query_vcvarsall(ver, arch: str = ..., *args, **kwargs): ...
+
+PLAT_SPEC_TO_RUNTIME: Any
+
+def msvc14_get_vc_env(plat_spec): ...
+def msvc14_gen_lib_options(*args, **kwargs): ...
+
+class PlatformInfo:
+    current_cpu: Any
+    arch: Any
+    def __init__(self, arch) -> None: ...
+    @property
+    def target_cpu(self): ...
+    def target_is_x86(self): ...
+    def current_is_x86(self): ...
+    def current_dir(self, hidex86: bool = ..., x64: bool = ...): ...
+    def target_dir(self, hidex86: bool = ..., x64: bool = ...): ...
+    def cross_dir(self, forcex86: bool = ...): ...
+
+class RegistryInfo:
+    HKEYS: Any
+    pi: Any
+    def __init__(self, platform_info) -> None: ...
+    @property
+    def visualstudio(self): ...
+    @property
+    def sxs(self): ...
+    @property
+    def vc(self): ...
+    @property
+    def vs(self): ...
+    @property
+    def vc_for_python(self): ...
+    @property
+    def microsoft_sdk(self): ...
+    @property
+    def windows_sdk(self): ...
+    @property
+    def netfx_sdk(self): ...
+    @property
+    def windows_kits_roots(self): ...
+    def microsoft(self, key, x86: bool = ...): ...
+    def lookup(self, key, name): ...
+
+class SystemInfo:
+    WinDir: Any
+    ProgramFiles: Any
+    ProgramFilesx86: Any
+    ri: Any
+    pi: Any
+    known_vs_paths: Any
+    vs_ver: Any
+    def __init__(self, registry_info, vc_ver: Any | None = ...) -> None: ...
+    def find_reg_vs_vers(self): ...
+    def find_programdata_vs_vers(self): ...
+    @property
+    def VSInstallDir(self): ...
+    @property
+    def VCInstallDir(self): ...
+    @property
+    def WindowsSdkVersion(self): ...
+    @property
+    def WindowsSdkLastVersion(self): ...
+    @property
+    def WindowsSdkDir(self): ...
+    @property
+    def WindowsSDKExecutablePath(self): ...
+    @property
+    def FSharpInstallDir(self): ...
+    @property
+    def UniversalCRTSdkDir(self): ...
+    @property
+    def UniversalCRTSdkLastVersion(self): ...
+    @property
+    def NetFxSdkVersion(self): ...
+    @property
+    def NetFxSdkDir(self): ...
+    @property
+    def FrameworkDir32(self): ...
+    @property
+    def FrameworkDir64(self): ...
+    @property
+    def FrameworkVersion32(self): ...
+    @property
+    def FrameworkVersion64(self): ...
+
+class EnvironmentInfo:
+    pi: Any
+    ri: Any
+    si: Any
+    def __init__(self, arch, vc_ver: Any | None = ..., vc_min_ver: int = ...) -> None: ...
+    @property
+    def vs_ver(self): ...
+    @property
+    def vc_ver(self): ...
+    @property
+    def VSTools(self): ...
+    @property
+    def VCIncludes(self): ...
+    @property
+    def VCLibraries(self): ...
+    @property
+    def VCStoreRefs(self): ...
+    @property
+    def VCTools(self): ...
+    @property
+    def OSLibraries(self): ...
+    @property
+    def OSIncludes(self): ...
+    @property
+    def OSLibpath(self): ...
+    @property
+    def SdkTools(self): ...
+    @property
+    def SdkSetup(self): ...
+    @property
+    def FxTools(self): ...
+    @property
+    def NetFxSDKLibraries(self): ...
+    @property
+    def NetFxSDKIncludes(self): ...
+    @property
+    def VsTDb(self): ...
+    @property
+    def MSBuild(self): ...
+    @property
+    def HTMLHelpWorkshop(self): ...
+    @property
+    def UCRTLibraries(self): ...
+    @property
+    def UCRTIncludes(self): ...
+    @property
+    def FSharp(self): ...
+    @property
+    def VCRuntimeRedist(self): ...
+    def return_env(self, exists: bool = ...): ...

stubs/setuptools/setuptools/namespaces.pyi

@@ -0,0 +1,10 @@
+from typing import Any
+
+flatten: Any
+
+class Installer:
+    nspkg_ext: str
+    def install_namespaces(self) -> None: ...
+    def uninstall_namespaces(self) -> None: ...
+
+class DevelopInstaller(Installer): ...

stubs/setuptools/setuptools/package_index.pyi

@@ -0,0 +1,84 @@
+import configparser
+from typing import Any
+
+from pkg_resources import Environment
+
+def parse_bdist_wininst(name): ...
+def distros_for_url(url, metadata: Any | None = ...) -> None: ...
+def interpret_distro_name(
+    location, basename, metadata, py_version: Any | None = ..., precedence=..., platform: Any | None = ...
+) -> None: ...
+
+class ContentChecker:
+    def feed(self, block) -> None: ...
+    def is_valid(self): ...
+    def report(self, reporter, template) -> None: ...
+
+class HashChecker(ContentChecker):
+    pattern: Any
+    hash_name: Any
+    hash: Any
+    expected: Any
+    def __init__(self, hash_name, expected) -> None: ...
+    @classmethod
+    def from_url(cls, url): ...
+    def feed(self, block) -> None: ...
+    def is_valid(self): ...
+    def report(self, reporter, template): ...
+
+class PackageIndex(Environment):
+    index_url: Any
+    scanned_urls: Any
+    fetched_urls: Any
+    package_pages: Any
+    allows: Any
+    to_scan: Any
+    opener: Any
+    def __init__(
+        self, index_url: str = ..., hosts=..., ca_bundle: Any | None = ..., verify_ssl: bool = ..., *args, **kw
+    ) -> None: ...
+    def process_url(self, url, retrieve: bool = ...) -> None: ...
+    def process_filename(self, fn, nested: bool = ...) -> None: ...
+    def url_ok(self, url, fatal: bool = ...): ...
+    def scan_egg_links(self, search_path) -> None: ...
+    def scan_egg_link(self, path, entry) -> None: ...
+    def process_index(self, url, page): ...
+    def need_version_info(self, url) -> None: ...
+    def scan_all(self, msg: Any | None = ..., *args) -> None: ...
+    def find_packages(self, requirement) -> None: ...
+    def obtain(self, requirement, installer: Any | None = ...): ...
+    def check_hash(self, checker, filename, tfp) -> None: ...
+    def add_find_links(self, urls) -> None: ...
+    def prescan(self) -> None: ...
+    def not_found_in_index(self, requirement) -> None: ...
+    def download(self, spec, tmpdir): ...
+    def fetch_distribution(
+        self,
+        requirement,
+        tmpdir,
+        force_scan: bool = ...,
+        source: bool = ...,
+        develop_ok: bool = ...,
+        local_index: Any | None = ...,
+    ): ...
+    def fetch(self, requirement, tmpdir, force_scan: bool = ..., source: bool = ...): ...
+    def gen_setup(self, filename, fragment, tmpdir): ...
+    dl_blocksize: int
+    def reporthook(self, url, filename, blocknum, blksize, size) -> None: ...
+    def open_url(self, url, warning: Any | None = ...): ...
+    def scan_url(self, url) -> None: ...
+    def debug(self, msg, *args) -> None: ...
+    def info(self, msg, *args) -> None: ...
+    def warn(self, msg, *args) -> None: ...
+
+class Credential:
+    username: Any
+    password: Any
+    def __init__(self, username, password) -> None: ...
+    def __iter__(self): ...
+
+class PyPIConfig(configparser.RawConfigParser):
+    def __init__(self) -> None: ...
+    @property
+    def creds_by_repository(self): ...
+    def find_credential(self, url): ...

stubs/setuptools/setuptools/sandbox.pyi

@@ -0,0 +1,28 @@
+from distutils.errors import DistutilsError
+from typing import Any
+
+class UnpickleableException(Exception):
+    @staticmethod
+    def dump(type, exc): ...
+
+class ExceptionSaver:
+    def __enter__(self): ...
+    def __exit__(self, type, exc, tb): ...
+    def resume(self) -> None: ...
+
+def run_setup(setup_script, args): ...
+
+class AbstractSandbox:
+    def __init__(self) -> None: ...
+    def __enter__(self) -> None: ...
+    def __exit__(self, exc_type, exc_value, traceback) -> None: ...
+    def run(self, func): ...
+
+class DirectorySandbox(AbstractSandbox):
+    write_ops: Any
+    def __init__(self, sandbox, exceptions=...) -> None: ...
+    def tmpnam(self) -> None: ...
+    def open(self, file, flags, mode: int = ..., *args, **kw): ...
+
+class SandboxViolation(DistutilsError):
+    tmpl: Any

stubs/setuptools/setuptools/unicode_utils.pyi

@@ -0,0 +1,3 @@
+def decompose(path): ...
+def filesys_decode(path): ...
+def try_encode(string, enc): ...

stubs/setuptools/setuptools/version.pyi

@@ -0,0 +1 @@
+__version__: str

stubs/setuptools/setuptools/wheel.pyi

@@ -0,0 +1,15 @@
+from typing import Any
+
+WHEEL_NAME: Any
+NAMESPACE_PACKAGE_INIT: str
+
+def unpack(src_dir, dst_dir) -> None: ...
+
+class Wheel:
+    filename: Any
+    def __init__(self, filename) -> None: ...
+    def tags(self): ...
+    def is_compatible(self): ...
+    def egg_name(self): ...
+    def get_dist_info(self, zf): ...
+    def install_as_egg(self, destination_eggdir) -> None: ...

stubs/setuptools/setuptools/windows_support.pyi

@@ -0,0 +1,2 @@
+def windows_only(func): ...
+def hide_file(path) -> None: ...