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

nui_python_shared_utils-2.5.0/.github/workflows/lambda-validation.yml

@@ -0,0 +1,71 @@
+name: Lambda validation tool
+
+# tools/lambda-validation is a separately versioned build-time package. Its consumers
+# pin it by commit, so every change runs its own suite, including the container checks.
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  tool:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12', '3.13', '3.14']
+    defaults:
+      run:
+        working-directory: tools/lambda-validation
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install the tool and its test runner
+        run: |
+          python -m venv "$RUNNER_TEMP/lv"
+          "$RUNNER_TEMP/lv/bin/pip" install . pytest==8.4.2
+      - name: Lint the tool
+        run: |
+          python -m venv "$RUNNER_TEMP/lint"
+          "$RUNNER_TEMP/lint/bin/pip" install ruff==0.16.6 black==24.10.0
+          "$RUNNER_TEMP/lint/bin/ruff" check --select F,E9,B .
+          "$RUNNER_TEMP/lint/bin/black" -l 120 --check .
+      - name: Pull the Lambda runtime images the container tests use
+        run: |
+          for version in 3.11 3.12 3.13 3.14; do
+            docker pull --platform linux/amd64 "public.ecr.aws/lambda/python:$version"
+          done
+      - name: Tool tests, zero skips
+        run: |
+          "$RUNNER_TEMP/lv/bin/python" -m pytest -p no:cacheprovider -c /dev/null --rootdir . \
+            --junitxml="$RUNNER_TEMP/tool.xml" tests
+          "$RUNNER_TEMP/lv/bin/python" -c 'import os, xml.etree.ElementTree as ET; r = ET.parse(os.environ["RUNNER_TEMP"] + "/tool.xml").getroot(); assert sum(int(s.get("skipped", 0)) for s in r.iter("testsuite")) == 0'
+
+  root-distribution:
+    # The root nui-python-shared-utils wheel must never carry the tool.
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.12'
+      - run: python -m pip install build
+      - run: python -m build --outdir "$RUNNER_TEMP/dist" .
+      - name: No tool members in the root wheel or sdist
+        # `set -e` ignores a `!`-negated command, so each test exits explicitly.
+        run: |
+          if unzip -Z1 "$RUNNER_TEMP"/dist/*.whl | grep -E '(^|/)(tools/|nui_lambda_validation)'; then exit 1; fi
+          if tar -tzf "$RUNNER_TEMP"/dist/*.tar.gz | grep -E '/tools/'; then exit 1; fi
+          unzip -Z1 "$RUNNER_TEMP"/dist/*.whl | grep '^nui_shared_utils/__init__.py$' >/dev/null
+          tar -tzf "$RUNNER_TEMP"/dist/*.tar.gz | grep '/nui_shared_utils/__init__.py$' >/dev/null  # no -q: an early exit would SIGPIPE the lister under pipefail

{nui_python_shared_utils-2.4.2 → nui_python_shared_utils-2.5.0}/AGENTS.md

@@ -65,6 +65,15 @@ The `slack_setup/` submodule provides automated Slack workspace configuration:
 - **CLI Tool** - `slack-channel-setup` command for automation
 - **Generic Design** - Adaptable for any Slack workspace, not NUI-specific
 
+### Build-time tools (`tools/`)
+
+`tools/lambda-validation/` is a separate distribution, `nui-lambda-validation`, with its own
+`pyproject.toml`, tests and workflow (`.github/workflows/lambda-validation.yml`). It must not
+import or depend on `nui_shared_utils`, and `MANIFEST.in` prunes `tools/` so it never ships in
+this package. The root `pytest` run does not collect its tests; run them from the tool
+directory as its README describes. Consumers pin it by full commit SHA, so a change there is a
+new release for every repository that bumps its pin.
+
 ## Design Principles
 
 ### Keeping the Package Generic

{nui_python_shared_utils-2.4.2 → nui_python_shared_utils-2.5.0}/MANIFEST.in

@@ -7,6 +7,8 @@ recursive-include nui_shared_utils *.py
 recursive-include nui_shared_utils/slack_setup *.yaml
 
 # Exclude development and build files
+# tools/ holds separately versioned build-time packages, never part of this distribution
+prune tools
 exclude .gitignore
 exclude .github
 recursive-exclude * __pycache__

{nui_python_shared_utils-2.4.2 → nui_python_shared_utils-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nui-python-shared-utils
-Version: 2.4.2
+Version: 2.5.0
 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
@@ -152,6 +152,8 @@ Production-ready shared Python utilities for AWS Lambda functions, CLI tools, an
 
 **Complete documentation**: See [docs/](docs/README.md) for all guides and references.
 
+**Build-time Lambda artifact checks** live in a separate package, `nui-lambda-validation`, pinned by commit and never shipped in this distribution or in a Lambda ZIP: [tools/lambda-validation/README.md](tools/lambda-validation/README.md).
+
 **Component Guides:**
 
 - **[AWS Powertools Integration Guide](docs/guides/powertools-integration.md)** - Logging, metrics, error handling

{nui_python_shared_utils-2.4.2 → nui_python_shared_utils-2.5.0}/README.md

@@ -52,6 +52,8 @@ Production-ready shared Python utilities for AWS Lambda functions, CLI tools, an
 
 **Complete documentation**: See [docs/](docs/README.md) for all guides and references.
 
+**Build-time Lambda artifact checks** live in a separate package, `nui-lambda-validation`, pinned by commit and never shipped in this distribution or in a Lambda ZIP: [tools/lambda-validation/README.md](tools/lambda-validation/README.md).
+
 **Component Guides:**
 
 - **[AWS Powertools Integration Guide](docs/guides/powertools-integration.md)** - Logging, metrics, error handling

{nui_python_shared_utils-2.4.2 → nui_python_shared_utils-2.5.0}/nui_python_shared_utils.egg-info/SOURCES.txt

@@ -14,6 +14,7 @@ pytest.ini
 requirements-test.txt
 setup.py
 .github/workflows/ci.yml
+.github/workflows/lambda-validation.yml
 .github/workflows/publish.yml
 .github/workflows/test.yml
 docs/README.md