nui-python-shared-utils 2.3__tar.gz → 2.4.1__tar.gz

{nui_python_shared_utils-2.3 → nui_python_shared_utils-2.4.1}/.github/workflows/ci.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.9', '3.10', '3.11', '3.12']
+        python-version: ['3.10', '3.11', '3.12']
     
     steps:
     - uses: actions/checkout@v5

{nui_python_shared_utils-2.3 → nui_python_shared_utils-2.4.1}/.github/workflows/publish.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.9', '3.10', '3.11', '3.12']
+        python-version: ['3.10', '3.11', '3.12']
     
     steps:
     - uses: actions/checkout@v5

{nui_python_shared_utils-2.3 → nui_python_shared_utils-2.4.1}/.github/workflows/test.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.9', '3.10', '3.11']
+        python-version: ['3.10', '3.11']
 
     steps:
     - uses: actions/checkout@v5

nui_python_shared_utils-2.4.1/.markdownlint-base.yaml

@@ -0,0 +1,66 @@
+# === managed by sync-markdownlint.sh — DO NOT EDIT ===
+# Source of truth: shared tooling config/markdownlint-base.yaml
+# Change rules in the source, then run: sync-markdownlint.sh --update
+# stamp: e9f1a3abeab6
+# === end managed header (sync-markdownlint.sh) ===
+# Shared markdownlint ruleset (FLAT format).
+# See: https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
+#
+# SOURCE OF TRUTH. Repos adopt this by vendoring a stamped copy as
+# `.markdownlint-base.yaml` (via sync-markdownlint.sh) and pointing their own
+# `.markdownlint-cli2.yaml` at it with `config: { extends: .markdownlint-base.yaml }`,
+# then adding repo-specific `globs`/`ignores` (and any rare repo-only rule tweaks).
+#
+# This file is FLAT (rules at top level, no `config:` wrapper) because that is
+# the format markdownlint's `extends` requires. Keep it rules-only: file
+# selection (globs) and exclusions (ignores) are per-repo.
+
+# Enable all rules by default; disables/customisations follow.
+default: true
+
+# MD013: Line length - off. Code blocks, tables, and URLs routinely exceed any
+# sane width; wrapping prose to a column is not a standard we enforce.
+MD013: false
+
+# MD033: Inline HTML - allowed. Needed for details/summary, anchors, and the
+# HTML comment markers some docs use (companions metadata, stay markers).
+MD033: false
+
+# MD034: Bare URLs - off. Bare URLs in reference docs are intentional.
+MD034: false
+
+# MD041: First line in file should be a top-level heading - off. Many docs open
+# with YAML frontmatter or a metadata block, not an H1.
+MD041: false
+
+# MD024: Multiple headings with the same content - allowed when not siblings
+# (e.g. a repeated "Example" under different sections).
+MD024:
+  siblings_only: true
+
+# MD046: Code block style - require fenced (not indented) blocks.
+MD046:
+  style: "fenced"
+
+# MD026: Trailing punctuation in headings - off. "Note:" / "Warning!" are fine.
+MD026: false
+
+# MD029: Ordered list item prefix - off. Docs mix "1. 1. 1." and "1. 2. 3." and
+# both render correctly; not worth churning.
+MD029: false
+
+# MD036: Emphasis used instead of a heading - off. Bold-as-label
+# ("**Root cause:**", date stamps) is an accepted convention here.
+MD036: false
+
+# MD040: Fenced code language - off. Not every code block has (or needs) a
+# language tag; forcing one produces noise on output samples and snippets.
+MD040: false
+
+# MD051: Link fragments should be valid - off. Cross-doc anchor validation is
+# unreliable across the workspace's mixed heading styles and generated pages.
+MD051: false
+
+# MD060: Table column style - off. Minor pipe-alignment preference; the corpus
+# has always mixed styles.
+MD060: false

nui_python_shared_utils-2.4.1/.markdownlint-cli2.yaml

@@ -0,0 +1,17 @@
+# Markdownlint configuration for nui-python-shared-utils
+# Shared rules are vendored by sync-markdownlint.sh.
+
+config:
+  extends: .markdownlint-base.yaml
+
+# File patterns to check
+globs:
+  - "**/*.md"
+
+# Exclusions
+ignores:
+  - "node_modules/**"
+  - "vendor/**"
+  - ".git/**"
+  - "venv/**"
+  - ".venv/**"

nui_python_shared_utils-2.4.1/CHANGELOG.md

@@ -0,0 +1,265 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and breaking changes are called out explicitly below, including historical minor releases
+that contained them.
+
+## [Unreleased]
+
+### Changed
+
+- **BREAKING**: require Python 3.10 or newer in both the main package and the legacy
+  redirect package. Python 3.9 is no longer supported or included in CI test matrices.
+
+### Fixed
+
+- Use canonical IANA names `America/New_York` and `America/Los_Angeles` for US timezone
+  constants and option labels, so importing timezone utilities and Slack formatting works
+  on systems without legacy timezone links.
+
+## [2.4] - 2026-10-20
+
+### Added
+
+- Add an opt-in `reraise_exceptions` parameter to `powertools_handler`. When enabled,
+  handler failures are logged and alerted before the original exception is re-raised so
+  stream and asynchronous event sources can apply their configured failure handling.
+  The default remains the existing 500 response, while SQS events continue to re-raise
+  unconditionally.
+
+## [2.3] - 2026-10-12
+
+### Fixed
+
+- `powertools_handler` re-raises exceptions for SQS event-source mappings after logging and
+  alerting, so failed batches are redelivered and can reach a configured DLQ instead of
+  being acknowledged by the wrapper's 500 response.
+
+## [2.2] - 2026-09-14
+
+### Added
+
+- Add response-returning Slack write methods (`post_message`, `post_thread_reply`,
+  `post_update`, and `post_file`) for callers that need message timestamps, channel IDs,
+  or the raw upload response. The existing bool-returning `send_*` methods retain their
+  error-swallowing behavior.
+- Add `SentMessage` as the result type for posted messages and thread replies.
+
+### Changed
+
+- `send_file` and `post_file` accept bytes and can upload into a thread with `thread_ts`.
+
+## [2.1] - 2026-08-03
+
+### Changed
+
+- **BREAKING**: replace `pytz` with the standard-library `zoneinfo` API and remove `pytz`
+  from the base dependencies. Code importing timezone constants must replace `.localize()`
+  with `tzinfo=...`, passing `fold=1` for repeated wall times where the old `is_dst=False`
+  default mattered, and replace `.zone` with `.key`. Declare `pytz` directly if application
+  code still imports it. The `[timezone]` extra supplies `tzdata` for minimal images without
+  a system IANA database.
+- Allow Elasticsearch client majors 7.17, 8.x, and 9.x through the `[elasticsearch]` and
+  `all` extras. See
+  [ADR-007](docs/decisions/ADR-007-elasticsearch-client-version-range.md).
+
+### Fixed
+
+- Send Elasticsearch search `size` inside a copied request body, avoiding caller-dict
+  mutation and duplicate-value errors on client majors 8.x and 9.x.
+- Return a plain `list` from `ElasticsearchClient.get_indices_info()` on every supported
+  Elasticsearch client major.
+- Make no-argument `slack_formatter.format_nz_time()` independent of the host timezone.
+
+### Added
+
+- Add an Elasticsearch compatibility test matrix for client majors 7.17, 8.x, and 9.x.
+- Add ADRs covering Elasticsearch version support and the move to `zoneinfo`.
+
+## [2.0] - 2026-07-13
+
+### Removed
+
+- **BREAKING**: the `nui_lambda_shared_utils` import shim. Import from `nui_shared_utils` instead (`from nui_shared_utils import ...`). The shim forwarded to `nui_shared_utils` with a `DeprecationWarning` since the 1.3.1 import-root rename and was always slated for removal in 2.0.0.
+  - The old distribution name still installs: `pip install nui-lambda-shared-utils` continues to resolve via the redirect package (which depends on `nui-python-shared-utils`). Only the old import root is gone.
+
+### Added
+
+- Add ADRs for the package's generic scope, lazy integrations, credential precedence,
+  explicit Secrets Manager region resolution, and Snowflake SQL API choice.
+
+## [1.6.0] - 2026-07-13
+
+### Added
+
+- Add a backend-neutral structured logging field registry, request-scoped Powertools and
+  stdlib binders, binding helpers, field validation, and recursive payload redaction.
+- Add the structured logging contract guide and ADR-001.
+
+## [1.5.0] - 2026-07-02
+
+### Added
+
+- Add optional `unfurl_links` and `unfurl_media` controls to `SlackClient.send_message`.
+  Unset values preserve Slack's existing defaults.
+
+## [1.4.1] - 2026-06-29
+
+### Fixed
+
+- Replace the Snowflake extra's direct Git dependency with the published
+  `snowflake-sql-api>=0.1.1,<0.2.0` range so PyPI accepts the package metadata.
+
+## [1.4.0] - 2026-06-29
+
+### Added
+
+- Add the pure-Python Snowflake SQL API client behind the optional `[snowflake]` extra,
+  including sync and async factories, key-pair credential resolution, query logging, and
+  offline tests.
+- Add a generic Anthropic client helper behind the optional `[llm]` extra, with API-key and
+  Bedrock authentication, forced tool-use calls, and text calls.
+- Add Snowflake and LLM integration guides.
+
+### Changed
+
+- **BREAKING**: resolve the Secrets Manager region from the boto3 session, `AWS_REGION`, or
+  `AWS_DEFAULT_REGION`, and fail explicitly instead of silently defaulting to
+  `ap-southeast-2`.
+
+## [1.3.3] - 2026-05-06
+
+### Performance
+
+- Cold-start init for Lambda consumers reduced by ~400ms.
+  - `boto3` and `botocore` are no longer imported at module load. They are deferred to first use inside `secrets_helper.get_secret`, `utils.create_aws_client`/`resolve_aws_region`, and `cloudwatch_metrics.MetricsPublisher` (now lazy-constructs its boto3 client on first metric publish).
+  - The package `__init__` uses PEP 562 `__getattr__` so submodules (`slack_client`, `es_client`, `db_client`, `jwt_auth`, `powertools_helpers`, etc.) only load when their attributes are first accessed. `import nui_shared_utils` is ~10ms, down from ~700ms+.
+- Public API is unchanged. Optional integrations still resolve to `None` when their backing dependency is not installed (matching the previous behaviour).
+
+### Added
+
+- `scripts/bench_imports.py` for measuring `python -X importtime` cumulative cost across common entry points.
+- `tests/test_lazy_imports.py` regression tests (boto3 must not appear in `sys.modules` after a bare package import or after importing `jwt_auth`/`powertools_helpers`).
+
+## [1.3.2] - 2026-04-10
+
+### Fixed
+
+- `get_elasticsearch_credentials()` now checks env vars (`ES_PASSWORD`/`ES_PASS`) before Secrets Manager, aligning with `BaseServiceClient` credential precedence
+- `ESClient._resolve_credentials_from_env()` accepts both `ES_PASSWORD`/`ES_USERNAME` and `ES_PASS`/`ES_USER` conventions
+
+## [1.3.1] - 2026-04-05
+
+### Changed
+
+- Renamed internal import from `nui_lambda_shared_utils` to `nui_shared_utils`
+
+## [1.3.0] - 2026-04-05
+
+### Changed
+
+- Renamed PyPI package from `nui-lambda-shared-utils` to `nui-python-shared-utils`
+- Added explicit license field for twine 6.x compatibility
+- Updated CI publish workflow for new package name and tag pattern
+
+## [1.0.0 - 1.2.3] - 2025-11 to 2026-03
+
+### Added
+
+- **Log Processors Module** - `log_processors` for Kinesis/CloudWatch log extraction
+- **AWS Powertools Integration** - `powertools_helpers` module with `get_powertools_logger()` and `powertools_handler()`
+- **JWT Authentication** - RS256 token validation for API Gateway Lambdas
+- **Slack Block Kit improvements** - Enhanced block builder patterns
+- **`slack-channel-setup` CLI tool** for Slack workspace automation
+- `service_name` parameter to `SlackClient` for custom display names
+- `[powertools]` optional dependency group
+- Streaming bulk operations for Elasticsearch
+- Environment-based credential resolution in `BaseServiceClient`
+- Pass-through account names support
+
+### Changed
+
+- Rebranded as generic production-ready package (not NUI-specific)
+- Improved Slack Lambda header formatting (cleaner 2-line layout)
+- Documentation reorganization and expansion
+
+### Breaking Changes
+
+- Removed `SERVICE_EMOJI` from public API exports
+- Removed `get_entity_stats()` and `get_record_stats()` from `DatabaseClient`
+- `format_currency()` now requires explicit currency parameter
+
+## [0.0.6] - 2025-11-16
+
+### Added
+
+- Configuration YAML support for account info
+- RabbitMQ integration utilities
+
+### Changed
+
+- Enhanced configuration system
+
+## [0.0.5] - 2025-09-29
+
+### Added
+
+- Comprehensive test improvements
+- Better test coverage across modules
+
+### Fixed
+
+- Various test fixes and improvements
+
+## [0.0.4] - 2025-09-05
+
+### Changed
+
+- Minor improvements and fixes
+
+## [0.0.3] - 2025-09-05
+
+### Changed
+
+- Initial improvements
+
+## [0.0.2] - 2025-09-05
+
+### Added
+
+- Initial package structure
+- Core client implementations (Slack, Elasticsearch, Database)
+- Metrics publishing utilities
+- Error handling decorators
+- Timezone utilities for NZ timezone handling
+
+## [0.0.1] - 2025-09-05
+
+### Added
+
+- Initial release
+- Basic project structure
+- Python package configuration
+
+[Unreleased]: https://github.com/nuimarkets/nui-python-shared-utils/compare/2.4...HEAD
+[2.4]: https://github.com/nuimarkets/nui-python-shared-utils/compare/2.3...2.4
+[2.3]: https://github.com/nuimarkets/nui-python-shared-utils/compare/2.2...2.3
+[2.2]: https://github.com/nuimarkets/nui-python-shared-utils/compare/2.1...2.2
+[2.1]: https://github.com/nuimarkets/nui-python-shared-utils/compare/2.0...2.1
+[2.0]: https://github.com/nuimarkets/nui-python-shared-utils/compare/1.6.0...2.0
+[1.6.0]: https://github.com/nuimarkets/nui-python-shared-utils/compare/1.5.0...1.6.0
+[1.5.0]: https://github.com/nuimarkets/nui-python-shared-utils/compare/1.4.1...1.5.0
+[1.4.1]: https://github.com/nuimarkets/nui-python-shared-utils/compare/1.4.0...1.4.1
+[1.4.0]: https://github.com/nuimarkets/nui-python-shared-utils/compare/1.3.3...1.4.0
+[1.3.3]: https://github.com/nuimarkets/nui-python-shared-utils/compare/1.3.2...1.3.3
+[1.3.2]: https://github.com/nuimarkets/nui-python-shared-utils/compare/1.3.1...1.3.2
+[1.3.1]: https://github.com/nuimarkets/nui-python-shared-utils/compare/1.3.0...1.3.1
+[1.3.0]: https://github.com/nuimarkets/nui-python-shared-utils/compare/0.0.6...1.3.0
+[0.0.6]: https://github.com/nuimarkets/nui-python-shared-utils/compare/0.0.5...0.0.6
+[0.0.5]: https://github.com/nuimarkets/nui-python-shared-utils/compare/0.0.4...0.0.5
+[0.0.4]: https://github.com/nuimarkets/nui-python-shared-utils/compare/0.0.3...0.0.4
+[0.0.3]: https://github.com/nuimarkets/nui-python-shared-utils/compare/0.0.2...0.0.3
+[0.0.2]: https://github.com/nuimarkets/nui-python-shared-utils/compare/0.0.1...0.0.2
+[0.0.1]: https://github.com/nuimarkets/nui-python-shared-utils/releases/tag/0.0.1

{nui_python_shared_utils-2.3 → nui_python_shared_utils-2.4.1}/CONTRIBUTING.md

@@ -6,7 +6,7 @@ We welcome contributions to the NUI Python Shared Utilities project! This docume
 
 ### Prerequisites
 
-- Python 3.9 or higher
+- Python 3.10 or higher
 - Git
 - Virtual environment tool (venv, virtualenv, etc.)
 

{nui_python_shared_utils-2.3 → nui_python_shared_utils-2.4.1}/PKG-INFO

@@ -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 → nui_python_shared_utils-2.4.1}/README.md

@@ -1,7 +1,7 @@
 # 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 → nui_python_shared_utils-2.4.1}/docs/decisions/ADR-008-stdlib-zoneinfo-over-pytz.md

@@ -11,7 +11,7 @@ that wanted only the logging contract or the metrics helper still shipped it.
 
 The cost is not the code. `pytz` bundles its own copy of the Olson/IANA database (0.86 MB of a
 1.0 MB installed package, measured on `pytz==2025.2`), and that copy is redundant on
-every interpreter this package supports: `requires-python = ">=3.9"`, and `zoneinfo` has been in
+every interpreter this package supports: `requires-python = ">=3.10"`, and `zoneinfo` has been in
 the standard library since 3.9, reading the system database that Linux, macOS, and the AWS Lambda
 runtimes all ship.
 
@@ -82,8 +82,9 @@ a database to everyone:
 
 ## Load-bearing premises (supersede triggers)
 
-- **The interpreter floor stays at 3.9+.** `zoneinfo` is stdlib from 3.9. A drop below that
-  would need `backports.zoneinfo`, at which point the calculus changes.
+- **All supported interpreters include stdlib `zoneinfo`.** The package requires Python 3.10
+  or higher. Supporting an interpreter older than 3.9 would need `backports.zoneinfo`, at
+  which point the calculus changes.
 - **Target runtimes ship a system IANA database.** True of Linux, macOS, and the AWS Lambda
   runtimes today. If the primary deployment target became one that does not, `tzdata` belongs in
   the base dependencies unconditionally and this ADR's marker split is obsolete.

{nui_python_shared_utils-2.3 → nui_python_shared_utils-2.4.1}/docs/getting-started/installation.md

@@ -4,7 +4,7 @@ This guide covers installation, dependency management, and environment setup for
 
 ## Requirements
 
-- Python 3.9 or higher
+- Python 3.10 or higher
 - AWS credentials configured for Secrets Manager access
 - Optional: AWS CLI for credential management
 
@@ -139,7 +139,7 @@ pip install nui-python-shared-utils[all]
 
 ```bash
 # Create environment
-conda create -n nui-utils python=3.9
+conda create -n nui-utils python=3.10
 
 # Activate environment
 conda activate nui-utils
@@ -209,7 +209,7 @@ aws lambda publish-layer-version \
   --layer-name nui-python-shared-utils \
   --description "NUI Lambda Shared Utilities" \
   --zip-file fileb://nui-utils-layer.zip \
-  --compatible-runtimes python3.9 python3.10 python3.11
+  --compatible-runtimes python3.10 python3.11
 ```
 
 ### Using in Lambda Function

{nui_python_shared_utils-2.3 → nui_python_shared_utils-2.4.1}/docs/guides/powertools-integration.md

@@ -168,6 +168,9 @@ def powertools_handler(
     service_name: str,
     metrics_namespace: Optional[str] = None,
     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.
@@ -176,6 +179,9 @@ def powertools_handler(
         service_name: Service identifier for logging and metrics dimensions
         metrics_namespace: CloudWatch namespace (e.g., "NUI/TenderAnalyser")
         slack_alert_channel: Slack channel for error alerts (e.g., "#alerts")
+        slack_account_names: AWS account ID to display-name mapping for alerts
+        slack_account_names_config: YAML file containing account-name defaults
+        reraise_exceptions: Re-raise after logging and alerting. Defaults to False.
     """
 ```
 
@@ -193,7 +199,46 @@ The decorator logs the exception and sends the Slack alert (if configured), then
   group waits until the batch succeeds or redrives, and the Slack alert fires on every
   receive. For per-record retries, enable `ReportBatchItemFailures` on the mapping and
   return `{"batchItemFailures": [...]}` from the handler; the decorator passes it through.
-- **Every other event**: returns `{"statusCode": 500, "body": "Internal Server Error"}`.
+- **Every other event, by default**: returns
+  `{"statusCode": 500, "body": "Internal Server Error"}` to preserve existing behavior.
+- **Every other event with `reraise_exceptions=True`**: re-raises after logging the
+  exception and sending the configured Slack alert. Use this for Kinesis and DynamoDB
+  Streams, where a raised exception prevents the checkpoint from advancing, and for
+  asynchronous sources such as SNS, S3, and EventBridge, where Lambda failure handling
+  depends on the invocation failing.
+
+The option is handler-wide rather than an event-source list because the handler's trigger
+configuration determines whether Lambda failure semantics are appropriate. SQS does not
+require the option and continues to re-raise unconditionally.
+
+For synchronous triggers such as API Gateway, enabling this option changes failures from
+the decorator's 500 response into an unhandled Lambda invocation error. Enable it only when
+that caller-visible behavior is intended.
+
+### Re-raise Failures for Stream and Async Sources
+
+```python
+from nui_shared_utils import powertools_handler
+
+
+@powertools_handler(
+    service_name="event-processor",
+    slack_alert_channel="#production-alerts",
+    reraise_exceptions=True,
+)
+def handler(event, context):
+    records = event.get("Records", [])
+    for record in records:
+        print(record)
+    return {"processed": len(records)}
+```
+
+Logging and Slack alerting run before the original exception is re-raised. Configure the
+trigger's retry, bisect, failure destination, or dead-letter behavior separately in AWS.
+Every retry invokes the decorator again, so a configured Slack alert can be sent once per
+attempt. For Kinesis and DynamoDB Streams, maximum retry attempts and maximum record age
+bound retries. Bisect-on-error isolates a failing record by adding invocations, which do not
+consume the retry quota and can produce additional alerts.
 
 ### Basic Usage (Logging Only)
 

{nui_python_shared_utils-2.3 → nui_python_shared_utils-2.4.1}/docs/guides/shared-types.md

@@ -103,6 +103,7 @@ client.get_connection_info() -> Dict
 ```
 
 **Connection Pool Entry Structure:**
+
 ```python
 {
     "connection": pymysql.Connection,
@@ -111,6 +112,7 @@ client.get_connection_info() -> Dict
 ```
 
 **Connection Info Response:**
+
 ```python
 {
     "host": str,
@@ -169,6 +171,7 @@ client.get_indices_info(pattern="*") -> List[Dict]
 ```
 
 **Service Stats Response:**
+
 ```python
 {
     "service": str,
@@ -183,6 +186,7 @@ client.get_indices_info(pattern="*") -> List[Dict]
 ```
 
 **Cluster Info Response:**
+
 ```python
 {
     "version": str,
@@ -222,6 +226,7 @@ client.get_bot_info() -> Dict
 ```
 
 **Lambda Context Structure:**
+
 ```python
 {
     "function_name": str,
@@ -240,6 +245,7 @@ client.get_bot_info() -> Dict
 ```
 
 **Bot Info Response:**
+
 ```python
 {
     "bot_id": str,
@@ -274,6 +280,7 @@ result = matcher.categorize_error(exception)
 ```
 
 **Categorized Error Response:**
+
 ```python
 {
     "error": str,
@@ -286,6 +293,7 @@ result = matcher.categorize_error(exception)
 ```
 
 **Built-in Error Categories:**
+
 - `data_format` - JSON parsing errors
 - `authentication` - Auth failures
 - `database` - DB timeouts
@@ -310,6 +318,7 @@ summary = aggregator.get_summary()
 ```
 
 **Error Summary Response:**
+
 ```python
 {
     "total_errors": int,
@@ -360,6 +369,7 @@ publisher.flush() -> bool
 ```
 
 **Metric Data Structure (internal buffer):**
+
 ```python
 {
     "MetricName": str,
@@ -429,6 +439,7 @@ with TimedMetric(publisher, "DatabaseQuery", unit="Milliseconds", dimensions=Non
 ### Credential Structures
 
 **Database Credentials:**
+
 ```python
 {
     "host": str,
@@ -440,6 +451,7 @@ with TimedMetric(publisher, "DatabaseQuery", unit="Milliseconds", dimensions=Non
 ```
 
 **Elasticsearch Credentials:**
+
 ```python
 {
     "host": str,                      # With port (e.g., "elastic:9200")
@@ -449,6 +461,7 @@ with TimedMetric(publisher, "DatabaseQuery", unit="Milliseconds", dimensions=Non
 ```
 
 **Slack Credentials:**
+
 ```python
 {
     "bot_token": str,
@@ -492,6 +505,7 @@ stats = get_pool_stats()
 ```
 
 **Pool Stats Response:**
+
 ```python
 {
     "total_pools": int,
@@ -514,6 +528,7 @@ response = handle_lambda_error(error, context)
 ```
 
 **Lambda Error Response:**
+
 ```python
 {
     "statusCode": 500,

{nui_python_shared_utils-2.3 → nui_python_shared_utils-2.4.1}/mypy.ini

@@ -1,5 +1,5 @@
 [mypy]
-python_version = 3.9
+python_version = 3.10
 warn_return_any = False
 warn_unused_configs = True
 ignore_missing_imports = True