feat(event_handler): Add new EventHandler for Async Lambda

aws_lambda_powertools/event_handler/async_execution/exceptions.py

@@ -0,0 +1,2 @@
+class RouteNotFoundError(Exception):
+    pass

aws_lambda_powertools/event_handler/async_execution/router.py

@@ -0,0 +1,169 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Callable
+
+from .routes.aws_config_rule import AwsConfigRuleRoute
+from .routes.cloud_watch_alarm import CloudWatchAlarmRoute
+from .routes.cloud_watch_logs import CloudWatchLogsRoute
+from .routes.code_deploy_lifecycle_hook import CodeDeployLifecycleHookRoute
+from .routes.event_bridge import EventBridgeRoute
+from .routes.s3 import S3Route
+from .routes.secrets_manager import SecretsManagerRoute
+from .routes.ses import SESRoute
+from .routes.sns import SNSRoute
+
+if TYPE_CHECKING:
+    from .routes.base import BaseRoute
+
+
+class Router:
+    _routes: list[BaseRoute]
+
+    def __init__(self):
+        self._routes = []
+
+    def aws_config_rule(
+        self,
+        arn: str | None = None,
+        rule_name: str | None = None,
+        rule_name_prefix: str | None = None,
+        rule_id: str | None = None,
+    ) -> Callable:
+        def wrapper_aws_config_rule(func: Callable):
+            self._routes.append(
+                AwsConfigRuleRoute(
+                    func=func,
+                    arn=arn,
+                    rule_name=rule_name,
+                    rule_name_prefix=rule_name_prefix,
+                    rule_id=rule_id,
+                ),
+            )
+
+        return wrapper_aws_config_rule
+
+    def cloud_watch_alarm(
+        self,
+        arn: str | None = None,
+        alarm_name: str | None = None,
+        alarm_name_prefix: str | None = None,
+    ) -> Callable:
+        def wrapper_cloud_watch_alarm(func: Callable):
+            self._routes.append(
+                CloudWatchAlarmRoute(func=func, arn=arn, alarm_name=alarm_name, alarm_name_prefix=alarm_name_prefix),
+            )
+
+        return wrapper_cloud_watch_alarm
+
+    def cloud_watch_logs(
+        self,
+        log_group: str | None = None,
+        log_group_prefix: str | None = None,
+        log_stream: str | None = None,
+        log_stream_prefix: str | None = None,
+        subscription_filters: str | list[str] | None = None,
+    ) -> Callable:
+        def wrapper_cloud_watch_logs(func: Callable):
+            self._routes.append(
+                CloudWatchLogsRoute(
+                    func=func,
+                    log_group=log_group,
+                    log_group_prefix=log_group_prefix,
+                    log_stream=log_stream,
+                    log_stream_prefix=log_stream_prefix,
+                    subscription_filters=subscription_filters,
+                ),
+            )
+
+        return wrapper_cloud_watch_logs
+
+    def code_deploy_lifecycle_hook(self) -> Callable:
+        def wrapper_code_deploy_lifecycle_hook(func: Callable):
+            self._routes.append(CodeDeployLifecycleHookRoute(func=func))
+
+        return wrapper_code_deploy_lifecycle_hook
+
+    def event_bridge(
+        self,
+        detail_type: str | None = None,
+        source: str | None = None,
+        resources: str | list[str] | None = None,
+    ) -> Callable:
+        def wrap_event_bridge(func: Callable):
+            self._routes.append(
+                EventBridgeRoute(func=func, detail_type=detail_type, source=source, resources=resources),
+            )
+
+        return wrap_event_bridge
+
+    def s3(
+        self,
+        bucket: str | None = None,
+        bucket_prefix: str | None = None,
+        key: str | None = None,
+        key_prefix: str | None = None,
+        key_suffix: str | None = None,
+        event_name: str | None = None,
+    ) -> Callable:
+        def wrap_s3(func: Callable):
+            self._routes.append(
+                S3Route(
+                    func=func,
+                    bucket=bucket,
+                    bucket_prefix=bucket_prefix,
+                    key=key,
+                    key_prefix=key_prefix,
+                    key_suffix=key_suffix,
+                    event_name=event_name,
+                ),
+            )
+
+        return wrap_s3
+
+    def secrets_manager(self, secret_id: str | None = None, secret_name_prefix: str | None = None):
+        def wrap_secrets_manager(func: Callable):
+            self._routes.append(
+                SecretsManagerRoute(func=func, secret_id=secret_id, secret_name_prefix=secret_name_prefix),
+            )
+
+        return wrap_secrets_manager
+
+    def ses(
+        self,
+        mail_to: str | list[str] | None = None,
+        mail_from: str | list[str] | None = None,
+        mail_subject: str | None = None,
+    ) -> Callable:
+        def wrap_ses(func: Callable):
+            self._routes.append(SESRoute(func=func, mail_to=mail_to, mail_from=mail_from, mail_subject=mail_subject))
+
+        return wrap_ses
+
+    def sns(
+        self,
+        arn: str | None = None,
+        name: str | None = None,
+        name_prefix: str | None = None,
+        subject: str | None = None,
+        subject_prefix: str | None = None,
+    ) -> Callable:
+        def wrap_sns(func: Callable):
+            self._routes.append(
+                SNSRoute(
+                    func=func,
+                    arn=arn,
+                    name=name,
+                    name_prefix=name_prefix,
+                    subject=subject,
+                    subject_prefix=subject_prefix,
+                ),
+            )
+
+        return wrap_sns
+
+    def resolve_route(self, event: dict[str, Any]) -> tuple[Callable, Any] | None:
+        for route in self._routes:
+            data = route.match(event=event)
+            if data is not None:
+                return data
+        return None

aws_lambda_powertools/event_handler/async_execution/routes/aws_config_rule.py

@@ -0,0 +1,107 @@
+from __future__ import annotations
+
+from typing import Any, Callable
+
+from aws_lambda_powertools.utilities.data_classes.aws_config_rule_event import (
+    AWSConfigRuleEvent,
+)
+
+from .base import BaseRoute
+
+
+class AwsConfigRuleRoute(BaseRoute):
+    arn: str | None
+    rule_name: str | None
+    rule_name_prefix: str | None
+    rule_id: str | None
+
+    def __init__(
+        self,
+        func: Callable,
+        arn: str | None = None,
+        rule_name: str | None = None,
+        rule_name_prefix: str | None = None,
+        rule_id: str | None = None,
+    ):
+        self.func = func
+        self.arn = arn
+        self.rule_name = rule_name
+        self.rule_name_prefix = rule_name_prefix
+        self.rule_id = rule_id
+
+        if not self.arn and not self.rule_name and not self.rule_name_prefix and not self.rule_id:
+            raise ValueError("arn, rule_name, rule_name_prefix, or rule_id must be not null")
+
+    def is_target_with_arn(self, arn: str | None) -> bool:
+        if not arn:
+            return False
+        elif self.arn:
+            return self.arn == arn
+        else:
+            return False
+
+    def is_target_with_rule_name(self, rule_name: str | None) -> bool:
+        if not rule_name:
+            return False
+        elif self.rule_name:
+            return self.rule_name == rule_name
+        elif self.rule_name_prefix:
+            return rule_name.find(self.rule_name_prefix) == 0
+        else:
+            return False
+
+    def is_target_with_rule_id(self, rule_id: str | None) -> bool:
+        if not rule_id:
+            return False
+        elif self.rule_id:
+            return self.rule_id == rule_id
+        else:
+            return False
+
+    def match(self, event: dict[str, Any]) -> tuple[Callable, AWSConfigRuleEvent] | None:
+        if not isinstance(event, dict):
+            return None
+
+        arn = event.get("configRuleArn")
+        rule_name = event.get("configRuleName")
+        rule_id = event.get("configRuleId")
+
+        if not arn and not rule_name and not rule_id:
+            return None
+
+        if not self.arn:
+            arn = None
+
+        if not self.rule_name and not self.rule_name_prefix:
+            rule_name = None
+
+        if not self.rule_id:
+            rule_id = None
+
+        flag_arn = self.is_target_with_arn(arn=arn)
+        flag_rule_name = self.is_target_with_rule_name(rule_name=rule_name)
+        flag_rule_id = self.is_target_with_rule_id(rule_id=rule_id)
+
+        text = ", ".join(
+            [
+                "arn: x" if arn is None else "arn: o",
+                "rule_name: x" if rule_name is None else "rule_name: o",
+                "rule_id: x" if rule_id is None else "rule_id: o",
+            ],
+        )
+
+        mapping = {
+            "arn: o, rule_name: o, rule_id: o": flag_arn and flag_rule_name and flag_rule_id,
+            "arn: o, rule_name: o, rule_id: x": flag_arn and flag_rule_name,
+            "arn: o, rule_name: x, rule_id: o": flag_arn and flag_rule_id,
+            "arn: x, rule_name: o, rule_id: o": flag_rule_name and flag_rule_id,
+            "arn: o, rule_name: x, rule_id: x": flag_arn,
+            "arn: x, rule_name: o, rule_id: x": flag_rule_name,
+            "arn: x, rule_name: x, rule_id: o": flag_rule_id,
+            "arn: x, rule_name: x, rule_id: x": False,
+        }
+
+        if mapping[text]:
+            return self.func, AWSConfigRuleEvent(event)
+        else:
+            return None

aws_lambda_powertools/event_handler/async_execution/routes/base.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import Any, Callable
+
+
+class BaseRoute(ABC):
+    func: Callable
+
+    @abstractmethod
+    def match(self, event: dict[str, Any]) -> tuple[Callable, Any] | None:
+        raise NotImplementedError()

aws_lambda_powertools/event_handler/async_execution/routes/cloud_watch_alarm.py

@@ -0,0 +1,83 @@
+from __future__ import annotations
+
+from typing import Any, Callable
+
+from aws_lambda_powertools.utilities.data_classes.cloud_watch_alarm_event import (
+    CloudWatchAlarmEvent,
+)
+
+from .base import BaseRoute
+
+
+class CloudWatchAlarmRoute(BaseRoute):
+    arn: str | None
+    alarm_name: str | None
+    alarm_name_prefix: str | None
+
+    def __init__(
+        self,
+        func: Callable,
+        arn: str | None = None,
+        alarm_name: str | None = None,
+        alarm_name_prefix: str | None = None,
+    ):
+        self.func = func
+        self.arn = arn
+        self.alarm_name = alarm_name
+        self.alarm_name_prefix = alarm_name_prefix
+
+        if not self.arn and not self.alarm_name and not self.alarm_name_prefix:
+            raise ValueError("arn, alarm_name, or alarm_name_prefix must be not null")
+
+    def is_target_with_arn(self, arn: str | None) -> bool:
+        if not arn:
+            return False
+        elif self.arn:
+            return self.arn == arn
+        else:
+            return False
+
+    def is_target_with_alarm_name(self, alarm_name: str | None) -> bool:
+        if not alarm_name:
+            return False
+        elif self.alarm_name:
+            return self.alarm_name == alarm_name
+        elif self.alarm_name_prefix:
+            return alarm_name.find(self.alarm_name_prefix) == 0
+        else:
+            return False
+
+    def match(self, event: dict[str, Any]) -> tuple[Callable, CloudWatchAlarmEvent] | None:
+        if not isinstance(event, dict):
+            return None
+
+        arn: str | None = event.get("alarmArn")
+        alarm_name: str | None = event.get("alarmData", {}).get("alarmName")
+
+        if not arn and not alarm_name:
+            return None
+
+        if not self.arn:
+            arn = None
+
+        if not self.alarm_name and not self.alarm_name_prefix:
+            alarm_name = None
+
+        flag_arn = self.is_target_with_arn(arn=arn)
+        flag_alarm_name = self.is_target_with_alarm_name(alarm_name=alarm_name)
+
+        text = ", ".join(
+            ["arn: x" if arn is None else "arn: o", "alarm_name: x" if alarm_name is None else "alarm_name: o"],
+        )
+
+        mapping = {
+            "arn: o, alarm_name: o": flag_arn and flag_alarm_name,
+            "arn: o, alarm_name: x": flag_arn,
+            "arn: x, alarm_name: o": flag_alarm_name,
+            "arn: x, alarm_name: x": False,
+        }
+
+        if mapping[text]:
+            return self.func, CloudWatchAlarmEvent(event)
+        else:
+            return None