botocore-stubs 1.34.65__py3-none-any.whl → 1.35.98__py3-none-any.whl

botocore-stubs/discovery.pyi

@@ -1,13 +1,19 @@
+"""
+Type annotations for botocore.discovery module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 from logging import Logger
-from typing import Any, Callable, Dict, List, Optional
+from typing import Any, Callable, Mapping
 
 from botocore.client import BaseClient
 from botocore.exceptions import BotoCoreError as BotoCoreError
 from botocore.exceptions import ConnectionError as ConnectionError
 from botocore.exceptions import HTTPClientError as HTTPClientError
-from botocore.model import OperationModel
+from botocore.hooks import BaseEventHooks
+from botocore.model import OperationModel, ServiceModel
 from botocore.model import OperationNotFoundError as OperationNotFoundError
-from botocore.model import ServiceModel
 from botocore.utils import CachedProperty as CachedProperty
 
 logger: Logger = ...
@@ -20,37 +26,47 @@ class EndpointDiscoveryRequired(EndpointDiscoveryException):
 class EndpointDiscoveryRefreshFailed(EndpointDiscoveryException):
     fmt: str = ...
 
-def block_endpoint_discovery_required_operations(model: Any, **kwargs: Any) -> None: ...
+def block_endpoint_discovery_required_operations(model: OperationModel, **kwargs: Any) -> None: ...
 
 class EndpointDiscoveryModel:
     def __init__(self, service_model: ServiceModel) -> None: ...
     @CachedProperty
     def discovery_operation_name(self) -> str: ...
     @CachedProperty
-    def discovery_operation_keys(self) -> List[str]: ...
+    def discovery_operation_keys(self) -> list[str]: ...
     def discovery_required_for(self, operation_name: str) -> bool: ...
-    def discovery_operation_kwargs(self, **kwargs: Any) -> Dict[str, Any]: ...
-    def gather_identifiers(self, operation: OperationModel, params: Any) -> Dict[str, Any]: ...
+    def discovery_operation_kwargs(self, **kwargs: Any) -> dict[str, Any]: ...
+    def gather_identifiers(
+        self, operation: OperationModel, params: Mapping[str, Any]
+    ) -> dict[str, Any]: ...
 
 class EndpointDiscoveryManager:
     def __init__(
         self,
         client: BaseClient,
-        cache: Optional[Any] = ...,
-        current_time: Optional[Callable[[], float]] = ...,
+        cache: Any | None = ...,
+        current_time: Callable[[], float] | None = ...,
         always_discover: bool = ...,
     ) -> None: ...
-    def gather_identifiers(self, operation: OperationModel, params: Any) -> Any: ...
+    def gather_identifiers(self, operation: OperationModel, params: Mapping[str, Any]) -> Any: ...
     def delete_endpoints(self, **kwargs: Any) -> None: ...
     def describe_endpoint(self, **kwargs: Any) -> Any: ...
 
 class EndpointDiscoveryHandler:
-    def __init__(self, manager: Any) -> None: ...
-    def register(self, events: Any, service_id: str) -> None: ...
+    def __init__(self, manager: EndpointDiscoveryManager) -> None: ...
+    def register(self, events: BaseEventHooks, service_id: str) -> None: ...
     def gather_identifiers(
-        self, params: Any, model: OperationModel, context: Any, **kwargs: Any
+        self,
+        params: Mapping[str, Any],
+        model: OperationModel,
+        context: Mapping[str, Any],
+        **kwargs: Any,
     ) -> None: ...
     def discover_endpoint(self, request: Any, operation_name: str, **kwargs: Any) -> None: ...
     def handle_retries(
-        self, request_dict: Any, response: Any, operation: OperationModel, **kwargs: Any
+        self,
+        request_dict: Mapping[str, Any],
+        response: Mapping[str, Any],
+        operation: OperationModel,
+        **kwargs: Any,
     ) -> Any: ...

botocore-stubs/docs/__init__.pyi

@@ -1,7 +1,11 @@
-from typing import Set
+"""
+Type annotations for botocore.docs module.
+
+Copyright 2024 Vlad Emelianov
+"""
 
 from botocore.session import Session
 
-DEPRECATED_SERVICE_NAMES: Set[str] = ...
+DEPRECATED_SERVICE_NAMES: set[str] = ...
 
 def generate_docs(root_dir: str, session: Session) -> None: ...

botocore-stubs/docs/bcdoc/__init__.pyi

@@ -1 +1,7 @@
+"""
+Type annotations for botocore.docs.bcdoc module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 __version__: str = ...

botocore-stubs/docs/bcdoc/docstringparser.pyi

@@ -1,12 +1,18 @@
+"""
+Type annotations for botocore.docs.bcdoc.docstringparser module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 from html.parser import HTMLParser
-from typing import Any, List, Tuple
+from typing import Any
 
 from botocore.docs.bcdoc.restdoc import ReSTDocument
 
-PRIORITY_PARENT_TAGS: Tuple[str, ...] = ...
-OMIT_NESTED_TAGS: Tuple[str, ...] = ...
-OMIT_SELF_TAGS: Tuple[str, ...] = ...
-HTML_BLOCK_DISPLAY_TAGS: Tuple[str, ...] = ...
+PRIORITY_PARENT_TAGS: tuple[str, ...] = ...
+OMIT_NESTED_TAGS: tuple[str, ...] = ...
+OMIT_SELF_TAGS: tuple[str, ...] = ...
+HTML_BLOCK_DISPLAY_TAGS: tuple[str, ...] = ...
 
 class DocStringParser(HTMLParser):
     def __init__(self, doc: Any) -> None: ...
@@ -32,8 +38,8 @@ class StemNode(Node):
     def add_child(self, child: Any) -> None: ...
     def write(self, doc: ReSTDocument) -> None: ...
     def is_whitespace(self) -> bool: ...
-    def startswith_whitespace(self) -> List[Any]: ...
-    def endswith_whitespace(self) -> List[Any]: ...
+    def startswith_whitespace(self) -> list[Any]: ...
+    def endswith_whitespace(self) -> list[Any]: ...
     def lstrip(self) -> None: ...
     def rstrip(self) -> None: ...
     def collapse_whitespace(self) -> None: ...

botocore-stubs/docs/bcdoc/restdoc.pyi

@@ -1,12 +1,19 @@
+"""
+Type annotations for botocore.docs.bcdoc.restdoc module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+import re
 from logging import Logger
-from typing import Any, Dict, List, Optional
+from typing import Any, Iterable, Mapping
 
 DEFAULT_AWS_DOCS_LINK: str = ...
-DOCUMENTATION_LINK_REGEX: Any = ...
+DOCUMENTATION_LINK_REGEX: re.Pattern[str] = ...
 LARGE_SECTION_MESSAGE: str = ...
 LOG: Logger = ...
-SECTION_LINE_LIMIT_CONFIG: Dict[str, Any] = ...
-SECTION_METHOD_PATH_DEPTH: Dict[str, int] = ...
+SECTION_LINE_LIMIT_CONFIG: dict[str, Any] = ...
+SECTION_METHOD_PATH_DEPTH: dict[str, int] = ...
 
 class ReSTDocument:
     def __init__(self, target: str = ...) -> None: ...
@@ -16,8 +23,8 @@ class ReSTDocument:
     def pop_write(self) -> None: ...
     def push_write(self, s: str) -> None: ...
     def getvalue(self) -> bytes: ...
-    def translate_words(self, words: Any) -> list[Any]: ...
-    def handle_data(self, data: Any) -> None: ...
+    def translate_words(self, words: Iterable[str]) -> list[str]: ...
+    def handle_data(self, data: str | None) -> None: ...
     def include_doc_string(self, doc_string: str) -> None: ...
     def remove_last_doc_string(self) -> None: ...
 
@@ -25,26 +32,29 @@ class DocumentStructure(ReSTDocument):
     def __init__(
         self,
         name: str,
-        section_names: Optional[List[str]] = ...,
-        target: Any = ...,
-        context: Any = ...,
+        section_names: list[str] | None = ...,
+        target: str = ...,
+        context: Mapping[str, Any] | None = ...,
     ) -> None: ...
     @property
     def name(self) -> str: ...
     @property
-    def path(self) -> list[Any]: ...
+    def path(self) -> list[str]: ...
     @path.setter
-    def path(self, value: Any) -> None: ...
+    def path(self, value: list[str]) -> None: ...
     @property
-    def available_sections(self) -> list[Any]: ...
+    def available_sections(self) -> list[str]: ...
     @property
-    def context(self) -> Dict[str, Any]: ...
-    def add_new_section(self, name: str, context: Any = ...) -> Any: ...
-    def get_section(self, name: str) -> Any: ...
+    def context(self) -> dict[str, Any]: ...
+    def add_new_section(
+        self, name: str, context: Mapping[str, Any] | None = ...
+    ) -> DocumentStructure: ...
+    def get_section(self, name: str) -> DocumentStructure: ...
+    def has_section(self, name: str) -> bool: ...
     def delete_section(self, name: str) -> None: ...
-    def flush_structure(self, docs_link: Optional[str] = ...) -> bytes: ...
+    def flush_structure(self, docs_link: str | None = ...) -> bytes: ...
     def getvalue(self) -> bytes: ...
     def remove_all_sections(self) -> None: ...
     def clear_text(self) -> None: ...
-    def add_title_section(self, title: str) -> Any: ...
+    def add_title_section(self, title: str) -> DocumentStructure: ...
     def write_to_file(self, full_path: str, file_name: str) -> None: ...

botocore-stubs/docs/bcdoc/style.pyi

@@ -1,10 +1,16 @@
+"""
+Type annotations for botocore.docs.bcdoc.style module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 from logging import Logger
-from typing import Any, Optional, Tuple
+from typing import Any
 
 from botocore.docs.bcdoc.restdoc import ReSTDocument
 
 logger: Logger = ...
-PUNCTUATION_CHARACTERS: Tuple[str, ...] = ...
+PUNCTUATION_CHARACTERS: tuple[str, ...] = ...
 
 class BaseStyle:
     def __init__(self, doc: ReSTDocument, indent_width: int = ...) -> None: ...
@@ -17,7 +23,7 @@ class BaseStyle:
     def dedent(self) -> None: ...
     def spaces(self) -> str: ...
     def bold(self, s: str) -> str: ...
-    def ref(self, link: Optional[str], title: Optional[str] = ...) -> str: ...
+    def ref(self, link: str | None, title: str | None = ...) -> str: ...
     def h2(self, s: str) -> str: ...
     def h3(self, s: str) -> str: ...
     def underline(self, s: str) -> str: ...
@@ -33,7 +39,7 @@ class ReSTStyle(BaseStyle):
     def start_b(self, attrs: Any = ...) -> None: ...
     def end_b(self) -> None: ...
     def bold(self, s: str) -> None: ...  # type: ignore[override]
-    def ref(self, title: str, link: Optional[str] = ...) -> None: ...  # type: ignore[override]
+    def ref(self, title: str, link: str | None = ...) -> None: ...  # type: ignore[override]
     def h1(self, s: str) -> None: ...
     def h2(self, s: str) -> None: ...  # type: ignore[override]
     def h3(self, s: str) -> None: ...  # type: ignore[override]
@@ -53,7 +59,7 @@ class ReSTStyle(BaseStyle):
     def end_danger(self) -> None: ...
     def start_a(self, attrs: Any = ...) -> None: ...
     def link_target_definition(self, refname: str, link: str) -> None: ...
-    def sphinx_reference_label(self, label: str, text: Optional[str] = ...) -> None: ...
+    def sphinx_reference_label(self, label: str, text: str | None = ...) -> None: ...
     def end_a(self, next_child: Any = ...) -> None: ...
     def start_i(self, attrs: Any = ...) -> None: ...
     def end_i(self) -> None: ...
@@ -72,10 +78,10 @@ class ReSTStyle(BaseStyle):
     def end_codeblock(self) -> None: ...
     def codeblock(self, code: str) -> None: ...
     def toctree(self) -> None: ...
-    def tocitem(self, item: str, file_name: Optional[str] = ...) -> None: ...
+    def tocitem(self, item: str, file_name: str | None = ...) -> None: ...
     def hidden_toctree(self) -> None: ...
     def hidden_tocitem(self, item: str) -> None: ...
-    def table_of_contents(self, title: Optional[str] = ..., depth: Optional[int] = ...) -> None: ...
+    def table_of_contents(self, title: str | None = ..., depth: int | None = ...) -> None: ...
     def start_sphinx_py_class(self, class_name: str) -> None: ...
     def end_sphinx_py_class(self) -> None: ...
     def start_sphinx_py_method(self, method_name: str, parameters: Any = ...) -> None: ...

botocore-stubs/docs/client.pyi

@@ -1,16 +1,22 @@
-from typing import Any, Callable, Dict, List, Optional, Tuple
+"""
+Type annotations for botocore.docs.client module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from typing import Any, Callable
 
 from botocore.client import BaseClient
 from botocore.docs.bcdoc.restdoc import DocumentStructure
 from botocore.docs.utils import DocumentedShape
 
 class ClientDocumenter:
-    _CLIENT_METHODS_FILTERS: List[Callable[..., bool]] = ...
+    _CLIENT_METHODS_FILTERS: list[Callable[..., bool]] = ...
     def __init__(
         self,
         client: BaseClient,
         root_docs_path: str,
-        shared_examples: Optional[Dict[str, Any]] = ...,
+        shared_examples: dict[str, Any] | None = ...,
     ) -> None: ...
     def document_client(self, section: DocumentStructure) -> None: ...
 
@@ -22,6 +28,6 @@ class ClientExceptionsDocumenter:
 
 class ClientContextParamsDocumenter:
     _CONFIG_GUIDE_LINK: str = ...
-    OMITTED_CONTEXT_PARAMS: Dict[str, Tuple[str, ...]] = ...
+    OMITTED_CONTEXT_PARAMS: dict[str, tuple[str, ...]] = ...
     def __init__(self, service_name: str, context_params: Any) -> None: ...
     def document_context_params(self, section: DocumentStructure) -> None: ...

botocore-stubs/docs/docstring.pyi

@@ -1,11 +1,15 @@
+"""
+Type annotations for botocore.docs.docstring module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 from typing import Any
 
 class LazyLoadedDocstring(str):
     def __init__(self, *args: Any, **kwargs: Any) -> None: ...
     def __new__(cls, *args: Any, **kwargs: Any) -> Any: ...
     def expandtabs(self, tabsize: Any = ...) -> str: ...
-    def __str__(self) -> str: ...
-    def __repr__(self) -> str: ...
 
 class ClientMethodDocstring(LazyLoadedDocstring): ...
 class WaiterDocstring(LazyLoadedDocstring): ...

botocore-stubs/docs/example.pyi

@@ -1,61 +1,70 @@
-from typing import Any, List, Optional
+"""
+Type annotations for botocore.docs.example module.
 
+Copyright 2024 Vlad Emelianov
+"""
+
+from typing import Any
+
+from botocore.docs.bcdoc.restdoc import DocumentStructure
 from botocore.docs.shape import ShapeDocumenter
 from botocore.model import Shape
 
 class BaseExampleDocumenter(ShapeDocumenter):
     def document_example(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
-        prefix: Optional[str] = ...,
-        include: Optional[List[str]] = ...,
-        exclude: Optional[List[str]] = ...,
+        prefix: str | None = ...,
+        include: list[str] | None = ...,
+        exclude: list[str] | None = ...,
+    ) -> None: ...
+    def document_recursive_shape(
+        self, section: DocumentStructure, shape: Shape, **kwargs: Any
     ) -> None: ...
-    def document_recursive_shape(self, section: Any, shape: Shape, **kwargs: Any) -> None: ...
     def document_shape_default(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
-        include: Optional[List[str]] = ...,
-        exclude: Optional[List[str]] = ...,
+        include: list[str] | None = ...,
+        exclude: list[str] | None = ...,
         **kwargs: Any,
     ) -> None: ...
     def document_shape_type_string(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
-        include: Optional[List[str]] = ...,
-        exclude: Optional[List[str]] = ...,
+        include: list[str] | None = ...,
+        exclude: list[str] | None = ...,
         **kwargs: Any,
     ) -> None: ...
     def document_shape_type_list(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
-        include: Optional[List[str]] = ...,
-        exclude: Optional[List[str]] = ...,
+        include: list[str] | None = ...,
+        exclude: list[str] | None = ...,
         **kwargs: Any,
     ) -> None: ...
     def document_shape_type_structure(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
-        include: Optional[List[str]] = ...,
-        exclude: Optional[List[str]] = ...,
+        include: list[str] | None = ...,
+        exclude: list[str] | None = ...,
         **kwargs: Any,
     ) -> None: ...
     def document_shape_type_map(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
-        include: Optional[List[str]] = ...,
-        exclude: Optional[List[str]] = ...,
+        include: list[str] | None = ...,
+        exclude: list[str] | None = ...,
         **kwargs: Any,
     ) -> None: ...
 
@@ -63,7 +72,7 @@ class ResponseExampleDocumenter(BaseExampleDocumenter):
     EVENT_NAME: str = ...
     def document_shape_type_event_stream(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
         **kwargs: Any,
@@ -73,10 +82,10 @@ class RequestExampleDocumenter(BaseExampleDocumenter):
     EVENT_NAME: str = ...
     def document_shape_type_structure(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
-        include: Optional[List[str]] = ...,
-        exclude: Optional[List[str]] = ...,
+        include: list[str] | None = ...,
+        exclude: list[str] | None = ...,
         **kwargs: Any,
     ) -> None: ...

botocore-stubs/docs/method.pyi

@@ -1,37 +1,44 @@
-from typing import Any, Dict, Optional, Sequence
+"""
+Type annotations for botocore.docs.method module.
 
+Copyright 2024 Vlad Emelianov
+"""
+
+from typing import Any, Sequence
+
+from botocore.docs.bcdoc.restdoc import DocumentStructure
 from botocore.hooks import BaseEventHooks
 from botocore.model import OperationModel
 
 AWS_DOC_BASE: str = ...
 
-def get_instance_public_methods(instance: Any) -> Dict[str, Any]: ...
+def get_instance_public_methods(instance: Any) -> dict[str, Any]: ...
 def document_model_driven_signature(
-    section: Any,
+    section: DocumentStructure,
     name: str,
     operation_model: OperationModel,
-    include: Optional[Sequence[str]] = ...,
-    exclude: Optional[Sequence[str]] = ...,
+    include: Sequence[str] | None = ...,
+    exclude: Sequence[str] | None = ...,
 ) -> None: ...
 def document_custom_signature(
-    section: Any,
+    section: DocumentStructure,
     name: str,
     method: Any,
-    include: Optional[Sequence[str]] = ...,
-    exclude: Optional[Sequence[str]] = ...,
+    include: Sequence[str] | None = ...,
+    exclude: Sequence[str] | None = ...,
 ) -> None: ...
-def document_custom_method(section: Any, method_name: str, method: Any) -> None: ...
+def document_custom_method(section: DocumentStructure, method_name: str, method: Any) -> None: ...
 def document_model_driven_method(
-    section: Any,
+    section: DocumentStructure,
     method_name: str,
     operation_model: OperationModel,
     event_emitter: BaseEventHooks,
-    method_description: Optional[str] = ...,
-    example_prefix: Optional[str] = ...,
-    include_input: Optional[Dict[str, Any]] = ...,
-    include_output: Optional[Dict[str, Any]] = ...,
-    exclude_input: Optional[Sequence[str]] = ...,
-    exclude_output: Optional[Sequence[str]] = ...,
+    method_description: str | None = ...,
+    example_prefix: str | None = ...,
+    include_input: dict[str, Any] | None = ...,
+    include_output: dict[str, Any] | None = ...,
+    exclude_input: Sequence[str] | None = ...,
+    exclude_output: Sequence[str] | None = ...,
     document_output: bool = ...,
     include_signature: bool = ...,
 ) -> None: ...

botocore-stubs/docs/paginator.pyi

@@ -1,6 +1,13 @@
+"""
+Type annotations for botocore.docs.paginator module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 from typing import Any
 
 from botocore.client import BaseClient
+from botocore.docs.bcdoc.restdoc import DocumentStructure
 from botocore.hooks import BaseEventHooks
 from botocore.model import ServiceModel
 
@@ -8,10 +15,10 @@ class PaginatorDocumenter:
     def __init__(
         self, client: BaseClient, service_paginator_model: ServiceModel, root_docs_path: str
     ) -> None: ...
-    def document_paginators(self, section: Any) -> None: ...
+    def document_paginators(self, section: DocumentStructure) -> None: ...
 
 def document_paginate_method(
-    section: Any,
+    section: DocumentStructure,
     paginator_name: str,
     event_emitter: BaseEventHooks,
     service_model: ServiceModel,

botocore-stubs/docs/params.pyi

@@ -1,52 +1,61 @@
-from typing import Any, Optional, Sequence
+"""
+Type annotations for botocore.docs.params module.
 
+Copyright 2024 Vlad Emelianov
+"""
+
+from typing import Any, Sequence
+
+from botocore.docs.bcdoc.restdoc import DocumentStructure
 from botocore.docs.shape import ShapeDocumenter
 from botocore.model import Shape
 
 class BaseParamsDocumenter(ShapeDocumenter):
     def document_params(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
-        include: Optional[Sequence[str]] = ...,
-        exclude: Optional[Sequence[str]] = ...,
+        include: Sequence[str] | None = ...,
+        exclude: Sequence[str] | None = ...,
+    ) -> None: ...
+    def document_recursive_shape(
+        self, section: DocumentStructure, shape: Shape, **kwargs: Any
     ) -> None: ...
-    def document_recursive_shape(self, section: Any, shape: Shape, **kwargs: Any) -> None: ...
     def document_shape_default(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
-        include: Optional[Sequence[str]] = ...,
-        exclude: Optional[Sequence[str]] = ...,
+        include: Sequence[str] | None = ...,
+        exclude: Sequence[str] | None = ...,
         **kwargs: Any,
     ) -> None: ...
     def document_shape_type_list(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
-        include: Optional[Sequence[str]] = ...,
-        exclude: Optional[Sequence[str]] = ...,
+        include: Sequence[str] | None = ...,
+        exclude: Sequence[str] | None = ...,
         **kwargs: Any,
     ) -> None: ...
     def document_shape_type_map(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
-        include: Optional[Sequence[str]] = ...,
-        exclude: Optional[Sequence[str]] = ...,
+        include: Sequence[str] | None = ...,
+        exclude: Sequence[str] | None = ...,
         **kwargs: Any,
     ) -> None: ...
     def document_shape_type_structure(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
-        include: Optional[Sequence[str]] = ...,
-        exclude: Optional[Sequence[str]] = ...,
-        name: Optional[str] = ...,
+        include: Sequence[str] | None = ...,
+        exclude: Sequence[str] | None = ...,
+        name: str | None = ...,
         **kwargs: Any,
     ) -> None: ...
 
@@ -54,7 +63,7 @@ class ResponseParamsDocumenter(BaseParamsDocumenter):
     EVENT_NAME: str = ...
     def document_shape_type_event_stream(
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
         **kwargs: Any,
@@ -64,10 +73,10 @@ class RequestParamsDocumenter(BaseParamsDocumenter):
     EVENT_NAME: str = ...
     def document_shape_type_structure(  # type: ignore[override]
         self,
-        section: Any,
+        section: DocumentStructure,
         shape: Shape,
         history: Any,
-        include: Optional[Sequence[str]] = ...,
-        exclude: Optional[Sequence[str]] = ...,
+        include: Sequence[str] | None = ...,
+        exclude: Sequence[str] | None = ...,
         **kwargs: Any,
     ) -> None: ...

botocore-stubs/docs/service.pyi

@@ -1,15 +1,20 @@
-from typing import Any, List, Optional
+"""
+Type annotations for botocore.docs.service module.
 
+Copyright 2024 Vlad Emelianov
+"""
+
+from botocore.docs.bcdoc.restdoc import DocumentStructure
 from botocore.session import Session
 
 class ServiceDocumenter:
     def __init__(self, service_name: str, session: Session, root_docs_path: str) -> None: ...
     def document_service(self) -> bytes: ...
-    def title(self, section: Any) -> None: ...
-    def table_of_contents(self, section: Any) -> None: ...
-    def client_api(self, section: Any) -> None: ...
-    def client_exceptions(self, section: Any) -> None: ...
-    def paginator_api(self, section: Any) -> None: ...
-    def waiter_api(self, section: Any) -> None: ...
-    def get_examples(self, service_name: str, api_version: Optional[str] = ...) -> List[str]: ...
-    def client_context_params(self, section: Any) -> None: ...
+    def title(self, section: DocumentStructure) -> None: ...
+    def table_of_contents(self, section: DocumentStructure) -> None: ...
+    def client_api(self, section: DocumentStructure) -> None: ...
+    def client_exceptions(self, section: DocumentStructure) -> None: ...
+    def paginator_api(self, section: DocumentStructure) -> None: ...
+    def waiter_api(self, section: DocumentStructure) -> None: ...
+    def get_examples(self, service_name: str, api_version: str | None = ...) -> list[str]: ...
+    def client_context_params(self, section: DocumentStructure) -> None: ...