feat: localize library type stubs

Author: aekasitt

src/itsdangerous.pyi

@@ -0,0 +1,50 @@
+#!/usr/bin/env python3.9
+# Copyright (C) 2020-2025 All rights reserved.
+# FILENAME:    ~~/src/itsdangerous.pyi
+# VERSION:     1.0.2
+# CREATED:     2025-03-21 15:43
+# AUTHOR:      Sitt Guruvanich <aekazitt+github@gmail.com>
+# DESCRIPTION: https://mypy.readthedocs.io/en/stable/stubs.html
+#
+# HISTORY:
+# *************************************************************
+"""Stub file containing a skeleton of the public interface of `itsdangerous` library"""
+
+from abc import ABCMeta
+from collections.abc import Iterable
+from typing import Any, Generic, Protocol, TYPE_CHECKING, Union
+from typing_extensions import TypeVar
+
+class BadData(Exception, metaclass=ABCMeta): ...
+class BadSignature(BadData, metaclass=ABCMeta): ...
+class BadTimeSignature(BadSignature, metaclass=ABCMeta): ...
+class SignatureExpired(BadTimeSignature, metaclass=ABCMeta): ...
+
+if TYPE_CHECKING:
+  _TSerialized = TypeVar(
+    "_TSerialized", bound=Union[str, bytes], default=Union[str, bytes], covariant=True
+  )
+else:
+  _TSerialized = TypeVar("_TSerialized", bound=Union[str, bytes], covariant=True)
+
+class _PDataSerializer(Protocol[_TSerialized], metaclass=ABCMeta): ...
+
+class Serializer(Generic[_TSerialized], metaclass=ABCMeta):
+  def __init__(
+    self: Serializer[str],
+    secret_key: str | bytes | Iterable[str] | Iterable[bytes],
+    salt: str | bytes | None = b"itsdangerous",
+    serializer: None | _PDataSerializer[str] = None,
+    serializer_kwargs: dict[str, Any] | None = None,
+    signer: type[Signer] | None = None,
+    signer_kwargs: dict[str, Any] | None = None,
+    fallback_signers: list[dict[str, Any] | tuple[type[Signer], dict[str, Any]] | type[Signer]]
+    | None = None,
+  ): ...
+  def dumps(self, obj: Any, salt: str | bytes | None = None) -> _TSerialized: ...
+  def loads(self, s: str | bytes, salt: str | bytes | None = None, **kwargs: Any) -> Any: ...
+
+class Signer(metaclass=ABCMeta): ...
+class TimedSerializer(Serializer[_TSerialized], metaclass=ABCMeta): ...
+class URLSafeSerializerMixin(Serializer[str], metaclass=ABCMeta): ...
+class URLSafeTimedSerializer(URLSafeSerializerMixin, TimedSerializer[str], metaclass=ABCMeta): ...

src/pydantic.pyi

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3.9
+# Copyright (C) 2020-2025 All rights reserved.
+# FILENAME:    ~~/src/pydantic.pyi
+# VERSION:     1.0.2
+# CREATED:     2025-03-21 15:43
+# AUTHOR:      Sitt Guruvanich <aekazitt+github@gmail.com>
+# DESCRIPTION: https://mypy.readthedocs.io/en/stable/stubs.html
+#
+# HISTORY:
+# *************************************************************
+"""Stub file containing a skeleton of the public interface of `pydantic` library"""
+
+from abc import ABCMeta
+from typing import Any, Literal, Generator, Mapping, Set, Tuple, TypeAlias, Union
+from typing_extensions import Annotated, Self
+
+class BaseModel(metaclass=ABCMeta):
+  def __iter__(self) -> TupleGenerator: ...
+  def model_dump(
+    self,
+    *,
+    mode: Literal["json", "python"] | str = "python",
+    include: IncEx | None = None,
+    exclude: IncEx | None = None,
+    context: Any | None = None,
+    by_alias: bool = False,
+    exclude_unset: bool = False,
+    exclude_defaults: bool = False,
+    exclude_none: bool = False,
+    round_trip: bool = False,
+    warnings: bool | Literal["none", "warn", "error"] = True,
+    serialize_as_any: bool = False,
+  ) -> dict[str, Any]: ...
+  @classmethod
+  def model_validate_json(
+    cls,
+    json_data: str | bytes | bytearray,
+    *,
+    strict: bool | None = None,
+    context: Any | None = None,
+  ) -> Self: ...
+
+IncEx: TypeAlias = Union[
+  Set[int], Set[str], Mapping[int, Union["IncEx", bool]], Mapping[str, Union["IncEx", bool]]
+]
+StrictBool = Annotated[bool, ...]
+StrictInt = Annotated[int, ...]
+StrictStr = Annotated[str, ...]
+TupleGenerator: TypeAlias = Generator[Tuple[str, Any], None, None]
+
+class ValidationError(ValueError, metaclass=ABCMeta): ...
+
+def create_model(model_name: str) -> type[BaseModel]: ...
+def model_validator(*, mode: Literal["wrap", "before", "after"]) -> Any: ...

src/pydantic_settings.pyi

@@ -0,0 +1,16 @@
+#!/usr/bin/env python3.9
+# Copyright (C) 2020-2025 All rights reserved.
+# FILENAME:    ~~/src/pydantic_settings.pyi
+# VERSION:     1.0.2
+# CREATED:     2025-03-21 15:43
+# AUTHOR:      Sitt Guruvanich <aekazitt+github@gmail.com>
+# DESCRIPTION: https://mypy.readthedocs.io/en/stable/stubs.html
+#
+# HISTORY:
+# *************************************************************
+"""Stub file containing a skeleton of the public interface of `pydantic_settings` library"""
+
+from abc import ABCMeta
+from pydantic import BaseModel
+
+class BaseSettings(BaseModel, metaclass=ABCMeta): ...

src/starlette/datastructures.pyi

@@ -0,0 +1,18 @@
+#!/usr/bin/env python3.9
+# Copyright (C) 2020-2025 All rights reserved.
+# FILENAME:    ~~/src/starlette/datastructures.pyi
+# VERSION:     1.0.2
+# CREATED:     2025-03-21 15:43
+# AUTHOR:      Sitt Guruvanich <aekazitt+github@gmail.com>
+# DESCRIPTION: https://mypy.readthedocs.io/en/stable/stubs.html
+#
+# HISTORY:
+# *************************************************************
+"""Stub file containing a skeleton of the public interface of `starlette.datastructures` module"""
+
+from abc import ABCMeta
+from typing import Mapping
+
+class Headers(Mapping[str, str], metaclass=ABCMeta): ...
+class MutableHeaders(Headers, metaclass=ABCMeta): ...
+class UploadFile(metaclass=ABCMeta): ...

src/starlette/requests.pyi

@@ -0,0 +1,23 @@
+#!/usr/bin/env python3.9
+# Copyright (C) 2020-2025 All rights reserved.
+# FILENAME:    ~~/src/starlette/requests.pyi
+# VERSION:     1.0.2
+# CREATED:     2025-03-21 15:43
+# AUTHOR:      Sitt Guruvanich <aekazitt+github@gmail.com>
+# DESCRIPTION: https://mypy.readthedocs.io/en/stable/stubs.html
+#
+# HISTORY:
+# *************************************************************
+"""Stub file containing a skeleton of the public interface of `starlette.requests` module"""
+
+from abc import ABCMeta
+from typing import Any, Dict, Mapping
+
+from starlette.datastructures import MutableHeaders
+
+class Request(Mapping[str, Any], metaclass=ABCMeta):
+  async def body(self) -> bytes: ...
+  @property
+  def cookies(self) -> Dict[str, str]: ...
+  @property
+  def headers(self) -> MutableHeaders: ...

src/starlette/responses.pyi

@@ -0,0 +1,42 @@
+#!/usr/bin/env python3.9
+# Copyright (C) 2020-2025 All rights reserved.
+# FILENAME:    ~~/src/starlette/responses.pyi
+# VERSION:     1.0.2
+# CREATED:     2025-03-21 15:43
+# AUTHOR:      Sitt Guruvanich <aekazitt+github@gmail.com>
+# DESCRIPTION: https://mypy.readthedocs.io/en/stable/stubs.html
+#
+# HISTORY:
+# *************************************************************
+"""Stub file containing a skeleton of the public interface of `starlette.responses` module"""
+
+from abc import ABCMeta, abstractmethod
+from datetime import datetime
+from typing import Any, Literal, Mapping
+
+class HTTPConnection(Mapping[str, Any], metaclass=ABCMeta): ...
+
+class Response(HTTPConnection, metaclass=ABCMeta):
+  @abstractmethod
+  def delete_cookie(
+    self,
+    key: str,
+    path: str = "/",
+    domain: str | None = None,
+    secure: bool = False,
+    httponly: bool = False,
+    samesite: Literal["lax", "strict", "none"] | None = "lax",
+  ) -> None: ...
+  @abstractmethod
+  def set_cookie(
+    self,
+    key: str,
+    value: str = "",
+    max_age: int | None = None,
+    expires: datetime | str | int | None = None,
+    path: str | None = "/",
+    domain: str | None = None,
+    secure: bool = False,
+    httponly: bool = False,
+    samesite: Literal["lax", "strict", "none"] | None = "lax",
+  ) -> None: ...