|
1 | 1 | from __future__ import annotations |
2 | 2 |
|
3 | 3 | import logging |
4 | | -from typing import TYPE_CHECKING, Any |
| 4 | +from typing import TYPE_CHECKING, Any, Protocol, TypeVar, overload |
5 | 5 |
|
6 | 6 | from aws_lambda_powertools.middleware_factory import lambda_handler_decorator |
7 | 7 | from aws_lambda_powertools.utilities import jmespath_utils |
|
10 | 10 | if TYPE_CHECKING: |
11 | 11 | from collections.abc import Callable |
12 | 12 |
|
| 13 | + from aws_lambda_powertools.shared.types import LambdaHandler |
| 14 | + |
13 | 15 | logger = logging.getLogger(__name__) |
14 | 16 |
|
| 17 | +EventT = TypeVar("EventT") |
| 18 | +ContextT = TypeVar("ContextT") |
| 19 | +ReturnT = TypeVar("ReturnT") |
| 20 | + |
| 21 | + |
| 22 | +class _ValidatorHandlerDecorator(Protocol): |
| 23 | + def __call__( |
| 24 | + self, |
| 25 | + handler: Callable[[EventT, ContextT], ReturnT], |
| 26 | + /, |
| 27 | + ) -> LambdaHandler[EventT, ContextT, ReturnT]: ... |
| 28 | + |
| 29 | + |
| 30 | +class _ValidatorEnvelopeHandlerDecorator(Protocol): |
| 31 | + # The handler's event type is Any, as it can't be derived from the arguments, e.g. |
| 32 | + # - @validator(envelope=envelopes.SQS) |
| 33 | + def __call__( |
| 34 | + self, |
| 35 | + handler: Callable[[Any, ContextT], ReturnT], |
| 36 | + /, |
| 37 | + ) -> LambdaHandler[dict[str, Any] | str, ContextT, ReturnT]: ... |
| 38 | + |
| 39 | + |
| 40 | +@overload |
| 41 | +def validator( |
| 42 | + handler: Callable[[EventT, ContextT], ReturnT], |
| 43 | + /, |
| 44 | +) -> LambdaHandler[EventT, ContextT, ReturnT]: ... |
| 45 | + |
| 46 | + |
| 47 | +@overload |
| 48 | +def validator( |
| 49 | + *, |
| 50 | + inbound_schema: dict | None = None, |
| 51 | + inbound_formats: dict | None = None, |
| 52 | + inbound_handlers: dict | None = None, |
| 53 | + inbound_provider_options: dict | None = None, |
| 54 | + outbound_schema: dict | None = None, |
| 55 | + outbound_formats: dict | None = None, |
| 56 | + outbound_handlers: dict | None = None, |
| 57 | + outbound_provider_options: dict | None = None, |
| 58 | +) -> _ValidatorHandlerDecorator: ... |
| 59 | + |
| 60 | + |
| 61 | +@overload |
| 62 | +def validator( |
| 63 | + *, |
| 64 | + inbound_schema: dict | None = None, |
| 65 | + inbound_formats: dict | None = None, |
| 66 | + inbound_handlers: dict | None = None, |
| 67 | + inbound_provider_options: dict | None = None, |
| 68 | + outbound_schema: dict | None = None, |
| 69 | + outbound_formats: dict | None = None, |
| 70 | + outbound_handlers: dict | None = None, |
| 71 | + outbound_provider_options: dict | None = None, |
| 72 | + envelope: str, |
| 73 | + jmespath_options: dict | None = None, |
| 74 | +) -> _ValidatorEnvelopeHandlerDecorator: ... |
| 75 | + |
15 | 76 |
|
16 | 77 | @lambda_handler_decorator |
17 | 78 | def validator( |
|
0 commit comments