This is an automated email from the ASF dual-hosted git repository.
ephraimanierobi pushed a commit to branch v3-1-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
commit 313d88208eacdff3b121bd08c6a9ce2d3630c812
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Thu Nov 20 10:18:59 2025 +0100
[v3-1-test] Update release python client docs (#58507) (#58512)
(cherry picked from commit 1cf1b8432172ee2ea588c91198d150b590b2678c)
Co-authored-by: Jarek Potiuk <[email protected]>
---
clients/python/version.txt | 2 +-
dev/README_RELEASE_PYTHON_CLIENT.md | 21 ++++++++++++++++-----
2 files changed, 17 insertions(+), 6 deletions(-)
diff --git a/clients/python/version.txt b/clients/python/version.txt
index fd2a01863fd..ff365e06b95 100644
--- a/clients/python/version.txt
+++ b/clients/python/version.txt
@@ -1 +1 @@
-3.1.0
+3.1.3
diff --git a/dev/README_RELEASE_PYTHON_CLIENT.md
b/dev/README_RELEASE_PYTHON_CLIENT.md
index 2cee93de6a6..0ab25b6039c 100644
--- a/dev/README_RELEASE_PYTHON_CLIENT.md
+++ b/dev/README_RELEASE_PYTHON_CLIENT.md
@@ -81,7 +81,7 @@ cd ..
```bash
cd ${AIRFLOW_REPO_ROOT}
-export VERSION="2.8.0"
+export VERSION="3.1.3"
export VERSION_SUFFIX="rc1"
echo "${VERSION}" > clients/python/version.txt
```
@@ -94,10 +94,17 @@ cd ${AIRFLOW_REPO_ROOT}
git log 2.8.0..HEAD --pretty=oneline --
airflow-core/src/airflow/api_fastapi/core_api/openapi/v2-rest-api-generated.yaml
```
-- Update CHANGELOG.md with the details.
+- Update CHANGELOG.md with the details. Commit the changes.
+
+```shell script
+cd ${AIRFLOW_REPO_ROOT}
+git add .
+git commit -m "Prepare release ${VERSION}${VERSION_SUFFIX}"
+
+```
- Create PR where you add the changelog in `main` branch and cherry-pick it to
the `v2-test` branch - same
- as in case of Airflow changelog.
+ as in case of Airflow changelog. This PR should also contain the change to
`clients/python/version.txt`.
- Merge it to the `v2-*-stable` branch with the command below. You will
release API client from the latest `v2-*-stable` branch
of Airflow repository - same branch that is used to release Airflow:
@@ -381,8 +388,10 @@ cd ..
[ -d asf-dist ] || svn checkout --depth=immediates
https://dist.apache.org/repos/dist asf-dist
svn update --set-depth=infinity asf-dist/dev/airflow/clients/python
+export PATH_TO_SVN="${PWD}/asf-dist/dev/airflow/clients/python/${VERSION_RC}"
+
# Then compare the packages
-cd asf-dist/dev/airflow/clients/python/${VERSION_RC}
+cd ${PATH_TO_SVN}
for i in ${AIRFLOW_REPO_ROOT}/dist/*
do
echo "Checking if $(basename $i) is the same as $i"
@@ -412,7 +421,7 @@ wget -qO-
https://dlcdn.apache.org//creadur/apache-rat-0.17/apache-rat-0.17-bin.
Unpack the release source archive (the `<package + version>-source.tar.gz`
file) to a folder
```shell script
-rm -rf /tmp/apache/airflow-python-client-src && mkdir -p
/tmp/apache-airflow-python-client-src && tar -xzf
${PATH_TO_SVN}/providers/${RELEASE_DATE}/apache_airflow_python_client-*-source.tar.gz
--strip-components 1 -C /tmp/apache-airflow-python-client-src
+rm -rf /tmp/apache/airflow-python-client-src && mkdir -p
/tmp/apache-airflow-python-client-src && tar -xzf
${PATH_TO_SVN}/apache_airflow_python_client-*-source.tar.gz --strip-components
1 -C /tmp/apache-airflow-python-client-src
```
Run the check:
@@ -486,6 +495,7 @@ gpg --keyserver keys.gnupg.net --receive-keys
CDE15C6E4D3A8EC4ECF4BA4B6674E08AD7
Once you have the keys, the signatures can be verified by running this:
```shell script
+cd ${PATH_TO_SVN}
for i in *.asc
do
echo -e "Checking $i\n"; gpg --verify $i
@@ -525,6 +535,7 @@ Primary key fingerprint: 1271 7556 040E EF2E EAF1 B9C2
75FC CD0A 25FA 0E4B
Run this:
```shell script
+cd ${PATH_TO_SVN}
for i in *.sha512
do
echo "Checking $i"; shasum -a 512 `basename $i .sha512 ` | diff - $i
