import optparse
from _typeshed import Incomplete
from collections.abc import Iterable, Mapping
from configparser import RawConfigParser
from typing import Any, ClassVar

from docutils import SettingsSpec
from docutils.utils import DependencyList

__docformat__: str

def store_multiple(option, opt, value, parser, *args, **kwargs) -> None: ...
def read_config_file(option, opt, value, parser) -> None: ...
def validate_encoding(
    setting,
    value: Incomplete | None = None,
    option_parser: Incomplete | None = None,
    config_parser: Incomplete | None = None,
    config_section: Incomplete | None = None,
): ...
def validate_encoding_error_handler(
    setting,
    value: Incomplete | None = None,
    option_parser: Incomplete | None = None,
    config_parser: Incomplete | None = None,
    config_section: Incomplete | None = None,
): ...
def validate_encoding_and_error_handler(
    setting, value, option_parser, config_parser: Incomplete | None = None, config_section: Incomplete | None = None
): ...
def validate_boolean(
    setting,
    value: Incomplete | None = None,
    option_parser: Incomplete | None = None,
    config_parser: Incomplete | None = None,
    config_section: Incomplete | None = None,
) -> bool: ...
def validate_nonnegative_int(
    setting,
    value: Incomplete | None = None,
    option_parser: Incomplete | None = None,
    config_parser: Incomplete | None = None,
    config_section: Incomplete | None = None,
) -> int: ...
def validate_threshold(
    setting,
    value: Incomplete | None = None,
    option_parser: Incomplete | None = None,
    config_parser: Incomplete | None = None,
    config_section: Incomplete | None = None,
) -> int: ...
def validate_colon_separated_string_list(
    setting,
    value: Incomplete | None = None,
    option_parser: Incomplete | None = None,
    config_parser: Incomplete | None = None,
    config_section: Incomplete | None = None,
) -> list[str]: ...
def validate_comma_separated_list(
    setting,
    value: Incomplete | None = None,
    option_parser: Incomplete | None = None,
    config_parser: Incomplete | None = None,
    config_section: Incomplete | None = None,
) -> list[str]: ...
def validate_url_trailing_slash(
    setting,
    value: Incomplete | None = None,
    option_parser: Incomplete | None = None,
    config_parser: Incomplete | None = None,
    config_section: Incomplete | None = None,
) -> str: ...
def validate_dependency_file(
    setting,
    value: Incomplete | None = None,
    option_parser: Incomplete | None = None,
    config_parser: Incomplete | None = None,
    config_section: Incomplete | None = None,
) -> DependencyList: ...
def validate_strip_class(
    setting,
    value: Incomplete | None = None,
    option_parser: Incomplete | None = None,
    config_parser: Incomplete | None = None,
    config_section: Incomplete | None = None,
): ...
def validate_smartquotes_locales(
    setting,
    value: Incomplete | None = None,
    option_parser: Incomplete | None = None,
    config_parser: Incomplete | None = None,
    config_section: Incomplete | None = None,
) -> list[tuple[str, str]]: ...
def make_paths_absolute(pathdict, keys, base_path: Incomplete | None = None) -> None: ...
def make_one_path_absolute(base_path, path) -> str: ...
def filter_settings_spec(settings_spec, *exclude, **replace) -> tuple[Any, ...]: ...

class Values(optparse.Values):
    def update(self, other_dict, option_parser) -> None: ...
    def copy(self) -> Values: ...

class Option(optparse.Option): ...

class OptionParser(optparse.OptionParser, SettingsSpec):
    standard_config_files: ClassVar[list[str]]
    threshold_choices: ClassVar[list[str]]
    thresholds: ClassVar[dict[str, int]]
    booleans: ClassVar[dict[str, bool]]
    default_error_encoding: ClassVar[str]
    default_error_encoding_error_handler: ClassVar[str]
    config_section: ClassVar[str]
    version_template: ClassVar[str]
    def __init__(
        self,
        components: Iterable[SettingsSpec | type[SettingsSpec]] = (),
        defaults: Mapping[str, Any] | None = None,
        read_config_files: bool | None = False,
        *args,
        **kwargs,
    ) -> None: ...
    def __getattr__(self, name: str) -> Incomplete: ...

class ConfigParser(RawConfigParser):
    def __getattr__(self, name: str) -> Incomplete: ...

class ConfigDeprecationWarning(DeprecationWarning): ...

def get_default_settings(*components) -> Values: ...
