feat(python): add snippet tests and Linux CI

.github/workflows/python-darwin-snippets.yaml

@@ -0,0 +1,88 @@
+name: python darwin snippets
+
+on:
+  pull_request:
+  schedule:
+    - cron: "15 7 * * *"
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
+permissions: {}
+
+jobs:
+  sdk-versions:
+    runs-on: ubuntu-latest
+    outputs:
+      senzingsdk-versions: ${{ steps.cfg.outputs.senzingsdk-versions }}
+    steps:
+      - id: cfg
+        uses: senzing-factory/build-resources/sdk-versions@v4
+
+  python-darwin-snippets:
+    needs: sdk-versions
+    permissions:
+      contents: read
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.14"]
+        senzingsdk-version: ${{ fromJSON(needs.sdk-versions.outputs.senzingsdk-versions) }}
+
+    steps:
+      - name: checkout repository
+        uses: actions/checkout@v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: install test dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install --group test
+
+      - name: Mint staging tap token
+        if: matrix.senzingsdk-version != 'production-v4'
+        id: staging-token
+        uses: actions/create-github-app-token@v3.2.0
+        with:
+          client-id: ${{ secrets.SENZINGSDK_STAGING_CLIENT_ID }}
+          private-key: ${{ secrets.SENZINGSDK_STAGING_APP_KEY }}
+          owner: senzing-factory # zizmor: ignore[github-app]
+          repositories: homebrew-senzingsdk-staging
+          permission-contents: read
+
+      - name: install Senzing SDK
+        uses: senzing-factory/github-action-install-senzing-sdk@v5
+        with:
+          senzingsdk-version: ${{ matrix.senzingsdk-version }}
+          senzingsdk-token: ${{ steps.staging-token.outputs.token || github.token }}
+
+      - name: configure environment
+        run: |
+          SENZING_PATH="${HOME}/senzing"
+          {
+            echo "SENZING_PATH=${SENZING_PATH}"
+            echo "DYLD_LIBRARY_PATH=${SENZING_PATH}/er/lib:${SENZING_PATH}/er/lib/macos"
+            echo "PYTHONPATH=${SENZING_PATH}/er/sdk/python"
+          } >> "$GITHUB_ENV"
+
+      - name: run python snippets
+        run: |
+          python -m pytest -rs
+
+      - name: Notify Slack on failure
+        if: (failure() || cancelled()) && github.event_name == 'schedule'
+        uses: senzing-factory/build-resources/slack-failure-notification@v4
+        with:
+          job-status: ${{ job.status }}
+          slack-channel: ${{ secrets.SLACK_CHANNEL }}
+          slack-bot-token: ${{ secrets.SLACK_BOT_TOKEN }}
+          additional-info: "SDK: ${{ matrix.senzingsdk-version }}, Python: ${{ matrix.python-version }}"

.github/workflows/python-linux-snippets.yaml

@@ -0,0 +1,74 @@
+name: python linux snippets
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: "15 7 * * *"
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
+permissions: {}
+
+jobs:
+  sdk-versions:
+    runs-on: ubuntu-latest
+    outputs:
+      senzingsdk-versions: ${{ steps.cfg.outputs.senzingsdk-versions }}
+    steps:
+      - id: cfg
+        uses: senzing-factory/build-resources/sdk-versions@v4
+
+  python-linux-snippets:
+    needs: sdk-versions
+    permissions:
+      contents: read
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        senzingsdk-version: ${{ fromJSON(needs.sdk-versions.outputs.senzingsdk-versions) }}
+
+    steps:
+      - name: checkout repository
+        uses: actions/checkout@v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: install test dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install --group test
+
+      - name: install Senzing runtime
+        uses: senzing-factory/github-action-install-senzing-sdk@v5
+        with:
+          packages-to-install: "senzingsdk-runtime senzingsdk-setup"
+          senzingsdk-version: ${{ matrix.senzingsdk-version }}
+
+      - name: run python snippets
+        env:
+          LD_LIBRARY_PATH: "/opt/senzing/er/lib"
+          PYTHONPATH: "/opt/senzing/er/sdk/python"
+        run: |
+          python -m pytest -rs
+
+      - name: Notify Slack on failure
+        if: (failure() || cancelled()) && github.event_name == 'schedule'
+        uses: senzing-factory/build-resources/slack-failure-notification@v4
+        with:
+          job-status: ${{ job.status }}
+          slack-channel: ${{ secrets.SLACK_CHANNEL }}
+          slack-bot-token: ${{ secrets.SLACK_BOT_TOKEN }}
+          additional-info: "SDK: ${{ matrix.senzingsdk-version }}, Python: ${{ matrix.python-version }}"

.github/workflows/python-windows-snippets.yaml

@@ -0,0 +1,84 @@
+name: python windows snippets
+
+on:
+  pull_request:
+  schedule:
+    - cron: "15 7 * * *"
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
+permissions: {}
+
+jobs:
+  sdk-versions:
+    runs-on: ubuntu-latest
+    outputs:
+      senzingsdk-versions: ${{ steps.cfg.outputs.senzingsdk-versions }}
+    steps:
+      - id: cfg
+        uses: senzing-factory/build-resources/sdk-versions@v4
+
+  python-windows-snippets:
+    needs: sdk-versions
+    permissions:
+      contents: read
+    runs-on: windows-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.14"]
+        senzingsdk-version: ${{ fromJSON(needs.sdk-versions.outputs.senzingsdk-versions) }}
+
+    steps:
+      - name: checkout repository
+        uses: actions/checkout@v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: install test dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install --group test
+
+      - name: Mint staging bucket token
+        if: matrix.senzingsdk-version != 'production-v4'
+        id: staging-token
+        uses: actions/create-github-app-token@v3.2.0
+        with:
+          client-id: ${{ secrets.SENZINGSDK_STAGING_CLIENT_ID }}
+          private-key: ${{ secrets.SENZINGSDK_STAGING_APP_KEY }}
+          owner: senzing-factory # zizmor: ignore[github-app]
+          repositories: scoop-senzingsdk-staging
+          permission-contents: read
+
+      - name: install Senzing SDK
+        uses: senzing-factory/github-action-install-senzing-sdk@v5
+        with:
+          senzingsdk-version: ${{ matrix.senzingsdk-version }}
+          senzingsdk-token: ${{ steps.staging-token.outputs.token || github.token }}
+
+      - name: configure environment
+        run: |
+          Add-Content $env:GITHUB_PATH "$Env:USERPROFILE\senzing\er\lib"
+          Add-Content $env:GITHUB_ENV "PYTHONPATH=$Env:USERPROFILE\senzing\er\sdk\python"
+
+      - name: run python snippets
+        run: |
+          python -m pytest -rs
+
+      - name: Notify Slack on failure
+        if: (failure() || cancelled()) && github.event_name == 'schedule'
+        uses: senzing-factory/build-resources/slack-failure-notification@v4
+        with:
+          job-status: ${{ job.status }}
+          slack-channel: ${{ secrets.SLACK_CHANNEL }}
+          slack-bot-token: ${{ secrets.SLACK_BOT_TOKEN }}
+          additional-info: "SDK: ${{ matrix.senzingsdk-version }}, Python: ${{ matrix.python-version }}"

.gitignore

@@ -135,8 +135,9 @@ dmypy.json
 *.code-workspace
 .history
 
-# Output folder used by examples
-resources/output/
+# Output folder used by examples; keep the folder, ignore its contents
+resources/output/*
+!resources/output/.gitkeep
 
 csharp/snippets/**/bin
 csharp/snippets/**/obj

.vscode/cspell.json

@@ -5,6 +5,7 @@
     "accessibilities",
     "analysing",
     "antaenc",
+    "autouse",
     "Axxxx",
     "barrycaceres",
     "bugtracker",
@@ -22,6 +23,7 @@
     "Dsenzing",
     "DSRC",
     "DYLD",
+    "executescript",
     "findsecbugs",
     "fpvs",
     "glassfish",
@@ -44,11 +46,13 @@
     "pylint",
     "pypa",
     "pytest",
+    "PYTHONPATH",
     "RESOURCEPATH",
     "Retryable",
     "roslynator",
     "Rotorville",
     "schemaname",
+    "SENZ",
     "Senzing",
     "senzingsdk",
     "setuptools",
@@ -64,6 +68,7 @@
     "taskkill",
     "temurin",
     "terashuf",
+    "testpaths",
     "tpascalcase",
     "truthset",
     "unresolve",

CHANGELOG.md

@@ -5,11 +5,26 @@ All notable changes to this project will be documented in this file.
 The changelog format is based on [Keep a Changelog] and [CommonMark].
 This project adheres to [Semantic Versioning].
 
-## [Unreleased]
+## [0.0.11] - 2026-10-09
 
-### Added in Unreleased
+### Added in 0.0.11
 
 - Java Migration Guide (`java/Migration.md`) covering the version 3.x to 4.0 SDK changes
+- Python snippet tests (`python/tests`) running every snippet end to end against a temporary SQLite repository
+- GitHub Actions workflows running the Python snippet tests on Linux, macOS and Windows
+
+### Changed in 0.0.11
+
+- Python snippets exit with status 1 and report to stderr when a Senzing error stops them
+- `resources/output/` is now part of the repository so snippets writing with-info output work on a fresh clone
+- `add_queue.py` uses a producer thread instead of separate processes, matching the Java and C# snippets
+- `signal_handler.py` waits with a sleep loop instead of `signal.pause()`, which isn't available on Windows
+
+### Fixed in 0.0.11
+
+- `redo_with_info_continuous.py` raised a `TypeError` instead of exiting when a Senzing error occurred
+- `add_queue.py` loaded no records but exited successfully on macOS, Windows and Python 3.14+, and could stop early if the
+  queue was momentarily empty
 
 ## [0.0.10] - 2025-08-11
 

pyproject.toml

@@ -67,6 +67,9 @@ test = [
   "coverage==7.16.1; python_version > '3.11'",
 ]
 
+[tool.pytest.ini_options]
+testpaths = ["python/tests"]
+
 [tool.setuptools]
 package-dir = { "" = "python" }
 

python/README.md

@@ -1 +1,15 @@
 # Python Snippets
+
+## Running the tests
+
+`python/tests` runs every snippet end to end as a subprocess, each against its own temporary SQLite repository, and checks it exits cleanly with nothing on stderr. Your `SENZING_ENGINE_CONFIGURATION_JSON` is not used and your repository is not touched.
+
+```bash
+export PYTHONPATH=/opt/senzing/er/sdk/python
+export LD_LIBRARY_PATH=/opt/senzing/er/lib
+python -m pytest
+```
+
+Senzing install locations default to `/opt/senzing/er`, `/opt/senzing/data` and `/etc/opt/senzing`; override them with the same environment variables the Java SnippetRunner uses: `SENZING_PATH`, `SENZING_DIR`, `SENZING_SUPPORT_DIR`, `SENZING_RESOURCE_DIR` and `SENZING_CONFIG_DIR`.
+
+Snippets are discovered automatically. A snippet needing data loaded, registered data sources, console input or a ctrl-c to stop it gets an entry in `SNIPPETS` in `tests/test_snippets.py`.

python/configuration/get_config_registry.py

@@ -18,3 +18,4 @@
     print(response)
 except SzError as err:
     print(f"{err.__class__.__name__} - {err}", file=sys.stderr)
+    sys.exit(1)

python/configuration/get_data_source_registry.py

@@ -21,3 +21,4 @@
     print(response)
 except SzError as err:
     print(f"{err.__class__.__name__} - {err}", file=sys.stderr)
+    sys.exit(1)

python/configuration/init_default_config.py

@@ -26,3 +26,4 @@
     print(f"New default config ID: {new_config_id}")
 except SzError as err:
     print(f"{err.__class__.__name__} - {err}", file=sys.stderr)
+    sys.exit(1)

python/configuration/register_data_sources.py

@@ -27,3 +27,4 @@
     print(f"New default config ID: {new_config_id}")
 except SzError as err:
     print(f"{err.__class__.__name__} - {err}", file=sys.stderr)
+    sys.exit(1)

python/deleting/delete_futures.py

@@ -73,3 +73,4 @@ def futures_del(engine, input_file):
     futures_del(sz_engine, INPUT_FILE)
 except SzError as err:
     mock_logger("CRITICAL", err)
+    sys.exit(1)

python/deleting/delete_loop.py

@@ -54,3 +54,4 @@ def del_records_from_file(engine, input_file):
     del_records_from_file(sz_engine, INPUT_FILE)
 except SzError as err:
     mock_logger("CRITICAL", err)
+    sys.exit(1)

python/deleting/delete_with_info_futures.py

@@ -84,3 +84,4 @@ def futures_del(engine, input_file, output_file):
     futures_del(sz_engine, INPUT_FILE, OUTPUT_FILE)
 except SzError as err:
     mock_logger("CRITICAL", err)
+    sys.exit(1)