nui-python-shared-utils 2.3__py3-none-any.whl → 2.4__py3-none-any.whl

{nui_python_shared_utils-2.3.dist-info → nui_python_shared_utils-2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nui-python-shared-utils
-Version: 2.3
+Version: 2.4
 Summary: Shared Python utilities for AWS Lambda, CLI tools, and agents with Slack, Elasticsearch, and monitoring integrations
 Home-page: https://github.com/nuimarkets/nui-python-shared-utils
 Author: NUI Markets

{nui_python_shared_utils-2.3.dist-info → nui_python_shared_utils-2.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-nui_python_shared_utils-2.3.dist-info/licenses/LICENSE,sha256=vGe2mC5yLUb8toYlY3T36ZwCB5zQUW5hlCtEMiqokhM,1071
+nui_python_shared_utils-2.4.dist-info/licenses/LICENSE,sha256=vGe2mC5yLUb8toYlY3T36ZwCB5zQUW5hlCtEMiqokhM,1071
 nui_shared_utils/__init__.py,sha256=wbm10x7THNbrCBGClWiWSVkTNxcBKcHZ-HjYpRQBFrk,13354
 nui_shared_utils/base_client.py,sha256=I1lKQGhrKyvujV2zps0TrtEdPDqMCwRQaIh6ceGONXQ,11016
 nui_shared_utils/cli.py,sha256=JJpSoQWKvAz4b8cO30yFNi5vY9jmqrCHzbFpvrVTkbU,8747
@@ -12,7 +12,7 @@ nui_shared_utils/jwt_auth.py,sha256=2Ag1zZKxd2R8QBz3aQA4h8OtKHQvUVKrjUp6lXpJxJU,
 nui_shared_utils/lambda_helpers.py,sha256=psHVotpmOfnmyQCoOt4MSIEj7VwWcy6gZM3vYSZwjOk,3041
 nui_shared_utils/llm.py,sha256=adNUO8Qbeb3__GvpROxWSUERkpiazKiGJFE5xzU5eZ0,8351
 nui_shared_utils/log_processors.py,sha256=x5gz1LEkbmoMCZ3ZB6q-mbn26dSzwh1trz4wSkBGxqk,5538
-nui_shared_utils/powertools_helpers.py,sha256=R4awhoo0w0niL662DMZvNa5sDjjP8Vh6m0pSpnOD1aU,12286
+nui_shared_utils/powertools_helpers.py,sha256=DGM6L0nBkhRpcQvj58s15jVfB3IH_4274aAoyW2Xi1o,13030
 nui_shared_utils/secrets_helper.py,sha256=_jQkMWzjayZ8vvyHG2yuuxur-SQYUUONfcsZ0MF8qOw,7025
 nui_shared_utils/slack_client.py,sha256=jvkLeBMA8WHOqdRzCEpG42FfBlMeWue8bZ1g1ZxF-UI,40304
 nui_shared_utils/slack_formatter.py,sha256=QT9VXApE0q09n_PmEVvaLCSfLW24vmowlCXF3Dzimfk,10850
@@ -27,8 +27,8 @@ nui_shared_utils/slack_setup/__init__.py,sha256=OElyS3xk4F_YKH5uUUTDpN0ah1dOO3e5
 nui_shared_utils/slack_setup/channel_creator.py,sha256=0gyCBIS0EC96SVn1Z2dD4Fpzk0xNdHSWyiCxoUQIUe8,10667
 nui_shared_utils/slack_setup/channel_definitions.py,sha256=atfz5ZhpqefOeLh1gShbWd-TLzgjPmhv95bfuTdmZog,5676
 nui_shared_utils/slack_setup/setup_helpers.py,sha256=pzzXMs12GI9sdZttWeYzgLPgC0xqPz7ZLHM1GUPNNXc,7219
-nui_python_shared_utils-2.3.dist-info/METADATA,sha256=Ma366Cqx3pp_PW7xaSA-n1UmeniBgjvShEwb96vdOgc,22688
-nui_python_shared_utils-2.3.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-nui_python_shared_utils-2.3.dist-info/entry_points.txt,sha256=TrJ3Z4kz3oXfy6InXn20jHu7rnTwo-4EA0KRFX3fkL0,66
-nui_python_shared_utils-2.3.dist-info/top_level.txt,sha256=YMRu5cnn3hxHoYq9wNvaI9atVHnTNVdswO5_cQSfnJI,17
-nui_python_shared_utils-2.3.dist-info/RECORD,,
+nui_python_shared_utils-2.4.dist-info/METADATA,sha256=APNpREIrigYHIaSvr5yyOi3HSqgu0iRgWpBoRWq_1Xo,22688
+nui_python_shared_utils-2.4.dist-info/WHEEL,sha256=a-udL2m4V_6Yn8b-uKzWb12RjRxwwMo6ohYFM24tpaY,91
+nui_python_shared_utils-2.4.dist-info/entry_points.txt,sha256=TrJ3Z4kz3oXfy6InXn20jHu7rnTwo-4EA0KRFX3fkL0,66
+nui_python_shared_utils-2.4.dist-info/top_level.txt,sha256=YMRu5cnn3hxHoYq9wNvaI9atVHnTNVdswO5_cQSfnJI,17
+nui_python_shared_utils-2.4.dist-info/RECORD,,

{nui_python_shared_utils-2.3.dist-info → nui_python_shared_utils-2.4.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (84.0.0)
+Generator: setuptools (84.2.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

nui_shared_utils/powertools_helpers.py

@@ -162,6 +162,7 @@ def powertools_handler(
     slack_alert_channel: Optional[str] = None,
     slack_account_names: Optional[Dict[str, str]] = None,
     slack_account_names_config: Optional[str] = None,
+    reraise_exceptions: bool = False,
 ):
     """
     Decorator for Lambda handlers with logging, metrics, and error handling.
@@ -175,6 +176,7 @@ def powertools_handler(
     - Optional metrics.log_metrics integration (if metrics_namespace provided)
     - Structured exception logging with traceback
     - Optional Slack alerts on failures (if slack_alert_channel provided)
+    - Optional exception re-raising for event sources that use Lambda failure semantics
     - Graceful degradation if Slack client unavailable
     - Proper Lambda error response formatting
 
@@ -190,6 +192,11 @@ def powertools_handler(
             Values loaded from this file are used as defaults, but any keys
             provided in ``slack_account_names`` take precedence and override
             the YAML-loaded values.
+        reraise_exceptions: Re-raise handler exceptions after logging and Slack
+            alerting. Enable this for event sources such as Kinesis, DynamoDB
+            Streams, SNS, S3, and EventBridge that rely on a raised exception to
+            record a failed invocation and apply their retry or failure handling.
+            Defaults to False to preserve the existing 500 response behavior.
 
     Returns:
         Decorator function for Lambda handlers
@@ -214,13 +221,14 @@ def powertools_handler(
         for API Gateway, ``{"batchItemFailures": [...]}`` for an SQS mapping with
         ``ReportBatchItemFailures``.
 
-        On exception, returns ``{"statusCode": 500, "body": "Internal Server Error"}``,
-        except for SQS events, where the exception is re-raised after logging and
-        alerting. A returned value tells the SQS mapping the batch succeeded (with
-        ``ReportBatchItemFailures``, a response without ``batchItemFailures`` means
-        every record did), so the 500 dict would delete the batch. Re-raising leaves
-        it on the queue for redelivery, and in the DLQ after ``maxReceiveCount``
-        when the queue has a redrive policy.
+        On exception, returns ``{"statusCode": 500, "body": "Internal Server Error"}``
+        by default. Set ``reraise_exceptions=True`` to re-raise after logging and
+        alerting when the event source relies on Lambda failure semantics. SQS events
+        are always re-raised, regardless of this option: a returned value tells the
+        SQS mapping the batch succeeded (with ``ReportBatchItemFailures``, a response
+        without ``batchItemFailures`` means every record did), so the 500 dict would
+        delete the batch. Re-raising leaves it on the queue for redelivery, and in the
+        DLQ after ``maxReceiveCount`` when the queue has a redrive policy.
     """
 
     def decorator(func: Callable) -> Callable:
@@ -297,8 +305,9 @@ def powertools_handler(
                     except Exception as slack_error:
                         logger.warning("Failed to send Slack alert: %s", slack_error)
 
-                # Re-raise for SQS so the batch stays on the queue; see the Note above.
-                if is_sqs:
+                # Re-raise for SQS so the batch stays on the queue, or when the caller
+                # opts into Lambda failure semantics; see the Note above.
+                if is_sqs or reraise_exceptions:
                     raise
 
                 # Return proper Lambda error response