NO-JIRA: build: use uv to run python tools with pip fallback

[cblecker]

Summary

• When uv is detected on PATH, codespell, gitlint, and pyyaml are invoked via uv run --with <pkg>==<ver> instead of being installed into hack/tools/bin/ with pip install --target
• When uv is not available, the existing pip-based install targets are used unchanged (full fallback, no behaviour change for CI or contributors without uv)
• All conditional logic is confined to a single ifneq variable block; the verify-codespell, run-gitlint, and verify-docs-nav targets themselves have zero conditionals

Test plan

• With uv on PATH: make verify-codespell, make run-gitlint, make verify-docs-nav — confirm each uses uv run
• Without uv: UV= make verify-codespell (and the other two) — confirm pip fallback still works
• make -j verify-parallel — confirm parallel execution works with both paths
• Custom override: UV=/custom/uv make verify-codespell — confirm override is respected

Summary by CodeRabbit

• Chores
  • Updated build system to support the uv package manager with automatic fallback to traditional tooling when unavailable.
  • Enhanced verification commands for documentation navigation, spell-checking, and linting to use dynamic tool detection.

[openshift-merge-bot]

Pipeline controller notification
This repo is configured to use the pipeline controller. Second-stage tests will be triggered either automatically or after lgtm label is added, depending on the repository configuration. The pipeline controller will automatically detect which contexts are required and will utilize /test Prow commands to trigger the second stage.

For optional jobs, comment /test ? to see a list of all defined jobs. To trigger manually all jobs from second stage use /pipeline required command.

This repository is configured in: LGTM mode

[openshift-ci-robot]

@cblecker: This pull request explicitly references no jira issue.

Details

In response to this:

Summary

• When uv is detected on PATH, codespell, gitlint, and pyyaml are invoked via uv run --with <pkg>==<ver> instead of being installed into hack/tools/bin/ with pip install --target
• When uv is not available, the existing pip-based install targets are used unchanged (full fallback, no behaviour change for CI or contributors without uv)
• All conditional logic is confined to a single ifneq variable block; the verify-codespell, run-gitlint, and verify-docs-nav targets themselves have zero conditionals

Test plan

• With uv on PATH: make verify-codespell, make run-gitlint, make verify-docs-nav — confirm each uses uv run
• Without uv: UV= make verify-codespell (and the other two) — confirm pip fallback still works
• make -j verify-parallel — confirm parallel execution works with both paths
• Custom override: UV=/custom/uv make verify-codespell — confirm override is respected

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

[openshift-ci]

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Central YAML (inherited)

Review profile: CHILL

Plan: Enterprise

Run ID: 839a64f9-6009-4d84-847e-6bb27873f92a

📥 Commits

Reviewing files that changed from the base of the PR and between 674d92a and b7b4960.

📒 Files selected for processing (1)

• Makefile

---

📝 Walkthrough

Walkthrough

The Makefile has been updated to support conditional execution of Python-based tooling using uv (when available) or falling back to locally installed tools via pip. A new UV variable detects the presence of the uv package manager. Three command variables (CODESPELL_CMD, GITLINT_CMD, DOCS_NAV_CMD) are now defined to run with uv run --with or via locally installed executables. Corresponding dependency variables (CODESPELL_DEPS, GITLINT_DEPS, DOCS_NAV_DEPS) are set to empty when uv is available or reference existing tool artifacts otherwise. Three targets—verify-docs-nav, verify-codespell, and run-gitlint—have been updated to use these conditional command and dependency variables instead of hardcoded paths or direct executable references.

🚥 Pre-merge checks | ✅ 12

✅ Passed checks (12 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the main change: introducing conditional use of the 'uv' tool for running Python tools with pip as fallback.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Stable And Deterministic Test Names	✅ Passed	This PR only modifies the Makefile to use uv run for Python tools when available. No test files or Ginkgo tests were changed, making the "Stable and Deterministic Test Names" check inapplicable.
Test Structure And Quality	✅ Passed	This PR contains no Ginkgo test code. It only modifies the Makefile to add uv support for Python tools. The custom check for test structure and quality is not applicable.
Microshift Test Compatibility	✅ Passed	This PR only modifies the Makefile for Python tool execution (uv with pip fallback). No Ginkgo e2e tests are added, so the MicroShift test compatibility check does not apply.
Single Node Openshift (Sno) Test Compatibility	✅ Passed	No new Ginkgo e2e tests were added. This PR only modifies the Makefile to support using the uv package manager for Python tools. SNO compatibility check not applicable.
Topology-Aware Scheduling Compatibility	✅ Passed	PR only modifies build system (Makefile) to use uv for Python tools. No deployment manifests, operator code, or controllers are changed. Check is not applicable.
Ote Binary Stdout Contract	✅ Passed	Not applicable. PR only modifies Makefile for Python tool execution. Check is for Go binaries with JSON stdout.
Ipv6 And Disconnected Network Test Compatibility	✅ Passed	This PR modifies only the Makefile to configure uv-based Python tool execution. No Ginkgo e2e tests are added or modified, so the custom check is not applicable.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[openshift-ci]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: cblecker

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

• OWNERS [cblecker]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[cblecker]

/area ci-tooling

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 40.00%. Comparing base (674d92a) to head (b7b4960).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #8508   +/-   ##
=======================================
  Coverage   40.00%   40.00%           
=======================================
  Files         751      751           
  Lines       92838    92838           
=======================================
  Hits        37137    37137           
  Misses      53014    53014           
  Partials     2687     2687           

Flag	Coverage Δ
cmd-support	34.09% <ø> (ø)
cpo-hostedcontrolplane	40.56% <ø> (ø)
cpo-other	40.14% <ø> (ø)
hypershift-operator	50.53% <ø> (ø)
other	31.54% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[cblecker]

/pipeline required
/verified by e2e

[openshift-merge-bot]

Scheduling tests matching the pipeline_run_if_changed or not excluded by pipeline_skip_if_only_changed parameters:
/test e2e-aks
/test e2e-aws
/test e2e-aws-upgrade-hypershift-operator
/test e2e-azure-self-managed
/test e2e-kubevirt-aws-ovn-reduced
/test e2e-v2-aws
/test e2e-v2-gke

[openshift-ci-robot]

@cblecker: This PR has been marked as verified by e2e.

Details

In response to this:

/pipeline required
/verified by e2e

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

[cblecker]

/retest-required

[cwbotbot]

Test Results

e2e-aks

• Status: ✅ PASS
• Started: 2026-05-13T23:56:48Z
• View Job
• View Job History

e2e-aws

• Status: ✅ PASS
• Started: 2026-05-13T23:56:47Z
• View Job
• View Job History

[openshift-ci]

@cblecker: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.