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

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.2}/.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.2}/.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.2}/.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.2/.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.2/.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.2}/AGENTS.md

@@ -194,6 +194,11 @@ Clients resolve credentials in this order (first match wins):
 2. **Environment variables** — per-client patterns, skips Secrets Manager
 3. **AWS Secrets Manager** — default behavior
 
+The `get_*_credentials` helpers in `secrets_helper.py` follow tiers 2 and 3 through the same
+per-service env resolver and secret normaliser the clients use. Elasticsearch host:
+`host` argument > `ES_HOST`/`ELASTICSEARCH_HOST` > `configure(es_host=...)` > secret `host` >
+`localhost:9200`.
+
 ### Environment Variables
 
 Runtime configuration:

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.2}/CHANGELOG.md

@@ -8,6 +8,47 @@ that contained them.
 
 ## [Unreleased]
 
+### Changed
+
+- **BREAKING**: `get_database_credentials` and `get_slack_credentials` check environment
+  variables before Secrets Manager, matching `DatabaseClient`, `SlackClient` and
+  `get_elasticsearch_credentials`. With `DB_HOST` and `DB_PASSWORD` set, or `SLACK_BOT_TOKEN`
+  set, they return the env values (MySQL defaults for unset `DB_PORT`, `DB_USERNAME`,
+  `DB_DATABASE`) and make no AWS call, even when a `secret_name` is passed, and they no longer
+  raise for a missing secret name in that case. A caller that reads a second database or
+  workspace through `get_database_credentials("<other secret>")` or
+  `get_slack_credentials("<other secret>")` while the `DB_*` or `SLACK_BOT_TOKEN` env vars
+  describe the first gets the first; read that secret with `get_secret` and map its fields.
+- `ElasticsearchClient` reads the `host` field of its resolved credentials. Host order on the
+  client and `get_elasticsearch_credentials` is: `host` argument (client only), `ES_HOST` or
+  `ELASTICSEARCH_HOST`, a host set with `configure(es_host=...)`, the credentials' `host`, then
+  `localhost:9200`. A client built from a secret that carries a host, with neither `ES_HOST` nor
+  `configure(es_host=...)` set, connects to that host instead of `localhost:9200`. The helper
+  appends `:9200` to any host that is not a URL and names no port, including one that starts
+  with `http` (`httpd-es`), as the client does.
+- `ElasticsearchClient` and `SlackClient` add the normalised fields the helpers return to
+  credentials fetched from Secrets Manager (`host`/`username`/`password`, and
+  `bot_token`/`webhook_url`), keeping the secret's other keys. A legacy `token` field is used
+  when `bot_token` is missing, null or empty; the helper used to keep a null or empty
+  `bot_token`. `SlackClient.credentials` from env vars always carries a `webhook_url` key,
+  `None` when `SLACK_WEBHOOK_URL` is unset.
+
+- **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.
+- Powertools docstring and guide examples use generic service and namespace names
+  (`order-processor`, `Ecommerce/Orders`) instead of internal repo names. Docs only, no
+  behaviour change.
+
+### Fixed
+
+- `PostgreSQLClient` given a secret with no `port` or `database` fills PostgreSQL defaults
+  (`5432`, `postgres`) instead of the MySQL ones (`3306`, `app`).
+- 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 +271,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.2}/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.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nui-python-shared-utils
-Version: 2.4
+Version: 2.4.2
 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.
@@ -222,7 +221,7 @@ from nui_shared_utils import get_secret, get_slack_credentials
 api_keys = get_secret("my-service/api-keys")
 
 # Specialized getters with normalized field names
-slack_creds = get_slack_credentials()  # Uses configured secret name
+slack_creds = get_slack_credentials()  # SLACK_BOT_TOKEN if set, else the configured secret
 ```
 
 **[→ See full secrets management guide](docs/getting-started/configuration.md#aws-secrets-manager)**

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.2}/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.
@@ -121,7 +121,7 @@ from nui_shared_utils import get_secret, get_slack_credentials
 api_keys = get_secret("my-service/api-keys")
 
 # Specialized getters with normalized field names
-slack_creds = get_slack_credentials()  # Uses configured secret name
+slack_creds = get_slack_credentials()  # SLACK_BOT_TOKEN if set, else the configured secret
 ```
 
 **[→ See full secrets management guide](docs/getting-started/configuration.md#aws-secrets-manager)**

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.2}/docs/decisions/ADR-004-credential-resolution-precedence.md

@@ -24,14 +24,19 @@ The function-based helper historically undercut this. `get_elasticsearch_credent
 (`secrets_helper.py`) called Secrets Manager first even when `ES_PASSWORD` was set, so CLI and
 local-dev paths paid an avoidable AWS call. Commit `0d3f8e8` (PR #23) added the env-var check
 ahead of the store lookup, aligning the helper with the precedence the clients already enforced.
+The database and Slack helpers kept calling the store first until they were routed through the
+clients' own env resolvers, and the Elasticsearch client ignored a secret's `host` field that the
+helper honoured.
 
 ## Decision
 
 Credentials resolve in a fixed order, first match wins, owned by `BaseClient._resolve_credentials`
 in `base_client.py`:
 
-1. **Explicit `credentials` dict** passed to the constructor. Returned as-is; nothing else is
-   consulted. The caller owns these values and the package does not merge or second-guess them.
+1. **Explicit `credentials` dict** passed to the constructor. Returned as-is; no other credential
+   source is consulted. The caller owns these values and the package does not merge or
+   second-guess them. An Elasticsearch `host` key in the dict is the one exception: it follows
+   the host order below.
 2. **Per-client environment variables**, via each client's `_resolve_credentials_from_env` override
    (Elasticsearch reads `ES_PASSWORD`/`ES_PASS` in `es_client.py`; database requires
    `DB_HOST` + `DB_PASSWORD` in `db_client.py`; Slack requires `SLACK_BOT_TOKEN` in
@@ -42,9 +47,19 @@ in `base_client.py`:
 
 A later tier fires only when every earlier tier is absent. An AWS call happens only when neither
 an explicit dict nor env vars resolve, so local-dev, CLI, and test paths that supply explicit or
-environment credentials make **zero** Secrets Manager calls. The direct function helper mirrors
-the tail of this ladder for callers that bypass the client classes:
-`get_elasticsearch_credentials` checks env vars, then the store.
+environment credentials make **zero** Secrets Manager calls. The direct function helpers mirror
+the tail of this ladder for callers that bypass the client classes: `get_elasticsearch_credentials`,
+`get_database_credentials` and `get_slack_credentials` each check the same env vars as their
+client, then the store. Client hook and helper call the same per-service functions in
+`secrets_helper.py` (an env resolver and a secret normaliser per service, with per-engine defaults
+for MySQL and PostgreSQL), so the two paths cannot drift apart.
+
+The Elasticsearch host follows its own order on both paths: the client's `host` argument, then
+`ES_HOST` (or `ELASTICSEARCH_HOST`), then the `host` field of the resolved credentials (the
+secret's, or an explicit dict's), then `localhost:9200`. A host set with `configure(es_host=...)`
+ranks between the env var and the credentials' `host`, because a caller that set it chose it; an
+`ES_HOST` the config picked up from the environment at startup does not. To pin the host of one
+client whatever the environment holds, pass its `host` argument.
 
 ## Alternatives considered
 

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.2}/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.2}/docs/getting-started/configuration.md

@@ -18,6 +18,18 @@ All clients (Slack, Elasticsearch, Database) resolve credentials in this order:
 2. **Credential environment variables** - Per-client env vars, skips Secrets Manager
 3. **AWS Secrets Manager** - Default behavior (unchanged)
 
+The helper functions `get_elasticsearch_credentials`, `get_database_credentials` and
+`get_slack_credentials` follow the same order from step 2: when the client's env vars are set
+they return those values without calling Secrets Manager. `get_database_credentials` applies the
+MySQL defaults; `PostgreSQLClient` applies the PostgreSQL ones on both the env and the secret path.
+
+The Elasticsearch host resolves as: the client's `host` argument, then `ES_HOST` (or
+`ELASTICSEARCH_HOST`), then a host set with `nui.configure(es_host=...)`, then the secret's
+`host` field, then the built-in default
+(`localhost:9200`). The client and `get_elasticsearch_credentials` use the same order. A `host`
+key in an explicit `credentials` dict ranks where the secret's does, so to pin one client's host
+pass `host=` instead.
+
 ## Environment Variables
 
 ### Core Configuration
@@ -163,7 +175,8 @@ The package expects AWS secrets in specific JSON formats:
 
 **Optional Fields:**
 
-- `host` - Can override ES_HOST if provided
+- `host` - Used when the credentials come from this secret (no `ES_PASSWORD` or `ES_PASS`) and
+  no `host=` argument, `ES_HOST`, `ELASTICSEARCH_HOST` or `configure(es_host=...)` names one
 - `username` - Defaults to "elastic" if not provided
 
 #### Database Credentials
@@ -178,7 +191,8 @@ The package expects AWS secrets in specific JSON formats:
 }
 ```
 
-**All fields are required** for database connections.
+`host`, `username` and `password` are required. A missing `port` or `database` takes the
+engine's default: `3306`/`app` for MySQL, `5432`/`postgres` for `PostgreSQLClient`.
 
 #### Slack Credentials
 
@@ -274,6 +288,8 @@ slack = nui.SlackClient(secret_name="custom-slack-secret")
 es_creds = nui.get_elasticsearch_credentials("custom-es-secret")
 db_creds = nui.get_database_credentials("custom-db-secret")
 slack_creds = nui.get_slack_credentials("custom-slack-secret")
+# These three return the env values instead, ignoring the secret name, when the
+# client's credential env vars are set (ES_PASSWORD, DB_HOST + DB_PASSWORD, SLACK_BOT_TOKEN).
 
 # Generic secret retrieval
 api_keys = nui.get_secret("my-service/api-keys")

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.2}/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.2}/docs/guides/powertools-integration.md

@@ -80,7 +80,7 @@ def get_powertools_logger(
     Create AWS Powertools Logger with Elasticsearch-compatible formatting.
 
     Args:
-        service_name: Service identifier (e.g., "nui-tender-analyser")
+        service_name: Service identifier (e.g., "order-processor")
         level: Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
         local_dev_colors: Enable coloredlogs for local development
 
@@ -177,7 +177,7 @@ def powertools_handler(
 
     Args:
         service_name: Service identifier for logging and metrics dimensions
-        metrics_namespace: CloudWatch namespace (e.g., "NUI/TenderAnalyser")
+        metrics_namespace: CloudWatch namespace (e.g., "Ecommerce/Orders")
         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

{nui_python_shared_utils-2.4 → nui_python_shared_utils-2.4.2}/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.2}/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.2}/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.2}/nui_shared_utils/config.py

@@ -34,7 +34,9 @@ class Config:
             slack_credentials_secret: AWS secret name for Slack credentials
             aws_region: AWS region for secrets/services
         """
-        # Elasticsearch settings
+        # Elasticsearch settings. An es_host passed here outranks a host carried in a
+        # credentials secret; the env-derived and built-in values do not.
+        self._es_host_explicit = es_host is not None
         if es_host is not None:
             self.es_host = es_host
         else: