from _typeshed import SupportsItems
from collections.abc import Callable, Iterable, Iterator
from typing import Any, NamedTuple, TypeVar, overload
from typing_extensions import Literal, Self, TypeAlias

_T = TypeVar("_T")
_ListOrTuple: TypeAlias = list[_T] | tuple[_T, ...]
_ParsedAccept: TypeAlias = tuple[str, float, list[tuple[str, str]], list[str | tuple[str, str]]]

class AcceptOffer(NamedTuple):
    type: str
    subtype: str
    params: tuple[tuple[str, str], ...]

class Accept:
    @classmethod
    def parse(cls, value: str) -> Iterator[_ParsedAccept]: ...
    @classmethod
    def parse_offer(cls, offer: str | AcceptOffer) -> AcceptOffer: ...

class AcceptValidHeader(Accept):
    @property
    def header_value(self) -> str: ...
    @property
    def parsed(self) -> list[_ParsedAccept] | None: ...
    def __init__(self, header_value: str) -> None: ...
    def copy(self) -> Self: ...
    @overload
    def __add__(self, other: str | None) -> Self: ...
    @overload
    def __add__(self, other: AcceptNoHeader | AcceptValidHeader | AcceptInvalidHeader) -> Self: ...
    @overload
    def __add__(self, other: SupportsItems[str, float | tuple[float, str]]) -> Self: ...
    @overload
    def __add__(self, other: _ListOrTuple[str | tuple[str, float, str] | list[Any]]) -> Self: ...
    def __bool__(self) -> Literal[True]: ...
    def __contains__(self, offer: str) -> bool: ...
    def __iter__(self) -> Iterator[str]: ...
    @overload
    def __radd__(self, other: str | None) -> Self: ...
    @overload
    def __radd__(self, other: SupportsItems[str, float | tuple[float, str]]) -> Self: ...
    @overload
    def __radd__(self, other: _ListOrTuple[str | tuple[str, float, str] | list[Any]]) -> Self: ...
    def accept_html(self) -> bool: ...
    @property
    def accepts_html(self) -> bool: ...
    def acceptable_offers(self, offers: Iterable[str | AcceptOffer]) -> list[tuple[str, float]]: ...
    @overload
    def best_match(self, offers: Iterable[str | tuple[str, float] | list[Any]], default_match: None = None) -> str | None: ...
    @overload
    def best_match(self, offers: Iterable[str | tuple[str, float] | list[Any]], default_match: str) -> str: ...
    def quality(self, offer: str) -> float | None: ...

class _AcceptInvalidOrNoHeader(Accept):
    @property
    def parsed(self) -> None: ...
    def copy(self) -> Self: ...
    @overload
    def __add__(self, other: None) -> AcceptNoHeader: ...
    @overload
    def __add__(self, other: str) -> AcceptValidHeader | AcceptNoHeader: ...
    @overload
    def __add__(self, other: AcceptValidHeader) -> AcceptValidHeader: ...
    @overload
    def __add__(self, other: AcceptNoHeader | AcceptInvalidHeader) -> AcceptNoHeader: ...
    @overload
    def __add__(self, other: SupportsItems[str, float | tuple[float, str]]) -> AcceptValidHeader | AcceptNoHeader: ...
    @overload
    def __add__(self, other: _ListOrTuple[str | tuple[str, float, str] | list[Any]]) -> AcceptValidHeader | AcceptNoHeader: ...
    @overload
    def __radd__(self, other: None) -> AcceptNoHeader: ...
    @overload
    def __radd__(self, other: str) -> AcceptValidHeader | AcceptNoHeader: ...
    @overload
    def __radd__(self, other: AcceptValidHeader) -> AcceptValidHeader: ...
    @overload
    def __radd__(self, other: AcceptNoHeader | AcceptInvalidHeader) -> AcceptNoHeader: ...
    @overload
    def __radd__(self, other: SupportsItems[str, float | tuple[float, str]]) -> AcceptValidHeader | AcceptNoHeader: ...
    @overload
    def __radd__(self, other: _ListOrTuple[str | tuple[str, float, str] | list[Any]]) -> AcceptValidHeader | AcceptNoHeader: ...
    def __bool__(self) -> Literal[False]: ...
    def __contains__(self, offer: str) -> Literal[True]: ...
    def __iter__(self) -> Iterator[str]: ...
    def accept_html(self) -> bool: ...
    @property
    def accepts_html(self) -> bool: ...
    def acceptable_offers(self, offers: Iterable[str | AcceptOffer]) -> list[tuple[str, float]]: ...
    @overload
    def best_match(self, offers: Iterable[str | tuple[str, float] | list[Any]], default_match: None = None) -> str | None: ...
    @overload
    def best_match(self, offers: Iterable[str | tuple[str, float] | list[Any]], default_match: str) -> str: ...
    def quality(self, offer: str) -> float: ...

class AcceptNoHeader(_AcceptInvalidOrNoHeader):
    @property
    def header_value(self) -> None: ...
    def __init__(self) -> None: ...

class AcceptInvalidHeader(_AcceptInvalidOrNoHeader):
    @property
    def header_value(self) -> str: ...
    def __init__(self, header_value: str) -> None: ...

@overload
def create_accept_header(header_value: None) -> AcceptNoHeader: ...
@overload
def create_accept_header(header_value: str) -> AcceptValidHeader | AcceptInvalidHeader: ...

class _AcceptProperty:
    @overload
    def __get__(self, __obj: None, __type: type | None = ...) -> property: ...
    @overload
    def __get__(self, __obj: Any, __type: type | None = ...) -> AcceptNoHeader | AcceptValidHeader | AcceptInvalidHeader: ...
    @overload
    def __set__(self, __obj: Any, __value: str | None) -> None: ...
    @overload
    def __set__(self, __obj: Any, __value: AcceptNoHeader | AcceptValidHeader | AcceptInvalidHeader) -> None: ...
    @overload
    def __set__(self, __obj: Any, __value: SupportsItems[str, float | tuple[float, str]]) -> None: ...
    @overload
    def __set__(self, __obj: Any, __value: _ListOrTuple[str | tuple[str, float, str] | list[Any]]) -> None: ...
    def __delete__(self, __obj: Any) -> None: ...

def accept_property() -> _AcceptProperty: ...

class AcceptCharset:
    @classmethod
    def parse(cls, value: str) -> Iterator[tuple[str, float]]: ...

class AcceptCharsetValidHeader(AcceptCharset):
    @property
    def header_value(self) -> str: ...
    @property
    def parsed(self) -> list[tuple[str, float]]: ...
    def __init__(self, header_value: str) -> None: ...
    def copy(self) -> Self: ...
    @overload
    def __add__(self, other: str | None) -> Self: ...
    @overload
    def __add__(self, other: AcceptCharsetValidHeader | AcceptCharsetNoHeader | AcceptCharsetInvalidHeader) -> Self: ...
    @overload
    def __add__(self, other: SupportsItems[str, float]) -> Self: ...
    @overload
    def __add__(self, other: _ListOrTuple[str | tuple[str, float] | list[Any]]) -> Self: ...
    def __bool__(self) -> Literal[True]: ...
    def __contains__(self, offer: str) -> bool: ...
    def __iter__(self) -> Iterator[str]: ...
    @overload
    def __radd__(self, other: str | None) -> Self: ...
    @overload
    def __radd__(self, other: AcceptCharsetValidHeader | AcceptCharsetNoHeader | AcceptCharsetInvalidHeader) -> Self: ...
    @overload
    def __radd__(self, other: SupportsItems[str, float]) -> Self: ...
    @overload
    def __radd__(self, other: _ListOrTuple[str | tuple[str, float] | list[Any]]) -> Self: ...
    def acceptable_offers(self, offers: Iterable[str]) -> list[tuple[str, float]]: ...
    @overload
    def best_match(self, offers: Iterable[str], default_match: None = None) -> str | None: ...
    @overload
    def best_match(self, offers: Iterable[str], default_match: str) -> str: ...
    def quality(self, offer: str) -> float | None: ...

class _AcceptCharsetInvalidOrNoHeader(AcceptCharset):
    @property
    def parsed(self) -> None: ...
    def __bool__(self) -> Literal[False]: ...
    def __contains__(self, offer: str) -> Literal[True]: ...
    def __iter__(self) -> Iterator[str]: ...
    @overload
    def __add__(self, other: None) -> AcceptCharsetNoHeader: ...
    @overload
    def __add__(self, other: str) -> AcceptCharsetValidHeader | AcceptCharsetNoHeader: ...
    @overload
    def __add__(self, other: AcceptCharsetValidHeader) -> AcceptCharsetValidHeader: ...
    @overload
    def __add__(self, other: AcceptCharsetNoHeader | AcceptCharsetInvalidHeader) -> AcceptCharsetNoHeader: ...
    @overload
    def __add__(self, other: SupportsItems[str, float]) -> AcceptCharsetValidHeader | AcceptCharsetNoHeader: ...
    @overload
    def __add__(
        self, other: _ListOrTuple[str | tuple[str, float] | list[Any]]
    ) -> AcceptCharsetValidHeader | AcceptCharsetNoHeader: ...
    @overload
    def __radd__(self, other: None) -> AcceptCharsetNoHeader: ...
    @overload
    def __radd__(self, other: str) -> AcceptCharsetValidHeader | AcceptCharsetNoHeader: ...
    @overload
    def __radd__(self, other: AcceptCharsetValidHeader) -> AcceptCharsetValidHeader: ...
    @overload
    def __radd__(self, other: AcceptCharsetNoHeader | AcceptCharsetInvalidHeader) -> AcceptCharsetNoHeader: ...
    @overload
    def __radd__(self, other: SupportsItems[str, float]) -> AcceptCharsetValidHeader | AcceptCharsetNoHeader: ...
    @overload
    def __radd__(
        self, other: _ListOrTuple[str | tuple[str, float] | list[Any]]
    ) -> AcceptCharsetValidHeader | AcceptCharsetNoHeader: ...
    def copy(self) -> Self: ...
    def acceptable_offers(self, offers: Iterable[str]) -> list[tuple[str, float]]: ...
    @overload
    def best_match(self, offers: Iterable[str], default_match: None = None) -> str | None: ...
    @overload
    def best_match(self, offers: Iterable[str], default_match: str) -> str: ...
    def quality(self, offer: str) -> float | None: ...

class AcceptCharsetNoHeader(_AcceptCharsetInvalidOrNoHeader):
    @property
    def header_value(self) -> None: ...
    def __init__(self) -> None: ...

class AcceptCharsetInvalidHeader(_AcceptCharsetInvalidOrNoHeader):
    @property
    def header_value(self) -> str: ...
    def __init__(self, header_value: str) -> None: ...

@overload
def create_accept_charset_header(header_value: None) -> AcceptCharsetNoHeader: ...
@overload
def create_accept_charset_header(header_value: str) -> AcceptCharsetValidHeader | AcceptCharsetInvalidHeader: ...

class _AcceptCharsetProperty:
    @overload
    def __get__(self, __obj: None, __type: type | None = ...) -> property: ...
    @overload
    def __get__(
        self, __obj: Any, __type: type | None = ...
    ) -> AcceptCharsetNoHeader | AcceptCharsetValidHeader | AcceptCharsetInvalidHeader: ...
    @overload
    def __set__(self, __obj: Any, __value: str | None) -> None: ...
    @overload
    def __set__(
        self, __obj: Any, __value: AcceptCharsetNoHeader | AcceptCharsetValidHeader | AcceptCharsetInvalidHeader
    ) -> None: ...
    @overload
    def __set__(self, __obj: Any, __value: SupportsItems[str, float]) -> None: ...
    @overload
    def __set__(self, __obj: Any, __value: _ListOrTuple[str | tuple[str, float] | list[Any]]) -> None: ...
    def __delete__(self, __obj: Any) -> None: ...

def accept_charset_property() -> _AcceptCharsetProperty: ...

class AcceptEncoding:
    @classmethod
    def parse(cls, value: str) -> Iterator[tuple[str, float]]: ...

class AcceptEncodingValidHeader(AcceptEncoding):
    @property
    def header_value(self) -> str: ...
    @property
    def parsed(self) -> list[tuple[str, float]]: ...
    def __init__(self, header_value: str) -> None: ...
    def copy(self) -> Self: ...
    @overload
    def __add__(self, other: str | None) -> Self: ...
    @overload
    def __add__(self, other: AcceptEncodingValidHeader | AcceptEncodingNoHeader | AcceptEncodingInvalidHeader) -> Self: ...
    @overload
    def __add__(self, other: SupportsItems[str, float]) -> Self: ...
    @overload
    def __add__(self, other: _ListOrTuple[str | tuple[str, float] | list[Any]]) -> Self: ...
    def __bool__(self) -> Literal[True]: ...
    def __contains__(self, offer: str) -> bool: ...
    def __iter__(self) -> Iterator[str]: ...
    @overload
    def __radd__(self, other: str | None) -> Self: ...
    @overload
    def __radd__(self, other: AcceptEncodingValidHeader | AcceptEncodingNoHeader | AcceptEncodingInvalidHeader) -> Self: ...
    @overload
    def __radd__(self, other: SupportsItems[str, float]) -> Self: ...
    @overload
    def __radd__(self, other: _ListOrTuple[str | tuple[str, float] | list[Any]]) -> Self: ...
    def acceptable_offers(self, offers: Iterable[str]) -> list[tuple[str, float]]: ...
    @overload
    def best_match(self, offers: Iterable[str], default_match: None = None) -> str | None: ...
    @overload
    def best_match(self, offers: Iterable[str], default_match: str) -> str: ...
    def quality(self, offer: str) -> float | None: ...

class _AcceptEncodingInvalidOrNoHeader(AcceptEncoding):
    @property
    def parsed(self) -> None: ...
    def __bool__(self) -> Literal[False]: ...
    def __contains__(self, offer: str) -> Literal[True]: ...
    def __iter__(self) -> Iterator[str]: ...
    @overload
    def __add__(self, other: None) -> AcceptEncodingNoHeader: ...
    @overload
    def __add__(self, other: str) -> AcceptEncodingValidHeader | AcceptEncodingNoHeader: ...
    @overload
    def __add__(self, other: AcceptEncodingValidHeader) -> AcceptEncodingValidHeader: ...
    @overload
    def __add__(self, other: AcceptEncodingNoHeader | AcceptEncodingInvalidHeader) -> AcceptEncodingNoHeader: ...
    @overload
    def __add__(self, other: SupportsItems[str, float]) -> AcceptEncodingValidHeader | AcceptEncodingNoHeader: ...
    @overload
    def __add__(
        self, other: _ListOrTuple[str | tuple[str, float] | list[Any]]
    ) -> AcceptEncodingValidHeader | AcceptEncodingNoHeader: ...
    @overload
    def __radd__(self, other: None) -> AcceptEncodingNoHeader: ...
    @overload
    def __radd__(self, other: str) -> AcceptEncodingValidHeader | AcceptEncodingNoHeader: ...
    @overload
    def __radd__(self, other: AcceptEncodingValidHeader) -> AcceptEncodingValidHeader: ...
    @overload
    def __radd__(self, other: AcceptEncodingNoHeader | AcceptEncodingInvalidHeader) -> AcceptEncodingNoHeader: ...
    @overload
    def __radd__(self, other: SupportsItems[str, float]) -> AcceptEncodingValidHeader | AcceptEncodingNoHeader: ...
    @overload
    def __radd__(
        self, other: _ListOrTuple[str | tuple[str, float] | list[Any]]
    ) -> AcceptEncodingValidHeader | AcceptEncodingNoHeader: ...
    def copy(self) -> Self: ...
    def acceptable_offers(self, offers: Iterable[str]) -> list[tuple[str, float]]: ...
    @overload
    def best_match(self, offers: Iterable[str], default_match: None = None) -> str | None: ...
    @overload
    def best_match(self, offers: Iterable[str], default_match: str) -> str: ...
    def quality(self, offer: str) -> float | None: ...

class AcceptEncodingNoHeader(_AcceptEncodingInvalidOrNoHeader):
    @property
    def header_value(self) -> None: ...
    def __init__(self) -> None: ...

class AcceptEncodingInvalidHeader(_AcceptEncodingInvalidOrNoHeader):
    @property
    def header_value(self) -> str: ...
    def __init__(self, header_value: str) -> None: ...

@overload
def create_accept_encoding_header(header_value: None) -> AcceptEncodingNoHeader: ...
@overload
def create_accept_encoding_header(header_value: str) -> AcceptEncodingValidHeader | AcceptEncodingInvalidHeader: ...

class _AcceptEncodingProperty:
    @overload
    def __get__(self, __obj: None, __type: type | None = ...) -> property: ...
    @overload
    def __get__(
        self, __obj: Any, __type: type | None = ...
    ) -> AcceptEncodingNoHeader | AcceptEncodingValidHeader | AcceptEncodingInvalidHeader: ...
    @overload
    def __set__(self, __obj: Any, __value: str | None) -> None: ...
    @overload
    def __set__(
        self, __obj: Any, __value: AcceptEncodingNoHeader | AcceptEncodingValidHeader | AcceptEncodingInvalidHeader
    ) -> None: ...
    @overload
    def __set__(self, __obj: Any, __value: SupportsItems[str, float]) -> None: ...
    @overload
    def __set__(self, __obj: Any, __value: _ListOrTuple[str | tuple[str, float] | list[Any]]) -> None: ...
    def __delete__(self, __obj: Any) -> None: ...

def accept_encoding_property() -> _AcceptEncodingProperty: ...

class AcceptLanguage:
    @classmethod
    def parse(cls, value: str) -> Iterator[tuple[str, float]]: ...

class AcceptLanguageValidHeader(AcceptLanguage):
    @property
    def header_value(self) -> str: ...
    @property
    def parsed(self) -> list[tuple[str, float]]: ...
    def __init__(self, header_value: str) -> None: ...
    def copy(self) -> Self: ...
    @overload
    def __add__(self, other: str | None) -> Self: ...
    @overload
    def __add__(self, other: AcceptLanguageValidHeader | AcceptLanguageNoHeader | AcceptLanguageInvalidHeader) -> Self: ...
    @overload
    def __add__(self, other: SupportsItems[str, float]) -> Self: ...
    @overload
    def __add__(self, other: _ListOrTuple[str | tuple[str, float] | list[Any]]) -> Self: ...
    def __bool__(self) -> Literal[True]: ...
    def __contains__(self, offer: str) -> bool: ...
    def __iter__(self) -> Iterator[str]: ...
    @overload
    def __radd__(self, other: str | None) -> Self: ...
    @overload
    def __radd__(self, other: AcceptLanguageValidHeader | AcceptLanguageNoHeader | AcceptLanguageInvalidHeader) -> Self: ...
    @overload
    def __radd__(self, other: SupportsItems[str, float]) -> Self: ...
    @overload
    def __radd__(self, other: _ListOrTuple[str | tuple[str, float] | list[Any]]) -> Self: ...
    def basic_filtering(self, language_tags: Iterable[str]) -> list[tuple[str, float]]: ...
    @overload
    def best_match(self, offers: Iterable[str], default_match: None = None) -> str | None: ...
    @overload
    def best_match(self, offers: Iterable[str], default_match: str) -> str: ...
    @overload
    def lookup(
        self,
        language_tags: Iterable[str],
        default_range: str | None = None,
        default_tag: str = ...,
        default: str | Callable[[], str | None] | None = None,
    ) -> str | None: ...
    @overload
    def lookup(
        self,
        language_tags: Iterable[str],
        default_range: str | None = None,
        default_tag: str | None = None,
        default: str | Callable[[], str | None] = ...,
    ) -> str | None: ...
    def quality(self, offer: str) -> float | None: ...

class _AcceptLanguageInvalidOrNoHeader(AcceptLanguage):
    @property
    def parsed(self) -> None: ...
    def __bool__(self) -> Literal[False]: ...
    def __contains__(self, offer: str) -> Literal[True]: ...
    def __iter__(self) -> Iterator[str]: ...
    @overload
    def __add__(self, other: None) -> AcceptLanguageNoHeader: ...
    @overload
    def __add__(self, other: str) -> AcceptLanguageValidHeader | AcceptLanguageNoHeader: ...
    @overload
    def __add__(self, other: AcceptLanguageValidHeader) -> AcceptLanguageValidHeader: ...
    @overload
    def __add__(self, other: AcceptLanguageNoHeader | AcceptLanguageInvalidHeader) -> AcceptLanguageNoHeader: ...
    @overload
    def __add__(self, other: SupportsItems[str, float]) -> AcceptLanguageValidHeader | AcceptLanguageNoHeader: ...
    @overload
    def __add__(
        self, other: _ListOrTuple[str | tuple[str, float] | list[Any]]
    ) -> AcceptLanguageValidHeader | AcceptLanguageNoHeader: ...
    @overload
    def __radd__(self, other: None) -> AcceptLanguageNoHeader: ...
    @overload
    def __radd__(self, other: str) -> AcceptLanguageValidHeader | AcceptLanguageNoHeader: ...
    @overload
    def __radd__(self, other: AcceptLanguageValidHeader) -> AcceptLanguageValidHeader: ...
    @overload
    def __radd__(self, other: AcceptLanguageNoHeader | AcceptLanguageInvalidHeader) -> AcceptLanguageNoHeader: ...
    @overload
    def __radd__(self, other: SupportsItems[str, float]) -> AcceptLanguageValidHeader | AcceptLanguageNoHeader: ...
    @overload
    def __radd__(
        self, other: _ListOrTuple[str | tuple[str, float] | list[Any]]
    ) -> AcceptLanguageValidHeader | AcceptLanguageNoHeader: ...
    def copy(self) -> Self: ...
    def basic_filtering(self, language_tags: Iterable[str]) -> list[tuple[str, float]]: ...
    @overload
    def best_match(self, offers: Iterable[str], default_match: None = None) -> str | None: ...
    @overload
    def best_match(self, offers: Iterable[str], default_match: str) -> str: ...
    @overload
    def lookup(
        self,
        language_tags: Iterable[str],
        default_range: str | None = None,
        default_tag: str = ...,
        default: str | Callable[[], str | None] | None = None,
    ) -> str | None: ...
    @overload
    def lookup(
        self,
        language_tags: Iterable[str],
        default_range: str | None = None,
        default_tag: str | None = None,
        default: str | Callable[[], str | None] = ...,
    ) -> str | None: ...
    def quality(self, offer: str) -> float | None: ...

class AcceptLanguageNoHeader(_AcceptLanguageInvalidOrNoHeader):
    def __init__(self) -> None: ...
    @property
    def header_value(self) -> None: ...

class AcceptLanguageInvalidHeader(_AcceptLanguageInvalidOrNoHeader):
    def __init__(self, header_value: str) -> None: ...
    @property
    def header_value(self) -> str: ...

@overload
def create_accept_language_header(header_value: None) -> AcceptLanguageNoHeader: ...
@overload
def create_accept_language_header(header_value: str) -> AcceptLanguageValidHeader | AcceptLanguageInvalidHeader: ...

class _AcceptLanguageProperty:
    @overload
    def __get__(self, __obj: None, __type: type | None = ...) -> property: ...
    @overload
    def __get__(
        self, __obj: Any, __type: type | None = ...
    ) -> AcceptLanguageNoHeader | AcceptLanguageValidHeader | AcceptLanguageInvalidHeader: ...
    @overload
    def __set__(self, __obj: Any, __value: str | None) -> None: ...
    @overload
    def __set__(
        self, __obj: Any, __value: AcceptLanguageNoHeader | AcceptLanguageValidHeader | AcceptLanguageInvalidHeader
    ) -> None: ...
    @overload
    def __set__(self, __obj: Any, __value: SupportsItems[str, float]) -> None: ...
    @overload
    def __set__(self, __obj: Any, __value: _ListOrTuple[str | tuple[str, float] | list[Any]]) -> None: ...
    def __delete__(self, __obj: Any) -> None: ...

def accept_language_property() -> _AcceptLanguageProperty: ...