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

{iperf3_lib-0.4.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → 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.0 → iperf3_lib-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: iperf3-lib
-Version: 0.4.0
+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/
@@ -80,13 +80,13 @@ Python **3.12–3.15** with the standard GIL is supported. Stable CI and release
 qualification cover all four Python versions against both native endpoints,
 including installed wheel and sdist checks.
 
-The **0.4.0 candidate is unreleased**; **0.3.0** is the latest published version.
-Documentation follows `main`. The installation guide explains how to choose
+The project has **Beta** maturity. Documentation follows `main`.
+The installation guide explains how to choose
 between a published package and a source revision; consult the
 [changelog](https://dariuszpanas.github.io/iperf3-lib/changelog.html) for release
 status. Upgrade guidance covers
 [0.2.0 to 0.3.0](https://dariuszpanas.github.io/iperf3-lib/guides/migration-0.3.html)
-and [unreleased changes after 0.3.0](https://dariuszpanas.github.io/iperf3-lib/guides/migration-0.4.html).
+and [0.3.0 to 0.4.0](https://dariuszpanas.github.io/iperf3-lib/guides/migration-0.4.html).
 
 ## Documentation
 
@@ -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.0 → iperf3_lib-0.4.2}/README.md

@@ -47,13 +47,13 @@ Python **3.12–3.15** with the standard GIL is supported. Stable CI and release
 qualification cover all four Python versions against both native endpoints,
 including installed wheel and sdist checks.
 
-The **0.4.0 candidate is unreleased**; **0.3.0** is the latest published version.
-Documentation follows `main`. The installation guide explains how to choose
+The project has **Beta** maturity. Documentation follows `main`.
+The installation guide explains how to choose
 between a published package and a source revision; consult the
 [changelog](https://dariuszpanas.github.io/iperf3-lib/changelog.html) for release
 status. Upgrade guidance covers
 [0.2.0 to 0.3.0](https://dariuszpanas.github.io/iperf3-lib/guides/migration-0.3.html)
-and [unreleased changes after 0.3.0](https://dariuszpanas.github.io/iperf3-lib/guides/migration-0.4.html).
+and [0.3.0 to 0.4.0](https://dariuszpanas.github.io/iperf3-lib/guides/migration-0.4.html).
 
 ## Documentation
 
@@ -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.0 → 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.0 → iperf3_lib-0.4.2}/development/design/advanced-execution.md

@@ -1,6 +1,6 @@
 # Advanced execution: design and release disposition
 
-Status: **implementation contracts for the unreleased 0.4.0 scope**. The original
+Status: **implementation contracts shipped in 0.4.0**. The original
 design review and native-event exploration were recorded on 2026-09-26.
 The [native-control guide](../../docs/guides/native-controls.md) and
 [live-event guide](../../docs/guides/live-events.md) document the public interfaces.
@@ -18,8 +18,8 @@ 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 [unreleased 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. |
+| [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) | 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
@@ -52,7 +52,7 @@ defines the current platform and native-version coverage.
 
 ### Admission and evidence
 
-The unreleased implementation is split between `adaptive.py` (pure decisions),
+The 0.4.0 implementation is split between `adaptive.py` (pure decisions),
 `adaptive_execution.py` (sequential batches) and `adaptive_reports.py` (standalone
 schema-1 archives). The [user guide](../../docs/guides/adaptive-udp.md) states its
 explicit limitations and public API. The following criteria remain the
@@ -126,7 +126,7 @@ and all admission limits with controlled observations. Then qualify bounded
 native mechanics on libiperf 3.19.1 and 3.22 and a controlled impaired link
 with recorded rate/loss settings. Clean loopback alone cannot validate the
 loss-threshold algorithm. Explicit finite sweeps remain the published 0.3.0
-mechanism; adaptive UDP remains unreleased until separately selected and qualified.
+mechanism; adaptive UDP shipped in 0.4.0 with its separate qualification.
 
 ## Typed live events
 
@@ -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.0 → iperf3_lib-0.4.2}/development/design/isolated-execution-qualification.md

@@ -8,7 +8,7 @@ Use the exact candidate commit, retained distributions and current Actions resul
 | --- | --- | --- |
 | Concurrent admission and contention | Invocation-local worker and aggregate target-rate caps, endpoint/user-resource exclusion and per-cell dependencies. Targets include streams, directions and warm-ups; wire traffic is measured separately. | Admission/race tests plus positive native traffic from overlapping workers, actual exclusions/rate-cap backfill and schema-v3 reservation histories. |
 | Comparison methodology | Descriptive analysis by default; comparisons require a declared matched cohort/contention method. Native-setting compatibility alone is insufficient. | The [comparison method](../../docs/guides/concurrent-plans.md#compare-experiments-with-a-declared-contention-policy), complete histories and strict v1/v2 type boundaries. Unknown contention remains inconclusive; no automatic concurrent performance assessment is claimed. |
-| Plan and consumer ownership | Cancellation owns every admitted child through cleanup. Callback failure suppresses delivery and propagates after shutdown. The unreleased typed iterator adds an owned context; see its [qualification map](live-event-qualification.md). | Queued/startup/completion races, repeated cancellation, multi-worker cleanup failure retaining original owners, and callback failure after positive native traffic. |
+| Plan and consumer ownership | Cancellation owns every admitted child through cleanup. Callback failure suppresses delivery and propagates after shutdown. The typed iterator added in 0.4.0 provides an owned context; see its [qualification map](live-event-qualification.md). | Queued/startup/completion races, repeated cancellation, multi-worker cleanup failure retaining original owners, and callback failure after positive native traffic. |
 | Shutdown and grace | Admission-only stops let peers finish; an optional overall deadline bounds that drain. Hard stops have zero natural-completion grace, then TERM/KILL cleanup with retained ownership on failure. | Deadline-after-admission-stop and first-cause tests; actual reaping/closed pipes. Cleanup-attempt budgets do not bound blocked callbacks or Python return time. |
 | Partial outcomes | Completed results remain artifacts. Interrupted and exceptional trials retain bounded diagnostic events, with unstarted trials explicit. No native summary or C finalizer is invented after a kill. | Existing v1/v2 fixtures, strict v2/v3 reports and saved native report/hash round-trips with positive partial intervals. Sequential SIGKILL and real output-pipe interruption after positive traffic must retain the completed prefix, failed active trial and unstarted suffix over TCP and UDP. |
 | IPC bounds | Versioned frames, identities/order, bounded queues/control capacity and terminal/EOF/exit validation. Native capture is outside wire/queue bounds. | Malformed, oversized, replayed/truncated and saturated channel tests, including interruption during incomplete output. |

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

@@ -6,7 +6,7 @@ decision.
 
 The published 0.3.0 scope included finite sequential trials, explicit sweeps,
 expanded native controls, callback events and isolated Python/CFFI workers.
-The planned 0.4.0 scope adds owned async and bounded concurrent plans, adaptive
+The published 0.4.0 scope adds owned async and bounded concurrent plans, adaptive
 UDP experiments, and typed live-event consumption. Their current qualification
 maps are linked from the [advanced execution design](design/advanced-execution.md).
 Historical release receipts do not qualify these additions. Release notes and
@@ -24,9 +24,9 @@ GIL configuration. The release verifier rejects prerelease versions.
 The eight-cell release gate requires **16 smoke and 16 lifecycle receipts,
 784 selected cases and 2352 passed phases**.
 
-Issue [#63](https://github.com/dariuszpanas/iperf3-lib/issues/63) tracks support
-and qualification evidence. Rerun the complete non-publishing release rehearsal
-on the final 0.4.0 candidate. Historical RC3 results or an earlier successful
+Issue [#63](https://github.com/dariuszpanas/iperf3-lib/issues/63) retains support
+and qualification evidence. Run the complete non-publishing release rehearsal
+on each final release candidate. Historical RC3 results or an earlier successful
 candidate cannot replace evidence for that exact source and its retained
 wheel/sdist pair. Python `>=3.12`, the shared wheel format and the two native
 endpoints remain unchanged. Free-threaded builds are outside this matrix.
@@ -81,7 +81,9 @@ A successful rehearsal contains:
   and unit gates, YAGA policy checks, and Docker-backed workflow lint.
 - One wheel/sdist pair checked with Twine and wheel-content validation.
   Both embedded descriptions must match the candidate README and render with
-  valid documentation links. Every absolute documentation URL in the README,
+  valid documentation links. The descriptions must be suitable for publication:
+  temporary claims such as "unreleased" or "latest published version" are
+  rejected. Every absolute documentation URL in the README,
   including its deployed HTML fragments, is checked alongside the public
   landing and changelog pages.
 - A `release-bundle` artifact with those distributions and
@@ -194,16 +196,26 @@ aggregate workflow result together before publication.
    deferred to a later version.
 2. Update `project.version` in `pyproject.toml` and the local project identity
    in `uv.lock`. Keep historical artifact producer identities unchanged. Record
-   selected changes under a versioned **unreleased candidate** heading in the
-   [changelog](../docs/changelog.md); a metadata version does not establish publication.
-   Update installation examples, migration instructions, and the banner
-   together. Keep the README's documentation links current; release history
-   and version-specific instructions belong in the linked pages.
-3. Run local quality/unit gates before the Docker/native matrix. Merge the
-   candidate through the normal required checks, then run a build-only hosted
-   rehearsal for the resulting exact commit. Inspect the retained distributions,
+   selected changes under a version heading in the
+   [changelog](../docs/changelog.md), without a publication date until upload
+   succeeds; a metadata version does not establish publication. Track candidate
+   status in the release issue. Prepare installation examples and migration
+   instructions together, and update the site's latest-release banner after
+   publication. Keep the packaged README release-neutral: no "unreleased",
+   "not yet published" or "latest published version" claims. Factual feature
+   availability, compatibility, Beta maturity and migration links are appropriate.
+   Release status and dates belong in the linked changelog and release pages.
+3. Run local quality/unit gates and build preview wheel/sdist archives. Inspect
+   their embedded, rendered README as the eventual PyPI description before
+   accepting the candidate for native qualification. Confirm that its wording
+   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 nonpublishing hosted
+   qualification for the resulting exact commit. Inspect the retained distributions,
    hashes, and every installed-native receipt.
-4. Inspect the rendered README and deployed documentation anonymously. Confirm
+4. Inspect the retained artifacts' rendered README and deployed documentation
+   anonymously. Confirm
    the Pages revision, actual page content, and public links. The automated
    HTTP checks alone do not establish that the intended revision is displayed.
 5. For measurement/exporter changes, also require the real
@@ -211,8 +223,11 @@ aggregate workflow result together before publication.
    or a string comparison of metrics is insufficient.
 6. After qualification, obtain the explicit publication decision. Only an
    actual publication establishes a release date and permits changing the
-   changelog's candidate status. Do not rebuild qualified distribution bytes
-   merely to remove a temporary publication-status sentence from their README.
+   changelog's publication date. If any packaged content, including its README,
+   needs correction after qualification, prepare a new candidate and repeat
+   exact-source qualification before publishing. Never publish a known stale
+   description to preserve an earlier qualification. Once published, retain the
+   immutable distribution bytes; a description correction needs a new release.
 7. Verify the registry's trusted-publisher configuration and intended publishing
    environment restrictions before selecting a publication target. The workflow
    does not create or administratively configure those settings for a rehearsal.
@@ -224,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.0
+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
@@ -258,6 +273,10 @@ assets and their hashes against the retained manifest. Install the published
 package in a clean environment, check version and lazy import, and run a
 native smoke with a supported library. Inspect the public PyPI description
 and its documentation links without maintainer authentication.
+Check that the description's wording is correct for the published release;
+matching the qualified source does not establish semantic correctness. Keep the
+release checklist open if this fails. A newer release can correct the default
+project page, but the old version's description remains immutable.
 
 If publication is interrupted, inspect which files reached the registry
 before retrying. Published files cannot be overwritten. If only GitHub Release