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

{nui_python_shared_utils-2.4 → 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.4 → 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.4 → 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 → nui_python_shared_utils-2.4.1}/CHANGELOG.md

@@ -8,6 +8,19 @@ 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,
@@ -230,7 +243,8 @@ that contained them.
 - Basic project structure
 - Python package configuration
 
-[Unreleased]: https://github.com/nuimarkets/nui-python-shared-utils/compare/2.3...HEAD
+[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

{nui_python_shared_utils-2.4 → 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.4 → nui_python_shared_utils-2.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nui-python-shared-utils
-Version: 2.4
+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.4 → 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.4 → 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.4 → 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.4 → 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.4 → 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

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.1}/nui_python_shared_utils.egg-info/SOURCES.txt

@@ -1,4 +1,5 @@
 .editorconfig
+.markdownlint-base.yaml
 .markdownlint-cli2.yaml
 AGENTS.md
 CHANGELOG.md

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.1}/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_python_shared_utils-2.4 → nui_python_shared_utils-2.4.1}/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)"),
     ]

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.1}/pyproject.toml

@@ -11,14 +11,13 @@ authors = [
 description = "Shared Python utilities for AWS Lambda, CLI tools, and agents with Slack, Elasticsearch, and monitoring integrations"
 readme = "README.md"
 license = {file = "LICENSE"}
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -110,7 +109,7 @@ include = ["nui_shared_utils*"]
 
 [tool.black]
 line-length = 120
-target-version = ['py39']
+target-version = ['py310']
 include = '\.pyi?$'
 extend-exclude = '''
 /(
@@ -127,7 +126,7 @@ extend-exclude = '''
 '''
 
 [tool.mypy]
-python_version = "3.9"
+python_version = "3.10"
 warn_return_any = false
 warn_unused_configs = true
 ignore_missing_imports = true

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.1}/redirect/pyproject.toml

@@ -10,7 +10,7 @@ authors = [
 ]
 description = "Redirect package: use nui-python-shared-utils instead"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 classifiers = [
     "Development Status :: 7 - Inactive",
     "Intended Audience :: Developers",

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.1}/setup.py

@@ -28,7 +28,6 @@ setup(
         "License :: OSI Approved :: MIT License",
         "Operating System :: OS Independent",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
@@ -103,6 +102,6 @@ setup(
             "anthropic[bedrock]>=0.45.0,<1.0.0",
         ],
     },
-    python_requires=">=3.9",
+    python_requires=">=3.10",
     keywords="aws lambda utilities slack elasticsearch monitoring serverless python shared",
 )

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.1}/tests/test_slack_client.py

@@ -51,12 +51,12 @@ class TestSlackClient:
     def test_init_with_default_secret_name(self, mock_webclient, mock_get_secret):
         """Test initialization with default secret name."""
         mock_get_secret.return_value = {"bot_token": "xoxb-default-token"}
-        
+
         with patch("nui_shared_utils.base_client.resolve_config_value") as mock_resolve:
             mock_resolve.return_value = "slack-credentials"
-            
+
             client = SlackClient()
-        
+
         mock_get_secret.assert_called_once_with("slack-credentials")
         mock_webclient.assert_called_once_with(token="xoxb-default-token")
 
@@ -77,7 +77,9 @@ class TestSendMessage:
         result = slack.send_message("C123", "Test message", include_lambda_header=False)
 
         assert result is True
-        mock_client.chat_postMessage.assert_called_once_with(channel="C123", text="Test message", blocks=None, attachments=None)
+        mock_client.chat_postMessage.assert_called_once_with(
+            channel="C123", text="Test message", blocks=None, attachments=None
+        )
 
     @patch("nui_shared_utils.base_client.get_secret")
     @patch("nui_shared_utils.slack_client.WebClient")
@@ -94,7 +96,9 @@ class TestSendMessage:
         result = slack.send_message("C123", "Fallback text", blocks=blocks, include_lambda_header=False)
 
         assert result is True
-        mock_client.chat_postMessage.assert_called_once_with(channel="C123", text="Fallback text", blocks=blocks, attachments=None)
+        mock_client.chat_postMessage.assert_called_once_with(
+            channel="C123", text="Fallback text", blocks=blocks, attachments=None
+        )
 
     @patch("nui_shared_utils.base_client.get_secret")
     @patch("nui_shared_utils.slack_client.WebClient")
@@ -954,7 +958,7 @@ class TestLambdaContextHeader:
             "AWS_LAMBDA_LOG_STREAM_NAME": "2023/11/15/[$LATEST]abc123",
             "AWS_REGION": "eu-west-1",
             "STAGE": "prod",
-            "AWS_EXECUTION_ENV": "AWS_Lambda_python3.9",
+            "AWS_EXECUTION_ENV": "AWS_Lambda_python3.10",
         },
     )
     def test_lambda_header_connect_production(self, mock_webclient, mock_get_secret, mock_boto3):
@@ -996,15 +1000,18 @@ class TestLambdaContextHeader:
             header_text = header_block["elements"][0]["text"]
 
             # Use helper to check all expected parts
-            self.assert_header_format(header_text, {
-                "robot emoji": "🤖",
-                "function name": "test-function",
-                "account name": "Production",
-                "account ID": "(123456789012)",
-                "region": "eu-west-1",
-                "log emoji": "📋",
-                "log group": "`/aws/lambda/test-function`"
-            })
+            self.assert_header_format(
+                header_text,
+                {
+                    "robot emoji": "🤖",
+                    "function name": "test-function",
+                    "account name": "Production",
+                    "account ID": "(123456789012)",
+                    "region": "eu-west-1",
+                    "log emoji": "📋",
+                    "log group": "`/aws/lambda/test-function`",
+                },
+            )
 
     @patch("nui_shared_utils.slack_client.create_aws_client")
     @patch("nui_shared_utils.base_client.get_secret")
@@ -1055,14 +1062,17 @@ class TestLambdaContextHeader:
             header_text = header_block["elements"][0]["text"]
 
             # Use helper to check all expected parts
-            self.assert_header_format(header_text, {
-                "robot emoji": "🤖",
-                "function name": "nui-service",
-                "account name": "Development",
-                "account ID": "(234567890123)",
-                "region": "ap-southeast-2",
-                "log emoji": "📋"
-            })
+            self.assert_header_format(
+                header_text,
+                {
+                    "robot emoji": "🤖",
+                    "function name": "nui-service",
+                    "account name": "Development",
+                    "account ID": "(234567890123)",
+                    "region": "ap-southeast-2",
+                    "log emoji": "📋",
+                },
+            )
 
     @patch("nui_shared_utils.slack_client.create_aws_client")
     @patch("nui_shared_utils.base_client.get_secret")
@@ -1096,14 +1106,14 @@ class TestLambdaContextHeader:
 
             # Create client with custom service name
             slack = SlackClient(
-                secret_name="test-secret",
-                service_name="my-service",
-                account_names={"123456789012": "Production"}
+                secret_name="test-secret", service_name="my-service", account_names={"123456789012": "Production"}
             )
 
             # Simulate Lambda handler providing context with ARN
             mock_context = Mock()
-            mock_context.invoked_function_arn = "arn:aws:lambda:eu-west-1:123456789012:function:connect-prod-long-service-name-12345"
+            mock_context.invoked_function_arn = (
+                "arn:aws:lambda:eu-west-1:123456789012:function:connect-prod-long-service-name-12345"
+            )
             slack.set_handler_context(mock_context)
 
             result = slack.send_message("C123", "Test message")
@@ -1122,14 +1132,17 @@ class TestLambdaContextHeader:
             assert "connect-prod-long-service-name-12345" not in header_text
 
             # Other header elements should still be present
-            self.assert_header_format(header_text, {
-                "robot emoji": "🤖",
-                "function name": "my-service",  # Custom name
-                "account name": "Production",
-                "account ID": "(123456789012)",
-                "region": "eu-west-1",
-                "log emoji": "📋"
-            })
+            self.assert_header_format(
+                header_text,
+                {
+                    "robot emoji": "🤖",
+                    "function name": "my-service",  # Custom name
+                    "account name": "Production",
+                    "account ID": "(123456789012)",
+                    "region": "eu-west-1",
+                    "log emoji": "📋",
+                },
+            )
 
     @patch("nui_shared_utils.slack_client.create_aws_client")
     @patch("nui_shared_utils.base_client.get_secret")
@@ -1153,19 +1166,14 @@ class TestLambdaContextHeader:
         # Mock Lambda client
         mock_lambda = Mock()
         mock_boto3.return_value = mock_lambda
-        mock_lambda.get_function.return_value = {
-            "Configuration": {"FunctionName": "test-function"}
-        }
+        mock_lambda.get_function.return_value = {"Configuration": {"FunctionName": "test-function"}}
 
         # Mock config file check
         with patch("os.path.exists") as mock_exists:
             mock_exists.return_value = False
 
             # Create client WITHOUT custom service name
-            slack = SlackClient(
-                secret_name="test-secret",
-                account_names={"123456789012": "Production"}
-            )
+            slack = SlackClient(secret_name="test-secret", account_names={"123456789012": "Production"})
 
             # Simulate Lambda handler providing context with ARN
             mock_context = Mock()
@@ -1187,14 +1195,17 @@ class TestLambdaContextHeader:
             assert "test-function" in header_text
 
             # All header elements should be present
-            self.assert_header_format(header_text, {
-                "robot emoji": "🤖",
-                "function name": "test-function",  # Original function name
-                "account name": "Production",
-                "account ID": "(123456789012)",
-                "region": "eu-west-1",
-                "log emoji": "📋"
-            })
+            self.assert_header_format(
+                header_text,
+                {
+                    "robot emoji": "🤖",
+                    "function name": "test-function",  # Original function name
+                    "account name": "Production",
+                    "account ID": "(123456789012)",
+                    "region": "eu-west-1",
+                    "log emoji": "📋",
+                },
+            )
 
     @patch("nui_shared_utils.slack_client.create_aws_client")
     @patch("nui_shared_utils.base_client.get_secret")
@@ -1632,7 +1643,11 @@ class TestSlackCredentialResolution:
 
     @patch("nui_shared_utils.base_client.get_secret")
     @patch("nui_shared_utils.slack_client.WebClient")
-    @patch.dict("os.environ", {"SLACK_BOT_TOKEN": "xoxb-env-token", "SLACK_WEBHOOK_URL": "https://hooks.slack.com/xxx"}, clear=False)
+    @patch.dict(
+        "os.environ",
+        {"SLACK_BOT_TOKEN": "xoxb-env-token", "SLACK_WEBHOOK_URL": "https://hooks.slack.com/xxx"},
+        clear=False,
+    )
     def test_env_var_includes_optional_webhook(self, _mock_webclient, _mock_get_secret):
         """SLACK_WEBHOOK_URL is included when present."""
         client = SlackClient()

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.1}/tests/test_timezone.py

@@ -8,9 +8,11 @@ import sys
 import textwrap
 from datetime import datetime, timedelta, timezone
 from unittest.mock import patch
+from zoneinfo import ZoneInfo
 
 import pytest
 
+import nui_shared_utils.timezone as timezone_utils
 from nui_shared_utils.timezone import nz_time, format_nz_time, NZ_TZ
 
 
@@ -259,6 +261,41 @@ class TestAmbiguousWallTimes:
 class TestTimezoneConstants:
     """Tests for timezone constants."""
 
+    def test_all_zone_keys_are_canonical(self):
+        # Canonical names for the supported regions, from IANA's zone1970.tab:
+        # https://data.iana.org/time-zones/tzdb/zone1970.tab
+        # Keep this list independent of the host database: available_timezones()
+        # also includes optional backward links on many systems.
+        canonical_keys = {
+            "Pacific/Auckland",
+            "Australia/Sydney",
+            "America/New_York",
+            "America/Los_Angeles",
+            "Europe/London",
+        }
+        zone_keys = {value.key for value in vars(timezone_utils).values() if isinstance(value, ZoneInfo)}
+        assert zone_keys, "No timezone constants were checked"
+        assert zone_keys <= canonical_keys, f"Non-canonical or unreviewed zone keys: {zone_keys - canonical_keys}"
+
+    def test_option_labels_use_canonical_zone_keys(self):
+        labels = dict(timezone_utils.get_timezone_options())
+        assert labels["us_east"] == "US Eastern (America/New_York)"
+        assert labels["us_west"] == "US Pacific (America/Los_Angeles)"
+
+    @pytest.mark.parametrize(
+        "zone, month, offset, abbreviation",
+        [
+            (timezone_utils.US_EAST_TZ, 1, -5, "EST"),
+            (timezone_utils.US_EAST_TZ, 7, -4, "EDT"),
+            (timezone_utils.US_WEST_TZ, 1, -8, "PST"),
+            (timezone_utils.US_WEST_TZ, 7, -7, "PDT"),
+        ],
+    )
+    def test_us_offsets_and_dst(self, zone, month, offset, abbreviation):
+        local = datetime(2024, month, 15, 12, tzinfo=timezone.utc).astimezone(zone)
+        assert local.utcoffset() == timedelta(hours=offset)
+        assert local.tzname() == abbreviation
+
     def test_nz_tz_constant(self):
         """Test that NZ_TZ is properly configured."""
         assert NZ_TZ.key == "Pacific/Auckland"

nui_python_shared_utils-2.4/.markdownlint-cli2.yaml

@@ -1,47 +0,0 @@
-# Markdownlint configuration for nui-python-shared-utils
-# Extends workspace config with project-specific overrides
-
-config:
-  # Enable all rules by default
-  default: true
-
-  # MD013: Line length - disabled (technical docs need long lines for URLs/commands)
-  MD013: false
-
-  # MD033: Inline HTML - allowed (needed for complex formatting)
-  MD033: false
-
-  # MD036: No emphasis as heading - disabled (acceptable in planning docs)
-  MD036: false
-
-  # MD040: Fenced code language - disabled (not all code blocks need language tags)
-  MD040: false
-
-  # MD041: First line heading - disabled (docs may start with metadata)
-  MD041: false
-
-  # MD024: Multiple headings with same content - allowed with different levels
-  MD024:
-    siblings_only: true
-
-  # MD034: Bare URLs - allowed (sometimes intentional)
-  MD034: false
-
-  # MD046: Code block style - prefer fenced
-  MD046:
-    style: "fenced"
-
-  # MD060: Table column style - disabled (minor formatting preference)
-  MD060: false
-
-# File patterns to check
-globs:
-  - "**/*.md"
-
-# Exclusions
-ignores:
-  - "node_modules/**"
-  - "vendor/**"
-  - ".git/**"
-  - "venv/**"
-  - ".venv/**"