refactor

Author: mkruszyx

.github/dockerfiles/ov_test/ubuntu_22_04_x64/Dockerfile

@@ -23,6 +23,8 @@ RUN apt-get update && \
         ca-certificates \
         gpg-agent \
         tzdata \
+        # coverage
+        lcov \
         # parallel gzip
         pigz \
         # Samples

.github/workflows/coverage.yml

@@ -65,6 +65,11 @@ on:
         type: boolean
         required: false
         default: true
+      upload-coverage-notes:
+        description: 'Whether to upload gcno notes captured from the build directory'
+        type: boolean
+        required: false
+        default: false
 
 permissions: read-all
 
@@ -109,6 +114,7 @@ jobs:
       ARTIFACTS_SHARE: "/mount/build-artifacts"
       MANIFEST_PATH: '${{ github.workspace }}/openvino/manifest.yml'
       PRODUCT_TYPE: public_linux_${{ inputs.os }}_${{ inputs.arch }}_release
+      COVERAGE_NOTES_DIR: ${{ env.BUILD_DIR }}/coverage_build_notes
     steps:
       - name: Append the environment variable - load SCCACHE_AZURE_CONNECTION_STRING from file
         shell: bash
@@ -269,6 +275,15 @@ jobs:
         run: tar -cvf - * | pigz > ${BUILD_DIR}/openvino_tests.tar.gz
         working-directory: ${{ env.INSTALL_TEST_DIR }}
 
+      - name: Capture coverage notes for main build
+        if: ${{ inputs.upload-coverage-notes }}
+        run: |
+          rm -rf "${COVERAGE_NOTES_DIR}"
+          mkdir -p "${COVERAGE_NOTES_DIR}/main-build"
+          rsync -a --prune-empty-dirs \
+            --include='*/' --include='*.gcno' --exclude='*' \
+            "${BUILD_DIR}/" "${COVERAGE_NOTES_DIR}/main-build/"
+
       - name: Build Debian packages
         if: ${{ inputs.build-debian-packages }}
         env:
@@ -324,6 +339,14 @@ jobs:
           tar -czvf ${BUILD_DIR}/openvino_node_npm_package.tar.gz bin openvino-node-*
         working-directory: ${{ env.OPENVINO_REPO }}/src/bindings/js/node
 
+      - name: Capture coverage notes for JS build
+        if: ${{ inputs.upload-coverage-notes && fromJSON(inputs.affected-components).JS_API && inputs.build-js }}
+        run: |
+          mkdir -p "${COVERAGE_NOTES_DIR}/js-build"
+          rsync -a --prune-empty-dirs \
+            --include='*/' --include='*.gcno' --exclude='*' \
+            "${BUILD_DIR}/" "${COVERAGE_NOTES_DIR}/js-build/"
+
       - name: Build RPM packages
         if: ${{ inputs.build-rpm-packages }}
         run: |
@@ -411,6 +434,14 @@ jobs:
           path: ${{ env.BUILD_DIR }}/openvino_tests.tar.gz
           if-no-files-found: 'error'
 
+      - name: Upload coverage build notes
+        if: ${{ inputs.upload-coverage-notes }}
+        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
+        with:
+          name: coverage_build_notes
+          path: ${{ env.COVERAGE_NOTES_DIR }}
+          if-no-files-found: 'error'
+
       - name: Prepare debian packages for storage on share
         if: ${{ always() }}
         continue-on-error: true

.github/workflows/job_build_linux.yml

@@ -1,98 +1,30 @@
-# Coverage Scripts
+# Coverage Helpers
 
-Coverage workflow orchestration is implemented in Python and is used by `.github/workflows/coverage.yml`.
-GitHub matrix helpers live in `tools/coverage/ci_matrix.py`.
-GitHub artifact aggregation helpers live in `tools/coverage/ci_reports.py`.
+Coverage CI is driven by `.github/workflows/coverage.yml`.
 
-## Entrypoint
-```bash
-python3 tools/coverage/coverage.py <command>
-```
-
-## Commands
-- `run-all`: run the full local flow (or a selected range).
-- `step <name>`: run a single step.
-- `list-tests --suite <cpp|python|js> --profile <...>`: show resolved tests for a profile.
-- `validate-config`: validate YAML suite configs.
-
-Step modules are in `tools/coverage/steps/`.
-
-## Profiles
-Supported profiles:
-- `cpu`
-- `gpu` (GPU-only; runs only tests explicitly marked for GPU execution)
-- `npu` (NPU-only; runs only tests explicitly marked for NPU execution)
-
-Profile-specific test selection and args are defined in:
-- `tools/coverage/config/tests_cpp.yml`
-- `tools/coverage/config/tests_python.yml`
-- `tools/coverage/config/tests_js.yml`
-
-## Local Prerequisites
-- Python 3.10+
-- C/C++ build toolchain and system deps (installed by `install-deps`)
-- Node.js + npm for JS coverage steps
-
-To install dependencies locally (including Node.js):
-```bash
-python3 tools/coverage/coverage.py step install-deps --install-nodejs --nodejs-version 22
-```
-
-`--install-nodejs` is optional. If omitted and Node.js is missing, JS coverage steps will fail.
+`tools/coverage` now contains only the helper code still used by that workflow:
+- suite definitions in `config/`
+- suite test runners in `steps/`
+- native C/C++ coverage collection in `steps/collect_cpp_coverage.py`
+- summary and duration aggregation in `ci_reports.py`
 
-## Typical Local Flows
-Run full flow with dependency installation:
+Main entrypoint:
 ```bash
-python3 tools/coverage/coverage.py run-all --profile cpu --install-deps --install-nodejs --nodejs-version 22
+python3 tools/coverage/coverage.py step <run-cpp-tests|run-python-tests|run-js-tests|collect-cpp-coverage>
 ```
 
-Run full flow without reinstalling deps:
-```bash
-python3 tools/coverage/coverage.py run-all --profile cpu
-```
-
-Run only test + coverage collection phase:
-```bash
-python3 tools/coverage/coverage.py run-all --profile cpu --from run-cpp-tests --to package-artifacts
-```
-
-Validate configs:
+Additional helper commands:
 ```bash
+python3 tools/coverage/coverage.py list-tests --suite <cpp|python|js> --profile <cpu|gpu|npu>
 python3 tools/coverage/coverage.py validate-config
 ```
 
-Inspect resolved tests:
-```bash
-python3 tools/coverage/coverage.py list-tests --suite python --profile gpu
-```
-
-## Outputs
-Main artifacts in workspace root:
-- `coverage.info` (native C/C++ lcov)
-- `coverage-artifact-metadata.json` (CI shard-artifact identity file used for summary aggregation)
-- `cpp-coverage-stats.env` (per-run C++ shard stats)
-- `cpp-test-durations.csv` (per-run C++ test durations in seconds)
-- `python-coverage-stats.env` (per-run Python shard stats)
-- `python-test-durations.csv` (per-run Python test durations in seconds)
-- `python-coverage.xml` (Python coverage XML)
-- `js-coverage-stats.env` (per-run JS shard stats)
-- `js-test-durations.csv` (per-run JS test durations in seconds)
-- `js-lcov.info` (Node.js lcov)
-- `coverage-report/index.html` (HTML report)
-- `.tmp/coverage-local/step_summary.md` (local summary when not in GitHub Actions)
-
-## Key Runtime Options
-- `--parallel-jobs <N>`
-- `--cpp-test-concurrency <N>`: run configured C++ coverage test binaries in parallel. Values above `1` isolate gcov output per run and merge it during `collect-cpp-coverage`.
-- `--pytest-workers <N>`
-- `--js-test-concurrency <N>`
-- `--profile <name>`
-- `--install-deps`
-- `--install-nodejs`
-- `--nodejs-version <major>`
-
-## Step-specific Environment
-- `CXX_TEST_NAMES=name1,name2,...`: limit `run-cpp-tests` to the named config entries. This is used by the GitHub Actions workflow to shard C++ coverage jobs.
-- `PY_TEST_NAMES=name1,name2,...`: limit `run-python-tests` to the named config entries. This is used by the GitHub Actions workflow to shard Python coverage jobs.
-- `JS_TEST_NAMES=name1,name2,...`: limit `run-js-tests` to the named config entries. This is used by the GitHub Actions workflow to shard JS coverage jobs.
-- `COVERAGE_WRITE_STEP_SUMMARY=false`: suppress per-step summary output so only the final workflow summary is published in GitHub Actions.
+Important environment variables used by the workflow:
+- `TEST_PROFILE`
+- `BUILD_DIR`
+- `INSTALL_PKG_DIR`
+- `BIN_DIR`
+- `CXX_TEST_NAMES`
+- `PY_TEST_NAMES`
+- `JS_TEST_NAMES`
+- `COVERAGE_WRITE_STEP_SUMMARY=false`