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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nui-python-shared-utils
-Version: 2.3
+Version: 2.4.1
 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
@@ -36,7 +36,6 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -45,7 +44,7 @@ Classifier: Topic :: System :: Monitoring
 Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
 Classifier: Environment :: Console
 Classifier: Framework :: AWS CDK
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: boto3>=1.20.0
@@ -102,7 +101,7 @@ Dynamic: requires-python
 # NUI Python Shared Utilities
 
 [![PyPI version](https://badge.fury.io/py/nui-python-shared-utils.svg)](https://badge.fury.io/py/nui-python-shared-utils)
-[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 Production-ready shared Python utilities for AWS Lambda functions, CLI tools, and agents. Provides standardized integrations for Slack, Elasticsearch, database, and monitoring. Built and battle-tested on the NUI platform with sensible defaults configurable for any environment.

{nui_python_shared_utils-2.3.dist-info → nui_python_shared_utils-2.4.1.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.1.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,23 +12,23 @@ 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
 nui_shared_utils/snowflake_client.py,sha256=e3jH6_2mMqbtP1TE8-mUFFYrfGW9eqUPT5tlcgeCqx8,16181
-nui_shared_utils/timezone.py,sha256=gTiSK5NUG0Z8UY_AsB4ktIzLrZ0wwTXtdTUH-Npdvik,3837
+nui_shared_utils/timezone.py,sha256=m-Ilx9FI2Bwv-GZOZy71N_S94g26UK68jP8QEEKNw74,3867
 nui_shared_utils/utils.py,sha256=gOpw80tZGC24QsyesR8EySRODY-TFXG8cXUvggPBsRI,8184
 nui_shared_utils/logging/__init__.py,sha256=gVC853q3ja4RhcBVbf5jKO10lFX4upfsTvkKZx4wu54,1805
-nui_shared_utils/logging/binding.py,sha256=I5VNmtf4U2yt54aS4F0Djw4u22mfjwCpWvORUnJNkPU,13577
+nui_shared_utils/logging/binding.py,sha256=FJhC2RjzhTczWz43Bk1HiQGsorSVFVHvmNmPhbwlW78,13495
 nui_shared_utils/logging/fields.py,sha256=7jhBdyEXAJod61aKPCk68idECTAV-_BNjiABp9IRFZo,11194
 nui_shared_utils/logging/redaction.py,sha256=t-EtNhR1nK6IOae70GnieHxn_36_jYuuta32T1dMlP8,6928
 nui_shared_utils/slack_setup/__init__.py,sha256=OElyS3xk4F_YKH5uUUTDpN0ah1dOO3e52muIPjAMPW8,320
 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.1.dist-info/METADATA,sha256=YIXzCX1TeKM2_D2zeukX6RcBLtszwORIH2_hc8O5gUM,22643
+nui_python_shared_utils-2.4.1.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+nui_python_shared_utils-2.4.1.dist-info/entry_points.txt,sha256=TrJ3Z4kz3oXfy6InXn20jHu7rnTwo-4EA0KRFX3fkL0,66
+nui_python_shared_utils-2.4.1.dist-info/top_level.txt,sha256=YMRu5cnn3hxHoYq9wNvaI9atVHnTNVdswO5_cQSfnJI,17
+nui_python_shared_utils-2.4.1.dist-info/RECORD,,

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

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

nui_shared_utils/logging/binding.py

@@ -306,7 +306,6 @@ def log_exception(binder: Any, exc: BaseException, message: str) -> None:
         extra={
             F.ERROR_TYPE: type(exc).__name__,
             F.ERROR_MESSAGE: str(exc),
-            # 3-arg form for Python 3.9 compatibility (single-arg added in 3.10).
             F.ERROR_STACK: "".join(traceback.format_exception(type(exc), exc, exc.__traceback__)),
         },
     )

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

nui_shared_utils/timezone.py

@@ -13,8 +13,8 @@ from zoneinfo import ZoneInfo
 # Supported timezones
 NZ_TZ = ZoneInfo("Pacific/Auckland")  # Primary timezone
 AUS_TZ = ZoneInfo("Australia/Sydney")
-US_EAST_TZ = ZoneInfo("US/Eastern")
-US_WEST_TZ = ZoneInfo("US/Pacific")
+US_EAST_TZ = ZoneInfo("America/New_York")
+US_WEST_TZ = ZoneInfo("America/Los_Angeles")
 EUR_TZ = ZoneInfo("Europe/London")
 
 
@@ -115,7 +115,7 @@ def get_timezone_options() -> List[Tuple[str, str]]:
     return [
         ("nz", "New Zealand (Pacific/Auckland)"),
         ("aus", "Australia (Australia/Sydney)"),
-        ("us_east", "US Eastern (US/Eastern)"),
-        ("us_west", "US Pacific (US/Pacific)"),
+        ("us_east", "US Eastern (America/New_York)"),
+        ("us_west", "US Pacific (America/Los_Angeles)"),
         ("eur", "Europe (Europe/London)"),
     ]