iperf3-lib 0.4.1__tar.gz → 0.4.2__tar.gz

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/.github/workflows/ci.yml

@@ -20,6 +20,30 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  scope:
+    name: CI scope
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    outputs:
+      native-required: ${{ steps.scope.outputs.native-required }}
+    steps:
+      - name: Check out exact event revision and comparison history
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.sha }}
+          fetch-depth: 0
+          persist-credentials: false
+      - name: Select required CI coverage
+        id: scope
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          BASE_SHA: ${{ github.event.pull_request.base.sha || github.event.before }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha || github.sha }}
+        run: >-
+          python scripts/ci_scope.py detect
+          --event "$EVENT_NAME" --base "$BASE_SHA" --head "$HEAD_SHA"
+          --github-output "$GITHUB_OUTPUT" --summary "$GITHUB_STEP_SUMMARY"
+
   lint-and-types:
     name: lint-and-types
     runs-on: ubuntu-latest
@@ -36,7 +60,7 @@ jobs:
 
       - name: Install uv and Python
         id: setup-uv
-        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
         with:
           python-version: "3.12"
           enable-cache: true
@@ -73,7 +97,7 @@ jobs:
             --github-output "$GITHUB_OUTPUT"
 
       - name: Retain the exact lifecycle qualification distributions
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: lifecycle-distributions
           path: lifecycle-dist/*
@@ -93,12 +117,13 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
       - name: Check pull request title and commits
-        uses: dariuszpanas/yaga/actions/commit-check@f61bbfa878447157239bb92ff67977bd64400afd # v0.2.0
+        uses: dariuszpanas/yaga/actions/commit-check@fe0a4b219002c7f49eee055f1fd7ef9c8ccd526f # v0.3.0
 
   docker-matrix-tests:
     name: docker (${{ matrix.python }}, iperf ${{ matrix.iperf }})
     runs-on: ubuntu-latest
-    needs: lint-and-types
+    needs: [scope, lint-and-types]
+    if: needs.scope.outputs.native-required == 'true'
     timeout-minutes: 45
     strategy:
       fail-fast: false
@@ -119,7 +144,7 @@ jobs:
           persist-credentials: false
 
       - name: Download the retained wheel, sdist and source manifest
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: lifecycle-distributions
           path: lifecycle-dist
@@ -175,7 +200,7 @@ jobs:
 
       - name: Retain installed lifecycle receipts and test logs
         if: always()
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: lifecycle-py${{ matrix.python }}-iperf${{ matrix.iperf }}
           path: lifecycle-evidence/*
@@ -185,19 +210,21 @@ jobs:
   ci:
     name: ci
     runs-on: ubuntu-latest
-    needs: [lint-and-types, commit-policy, docker-matrix-tests]
+    needs: [scope, lint-and-types, commit-policy, docker-matrix-tests]
     if: ${{ always() }}
     timeout-minutes: 5
     steps:
+      - name: Check out exact event revision
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.sha }}
+          persist-credentials: false
       - name: Verify required jobs
         env:
+          SCOPE_RESULT: ${{ needs.scope.result }}
+          NATIVE_REQUIRED: ${{ needs.scope.outputs.native-required }}
           LINT_RESULT: ${{ needs.lint-and-types.result }}
-          TEST_RESULT: ${{ needs.docker-matrix-tests.result }}
+          NATIVE_RESULT: ${{ needs.docker-matrix-tests.result }}
           COMMIT_RESULT: ${{ needs.commit-policy.result }}
           EVENT_NAME: ${{ github.event_name }}
-        run: |
-          test "$LINT_RESULT" = "success"
-          test "$TEST_RESULT" = "success"
-          if [ "$EVENT_NAME" = "pull_request" ]; then
-            test "$COMMIT_RESULT" = "success"
-          fi
+        run: python scripts/ci_scope.py gate

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/.github/workflows/docs.yml

@@ -24,7 +24,7 @@ jobs:
         with:
           persist-credentials: false
       - name: Install uv and Python
-        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
         with:
           python-version: "3.12"
           enable-cache: true

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/.github/workflows/python-preview.yml

@@ -29,7 +29,7 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
       - name: Install stable build tools
-        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
         with:
           python-version: "3.12"
       - name: Qualify source before native execution
@@ -54,7 +54,7 @@ jobs:
             --distributions preview-dist --revision "$SOURCE_REVISION" \
             --github-output "$GITHUB_OUTPUT"
       - name: Retain preview distributions and manifest
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: python-preview-distributions
           path: preview-dist/*
@@ -77,7 +77,7 @@ jobs:
           ref: ${{ needs.build.outputs.revision }}
           persist-credentials: false
       - name: Download the same preview distributions
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: python-preview-distributions
           path: preview-dist
@@ -96,7 +96,7 @@ jobs:
           cache-to: type=gha,mode=max,scope=preview-base-iperf${{ matrix.iperf }}
       - name: Install the exact candidate interpreter in a separate environment
         run: |
-          docker pull ghcr.io/astral-sh/uv:0.12.23@sha256:dd2385ac82b9aff6489344ec2b22916db986eb135454d030bce3038c7598a689
+          docker pull ghcr.io/astral-sh/uv:0.13.5@sha256:32a7bb39b496babbd997b0a39a4d66c126bdaf5661b302bf6f06abda8deca6ff
           docker build --builder default --load -f Dockerfile.preview \
             --build-arg NATIVE_IMAGE=iperf3-lib-preview-base:local \
             -t iperf3-lib-preview:local .
@@ -107,7 +107,7 @@ jobs:
         run: |
           mkdir -p preview-evidence
           docker image inspect iperf3-lib-preview:local > preview-evidence/image.json
-          docker image inspect ghcr.io/astral-sh/uv:0.12.23@sha256:dd2385ac82b9aff6489344ec2b22916db986eb135454d030bce3038c7598a689 > preview-evidence/uv-image.json
+          docker image inspect ghcr.io/astral-sh/uv:0.13.5@sha256:32a7bb39b496babbd997b0a39a4d66c126bdaf5661b302bf6f06abda8deca6ff > preview-evidence/uv-image.json
           docker run --rm -v "${{ github.workspace }}/preview-evidence:/evidence" \
             iperf3-lib-preview:local \
             /opt/preview-venv/bin/python -I /app/scripts/python_preview.py \
@@ -170,7 +170,7 @@ jobs:
             '
       - name: Retain preview runtime, installed receipts and logs
         if: always()
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: python-preview-rc3-iperf${{ matrix.iperf }}
           path: preview-evidence/**

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/.github/workflows/release.yml

@@ -44,7 +44,7 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
       - name: Install uv and Python
-        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
         with:
           python-version: "3.12"
           enable-cache: true
@@ -90,7 +90,7 @@ jobs:
             --distributions dist --manifest release-evidence/lifecycle-manifest.json \
             --revision "$EXPECTED_REVISION" --github-output "$GITHUB_OUTPUT"
       - name: Upload retained distributions and identity manifest
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: release-bundle
           path: |
@@ -123,7 +123,7 @@ jobs:
           ref: ${{ needs.build.outputs.revision }}
           persist-credentials: false
       - name: Download retained release bundle
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: release-bundle
       - name: Verify retained distribution hashes
@@ -212,7 +212,7 @@ jobs:
             '
       - name: Retain installed-native evidence
         if: always()
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: native-evidence-py${{ matrix.python }}-iperf${{ matrix.iperf }}
           path: native-evidence/*.json
@@ -239,7 +239,7 @@ jobs:
             --python "$PYTHON_VERSION" --native "$IPERF3_VERSION" --output /evidence
       - name: Retain installed lifecycle receipts and logs
         if: always()
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: lifecycle-evidence-py${{ matrix.python }}-iperf${{ matrix.iperf }}
           path: lifecycle-evidence/*
@@ -266,20 +266,20 @@ jobs:
           ref: ${{ needs.build.outputs.revision }}
           persist-credentials: false
       - name: Install qualification verifier dependencies
-        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
         with:
           python-version: "3.12"
       - name: Download retained release bundle
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: release-bundle
       - name: Download all installed smoke receipts
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           pattern: native-evidence-py*
           path: retained/smoke
       - name: Download all installed lifecycle receipts and logs
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           pattern: lifecycle-evidence-py*
           path: retained/lifecycle
@@ -302,7 +302,7 @@ jobs:
             --output release-evidence/qualification.json
           echo "Qualified revision: $EXPECTED_REVISION" >> "$GITHUB_STEP_SUMMARY"
       - name: Retain the verified release qualification index
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: release-qualification
           path: release-evidence/qualification.json
@@ -322,7 +322,7 @@ jobs:
       id-token: write
     steps:
       - name: Download retained release bundle
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: release-bundle
       - name: Verify retained distribution hashes
@@ -356,7 +356,7 @@ jobs:
                   raise SystemExit(f"Release artifact changed: {name}")
           PY
       - name: Publish to TestPyPI
-        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3
         with:
           repository-url: https://test.pypi.org/legacy/
 
@@ -373,7 +373,7 @@ jobs:
       id-token: write
     steps:
       - name: Download retained release bundle
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: release-bundle
       - name: Verify retained distribution hashes
@@ -407,7 +407,7 @@ jobs:
                   raise SystemExit(f"Release artifact changed: {name}")
           PY
       - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3
 
   github-release:
     name: Create GitHub release from retained artifacts
@@ -419,7 +419,7 @@ jobs:
       contents: write
     steps:
       - name: Download retained release bundle
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: release-bundle
       - name: Verify retained distribution hashes
@@ -453,7 +453,7 @@ jobs:
                   raise SystemExit(f"Release artifact changed: {name}")
           PY
       - name: Download verified qualification index
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: release-qualification
           path: release-evidence

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/Dockerfile.preview

@@ -1,7 +1,7 @@
 # The native image is built from the unchanged Dockerfile for each libiperf endpoint.
 ARG NATIVE_IMAGE
 
-FROM ghcr.io/astral-sh/uv:0.13.0@sha256:cdc6093146eb3ff6a40107b38f008b789e050e77ad87865e381d9917da55a168 AS preview-uv
+FROM ghcr.io/astral-sh/uv:0.13.5@sha256:32a7bb39b496babbd997b0a39a4d66c126bdaf5661b302bf6f06abda8deca6ff AS preview-uv
 FROM ${NATIVE_IMAGE}
 
 COPY --from=preview-uv /uv /uvx /usr/local/bin/

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/Makefile

@@ -83,9 +83,9 @@ docs-serve:
 	$(UV) run --frozen zensical serve
 
 build:
-	$(UV) build --no-sources
-	$(UV) run --frozen --no-dev --group release twine check dist/*
-	$(UV) run --frozen --no-dev --group release check-wheel-contents dist/*.whl
+	$(UV) build --no-sources --clear
+	$(UV) run --frozen --isolated --no-dev --group release twine check dist/*
+	$(UV) run --frozen --isolated --no-dev --group release check-wheel-contents dist/*.whl
 
 docker-build:
 	$(UV) run --frozen python scripts/docker_validate.py build \

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: iperf3-lib
-Version: 0.4.1
+Version: 0.4.2
 Summary: Programmable network benchmarking and analysis powered by libiperf.
 Project-URL: Homepage, https://github.com/dariuszpanas/iperf3-lib
 Project-URL: Documentation, https://dariuszpanas.github.io/iperf3-lib/
@@ -95,11 +95,11 @@ and execution limits.
 
 | Topic | Guides and references |
 | --- | --- |
-| Run clients and servers | [Running tests](https://dariuszpanas.github.io/iperf3-lib/guides/running-tests.html) · [Python API](https://dariuszpanas.github.io/iperf3-lib/reference/api.html) |
+| Run clients and servers | [Running tests](https://dariuszpanas.github.io/iperf3-lib/guides/running-tests.html) · [Live events](https://dariuszpanas.github.io/iperf3-lib/guides/live-events.html) · [Python API](https://dariuszpanas.github.io/iperf3-lib/reference/api.html) |
 | Bind interfaces and tune traffic | [Native-control recipes](https://dariuszpanas.github.io/iperf3-lib/guides/native-controls.html) · [Configuration](https://dariuszpanas.github.io/iperf3-lib/reference/configuration.html) · [Complete native-option inventory](https://dariuszpanas.github.io/iperf3-lib/reference/native-options.html) |
 | Check support and execution limits | [Compatibility and native setup](https://dariuszpanas.github.io/iperf3-lib/reference/compatibility.html) · [Rate intent and capabilities](https://dariuszpanas.github.io/iperf3-lib/guides/configuration-intent.html) |
 | Interpret and save measurements | [Results](https://dariuszpanas.github.io/iperf3-lib/guides/results.html) · [Portable artifacts](https://dariuszpanas.github.io/iperf3-lib/guides/artifacts.html) |
-| Analyze and compare experiments | [Analysis](https://dariuszpanas.github.io/iperf3-lib/guides/analysis.html) · [Trials and baselines](https://dariuszpanas.github.io/iperf3-lib/guides/trials.html) · [Parameter sweeps](https://dariuszpanas.github.io/iperf3-lib/guides/sweeps.html) |
+| Analyze and compare experiments | [Analysis](https://dariuszpanas.github.io/iperf3-lib/guides/analysis.html) · [Trials and baselines](https://dariuszpanas.github.io/iperf3-lib/guides/trials.html) · [Concurrent plans](https://dariuszpanas.github.io/iperf3-lib/guides/concurrent-plans.html) · [Parameter sweeps](https://dariuszpanas.github.io/iperf3-lib/guides/sweeps.html) · [Adaptive UDP](https://dariuszpanas.github.io/iperf3-lib/guides/adaptive-udp.html) |
 | Integrate monitoring | [Prometheus](https://dariuszpanas.github.io/iperf3-lib/guides/prometheus.html) · [Grafana](https://dariuszpanas.github.io/iperf3-lib/guides/grafana.html) |
 
 ## Contributing

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/README.md

@@ -62,11 +62,11 @@ and execution limits.
 
 | Topic | Guides and references |
 | --- | --- |
-| Run clients and servers | [Running tests](https://dariuszpanas.github.io/iperf3-lib/guides/running-tests.html) · [Python API](https://dariuszpanas.github.io/iperf3-lib/reference/api.html) |
+| Run clients and servers | [Running tests](https://dariuszpanas.github.io/iperf3-lib/guides/running-tests.html) · [Live events](https://dariuszpanas.github.io/iperf3-lib/guides/live-events.html) · [Python API](https://dariuszpanas.github.io/iperf3-lib/reference/api.html) |
 | Bind interfaces and tune traffic | [Native-control recipes](https://dariuszpanas.github.io/iperf3-lib/guides/native-controls.html) · [Configuration](https://dariuszpanas.github.io/iperf3-lib/reference/configuration.html) · [Complete native-option inventory](https://dariuszpanas.github.io/iperf3-lib/reference/native-options.html) |
 | Check support and execution limits | [Compatibility and native setup](https://dariuszpanas.github.io/iperf3-lib/reference/compatibility.html) · [Rate intent and capabilities](https://dariuszpanas.github.io/iperf3-lib/guides/configuration-intent.html) |
 | Interpret and save measurements | [Results](https://dariuszpanas.github.io/iperf3-lib/guides/results.html) · [Portable artifacts](https://dariuszpanas.github.io/iperf3-lib/guides/artifacts.html) |
-| Analyze and compare experiments | [Analysis](https://dariuszpanas.github.io/iperf3-lib/guides/analysis.html) · [Trials and baselines](https://dariuszpanas.github.io/iperf3-lib/guides/trials.html) · [Parameter sweeps](https://dariuszpanas.github.io/iperf3-lib/guides/sweeps.html) |
+| Analyze and compare experiments | [Analysis](https://dariuszpanas.github.io/iperf3-lib/guides/analysis.html) · [Trials and baselines](https://dariuszpanas.github.io/iperf3-lib/guides/trials.html) · [Concurrent plans](https://dariuszpanas.github.io/iperf3-lib/guides/concurrent-plans.html) · [Parameter sweeps](https://dariuszpanas.github.io/iperf3-lib/guides/sweeps.html) · [Adaptive UDP](https://dariuszpanas.github.io/iperf3-lib/guides/adaptive-udp.html) |
 | Integrate monitoring | [Prometheus](https://dariuszpanas.github.io/iperf3-lib/guides/prometheus.html) · [Grafana](https://dariuszpanas.github.io/iperf3-lib/guides/grafana.html) |
 
 ## Contributing

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/development/contributing.md

@@ -19,6 +19,32 @@ repository policies. `make test` runs non-native tests. Docker is required for
 workflow lint and the full native suite; see [compatibility](../docs/reference/compatibility.md)
 for supported versions. Run non-native gates before native tests.
 
+## CI coverage for documentation changes
+
+Pull requests and main pushes that change only the following documentation
+files skip the eight native Docker jobs:
+
+| Location | Allowed files |
+| --- | --- |
+| Repository root | `README.md`, `CONTRIBUTING.md`, `SECURITY.md` |
+| Anywhere under `docs/` or `development/` | `.md`, `.css` and image files |
+| Anywhere under `overrides/` | `.html`, `.css` and image files |
+
+Allowed image suffixes are `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg` and
+`.ico`. These paths and suffixes are case-sensitive. Changes must use ordinary
+non-executable files. Changes to any other path, executable or nonregular file
+modes, mixed changes, an empty diff or an uncertain comparison require the full
+native matrix. Renames retain both old and new paths for this decision.
+
+Quality checks, non-native unit tests, YAGA policies, the strict documentation
+build, README rendering and local-link checks, and the package build still run.
+The short workflow lint check also remains Docker-backed.
+
+The required `ci` result always runs and accepts a skipped native matrix only
+after an explicit documentation-only decision and successful remaining checks.
+Manual and scheduled CI runs still use the full matrix. Release qualification
+and publication always retain their complete native gates.
+
 ## Stable local Docker validation
 
 `make docker-build` and `make docker-test` copy the selected checkout into one

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/development/design/advanced-execution.md

@@ -19,7 +19,7 @@ criteria have evidence; implementation and collected tests alone are insufficien
 | Proposal | Decision | Evidence needed for complete qualification |
 | --- | --- | --- |
 | [Adaptive UDP #34](https://github.com/dariuszpanas/iperf3-lib/issues/34) | Qualified and merged through PR69; see the [0.4.0 guide](../../docs/guides/adaptive-udp.md). | The issue retains exact-source synthetic, minimum/latest native, isolated impairment, and installed wheel/sdist evidence. |
-| [Live events #35](https://github.com/dariuszpanas/iperf3-lib/issues/35) | Owned typed async contexts preserve complete-result access and legacy callbacks. | Minimum/latest event assembly, bounded delivery, failure/overflow/abandonment tests, and lifecycle qualification. |
+| [Live events #35](https://github.com/dariuszpanas/iperf3-lib/issues/35) | Qualified and merged through PR70; see the [0.4.0 live-event guide](../../docs/guides/live-events.md). | The [live-event qualification map](live-event-qualification.md) and issue retain minimum/latest event assembly, bounded delivery, failure/overflow/abandonment, and installed lifecycle evidence. |
 | [Process isolation #36](https://github.com/dariuszpanas/iperf3-lib/issues/36) | Qualified and merged through PR68. | The [acceptance map](isolated-execution-qualification.md) and issue retain the exact-source installed matrix, bounded transport, partial evidence and resource cleanup qualification. |
 
 Native event shapes have been observed in a small loopback experiment. The
@@ -186,7 +186,7 @@ and discards future nonterminal payloads; the owner must still drain/clean up
 the direct run or await an isolated worker's terminal state. Queue bounds do
 not cancel a native call.
 
-### Qualification still required
+### Qualification contract
 
 The 22 exploratory probes establish small event-shape observations only.
 The [live-event qualification map](live-event-qualification.md) connects these
@@ -306,7 +306,7 @@ Truncated or malformed frames invalidate only that worker's channel. Cap
 pending output, drain while waiting, and reject replayed/wrong-request terminal
 frames. Waiting for exit while a worker blocks sending its result can deadlock.
 
-### Qualification still required
+### Isolated worker qualification contract
 
 Test startup/import/native-load failure, malformed/oversized frames, crashes
 before and after allocation, stalled connection/run, user cancellation,
@@ -327,8 +327,7 @@ design do not establish its cancellation, stress or orphan-cleanup qualification
 
 Close each issue only when its implementation and qualification criteria are
 met, with acceptance checkboxes and retained exact-source evidence reconciled.
-Issues #34 and #36 record their completed qualification. The live-event issue
-tracks the remaining candidate evidence separately. The native-controls implementation must preserve complete results and
+Issues #34, #35, and #36 record their completed qualification and shipped in 0.4.0. The native-controls implementation must preserve complete results and
 explicit lifecycle/concurrency limits while its combined source is qualified.
 Revisit each broader proposal with its own acceptance evidence and release
 decision; adaptive UDP selection remains separate from explicit sweeps.

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/development/releasing.md

@@ -211,8 +211,8 @@ aggregate workflow result together before publication.
    will remain true after publication; rendering and matching hashes alone do
    not check this. PyPI retains the first uploaded description and cannot apply
    a later repository edit to that release. Then run the Docker/native matrix,
-   merge through the normal required checks, and run a build-only hosted
-   rehearsal for the resulting exact commit. Inspect the retained distributions,
+   merge through the normal required checks, and run a nonpublishing hosted
+   qualification for the resulting exact commit. Inspect the retained distributions,
    hashes, and every installed-native receipt.
 4. Inspect the retained artifacts' rendered README and deployed documentation
    anonymously. Confirm
@@ -239,7 +239,7 @@ and post releases are not part of this publication policy.
 Validate a planned tag against the current metadata:
 
 ```bash
-uv run --no-project python scripts/validate_release.py --tag v0.4.1
+uv run --no-project python scripts/validate_release.py --tag v0.4.2
 ```
 
 That local metadata check alone does not qualify the candidate. The workflow

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/development/roadmap.md

@@ -5,8 +5,19 @@ This is retained planning background from the 0.3.0 development cycle.
 for current scope and completion status; the tables below preserve the planning
 context rather than certify the current release candidate.
 
-## Released 0.4.0
-
+## 0.4.2 candidate and released 0.4.1 / 0.4.0
+
+The 0.4.2 candidate ([issue #106](https://github.com/dariuszpanas/iperf3-lib/issues/106))
+consolidates post-0.4.1 maintenance refinements: `address_family` verification
+from connected socket endpoints, strict report and artifact validation
+symmetry, consumer static-typing ergonomics and submodule `__all__` contracts
+([#102](https://github.com/dariuszpanas/iperf3-lib/issues/102)), adaptive UDP
+and worker/live-event runtime optimizations
+([#103](https://github.com/dariuszpanas/iperf3-lib/issues/103)), and the
+published API/schema stability policy and tagged documentation snapshots
+([#101](https://github.com/dariuszpanas/iperf3-lib/issues/101)).
+Version 0.4.1 refines CI scope detection for documentation-only changes while
+preserving the full native and installed-package qualification gates.
 Version 0.4.0 adds owned async and bounded concurrent plans,
 adaptive UDP experiments, and typed live-event consumption. Issues
 [#36](https://github.com/dariuszpanas/iperf3-lib/issues/36),
@@ -28,8 +39,9 @@ The 0.4.0 release completes this scope with the task-submission correction in
 recommendation. No additional feature cycle is required for this Beta release.
 Stable API/deprecation guarantees, immutable versioned documentation, broader
 platform coverage, longer mixed-workload qualification, and consumer feedback
-remain later stability work, tracked in
-[#78](https://github.com/dariuszpanas/iperf3-lib/issues/78).
+remain post-0.4.0 stability work, tracked in
+[#83](https://github.com/dariuszpanas/iperf3-lib/issues/83) (following the
+completed 0.4.0 readiness checklist in [#78](https://github.com/dariuszpanas/iperf3-lib/issues/78)).
 
 ## Historical 0.3.0 planning
 

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/docker-entrypoint.sh

@@ -2,11 +2,12 @@
 set -euo pipefail
 
 # Keep the image's development environment aligned with its baked-in lockfile.
-if [[ -f /app/pyproject.toml && -f /app/uv.lock ]]; then
-    uv sync --frozen --dev
-else
+if [[ ! -f /app/pyproject.toml || ! -f /app/uv.lock ]]; then
     echo "error: /app must contain pyproject.toml and uv.lock" >&2
     exit 2
 fi
+if [[ "${IPERF3_FORCE_UV_SYNC:-0}" == "1" || ! -f /opt/venv/pyvenv.cfg ]]; then
+    uv sync --frozen --dev
+fi
 
 exec "$@"

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/docs/changelog.md

@@ -4,7 +4,42 @@ These pages describe `main`. Released versions remain available through
 [GitHub releases](https://github.com/dariuszpanas/iperf3-lib/releases) and
 [PyPI](https://pypi.org/project/iperf3-lib/).
 
-## 0.4.1
+## 0.4.2
+
+- Verify `address_family` from observed socket endpoint literals in
+  `raw["start"]["connected"]`, populating `effective["address_family"]` as
+  `"ipv4"` or `"ipv6"` and treating `requested["address_family"] == "auto"` as
+  compatible with verified IPv4/IPv6 connections across client results,
+  artifacts, sweeps, and adaptive UDP experiments.
+- Accept `ipaddress.IPv4Address | ipaddress.IPv6Address` for
+  `ClientConfig.server` and `Literal["tcp", "udp", "sctp"]` strings for
+  `ClientConfig.protocol` in static type checking while normalizing to
+  `Protocol`. Declare explicit `__all__` exports across all public submodules.
+- Validate `TestResult` in-memory invariants (`version`, `protocol`,
+  `direction`, `reporting_role`) before artifact serialization, enforce
+  control-character and RFC 6901 JSON Pointer checks across artifact,
+  assessment, sweep, and concurrent report deserializers, preserve
+  `bytes_per_second` in `TrialAssessmentReport` text summaries, and include
+  `start_time_unix` in Prometheus exporter completeness checks.
+- Reuse first-pass observation dictionaries in adaptive UDP summaries, skip
+  unconditional `ctypes.util.find_library` subprocess probes when `IPERF3_LIB`
+  or standard Linux loader names succeed, switch worker parent-child pipes to
+  binary I/O with direct UTF-8 `bytes` JSON parsing, validate live-event
+  payloads in a single pass, and add a `/proc` fallback for `WaitPID` in
+  `docker-entrypoint.sh`.
+- Publish the [API and schema stability policy](reference/compatibility.md#compatibility-deprecation-and-archive-policy),
+  add tagged release documentation snapshot links (`v0.2.0`–`v0.4.1`), and
+  align architecture, design, and contributor documentation with the `0.4.x`
+  codebase.
+- Route documentation-only pull requests and pushes away from the native Docker
+  matrix while preserving the required `ci` check, static/unit gates, and full
+  native coverage for code, workflow, and release paths. Align preview `uv`
+  provenance checks and stricter `ty` keyword-argument typing.
+
+## 0.4.1 — 2026-10-12
+
+Published on [PyPI](https://pypi.org/project/iperf3-lib/0.4.1/) and as
+[GitHub release v0.4.1](https://github.com/dariuszpanas/iperf3-lib/releases/tag/v0.4.1).
 
 - Make the packaged README independent of publication timing. The immutable
   0.4.0 description incorrectly calls 0.4.0 unreleased; a repository-only edit

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/docs/getting-started.md

@@ -9,12 +9,13 @@ configuration, result, experiment, and reporting features, or keep your runner
 and import its completed JSON.
 
 !!! note "Match the documentation to your version"
-    This site follows `main`; the latest published version is **0.4.0**.
+    This site follows `main`; the latest published version is **0.4.1**.
     The project retains Beta maturity. Dataclasses, portable artifacts, analysis,
     trial plans, sweeps, and Prometheus output first shipped in 0.3.0; 0.4.0 adds
     owned async execution, concurrent plans, adaptive UDP and typed live events.
-    Use documentation matching your installed version.
-    Check the [changelog](changelog.md) and
+    Use documentation matching your installed version: see the
+    [tagged release documentation snapshots](reference/compatibility.md#release-documentation-snapshots),
+    [changelog](changelog.md), and
     [published releases](https://github.com/dariuszpanas/iperf3-lib/releases)
     for publication status.
 
@@ -28,7 +29,7 @@ changes, customizations, optional new APIs, and report readers.
 
 ## Install the Python package
 
-For the published 0.4.0 package, choose the installer used by your application:
+For the published 0.4.1 package, choose the installer used by your application:
 
 ```bash
 uv add iperf3-lib
@@ -121,14 +122,14 @@ unavailable. For directional analysis or missing-data decisions, use
 
 ## Next steps
 
-- [Migrate a 0.2.0 application to dataclasses](guides/migration-0.3.md).
-- [Run TCP, UDP, reverse, or bidirectional tests](guides/running-tests.md).
+- [Migrate a 0.2.0 application to dataclasses](guides/migration-0.3.md) or [upgrade from 0.3.0 to 0.4.0](guides/migration-0.4.md).
+- [Run TCP, UDP, reverse, or bidirectional tests](guides/running-tests.md) and [consume typed live events](guides/live-events.md).
 - [Choose configuration values and understand validation](reference/configuration.md).
 - [Find a native CLI option's Python equivalent](reference/native-options.md)
   and [use binding, transport, timeout and event controls](guides/native-controls.md).
 - [Declare aggregate rate intent and inspect capabilities](guides/configuration-intent.md).
 - [Read flows, observations, intervals, and native JSON](guides/results.md).
 - [Save portable artifacts](guides/artifacts.md) and [analyze measurements](guides/analysis.md).
-- [Repeat and assess trials](guides/trials.md) or [run finite parameter sweeps](guides/sweeps.md).
+- [Repeat and assess trials](guides/trials.md), [run bounded concurrent plans](guides/concurrent-plans.md), [run finite parameter sweeps](guides/sweeps.md), or [explore adaptive UDP rates](guides/adaptive-udp.md).
 - [Explore Prometheus snapshots and textfile output](guides/prometheus.md).
 

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/docs/guides/choosing-an-integration.md

@@ -37,14 +37,14 @@ launch the `iperf3` executable or parse its human-readable terminal output.
 Expanded controls use libiperf's public argument parser inside an isolated
 Python/CFFI worker, so that path also works without the CLI executable.
 
-Process isolation remains part of the implementation. On current `main`, basic
+Process isolation remains part of the implementation. Basic
 synchronous native calls run in the caller and must be serialized because
 libiperf has process-global state. Async operations, expanded controls, event delivery, and explicit execution
 timeouts use Python worker processes. The library manages their protocol,
 results, and cleanup; native traffic generation still happens in libiperf.
 
 !!! note "Additional ownership APIs in 0.4.0"
-    Changes after 0.3.0 make async cancellation await worker cleanup and any
+    Starting in 0.4.0, async cancellation awaits worker cleanup and any
     active callback, reporting unconfirmed cleanup as `IperfCleanupError`.
     [Owned live-event streams](live-events.md), [bounded concurrent plans](concurrent-plans.md),
     and [adaptive UDP experiments](adaptive-udp.md) are also available in 0.4.0.

{iperf3_lib-0.4.1 → iperf3_lib-0.4.2}/docs/guides/configuration-intent.md

@@ -156,10 +156,10 @@ flags still collapse lookup/load failures to false; use the report when those
 distinctions matter. Parser-backed worker controls are distinct from dedicated
 setter probes. SCTP and MPTCP still depend on the native build and kernel. Basic
 direct calls remain non-reentrant. Async methods always select the isolated
-worker on current `main`; an explicit execution timeout also selects it for a
-synchronous client. Async cancellation waits for worker cleanup and any active
-callback, and unconfirmed cleanup raises `IperfCleanupError`. This support is
-new after 0.3.0; see [async cancellation](running-tests.md#integrate-with-asyncio).
+worker; an explicit execution timeout also selects it for a synchronous client.
+Starting in 0.4.0, async cancellation waits for worker cleanup and any active
+callback, and unconfirmed cleanup raises `IperfCleanupError`; see
+[async cancellation](running-tests.md#integrate-with-asyncio).
 
 ## Profiles and native option decisions