mirror of
https://github.com/davidhalter/typeshed.git
synced 2025-12-07 20:54:28 +08:00
318 lines
15 KiB
Python
318 lines
15 KiB
Python
from _typeshed import Incomplete, StrOrBytesPath, StrPath, SupportsWrite
|
|
from collections.abc import Iterable, MutableMapping
|
|
from distutils.cmd import Command
|
|
from distutils.command.bdist import bdist
|
|
from distutils.command.bdist_dumb import bdist_dumb
|
|
from distutils.command.bdist_rpm import bdist_rpm
|
|
from distutils.command.build import build
|
|
from distutils.command.build_clib import build_clib
|
|
from distutils.command.build_ext import build_ext
|
|
from distutils.command.build_py import build_py
|
|
from distutils.command.build_scripts import build_scripts
|
|
from distutils.command.check import check
|
|
from distutils.command.clean import clean
|
|
from distutils.command.config import config
|
|
from distutils.command.install import install
|
|
from distutils.command.install_data import install_data
|
|
from distutils.command.install_egg_info import install_egg_info
|
|
from distutils.command.install_headers import install_headers
|
|
from distutils.command.install_lib import install_lib
|
|
from distutils.command.install_scripts import install_scripts
|
|
from distutils.command.register import register
|
|
from distutils.command.sdist import sdist
|
|
from distutils.command.upload import upload
|
|
from re import Pattern
|
|
from typing import IO, ClassVar, Literal, TypeVar, overload
|
|
from typing_extensions import TypeAlias
|
|
|
|
command_re: Pattern[str]
|
|
|
|
_OptionsList: TypeAlias = list[tuple[str, str | None, str, int] | tuple[str, str | None, str]]
|
|
_CommandT = TypeVar("_CommandT", bound=Command)
|
|
|
|
class DistributionMetadata:
|
|
def __init__(self, path: StrOrBytesPath | None = None) -> None: ...
|
|
name: str | None
|
|
version: str | None
|
|
author: str | None
|
|
author_email: str | None
|
|
maintainer: str | None
|
|
maintainer_email: str | None
|
|
url: str | None
|
|
license: str | None
|
|
description: str | None
|
|
long_description: str | None
|
|
keywords: str | list[str] | None
|
|
platforms: str | list[str] | None
|
|
classifiers: str | list[str] | None
|
|
download_url: str | None
|
|
provides: list[str] | None
|
|
requires: list[str] | None
|
|
obsoletes: list[str] | None
|
|
def read_pkg_file(self, file: IO[str]) -> None: ...
|
|
def write_pkg_info(self, base_dir: StrPath) -> None: ...
|
|
def write_pkg_file(self, file: SupportsWrite[str]) -> None: ...
|
|
def get_name(self) -> str: ...
|
|
def get_version(self) -> str: ...
|
|
def get_fullname(self) -> str: ...
|
|
def get_author(self) -> str: ...
|
|
def get_author_email(self) -> str: ...
|
|
def get_maintainer(self) -> str: ...
|
|
def get_maintainer_email(self) -> str: ...
|
|
def get_contact(self) -> str: ...
|
|
def get_contact_email(self) -> str: ...
|
|
def get_url(self) -> str: ...
|
|
def get_license(self) -> str: ...
|
|
def get_licence(self) -> str: ...
|
|
def get_description(self) -> str: ...
|
|
def get_long_description(self) -> str: ...
|
|
def get_keywords(self) -> str | list[str]: ...
|
|
def get_platforms(self) -> str | list[str]: ...
|
|
def get_classifiers(self) -> str | list[str]: ...
|
|
def get_download_url(self) -> str: ...
|
|
def get_requires(self) -> list[str]: ...
|
|
def set_requires(self, value: Iterable[str]) -> None: ...
|
|
def get_provides(self) -> list[str]: ...
|
|
def set_provides(self, value: Iterable[str]) -> None: ...
|
|
def get_obsoletes(self) -> list[str]: ...
|
|
def set_obsoletes(self, value: Iterable[str]) -> None: ...
|
|
|
|
class Distribution:
|
|
cmdclass: dict[str, type[Command]]
|
|
metadata: DistributionMetadata
|
|
def __init__(self, attrs: MutableMapping[str, Incomplete] | None = None) -> None: ...
|
|
def get_option_dict(self, command: str) -> dict[str, tuple[str, str]]: ...
|
|
def parse_config_files(self, filenames: Iterable[str] | None = None) -> None: ...
|
|
global_options: ClassVar[_OptionsList]
|
|
common_usage: ClassVar[str]
|
|
display_options: ClassVar[_OptionsList]
|
|
display_option_names: ClassVar[list[str]]
|
|
negative_opt: ClassVar[dict[str, str]]
|
|
verbose: Literal[0, 1]
|
|
dry_run: Literal[0, 1]
|
|
help: Literal[0, 1]
|
|
command_packages: list[str] | None
|
|
script_name: str | None
|
|
script_args: list[str] | None
|
|
command_options: dict[str, dict[str, tuple[str, str]]]
|
|
dist_files: list[tuple[str, str, str]]
|
|
packages: Incomplete
|
|
package_data: dict[str, list[str]]
|
|
package_dir: Incomplete
|
|
py_modules: Incomplete
|
|
libraries: Incomplete
|
|
headers: Incomplete
|
|
ext_modules: Incomplete
|
|
ext_package: Incomplete
|
|
include_dirs: Incomplete
|
|
extra_path: Incomplete
|
|
scripts: Incomplete
|
|
data_files: Incomplete
|
|
password: str
|
|
command_obj: Incomplete
|
|
have_run: Incomplete
|
|
want_user_cfg: bool
|
|
def dump_option_dicts(
|
|
self, header: Incomplete | None = None, commands: Incomplete | None = None, indent: str = ""
|
|
) -> None: ...
|
|
def find_config_files(self): ...
|
|
commands: Incomplete
|
|
def parse_command_line(self): ...
|
|
def finalize_options(self) -> None: ...
|
|
def handle_display_options(self, option_order): ...
|
|
def print_command_list(self, commands, header, max_length) -> None: ...
|
|
def print_commands(self) -> None: ...
|
|
def get_command_list(self): ...
|
|
def get_command_packages(self): ...
|
|
# NOTE: This list comes directly from the distutils/command folder. Minus bdist_msi and bdist_wininst.
|
|
@overload
|
|
def get_command_obj(self, command: Literal["bdist"], create: Literal[1, True] = 1) -> bdist: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["bdist_dumb"], create: Literal[1, True] = 1) -> bdist_dumb: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["bdist_rpm"], create: Literal[1, True] = 1) -> bdist_rpm: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["build"], create: Literal[1, True] = 1) -> build: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["build_clib"], create: Literal[1, True] = 1) -> build_clib: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["build_ext"], create: Literal[1, True] = 1) -> build_ext: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["build_py"], create: Literal[1, True] = 1) -> build_py: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["build_scripts"], create: Literal[1, True] = 1) -> build_scripts: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["check"], create: Literal[1, True] = 1) -> check: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["clean"], create: Literal[1, True] = 1) -> clean: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["config"], create: Literal[1, True] = 1) -> config: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["install"], create: Literal[1, True] = 1) -> install: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["install_data"], create: Literal[1, True] = 1) -> install_data: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["install_egg_info"], create: Literal[1, True] = 1) -> install_egg_info: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["install_headers"], create: Literal[1, True] = 1) -> install_headers: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["install_lib"], create: Literal[1, True] = 1) -> install_lib: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["install_scripts"], create: Literal[1, True] = 1) -> install_scripts: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["register"], create: Literal[1, True] = 1) -> register: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["sdist"], create: Literal[1, True] = 1) -> sdist: ...
|
|
@overload
|
|
def get_command_obj(self, command: Literal["upload"], create: Literal[1, True] = 1) -> upload: ...
|
|
@overload
|
|
def get_command_obj(self, command: str, create: Literal[1, True] = 1) -> Command: ...
|
|
# Not replicating the overloads for "Command | None", user may use "isinstance"
|
|
@overload
|
|
def get_command_obj(self, command: str, create: Literal[0, False]) -> Command | None: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["bdist"]) -> type[bdist]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["bdist_dumb"]) -> type[bdist_dumb]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["bdist_rpm"]) -> type[bdist_rpm]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["build"]) -> type[build]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["build_clib"]) -> type[build_clib]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["build_ext"]) -> type[build_ext]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["build_py"]) -> type[build_py]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["build_scripts"]) -> type[build_scripts]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["check"]) -> type[check]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["clean"]) -> type[clean]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["config"]) -> type[config]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["install"]) -> type[install]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["install_data"]) -> type[install_data]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["install_egg_info"]) -> type[install_egg_info]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["install_headers"]) -> type[install_headers]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["install_lib"]) -> type[install_lib]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["install_scripts"]) -> type[install_scripts]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["register"]) -> type[register]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["sdist"]) -> type[sdist]: ...
|
|
@overload
|
|
def get_command_class(self, command: Literal["upload"]) -> type[upload]: ...
|
|
@overload
|
|
def get_command_class(self, command: str) -> type[Command]: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["bdist"], reinit_subcommands: bool = False) -> bdist: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["bdist_dumb"], reinit_subcommands: bool = False) -> bdist_dumb: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["bdist_rpm"], reinit_subcommands: bool = False) -> bdist_rpm: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["build"], reinit_subcommands: bool = False) -> build: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["build_clib"], reinit_subcommands: bool = False) -> build_clib: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["build_ext"], reinit_subcommands: bool = False) -> build_ext: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["build_py"], reinit_subcommands: bool = False) -> build_py: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["build_scripts"], reinit_subcommands: bool = False) -> build_scripts: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["check"], reinit_subcommands: bool = False) -> check: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["clean"], reinit_subcommands: bool = False) -> clean: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["config"], reinit_subcommands: bool = False) -> config: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["install"], reinit_subcommands: bool = False) -> install: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["install_data"], reinit_subcommands: bool = False) -> install_data: ...
|
|
@overload
|
|
def reinitialize_command(
|
|
self, command: Literal["install_egg_info"], reinit_subcommands: bool = False
|
|
) -> install_egg_info: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["install_headers"], reinit_subcommands: bool = False) -> install_headers: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["install_lib"], reinit_subcommands: bool = False) -> install_lib: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["install_scripts"], reinit_subcommands: bool = False) -> install_scripts: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["register"], reinit_subcommands: bool = False) -> register: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["sdist"], reinit_subcommands: bool = False) -> sdist: ...
|
|
@overload
|
|
def reinitialize_command(self, command: Literal["upload"], reinit_subcommands: bool = False) -> upload: ...
|
|
@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 announce(self, msg, level: int = 2) -> None: ...
|
|
def run_commands(self) -> None: ...
|
|
def run_command(self, command: str) -> None: ...
|
|
def has_pure_modules(self) -> bool: ...
|
|
def has_ext_modules(self) -> bool: ...
|
|
def has_c_libraries(self) -> bool: ...
|
|
def has_modules(self) -> bool: ...
|
|
def has_headers(self) -> bool: ...
|
|
def has_scripts(self) -> bool: ...
|
|
def has_data_files(self) -> bool: ...
|
|
def is_pure(self) -> bool: ...
|
|
|
|
# Default getter methods generated in __init__ from self.metadata._METHOD_BASENAMES
|
|
def get_name(self) -> str: ...
|
|
def get_version(self) -> str: ...
|
|
def get_fullname(self) -> str: ...
|
|
def get_author(self) -> str: ...
|
|
def get_author_email(self) -> str: ...
|
|
def get_maintainer(self) -> str: ...
|
|
def get_maintainer_email(self) -> str: ...
|
|
def get_contact(self) -> str: ...
|
|
def get_contact_email(self) -> str: ...
|
|
def get_url(self) -> str: ...
|
|
def get_license(self) -> str: ...
|
|
def get_licence(self) -> str: ...
|
|
def get_description(self) -> str: ...
|
|
def get_long_description(self) -> str: ...
|
|
def get_keywords(self) -> str | list[str]: ...
|
|
def get_platforms(self) -> str | list[str]: ...
|
|
def get_classifiers(self) -> str | list[str]: ...
|
|
def get_download_url(self) -> str: ...
|
|
def get_requires(self) -> list[str]: ...
|
|
def get_provides(self) -> list[str]: ...
|
|
def get_obsoletes(self) -> list[str]: ...
|
|
|
|
# Default attributes generated in __init__ from self.display_option_names
|
|
help_commands: bool | Literal[0]
|
|
name: str | Literal[0]
|
|
version: str | Literal[0]
|
|
fullname: str | Literal[0]
|
|
author: str | Literal[0]
|
|
author_email: str | Literal[0]
|
|
maintainer: str | Literal[0]
|
|
maintainer_email: str | Literal[0]
|
|
contact: str | Literal[0]
|
|
contact_email: str | Literal[0]
|
|
url: str | Literal[0]
|
|
license: str | Literal[0]
|
|
licence: str | Literal[0]
|
|
description: str | Literal[0]
|
|
long_description: str | Literal[0]
|
|
platforms: str | list[str] | Literal[0]
|
|
classifiers: str | list[str] | Literal[0]
|
|
keywords: str | list[str] | Literal[0]
|
|
provides: list[str] | Literal[0]
|
|
requires: list[str] | Literal[0]
|
|
obsoletes: list[str] | Literal[0]
|