Regenerate the synchronous client with the modern Python generator

[tamird]

What type of PR is this?

/kind feature

What this PR does / why we need it:

The synchronous client is still generated with OpenAPI Generator 6.6's
python-legacy backend. OpenAPI Generator removed that backend in v7,
so the current generation path cannot move to a supported generator or
inherit the modern Python generator's native type information.

This PR moves the synchronous client to the modern python backend:

• regenerate the client and Sphinx API index with Pydantic models and
  modern generated type information;
• declare the generated runtime requirements and package py.typed;
• adapt dynamic, stream, watch, OIDC, YAML, and example helpers to the
  modern generated API; and
• remove obsolete post-generation hotfixes while retaining the small
  body-aware PATCH media-type correction.

Which issue(s) this PR fixes:

No single tracked issue. The regeneration fixes existing urllib
compatibility, typing, and bytes-handling gaps in the synchronous
client.

Special notes for your reviewer:

The paired generator migration is
kubernetes-client/gen#305. It selects the
released OpenAPI Generator v7.24.0, which contains the required legacy
compatibility and API-key-prefix fixes. The generated provenance records
the release tag and resolved commit 203d4867.

This changes synchronous generation only. The async client remains on
its existing generator path and should be regenerated separately; until
then, six remains an async requirement.

Legacy async_req=True still returns an ApplyResult consumed with
.get(), and _preload_content=False returns the raw response.
Ordinary return annotations intentionally describe the default call:
Watch reflects them to select event models. The generator rationale is
OpenAPITools/openapi-generator#24300.

The initial release render was produced by the normal
scripts/update-client.sh Docker path in
https://github.com/tamird/kubernetes-python/actions/runs/29785873376.
Until the paired generator PR merges, reproduce it with that generator
branch checked out locally:

GEN_ROOT=/path/to/kubernetes-client-gen scripts/update-client.sh

The previously published generated head passes the fork's Python
3.10-3.14 lint and test matrix:
https://github.com/tamird/kubernetes-python/actions/runs/29790431747.

Does this PR introduce a user-facing change?

The synchronous Python client is regenerated with the modern OpenAPI
Generator Python backend.

Additional documentation:

[penguinolog]

Which issue(s) this PR fixes:

technically ton of (urllib compatibility, typing, several broken places with bytes processing)

[penguinolog]

six is needed only for async after merge. Regenerate too as next PR?

[tamird]

Yes. This draft intentionally migrates only synchronous generation; async should be regenerated separately. setup.py reads requirements.txt, while the release package adds requirements-asyncio.txt, so I removed six from the synchronous requirements and left its async declaration in place.

[tamird]

Right; this is not tied to one tracked issue. I updated that section to name the urllib compatibility, typing, and bytes-handling gaps instead of saying None.

[penguinolog]

it's not released, IMHO released version should be used instead

[tamird]

Yes, that's why this is a draft. It requires some changed that are not yet released.

[tamird]

Agreed. The three prerequisite generator fixes have merged, but they are not released yet. I updated the draft description to make that boundary explicit: this stays inspection-only until client-gen can pin the first released version containing them and regenerate canonically.

[tamird]

Done. OpenAPI Generator v7.24.0 is released and contains the required compatibility fixes. I regenerated this branch from the release via kubernetes-client/gen#305; the checked-in VERSION is now 7.24.0 and the resolved generator commit is 203d4867. The canonical Docker render is https://github.com/tamird/kubernetes-python/actions/runs/29785873376.

[roycaihw]

/assign @yliaog

[kubernetes-prow]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: tamird
Once this PR has been reviewed and has the lgtm label, please ask for approval from yliaog. For more information see the Code Review Process.

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

Details

Needs approval from an approver in each of these files:

• OWNERS

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

[yliaog]

@tamird thanks for the PR, do you know whether the import latency issue reported in tomplus/kubernetes_asyncio#293 is resolved with the new openapi generator?

[yliaog]

could you also please take a look at the failure tests? https://github.com/kubernetes-client/python/actions/runs/29850863235/job/88758260386?pr=2631