basedpyright 1.28.3 → 1.28.4

package/dist/typeshed-fallback/stubs/WebOb/webob/descriptors.pyi

@@ -1,18 +1,25 @@
 from collections.abc import Callable, Iterable
 from datetime import date, datetime, timedelta
 from time import _TimeTuple, struct_time
-from typing import Any, Generic, NamedTuple, TypeVar, overload
+from typing import Any, NamedTuple, TypeVar, overload
 from typing_extensions import TypeAlias
 
+from webob._types import AsymmetricProperty, AsymmetricPropertyWithDelete, SymmetricProperty, SymmetricPropertyWithDelete
 from webob.byterange import ContentRange, Range
 from webob.etag import IfRange, IfRangeDate
 
-_T = TypeVar("_T")
 _DefaultT = TypeVar("_DefaultT")
 _GetterReturnType = TypeVar("_GetterReturnType")
 _SetterValueType = TypeVar("_SetterValueType")
 _ConvertedGetterReturnType = TypeVar("_ConvertedGetterReturnType")
 _ConvertedSetterValueType = TypeVar("_ConvertedSetterValueType")
+_DescriptorT = TypeVar("_DescriptorT", bound=AsymmetricPropertyWithDelete[Any, Any])
+
+_StringProperty: TypeAlias = SymmetricPropertyWithDelete[str | None]
+_ListProperty: TypeAlias = AsymmetricPropertyWithDelete[tuple[str, ...] | None, Iterable[str] | str | None]
+_DateProperty: TypeAlias = AsymmetricPropertyWithDelete[
+    datetime | None, date | datetime | timedelta | _TimeTuple | struct_time | float | str | None
+]
 _ContentRangeParams: TypeAlias = (
     ContentRange
     | list[int]
@@ -26,66 +33,48 @@ _ContentRangeParams: TypeAlias = (
     | None
 )
 
-class _AsymmetricProperty(Generic[_GetterReturnType, _SetterValueType]):
-    @overload
-    def __get__(self, obj: None, type: type | None = ..., /) -> property: ...
-    @overload
-    def __get__(self, obj: Any, type: type | None = ..., /) -> _GetterReturnType: ...
-    def __set__(self, obj: Any, value: _SetterValueType, /) -> None: ...
-
-class _AsymmetricPropertyWithDelete(_AsymmetricProperty[_GetterReturnType, _SetterValueType]):
-    def __delete__(self, obj: Any, /) -> None: ...
-
-class _SymmetricProperty(_AsymmetricProperty[_T, _T]): ...
-class _SymmetricPropertyWithDelete(_AsymmetricPropertyWithDelete[_T, _T]): ...
-class _StringProperty(_SymmetricPropertyWithDelete[str | None]): ...
-class _ListProperty(_AsymmetricPropertyWithDelete[tuple[str, ...] | None, Iterable[str] | str | None]): ...
-class _DateProperty(
-    _AsymmetricPropertyWithDelete[datetime | None, date | datetime | timedelta | _TimeTuple | struct_time | float | str | None]
-): ...
-
 @overload
-def environ_getter(key: str, default: None, rfc_section: str | None = None) -> _SymmetricPropertyWithDelete[Any | None]: ...
+def environ_getter(key: str, *, rfc_section: str | None = None) -> SymmetricProperty[Any]: ...
+@overload
+def environ_getter(key: str, default: None, rfc_section: str | None = None) -> SymmetricPropertyWithDelete[Any | None]: ...
 @overload
 def environ_getter(
     key: str, default: _DefaultT, rfc_section: str | None = None
-) -> _AsymmetricPropertyWithDelete[Any | _DefaultT, Any | _DefaultT | None]: ...
+) -> AsymmetricPropertyWithDelete[Any | _DefaultT, Any | _DefaultT | None]: ...
 @overload
-def environ_getter(key: str, *, rfc_section: str | None = None) -> _SymmetricProperty[Any]: ...
+def environ_decoder(key: str, *, rfc_section: str | None = None, encattr: str | None = None) -> SymmetricProperty[str]: ...
 @overload
 def environ_decoder(
     key: str, default: str, rfc_section: str | None = None, encattr: str | None = None
-) -> _AsymmetricPropertyWithDelete[str, str | None]: ...
+) -> AsymmetricPropertyWithDelete[str, str | None]: ...
 @overload
 def environ_decoder(
     key: str, default: None, rfc_section: str | None = None, encattr: str | None = None
-) -> _SymmetricPropertyWithDelete[str | None]: ...
-@overload
-def environ_decoder(key: str, *, rfc_section: str | None = None, encattr: str | None = None) -> _SymmetricProperty[str]: ...
-def upath_property(key: str) -> _SymmetricProperty[str]: ...
-def deprecated_property(attr: _T, name: str, text: str, version: str) -> _T: ...
+) -> SymmetricPropertyWithDelete[str | None]: ...
+def upath_property(key: str) -> SymmetricProperty[str]: ...
+def deprecated_property(attr: _DescriptorT, name: str, text: str, version: str) -> _DescriptorT: ...
 def header_getter(header: str, rfc_section: str) -> _StringProperty: ...
 @overload
 def converter(
-    prop: _AsymmetricPropertyWithDelete[_GetterReturnType, _SetterValueType],
+    prop: AsymmetricPropertyWithDelete[_GetterReturnType, _SetterValueType],
     parse: Callable[[_GetterReturnType], _ConvertedGetterReturnType],
     serialize: Callable[[_ConvertedSetterValueType], _SetterValueType],
     convert_name: str | None = None,
-) -> _AsymmetricPropertyWithDelete[_ConvertedGetterReturnType, _ConvertedSetterValueType]: ...
+) -> AsymmetricPropertyWithDelete[_ConvertedGetterReturnType, _ConvertedSetterValueType | None]: ...
 @overload
 def converter(
-    prop: _AsymmetricProperty[_GetterReturnType, _SetterValueType],
+    prop: AsymmetricProperty[_GetterReturnType, _SetterValueType],
     parse: Callable[[_GetterReturnType], _ConvertedGetterReturnType],
     serialize: Callable[[_ConvertedSetterValueType], _SetterValueType],
     convert_name: str | None = None,
-) -> _AsymmetricProperty[_ConvertedGetterReturnType, _ConvertedSetterValueType]: ...
+) -> AsymmetricProperty[_ConvertedGetterReturnType, _ConvertedSetterValueType | None]: ...
 def list_header(header: str, rfc_section: str) -> _ListProperty: ...
 def parse_list(value: str | None) -> tuple[str, ...] | None: ...
 def serialize_list(value: Iterable[str] | str) -> str: ...
 def converter_date(prop: _StringProperty) -> _DateProperty: ...
 def date_header(header: str, rfc_section: str) -> _DateProperty: ...
 def parse_etag_response(value: str | None, strong: bool = False) -> str | None: ...
-def serialize_etag_response(value: str | tuple[str, bool]) -> str: ...
+def serialize_etag_response(value: tuple[str, bool] | str) -> str: ...
 def serialize_if_range(value: IfRange | IfRangeDate | datetime | date | str) -> str | None: ...
 def parse_range(value: str | None) -> Range | None: ...
 def serialize_range(value: tuple[int, int | None] | list[int | None] | list[int] | str | None) -> str | None: ...

package/dist/typeshed-fallback/stubs/WebOb/webob/etag.pyi

@@ -1,41 +1,34 @@
 from collections.abc import Collection
 from datetime import datetime
-from typing import Any, overload
+from typing import Literal
 from typing_extensions import TypeAlias
 
+from webob._types import AsymmetricPropertyWithDelete
 from webob.response import Response
 
-_ETag: TypeAlias = _AnyETag | _NoETag | ETagMatcher
+__all__ = ["AnyETag", "NoETag", "ETagMatcher", "IfRange", "etag_property"]
 
-class _ETagProperty:
-    @overload
-    def __get__(self, obj: None, type: type | None = ..., /) -> property: ...
-    @overload
-    def __get__(self, obj: Any, type: type | None = ..., /) -> _ETag: ...
-    @overload
-    def __set__(self, obj: Any, value: str | None, /) -> None: ...
-    @overload
-    def __set__(self, obj: Any, value: _ETag, /) -> None: ...
-    def __delete__(self, obj: Any, /) -> None: ...
+_ETag: TypeAlias = _AnyETag | _NoETag | ETagMatcher
+_ETagProperty: TypeAlias = AsymmetricPropertyWithDelete[_ETag, _ETag | str | None]
 
 def etag_property(key: str, default: _ETag, rfc_section: str, strong: bool = True) -> _ETagProperty: ...
 
 class _AnyETag:
-    def __bool__(self) -> bool: ...
-    def __contains__(self, other: str) -> bool: ...
+    def __bool__(self) -> Literal[False]: ...
+    def __contains__(self, other: str | None) -> Literal[True]: ...
 
 AnyETag: _AnyETag
 
 class _NoETag:
-    def __bool__(self) -> bool: ...
-    def __contains__(self, other: str) -> bool: ...
+    def __bool__(self) -> Literal[False]: ...
+    def __contains__(self, other: str | None) -> Literal[False]: ...
 
 NoETag: _NoETag
 
 class ETagMatcher:
     etags: Collection[str]
     def __init__(self, etags: Collection[str]) -> None: ...
-    def __contains__(self, other: str) -> bool: ...
+    def __contains__(self, other: str | None) -> bool: ...
     @classmethod
     def parse(cls, value: str, strong: bool = True) -> ETagMatcher | _AnyETag: ...
 
@@ -43,7 +36,7 @@ class IfRange:
     etag: _ETag
     def __init__(self, etag: _ETag) -> None: ...
     @classmethod
-    def parse(cls, value: str) -> IfRange | IfRangeDate: ...
+    def parse(cls, value: str | None) -> IfRange | IfRangeDate: ...
     def __contains__(self, resp: Response) -> bool: ...
     def __bool__(self) -> bool: ...
 

package/dist/typeshed-fallback/stubs/WebOb/webob/exc.pyi

@@ -3,12 +3,73 @@ from _typeshed.wsgi import StartResponse, WSGIApplication, WSGIEnvironment
 from collections.abc import Iterable
 from string import Template
 from typing import Any, Literal, Protocol
-from typing_extensions import Self
+from typing_extensions import Self, TypeAlias
 
 from webob.response import Response
 
+__all__ = [
+    "HTTPAccepted",
+    "HTTPBadGateway",
+    "HTTPBadRequest",
+    "HTTPClientError",
+    "HTTPConflict",
+    "HTTPCreated",
+    "HTTPError",
+    "HTTPExpectationFailed",
+    "HTTPFailedDependency",
+    "HTTPForbidden",
+    "HTTPFound",
+    "HTTPGatewayTimeout",
+    "HTTPGone",
+    "HTTPInsufficientStorage",
+    "HTTPInternalServerError",
+    "HTTPLengthRequired",
+    "HTTPLocked",
+    "HTTPMethodNotAllowed",
+    "HTTPMovedPermanently",
+    "HTTPMultipleChoices",
+    "HTTPNetworkAuthenticationRequired",
+    "HTTPNoContent",
+    "HTTPNonAuthoritativeInformation",
+    "HTTPNotAcceptable",
+    "HTTPNotFound",
+    "HTTPNotImplemented",
+    "HTTPNotModified",
+    "HTTPOk",
+    "HTTPPartialContent",
+    "HTTPPaymentRequired",
+    "HTTPPermanentRedirect",
+    "HTTPPreconditionFailed",
+    "HTTPPreconditionRequired",
+    "HTTPProxyAuthenticationRequired",
+    "HTTPRedirection",
+    "HTTPRequestEntityTooLarge",
+    "HTTPRequestHeaderFieldsTooLarge",
+    "HTTPRequestRangeNotSatisfiable",
+    "HTTPRequestTimeout",
+    "HTTPRequestURITooLong",
+    "HTTPResetContent",
+    "HTTPSeeOther",
+    "HTTPServerError",
+    "HTTPServiceUnavailable",
+    "HTTPTemporaryRedirect",
+    "HTTPTooManyRequests",
+    "HTTPUnauthorized",
+    "HTTPUnavailableForLegalReasons",
+    "HTTPUnprocessableEntity",
+    "HTTPUnsupportedMediaType",
+    "HTTPUseProxy",
+    "HTTPVersionNotSupported",
+    "WSGIHTTPException",
+    "HTTPException",
+    "HTTPExceptionMiddleware",
+    "status_map",
+]
+
+_Headers: TypeAlias = SupportsItems[str, str] | SupportsKeysAndGetItem[str, str] | Iterable[tuple[str, str]]
+
 class _JSONFormatter(Protocol):
-    def __call__(self, *, body: str, status: str, title: str, environ: WSGIEnvironment) -> str: ...
+    def __call__(self, *, body: str, status: str, title: str, environ: WSGIEnvironment) -> Any: ...
 
 class HTTPException(Exception):
     wsgi_response: Response
@@ -28,7 +89,7 @@ class WSGIHTTPException(Response, HTTPException):
     def __init__(
         self,
         detail: str | None = None,
-        headers: SupportsItems[str, str] | SupportsKeysAndGetItem[str, str] | Iterable[tuple[str, str]] | None = None,
+        headers: _Headers | None = None,
         comment: str | None = None,
         body_template: str | None = None,
         json_formatter: _JSONFormatter | None = None,
@@ -36,9 +97,10 @@ class WSGIHTTPException(Response, HTTPException):
     ) -> None: ...
     def plain_body(self, environ: WSGIEnvironment) -> str: ...
     def html_body(self, environ: WSGIEnvironment) -> str: ...
-    def json_formatter(self, body: str, status: str, title: str, environ: WSGIEnvironment) -> str: ...
-    def json_body(self, environ: WSGIEnvironment) -> str: ...
+    def json_formatter(self, body: str, status: str, title: str, environ: WSGIEnvironment) -> Any: ...
+    def json_body(self, environ: WSGIEnvironment) -> str: ...  # type: ignore[override]
     def generate_response(self, environ: WSGIEnvironment, start_response: StartResponse) -> Iterable[bytes]: ...
+    def __call__(self, environ: WSGIEnvironment, start_response: StartResponse) -> Iterable[bytes]: ...
     @property
     def wsgi_response(self) -> Self: ...  # type: ignore[override]
     def __str__(self) -> str: ...  # type: ignore[override]  # noqa: Y029
@@ -64,12 +126,13 @@ class _HTTPMove(HTTPRedirection):
     def __init__(
         self,
         detail: str | None = None,
-        headers: str | None = None,
+        headers: _Headers | None = None,
         comment: str | None = None,
         body_template: str | None = None,
         location: str | None = None,
         add_slash: bool = False,
     ) -> None: ...
+    def __call__(self, environ: WSGIEnvironment, start_response: StartResponse) -> Iterable[bytes]: ...
 
 class HTTPMultipleChoices(_HTTPMove): ...
 class HTTPMovedPermanently(_HTTPMove): ...
@@ -123,4 +186,4 @@ class HTTPExceptionMiddleware:
     def __init__(self, application: WSGIApplication) -> None: ...
     def __call__(self, environ: WSGIEnvironment, start_response: StartResponse) -> Iterable[bytes]: ...
 
-status_map: dict[int, type[WSGIHTTPException]]
+status_map: dict[int, type[HTTPOk | HTTPRedirection | HTTPClientError | HTTPServerError]]

package/dist/typeshed-fallback/stubs/WebOb/webob/headers.pyi

@@ -1,9 +1,27 @@
 from _typeshed.wsgi import WSGIEnvironment
 from collections.abc import Iterator, MutableMapping
+from typing import TypeVar, overload
 
 from webob.multidict import MultiDict
 
-class ResponseHeaders(MultiDict[str, str]): ...
+__all__ = ["ResponseHeaders", "EnvironHeaders"]
+
+_T = TypeVar("_T")
+
+class ResponseHeaders(MultiDict[str, str]):
+    def __getitem__(self, key: str) -> str: ...
+    def getall(self, key: str) -> list[str]: ...
+    def mixed(self) -> dict[str, str | list[str]]: ...
+    def dict_of_lists(self) -> dict[str, list[str]]: ...
+    def __setitem__(self, key: str, value: str) -> None: ...
+    def __delitem__(self, key: str) -> None: ...
+    def __contains__(self, key: object) -> bool: ...
+    has_key = __contains__
+    def setdefault(self, key: str, default: str) -> str: ...  # type: ignore[override]
+    @overload
+    def pop(self, key: str) -> str: ...
+    @overload
+    def pop(self, key: str, default: _T) -> str | _T: ...
 
 class EnvironHeaders(MutableMapping[str, str]):
     environ: WSGIEnvironment
@@ -11,7 +29,7 @@ class EnvironHeaders(MutableMapping[str, str]):
     def __getitem__(self, hname: str) -> str: ...
     def __setitem__(self, hname: str, value: str) -> None: ...
     def __delitem__(self, hname: str) -> None: ...
-    def keys(self) -> list[str]: ...  # type: ignore[override]
+    def keys(self) -> Iterator[str]: ...  # type: ignore[override]
     def __contains__(self, hname: object) -> bool: ...
     def __len__(self) -> int: ...
     def __iter__(self) -> Iterator[str]: ...

package/dist/typeshed-fallback/stubs/WebOb/webob/multidict.pyi

@@ -1,30 +1,49 @@
-import sys
-from _typeshed import SupportsItems, SupportsKeysAndGetItem
+from _typeshed import SupportsKeysAndGetItem
 from _typeshed.wsgi import WSGIEnvironment
 from collections.abc import Collection, Iterable, Iterator, MutableMapping
-from typing import Any, Literal, TypeVar, overload
-from typing_extensions import Self, TypeAlias
+from typing import Literal, Protocol, TypeVar, overload
+from typing_extensions import Self
 
-if sys.version_info >= (3, 13):
-    _FieldStorage: TypeAlias = Any
-else:
-    from cgi import FieldStorage as _FieldStorage
+from webob.compat import cgi_FieldStorage, cgi_FieldStorage as _FieldStorageWithFile
+
+__all__ = ["MultiDict", "NestedMultiDict", "NoVars", "GetDict"]
 
 _T = TypeVar("_T")
 _KT = TypeVar("_KT")
 _VT = TypeVar("_VT")
+_KT_co = TypeVar("_KT_co", covariant=True)
+_VT_co = TypeVar("_VT_co", covariant=True)
+
+class _SupportsItemsWithIterableResult(Protocol[_KT_co, _VT_co]):
+    def items(self) -> Iterable[tuple[_KT_co, _VT_co]]: ...
 
 class MultiDict(MutableMapping[_KT, _VT]):
     @overload
-    def __init__(self, m: SupportsItems[_KT, _VT], /, **kwargs: _VT) -> None: ...
+    def __init__(self) -> None: ...
+    @overload
+    def __init__(self: MultiDict[str, _VT], **kwargs: _VT) -> None: ...  # pyright: ignore[reportInvalidTypeVarUse]  #11780
+    @overload
+    def __init__(self, m: _SupportsItemsWithIterableResult[_KT, _VT], /) -> None: ...
+    @overload
+    def __init__(
+        self: MultiDict[str, _VT],  # pyright: ignore[reportInvalidTypeVarUse]  #11780
+        m: _SupportsItemsWithIterableResult[str, _VT],
+        /,
+        **kwargs: _VT,
+    ) -> None: ...
     @overload
-    def __init__(self, m: Iterable[tuple[_KT, _VT]], /, **kwargs: _VT) -> None: ...
+    def __init__(self, m: Iterable[tuple[_KT, _VT]], /) -> None: ...
     @overload
-    def __init__(self, **kwargs: _VT) -> None: ...
+    def __init__(
+        self: MultiDict[str, _VT],  # pyright: ignore[reportInvalidTypeVarUse]  #11780
+        m: Iterable[tuple[str, _VT]],
+        /,
+        **kwargs: _VT,
+    ) -> None: ...
     @classmethod
-    def view_list(cls, lst: list[tuple[_KT, _VT]]) -> MultiDict[_KT, _VT]: ...
+    def view_list(cls, lst: list[tuple[_KT, _VT]]) -> Self: ...
     @classmethod
-    def from_fieldstorage(cls, fs: _FieldStorage) -> MultiDict[str, str | _FieldStorage]: ...
+    def from_fieldstorage(cls, fs: cgi_FieldStorage) -> MultiDict[str, str | _FieldStorageWithFile]: ...
     def __getitem__(self, key: _KT) -> _VT: ...
     def __setitem__(self, key: _KT, value: _VT) -> None: ...
     def add(self, key: _KT, value: _VT) -> None: ...
@@ -51,43 +70,90 @@ class MultiDict(MutableMapping[_KT, _VT]):
     def pop(self, key: _KT, default: _T) -> _VT | _T: ...
     def popitem(self) -> tuple[_KT, _VT]: ...
     @overload  # type: ignore[override]
-    def update(self, m: Collection[tuple[_KT, _VT]], /, **kwargs: _VT) -> None: ...
+    def update(self: MultiDict[str, _VT], **kwargs: _VT) -> None: ...
+    @overload
+    def update(self, m: Collection[tuple[_KT, _VT]], /) -> None: ...
+    @overload
+    def update(self: MultiDict[str, _VT], m: Collection[tuple[str, _VT]], /, **kwargs: _VT) -> None: ...
+    @overload
+    def extend(self, other: _SupportsItemsWithIterableResult[_KT, _VT]) -> None: ...
+    @overload
+    def extend(self: MultiDict[str, _VT], other: _SupportsItemsWithIterableResult[str, _VT], **kwargs: _VT) -> None: ...
     @overload
-    def update(self, **kwargs: _VT) -> None: ...
+    def extend(self, other: Iterable[tuple[_KT, _VT]]) -> None: ...
     @overload
-    def extend(self, other: SupportsItems[_KT, _VT], **kwargs: _VT) -> None: ...
+    def extend(self: MultiDict[str, _VT], other: Iterable[tuple[str, _VT]], **kwargs: _VT) -> None: ...
     @overload
-    def extend(self, other: SupportsKeysAndGetItem[_KT, _VT], **kwargs: _VT) -> None: ...
+    def extend(self, other: SupportsKeysAndGetItem[_KT, _VT]) -> None: ...
     @overload
-    def extend(self, other: Iterable[tuple[_KT, _VT]], **kwargs: _VT) -> None: ...
+    def extend(self: MultiDict[str, _VT], other: SupportsKeysAndGetItem[str, _VT], **kwargs: _VT) -> None: ...
     @overload
-    def extend(self, other: None = None, **kwargs: _VT) -> None: ...
+    def extend(self: MultiDict[str, _VT], other: None = None, **kwargs: _VT) -> None: ...
     def __len__(self) -> int: ...
     def keys(self) -> Iterator[_KT]: ...  # type: ignore[override]
     __iter__ = keys
-    def values(self) -> Iterator[_VT]: ...  # type: ignore[override]
     def items(self) -> Iterator[tuple[_KT, _VT]]: ...  # type: ignore[override]
+    def values(self) -> Iterator[_VT]: ...  # type: ignore[override]
 
 class GetDict(MultiDict[str, str]):
     env: WSGIEnvironment
     @overload
-    def __init__(self, data: SupportsItems[str, str], env: WSGIEnvironment) -> None: ...
+    def __init__(self, data: _SupportsItemsWithIterableResult[str, str], env: WSGIEnvironment) -> None: ...
     @overload
     def __init__(self, data: Iterable[tuple[str, str]], env: WSGIEnvironment) -> None: ...
     def on_change(self) -> None: ...
+    def __setitem__(self, key: str, value: str) -> None: ...
+    def add(self, key: str, value: str) -> None: ...
+    def __delitem__(self, key: str) -> None: ...
+    def clear(self) -> None: ...
+    def setdefault(self, key: str, default: str) -> str: ...  # type: ignore[override]
+    @overload
+    def pop(self, key: str) -> str: ...
+    @overload
+    def pop(self, key: str, default: _T) -> str | _T: ...
+    def popitem(self) -> tuple[str, str]: ...
+    @overload  # type: ignore[override]
+    def update(self, **kwargs: str) -> None: ...
+    @overload
+    def update(self, m: Collection[tuple[str, str]], /, **kwargs: str) -> None: ...
+    @overload
+    def extend(self, other: _SupportsItemsWithIterableResult[str, str], **kwargs: str) -> None: ...
+    @overload
+    def extend(self, other: Iterable[tuple[str, str]], **kwargs: str) -> None: ...
+    @overload
+    def extend(self, other: SupportsKeysAndGetItem[str, str], **kwargs: str) -> None: ...
+    @overload
+    def extend(self, other: None = None, **kwargs: str) -> None: ...
+    def copy(self) -> MultiDict[str, str]: ...  # type: ignore[override]
 
 class NestedMultiDict(MultiDict[_KT, _VT]):
-    dicts: tuple[MultiDict[_KT, _VT] | NoVars, ...]
-    def __init__(self, *dicts: MultiDict[_KT, _VT] | NoVars) -> None: ...
-    def __setitem__(self, key: _KT, value: _VT) -> None: ...
-    def add(self, key: _KT, value: _VT) -> None: ...
-    def __delitem__(self, key: _KT) -> None: ...
-    def clear(self) -> None: ...
-    def setdefault(self, key: _KT, default: _VT | None = ...) -> Any: ...
-    def pop(self, key: _KT, default: Any = ...) -> Any: ...
-    def popitem(self) -> tuple[_KT, _VT]: ...
-    def update(self, *args: Any, **kwargs: _VT) -> None: ...
+    # FIXME: It would be more accurate to use a Protocol here, which has a
+    #        covariant _VT, instead of MultiDict
+    dicts: tuple[MultiDict[_KT, _VT], ...]
+    def __init__(self, *dicts: MultiDict[_KT, _VT]) -> None: ...
+    def __getitem__(self, key: _KT) -> _VT: ...
+    # NOTE: These methods all return exceptions, so this will give us
+    #       somewhat sane type checker errors, we would prefer to use
+    #       something like @type_error here, if it existed.
+    #       This is only really necessary, because the inheritance hierachy
+    #       is a mess.
+    __setitem__: None  # type: ignore[assignment]
+    add: None  # type: ignore[assignment]
+    __delitem__: None  # type: ignore[assignment]
+    clear: None  # type: ignore[assignment]
+    setdefault: None  # type: ignore[assignment]
+    pop: None  # type: ignore[assignment]
+    popitem: None  # type: ignore[assignment]
+    update: None  # type: ignore[assignment]
+    def getall(self, key: _KT) -> list[_VT]: ...
     def copy(self) -> MultiDict[_KT, _VT]: ...  # type: ignore[override]
+    def __contains__(self, key: object) -> bool: ...
+    has_key = __contains__
+    def __len__(self) -> int: ...
+    def items(self) -> Iterator[tuple[_KT, _VT]]: ...  # type: ignore[override]
+    def values(self) -> Iterator[_VT]: ...  # type: ignore[override]
+    def keys(self) -> Iterator[_KT]: ...  # type: ignore[override]
+    __iter__ = keys
 
 class NoVars:
     reason: str