Merge branch 'master' into dependabot/pip/urllib3-neq-2.6.0-and-gte-2.7.0

Author: brendandburns

.github/workflows/deploy-wiki.yaml

@@ -11,7 +11,7 @@ jobs:
   deploy-wiki:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
       with:
         submodules: true
     - name: Install rsync

.github/workflows/e2e-master.yaml

@@ -15,7 +15,7 @@ jobs:
       matrix:
         python-version: ["3.10", "3.11", "3.12"]
     steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
       with:
         submodules: true
     - name: Create Kind Cluster
@@ -30,7 +30,7 @@ jobs:
         # as we sync with Kubernetes upstream
         config: .github/workflows/kind-configs/cluster-1.35.yaml
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405
+      uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies

.github/workflows/e2e-release-35.0.yaml

@@ -15,7 +15,7 @@ jobs:
       matrix:
         python-version: [3.10, 3.11, 3.12]
     steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
       with:
         submodules: true
     - name: Create Kind Cluster
@@ -30,7 +30,7 @@ jobs:
         # as we sync with Kubernetes upstream
         config: .github/workflows/kind-configs/cluster-1.35.yaml
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405
+      uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies

.github/workflows/test.yaml

@@ -13,11 +13,11 @@ jobs:
             use_coverage: 'coverage'
 
     steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
       with:
         submodules: true
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405
+      uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies
@@ -45,7 +45,7 @@ jobs:
 
     - name: Upload coverage to Codecov
       if: "matrix.use_coverage"
-      uses: codecov/codecov-action@e79a6962e0d4c0c17b229090214935d2e33f8354
+      uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f
       with:
         fail_ci_if_error: false
         verbose: true

.readthedocs.yaml

@@ -13,10 +13,19 @@ build:
     # nodejs: "20"
     # rust: "1.70"
     # golang: "1.20"
+  jobs:
+    # Empty build step to override and stop standard Sphinx/MkDocs execution
+    build:
+      html:
+        - mkdir -p $READTHEDOCS_OUTPUT/html
+        - cp -r doc/html/* $READTHEDOCS_OUTPUT/html/
+
+    # Copy your raw HTML directly to the hosted output folder
+    # post_build:
 
 # Build documentation in the "docs/" directory with Sphinx
-sphinx:
-  configuration: doc/source/conf.py
+# sphinx:
+  # configuration: doc/source/conf.py
   # You can configure Sphinx to use a different builder, for instance use the dirhtml builder for simpler URLs
   # builder: "dirhtml"
   # Fail on all warnings to avoid broken references
@@ -30,12 +39,13 @@ sphinx:
 # Optional but recommended, declare the Python requirements required
 # to build your documentation
 # See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
-python:
-  install:
-    - requirements: doc/requirements-docs.txt
-    - requirements: test-requirements.txt
-
-
+#python:
+#  install:
+#    - requirements: doc/requirements-docs.txt
+#    - requirements: test-requirements.txt
+#    - requirements: requirements.txt
+#
+#
 # git clone --depth 1 https://github.com/kubernetes-client/python .
 # git fetch origin --force --prune --prune-tags --depth 50 refs/heads/master:refs/remotes/origin/master
 # git checkout --force origin/master
@@ -50,4 +60,4 @@ python:
 # python -m sphinx -T -E -b latex -d _build/doctrees -D language=en . $READTHEDOCS_OUTPUT/pdf
 # cat latexmkrc
 # latexmk -r latexmkrc -pdf -f -dvi- -ps- -jobname=kubernetes -interaction=nonstopmode
-# python -m sphinx -T -E -b epub -d _build/doctrees -D language=en . $READTHEDOCS_OUTPUT/epub
+# python -m sphinx -T -E -b epub -d _build/doctrees -D language=en . $READTHEDOCS_OUTPUT/epub

CHANGELOG.md

@@ -1,3 +1,82 @@
+# Breaking Change from upgrading OpenAPI Generator to v7.24.0
+
+Both clients now use the modern Python generator instead of
+`python-legacy`. The asynchronous client uses the generator's `asyncio`
+library and `aiohttp` transport. Existing endpoint names, model names,
+and wire aliases are preserved, but applications may need the following
+updates:
+
+- Synchronous runtime dependencies now require `urllib3>=2.6.3,<3`,
+  `pydantic>=2.11`, `lazy-imports>=1,<2`,
+  `typing-extensions>=4.7.1`, and `python-dateutil>=2.8.2`.
+- Asynchronous runtime dependencies now require
+  `aiohttp>=3.13.5,<4.0.0`, `aiohttp-retry>=2.8.3`, `pydantic>=2.11`,
+  `lazy-imports>=1,<2`, `typing-extensions>=4.7.1`, and
+  `python-dateutil>=2.8.2`. `certifi` and `six` are no longer direct
+  asynchronous dependencies. Python 3.10 remains the minimum supported
+  version for both clients.
+- Models and API-call arguments now use Pydantic validation. Invalid,
+  unknown, or previously coerced values can raise
+  `pydantic.ValidationError` before a request is sent; models are
+  keyword-only, reject unknown fields during construction, and validate
+  assignments. The model `local_vars_configuration` argument and
+  Configuration's `discard_unknown_keys` and
+  `disabled_client_side_validations` arguments are removed.
+  `client_side_validation=False` no longer disables generated
+  validation.
+- Low-level synchronous transport interfaces changed. Direct callers of
+  `ApiClient.request`, `ApiClient.call_api`, `ApiClient.deserialize`, or
+  the `RESTClientObject` HTTP-verb helpers must migrate to the modern
+  request/response interface. `ApiException.body` is now decoded text
+  instead of bytes.
+- Low-level asynchronous transport interfaces also changed. Direct
+  callers of `ApiClient.call_api`, `ApiClient.param_serialize`,
+  `ApiClient.response_deserialize`, or `RESTClientObject.request` must
+  migrate to the modern `aiohttp` request/response interface. HTTP
+  sessions are created lazily; close an owned client with
+  `await client.close()` or an async context manager. Interactive
+  websocket streams use the generated `_without_preload_content`
+  operations.
+- `CoreV1Api.delete_namespace` now returns a decoded dictionary rather
+  than `V1Status`, since a successful deletion can return either a
+  terminating Namespace or a Status.
+
+See [kubernetes-client/python#2631][python-pr] and
+[kubernetes-client/gen#305][gen-pr].
+
+[python-pr]: https://github.com/kubernetes-client/python/pull/2631
+[gen-pr]: https://github.com/kubernetes-client/gen/pull/305
+
+# v36.0.3
+
+Kubernetes API Version: v1.36.2
+
+### Bug or Regression
+- Fix Watch.stream selecting watch instead of follow when streaming pod logs.
+- Start the leader election worker thread as a daemon so it does not block process shutdown.
+- Fix readline_channel, readline_stdout and readline_stderr crashing with OverflowError when using the default timeout, and returning None when a timeout expires.
+- Fix format_quantity returning imprecise, non-canonical values for the milli, micro and nano suffixes, and ignoring quantize=Decimal(0).
+
+# v36.0.2
+
+Kubernetes API Version: v1.36.1
+
+### Uncategorized
+- Restored backward compatibility for `Configuration.auth_settings()`:
+  the legacy `api_key['authorization']` lookup is honored as a fallback
+  when `api_key['BearerToken']` is not set, fixing 401 Unauthorized
+  regressions seen after upgrading to v36.0.0 (#2595). (#2604, @GK-07)
+
+# v36.0.1
+
+Kubernetes API Version: v1.36.1
+
+### Bug or Regression
+- Fix `load_incluster_config()` and `load_kube_config()` (sync and async, with a static token) so requests carry an `Authorization` header on `kubernetes-client/python` v36+. Without this fix, in-cluster pods upgrading to v36 silently send unauthenticated requests and the apiserver rejects them as `system:anonymous`. (#2585, @Jmacek)
+
+### Deprecation
+- Support new exec v5 websocket subprotocol (#2486, @aojea)
+
 # v36.0.0
 
 Kubernetes API Version: v1.36.1
@@ -250,6 +329,9 @@ Kubernetes API Version: v1.36.0
 
 - Configuration auth uses 'BearerToken' instead of 'authorization' in api_key.
 
+- V1ServiceSpec's external_i_ps has been renamed to external_ips, and
+  cluster_i_ps to cluster_ips.
+
 # v35.0.0
 
 Kubernetes API Version: v1.35.0

MANIFEST.in

@@ -3,6 +3,7 @@ include OWNERS
 include *.md
 include *.txt
 include *.ini
+include kubernetes/client/py.typed
 exclude .gitignore
 exclude .gitreview
 

README.md

@@ -134,7 +134,7 @@ supported versions of Kubernetes clusters.
 - [client 33.y.z](https://pypi.org/project/kubernetes/33.1.0/): Kubernetes 1.32 or below (+-), Kubernetes 1.33 (✓), Kubernetes 1.34 or above (+-)
 - [client 34.y.z](https://pypi.org/project/kubernetes/34.1.0/): Kubernetes 1.33 or below (+-), Kubernetes 1.34 (✓), Kubernetes 1.35 or above (+-)
 - [client 35.y.z](https://pypi.org/project/kubernetes/35.0.0/): Kubernetes 1.34 or below (+-), Kubernetes 1.35 (✓), Kubernetes 1.36 or above (+-)
-- [client 36.y.z](https://pypi.org/project/kubernetes/36.0.0/): Kubernetes 1.35 or below (+-), Kubernetes 1.36 (✓), Kubernetes 1.37 or above (+-)
+- [client 36.y.z](https://pypi.org/project/kubernetes/36.0.3/): Kubernetes 1.35 or below (+-), Kubernetes 1.36 (✓), Kubernetes 1.37 or above (+-)
 
 
 > See [here](#homogenizing-the-kubernetes-python-client-versions) for an explanation of why there is no v13-v16 release.

devel/release.md

@@ -104,62 +104,29 @@ command:
 scripts/update-client.sh
 ```
 
-**NOTE**: If you see a lot of new or modified files under the `kubernetes/test/`
-directory, delete everything except `kubernetes/test/test_api_client.py` and
-`kubernetes/test/test_configuration.py`.
-
 Commit changes (should be only version number changes) to the release branch.
 Name the commit something like "Update version constants for XXX release".
 
-***After you finished the steps above, refer to the section, "Hot issues", and
-apply the manual fixes.***
-
 ```bash
 git push upstream $RELEASE_BRANCH
 ```
 
-### 3. Hot issues
-
-Use the `scripts/apply-hotfixes.sh` script to apply the fixes below in one step.
-**As mentioned above, the script should be run after finishing the section "Update release tags". Also, ensure a clean working directory before applying the script.**
-
-Commit the manual changes like this [PR](https://github.com/kubernetes-client/python/pull/995/commits) does.
-
-There are some hot issues with the client generation that require manual fixes.
-**The steps below are deprecated and only exist for documentation purposess. They should be performed using the `scripts/apply-hotfixes.sh` script mentioned above.**
-
-1. Restore custom object patch behavior. You should apply [this commit](https://github.com/kubernetes-client/python/pull/995/commits/9959273625b999ae9a8f0679c4def2ee7d699ede)
-to ensure custom object patch behavior is backwards compatible. For more
-details, see [#866](https://github.com/kubernetes-client/python/issues/866) and
-[#959](https://github.com/kubernetes-client/python/pull/959).
-
-2. Add alias package kubernetes.client.apis with deprecation warning. You need
-to add [this file](https://github.com/kubernetes-client/python/blob/0976d59d6ff206f2f428cabc7a6b7b1144843b2a/kubernetes/client/apis/__init__.py)
-under `kubernetes/client/apis/` to ensure the package is backwards compatible.
-For more details, see [#974](https://github.com/kubernetes-client/python/issues/974)
-
-3. Add ability to the client to be used as Context Manager [kubernetes-client/python#1073](https://github.com/kubernetes-client/python/pull/1073)
-
-4. Remove the tests directory (ref: https://github.com/kubernetes-client/python/commit/ec9c944f076999543cd2122aff2d86f969d82548). See the [upstream issue](https://github.com/OpenAPITools/openapi-generator/issues/5377) for more information.
-
-5. Add tests for the default `Configuration` behavior (ref: https://github.com/kubernetes-client/python/pull/1303 and https://github.com/kubernetes-client/python/pull/1285). The commit [1ffa61d0650e4c93e0d7f0becd2c54797eafd407](https://github.com/kubernetes-client/python/pull/1285/commits/1ffa61d0650e4c93e0d7f0becd2c54797eafd407) should be cherry-picked.
-
-### 4. CHANGELOG
+### 3. CHANGELOG
 
 Make sure the change logs are up to date [here](https://github.com/kubernetes-client/python/blob/master/CHANGELOG.md).
 If they are not, follow commits added after the last release and update/commit
 the change logs to master.
 
 Then based on the release, follow one of next two steps.
 
-### 5. README
+### 4. README
 
 Update the compatibility matrix and maintenance status in the README file.
 
 ### Submit pull request
 
-Typically after the you've completed steps 2-6 above you can push your changes
-open a pull request against `kubernetes-client:release-x.y`
+After completing the steps above, push your changes and open a pull request
+against `kubernetes-client:release-x.y`.
 
 ## Patch a release branch
 

doc/Makefile

@@ -15,8 +15,13 @@ help:
 
 .PHONY: help Makefile
 
+# additional step to use sphinx-apidoc to generate rst files for APIs
+rst:
+	rm -f $(SOURCEDIR)/kubernetes.*.rst
+	$(SPHINXAPIDOC) -o "$(SOURCEDIR)" ../kubernetes/ -e -f
+
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
-html:
-	$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+html: rst
+	$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) -j 200 $(O)
 	@echo "\nDocs rendered successfully, open _/build/html/index.html to view"