This is an automated email from the ASF dual-hosted git repository.
dianfu pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/flink.git
The following commit(s) were added to refs/heads/master by this push:
new dba9bc33d34 [FLINK-39031][python] Add support of Python 3.13
dba9bc33d34 is described below
commit dba9bc33d3459e9681d5c0971ddf178dcd22225b
Author: florian <[email protected]>
AuthorDate: Mon Aug 24 17:12:50 2026 +0200
[FLINK-39031][python] Add support of Python 3.13
This closes #29017.
---
.github/workflows/template.flink-ci.yml | 4 ++--
docs/content.zh/docs/getting-started/datastream.md | 2 +-
docs/content.zh/docs/getting-started/local_installation.md | 2 +-
docs/content.zh/docs/getting-started/table_api.md | 2 +-
docs/content/docs/getting-started/datastream.md | 2 +-
docs/content/docs/getting-started/local_installation.md | 2 +-
docs/content/docs/getting-started/table_api.md | 2 +-
flink-python/apache-flink-libraries/setup.py | 3 ++-
flink-python/dev/build-wheels.sh | 2 +-
flink-python/dev/install_command.sh | 6 +++---
flink-python/dev/lint-python.sh | 10 +++++-----
flink-python/docs/getting_started/installation.rst | 4 ++--
flink-python/docs/getting_started/quickstart.rst | 2 +-
.../locales/zh/LC_MESSAGES/getting_started/installation.po | 2 +-
.../docs/locales/zh/LC_MESSAGES/getting_started/quickstart.po | 2 +-
.../locales/zh/LC_MESSAGES/user_guide/datastream_tutorial.po | 2 +-
.../docs/locales/zh/LC_MESSAGES/user_guide/table/udfs.po | 6 +++---
.../locales/zh/LC_MESSAGES/user_guide/table_api_tutorial.po | 2 +-
flink-python/docs/user_guide/datastream_tutorial.rst | 2 +-
flink-python/docs/user_guide/table/udfs.rst | 2 +-
flink-python/docs/user_guide/table_api_tutorial.rst | 2 +-
flink-python/pyproject.toml | 4 ++--
flink-python/setup.py | 3 ++-
flink-python/tox.ini | 10 ++++++----
tools/azure-pipelines/build-python-wheels.yml | 4 ++--
tools/azure-pipelines/e2e-template.yml | 2 +-
tools/releasing/create_binary_release.sh | 4 ++--
27 files changed, 47 insertions(+), 43 deletions(-)
diff --git a/.github/workflows/template.flink-ci.yml
b/.github/workflows/template.flink-ci.yml
index 2e79d4776ad..55af1a44e53 100644
--- a/.github/workflows/template.flink-ci.yml
+++ b/.github/workflows/template.flink-ci.yml
@@ -242,7 +242,7 @@ jobs:
if: matrix.module == 'python'
uses: actions/setup-python@v6
with:
- python-version: '3.12'
+ python-version: '3.13'
- name: "Install Python header files"
if: matrix.module == 'python'
@@ -391,7 +391,7 @@ jobs:
- name: "Setup python"
uses: actions/setup-python@v6
with:
- python-version: '3.12'
+ python-version: '3.13'
- name: "Install missing packages"
run: sudo apt-get install -y net-tools zip &&
diff --git a/docs/content.zh/docs/getting-started/datastream.md
b/docs/content.zh/docs/getting-started/datastream.md
index 891cab3df29..143b231a6b2 100644
--- a/docs/content.zh/docs/getting-started/datastream.md
+++ b/docs/content.zh/docs/getting-started/datastream.md
@@ -68,7 +68,7 @@ Flink 的
[用户邮件列表](https://flink.apache.org/community.html#mailing-l
{{< /tab >}}
{{< tab "Python" >}}
* Java 11、17 或 21
-* Python 3.9、3.10、3.11 或 3.12
+* Python 3.9、3.10、3.11、3.12 或 3.13
{{< /tab >}}
{{< /tabs >}}
diff --git a/docs/content.zh/docs/getting-started/local_installation.md
b/docs/content.zh/docs/getting-started/local_installation.md
index 25eae9c8ed4..72d9ec24d1b 100644
--- a/docs/content.zh/docs/getting-started/local_installation.md
+++ b/docs/content.zh/docs/getting-started/local_installation.md
@@ -172,7 +172,7 @@ $ java -version
# Java 11、17 或 21
$ python --version
-# Python 3.9、3.10、3.11 或 3.12
+# Python 3.9、3.10、3.11、3.12 或 3.13
```
### 步骤 2：安装 PyFlink
diff --git a/docs/content.zh/docs/getting-started/table_api.md
b/docs/content.zh/docs/getting-started/table_api.md
index 5ee6d941dcf..9375d9cd984 100644
--- a/docs/content.zh/docs/getting-started/table_api.md
+++ b/docs/content.zh/docs/getting-started/table_api.md
@@ -71,7 +71,7 @@ Flink 的
[用户邮件列表](https://flink.apache.org/community.html#mailing-l
{{< /tab >}}
{{< tab "Python" >}}
* Java 11、17 或 21
-* Python 3.9、3.10、3.11 或 3.12
+* Python 3.9、3.10、3.11、3.12 或 3.13
{{< /tab >}}
{{< /tabs >}}
diff --git a/docs/content/docs/getting-started/datastream.md
b/docs/content/docs/getting-started/datastream.md
index fef5c76814a..30554d80650 100644
--- a/docs/content/docs/getting-started/datastream.md
+++ b/docs/content/docs/getting-started/datastream.md
@@ -68,7 +68,7 @@ If you want to follow along, you will require a computer with:
{{< /tab >}}
{{< tab "Python" >}}
* Java 11, 17, or 21
-* Python 3.9, 3.10, 3.11, or 3.12
+* Python 3.9, 3.10, 3.11, 3.12 or 3.13
{{< /tab >}}
{{< /tabs >}}
diff --git a/docs/content/docs/getting-started/local_installation.md
b/docs/content/docs/getting-started/local_installation.md
index 6b0f24b07b6..91d7e7a31df 100644
--- a/docs/content/docs/getting-started/local_installation.md
+++ b/docs/content/docs/getting-started/local_installation.md
@@ -172,7 +172,7 @@ $ java -version
# Java 11, 17, or 21
$ python --version
-# Python 3.9, 3.10, 3.11, or 3.12
+# Python 3.9, 3.10, 3.11, 3.12 or 3.13
```
### Step 2: Install PyFlink
diff --git a/docs/content/docs/getting-started/table_api.md
b/docs/content/docs/getting-started/table_api.md
index ff6348395d9..bd8f9f12297 100644
--- a/docs/content/docs/getting-started/table_api.md
+++ b/docs/content/docs/getting-started/table_api.md
@@ -71,7 +71,7 @@ If you want to follow along, you will require a computer with:
{{< /tab >}}
{{< tab "Python" >}}
* Java 11, 17, or 21
-* Python 3.9, 3.10, 3.11, or 3.12
+* Python 3.9, 3.10, 3.11, 3.12 or 3.13
{{< /tab >}}
{{< /tabs >}}
diff --git a/flink-python/apache-flink-libraries/setup.py
b/flink-python/apache-flink-libraries/setup.py
index 2119b032bfb..55a3cd69de5 100644
--- a/flink-python/apache-flink-libraries/setup.py
+++ b/flink-python/apache-flink-libraries/setup.py
@@ -235,7 +235,8 @@ run sdist.
'Programming Language :: Python :: 3.9',
'Programming Language :: Python :: 3.10',
'Programming Language :: Python :: 3.11',
- 'Programming Language :: Python :: 3.12'],
+ 'Programming Language :: Python :: 3.12',
+ 'Programming Language :: Python :: 3.13'],
)
finally:
if in_flink_source:
diff --git a/flink-python/dev/build-wheels.sh b/flink-python/dev/build-wheels.sh
index 90ce3a471d7..5250b69b372 100755
--- a/flink-python/dev/build-wheels.sh
+++ b/flink-python/dev/build-wheels.sh
@@ -19,7 +19,7 @@ set -e -x
dev/lint-python.sh -s py_env
PY_ENV_DIR=`pwd`/dev/.uv/envs
-py_env=("3.9" "3.10" "3.11" "3.12")
+py_env=("3.9" "3.10" "3.11" "3.12" "3.13")
## 2. install dependency
for ((i=0;i<${#py_env[@]};i++)) do
source `pwd`/dev/.uv/envs/${py_env[i]}/bin/activate
diff --git a/flink-python/dev/install_command.sh
b/flink-python/dev/install_command.sh
index b422b20a179..85fc08837c4 100755
--- a/flink-python/dev/install_command.sh
+++ b/flink-python/dev/install_command.sh
@@ -35,14 +35,14 @@ if [[ `uname -s` == "Darwin" && `uname -m` == "arm64" ]];
then
fi
retry_times=3
-install_command="python -m pip install $@"
-${install_command}
+install_command=(python -m pip install "$@")
+"${install_command[@]}"
status=$?
while [[ ${status} -ne 0 ]] && [[ ${retry_times} -gt 0 ]]; do
retry_times=$((retry_times-1))
# sleep 3 seconds and then reinstall.
sleep 3
- ${install_command}
+ "${install_command[@]}"
status=$?
done
diff --git a/flink-python/dev/lint-python.sh b/flink-python/dev/lint-python.sh
index 90fceed46ec..52ecf914cb9 100755
--- a/flink-python/dev/lint-python.sh
+++ b/flink-python/dev/lint-python.sh
@@ -203,8 +203,8 @@ function install_uv() {
if [ ! -d "$CURRENT_DIR/.uv/venv" ]; then
print_function "STEP" "setup uv virtualenv"
- # Create a Python 3.12 virtual environment as the base environment.
- $CURRENT_DIR/download/uv venv "$CURRENT_DIR/.uv" --seed --python 3.12
+ # Create a Python 3.13 virtual environment as the base environment.
+ $CURRENT_DIR/download/uv venv "$CURRENT_DIR/.uv" --seed --python 3.13
print_function "STEP" "setup uv virtualenv... [SUCCESS]"
# orjson depend on pip >= 20.3
print_function "STEP" "upgrade pip..."
@@ -217,7 +217,7 @@ function install_uv() {
# Create different Python virtual environments for different Python versions
function install_py_env() {
- py_env=("3.9" "3.10" "3.11" "3.12")
+ py_env=("3.9" "3.10" "3.11" "3.12" "3.13")
for ((i=0;i<${#py_env[@]};i++)) do
if [ -d "$CURRENT_DIR/.uv/envs/${py_env[i]}" ]; then
rm -rf "$CURRENT_DIR/.uv/envs/${py_env[i]}"
@@ -378,7 +378,7 @@ function install_environment() {
fi
# step-2 install python environment which includes
- # 3.9 3.10 3.11 3.12
+ # 3.9 3.10 3.11 3.12 3.13
if [ $STEP -lt 2 ] && [ `need_install_component "py_env"` = true ]; then
print_function "STEP" "installing python environment..."
install_py_env
@@ -559,7 +559,7 @@ function check_stage() {
#########################
# Tox check
function tox_check() {
- LATEST_PYTHON="py312"
+ LATEST_PYTHON="py313"
print_function "STAGE" "tox checks"
# Set created py-env in $PATH for tox's creating virtual env
activate
diff --git a/flink-python/docs/getting_started/installation.rst
b/flink-python/docs/getting_started/installation.rst
index 8f913714ac1..31269391fa0 100644
--- a/flink-python/docs/getting_started/installation.rst
+++ b/flink-python/docs/getting_started/installation.rst
@@ -23,13 +23,13 @@ Environment Requirements
------------------------
.. note::
- Python version (3.9, 3.10, 3.11 or 3.12) is required for PyFlink. Please
run the following command
+ Python version (3.9, 3.10, 3.11, 3.12 or 3.13) is required for PyFlink.
Please run the following command
to make sure that it meets the requirements:
.. code-block:: bash
$ python --version
- # the version printed here must be 3.9, 3.10, 3.11 or 3.12
+ # the version printed here must be 3.9, 3.10, 3.11, 3.12 or 3.13
Environment Setup
-----------------
diff --git a/flink-python/docs/getting_started/quickstart.rst
b/flink-python/docs/getting_started/quickstart.rst
index 4c521149f58..9e6a3fbd68a 100644
--- a/flink-python/docs/getting_started/quickstart.rst
+++ b/flink-python/docs/getting_started/quickstart.rst
@@ -30,7 +30,7 @@ Prerequisites
Before you begin, make sure you have:
-- Python 3.9, 3.10, 3.11, or 3.12 installed
+- Python 3.9, 3.10, 3.11, 3.12 or 3.13 installed
- PyFlink installed (see :doc:`installation`)
Your First PyFlink Application
diff --git
a/flink-python/docs/locales/zh/LC_MESSAGES/getting_started/installation.po
b/flink-python/docs/locales/zh/LC_MESSAGES/getting_started/installation.po
index f9b9ee4196e..ebc59f1ba37 100644
--- a/flink-python/docs/locales/zh/LC_MESSAGES/getting_started/installation.po
+++ b/flink-python/docs/locales/zh/LC_MESSAGES/getting_started/installation.po
@@ -46,7 +46,7 @@ msgstr ""
#: ../../getting_started/installation.rst:26
msgid ""
-"Python version (3.9, 3.10, 3.11 or 3.12) is required for PyFlink. Please "
+"Python version (3.9, 3.10, 3.11, 3.12 or 3.13) is required for PyFlink.
Please "
"run the following command to make sure that it meets the requirements:"
msgstr ""
diff --git
a/flink-python/docs/locales/zh/LC_MESSAGES/getting_started/quickstart.po
b/flink-python/docs/locales/zh/LC_MESSAGES/getting_started/quickstart.po
index d2646bed584..ce717d24fe6 100644
--- a/flink-python/docs/locales/zh/LC_MESSAGES/getting_started/quickstart.po
+++ b/flink-python/docs/locales/zh/LC_MESSAGES/getting_started/quickstart.po
@@ -67,7 +67,7 @@ msgid "Before you begin, make sure you have:"
msgstr ""
#: ../../getting_started/quickstart.rst:33
-msgid "Python 3.9, 3.10, 3.11, or 3.12 installed"
+msgid "Python 3.9, 3.10, 3.11, 3.12 or 3.13 installed"
msgstr ""
#: ../../getting_started/quickstart.rst:34
diff --git
a/flink-python/docs/locales/zh/LC_MESSAGES/user_guide/datastream_tutorial.po
b/flink-python/docs/locales/zh/LC_MESSAGES/user_guide/datastream_tutorial.po
index dcc974d1ddc..e30adab2850 100644
--- a/flink-python/docs/locales/zh/LC_MESSAGES/user_guide/datastream_tutorial.po
+++ b/flink-python/docs/locales/zh/LC_MESSAGES/user_guide/datastream_tutorial.po
@@ -98,7 +98,7 @@ msgid "Java 11"
msgstr ""
#: ../../user_guide/datastream_tutorial.rst:60
-msgid "Python 3.9, 3.10, 3.11 or 3.12"
+msgid "Python 3.9, 3.10, 3.11, 3.12 or 3.13"
msgstr ""
#: ../../user_guide/datastream_tutorial.rst:62
diff --git a/flink-python/docs/locales/zh/LC_MESSAGES/user_guide/table/udfs.po
b/flink-python/docs/locales/zh/LC_MESSAGES/user_guide/table/udfs.po
index 080ab66b159..900e75c5fc6 100644
--- a/flink-python/docs/locales/zh/LC_MESSAGES/user_guide/table/udfs.po
+++ b/flink-python/docs/locales/zh/LC_MESSAGES/user_guide/table/udfs.po
@@ -48,12 +48,12 @@ msgstr "用户自定义函数是重要的功能，因为它们极大地扩展了
#: ../../user_guide/table/udfs.rst:25
msgid ""
-"**NOTE:** Python UDF execution requires Python version (3.9, 3.10, 3.11 "
-"or 3.12) with PyFlink installed. It's required on both the client side "
+"**NOTE:** Python UDF execution requires Python version (3.9, 3.10, 3.11, "
+"3.12 or 3.13) with PyFlink installed. It's required on both the client side "
"and the cluster side."
msgstr ""
"**注意:** 要执行 Python 用户自定义函数，客户端和集群端都需要安装 Python 3.9 以上版本"
-"（3.9、3.10、3.11 或 3.12），并安装 PyFlink。"
+"（3.9、3.10、3.11、3.12 或 3.13），并安装 PyFlink。"
#: ../../user_guide/table/udfs.rst:28
msgid "Scalar Functions"
diff --git
a/flink-python/docs/locales/zh/LC_MESSAGES/user_guide/table_api_tutorial.po
b/flink-python/docs/locales/zh/LC_MESSAGES/user_guide/table_api_tutorial.po
index 3d073820346..542d5706949 100644
--- a/flink-python/docs/locales/zh/LC_MESSAGES/user_guide/table_api_tutorial.po
+++ b/flink-python/docs/locales/zh/LC_MESSAGES/user_guide/table_api_tutorial.po
@@ -99,7 +99,7 @@ msgid "Java 11"
msgstr ""
#: ../../user_guide/table_api_tutorial.rst:63
-msgid "Python 3.9, 3.10, 3.11 or 3.12"
+msgid "Python 3.9, 3.10, 3.11, 3.12 or 3.13"
msgstr ""
#: ../../user_guide/table_api_tutorial.rst:65
diff --git a/flink-python/docs/user_guide/datastream_tutorial.rst
b/flink-python/docs/user_guide/datastream_tutorial.rst
index d4e6a0e3a7e..9e548db39bb 100644
--- a/flink-python/docs/user_guide/datastream_tutorial.rst
+++ b/flink-python/docs/user_guide/datastream_tutorial.rst
@@ -57,7 +57,7 @@ How To Follow Along
If you want to follow along, you will require a computer with:
- Java 11
-- Python 3.9, 3.10, 3.11 or 3.12
+- Python 3.9, 3.10, 3.11, 3.12 or 3.13
Using Python DataStream API requires installing PyFlink, which is
available on `PyPI <https://pypi.org/project/apache-flink/>`__ and can
diff --git a/flink-python/docs/user_guide/table/udfs.rst
b/flink-python/docs/user_guide/table/udfs.rst
index df83193fd8b..57e1c0c4349 100644
--- a/flink-python/docs/user_guide/table/udfs.rst
+++ b/flink-python/docs/user_guide/table/udfs.rst
@@ -22,7 +22,7 @@ Python User-defined Functions
User-defined functions are important features, because they significantly
extend the expressiveness of Python Table API programs.
-**NOTE:** Python UDF execution requires Python version (3.9, 3.10, 3.11 or
3.12) with PyFlink installed. It's required on both the client side and the
cluster side.
+**NOTE:** Python UDF execution requires Python version (3.9, 3.10, 3.11, 3.12
or 3.13) with PyFlink installed. It's required on both the client side and the
cluster side.
Scalar Functions
=================
diff --git a/flink-python/docs/user_guide/table_api_tutorial.rst
b/flink-python/docs/user_guide/table_api_tutorial.rst
index 6bd2c01c00c..5b42a666d23 100644
--- a/flink-python/docs/user_guide/table_api_tutorial.rst
+++ b/flink-python/docs/user_guide/table_api_tutorial.rst
@@ -60,7 +60,7 @@ How To Follow Along
If you want to follow along, you will require a computer with:
- Java 11
-- Python 3.9, 3.10, 3.11 or 3.12
+- Python 3.9, 3.10, 3.11, 3.12 or 3.13
Using Python Table API requires installing PyFlink, which is available
on `PyPI <https://pypi.org/project/apache-flink/>`__ and can be easily
diff --git a/flink-python/pyproject.toml b/flink-python/pyproject.toml
index d18e47acf10..1360bcaa96f 100644
--- a/flink-python/pyproject.toml
+++ b/flink-python/pyproject.toml
@@ -55,7 +55,7 @@ dev = [
"typing-extensions>=4.7.0; python_version >= '3.12'",
]
tox = [
- "tox==3.14.0"
+ "tox==4.61.4"
]
flake8 = [
"flake8==7.2.0"
@@ -75,7 +75,7 @@ mypy = [
[tool.cibuildwheel]
-build = ["cp39-*", "cp310-*", "cp311-*", "cp312-*"]
+build = ["cp39-*", "cp310-*", "cp311-*", "cp312-*", "cp313-*"]
[tool.cibuildwheel.macos]
archs = ["x86_64", "arm64"]
diff --git a/flink-python/setup.py b/flink-python/setup.py
index d643180f438..d9cc997f679 100644
--- a/flink-python/setup.py
+++ b/flink-python/setup.py
@@ -360,7 +360,8 @@ try:
'Programming Language :: Python :: 3.9',
'Programming Language :: Python :: 3.10',
'Programming Language :: Python :: 3.11',
- 'Programming Language :: Python :: 3.12'],
+ 'Programming Language :: Python :: 3.12',
+ 'Programming Language :: Python :: 3.13'],
ext_modules=extensions
)
finally:
diff --git a/flink-python/tox.ini b/flink-python/tox.ini
index ed09d9f4373..f8b7ac01518 100644
--- a/flink-python/tox.ini
+++ b/flink-python/tox.ini
@@ -21,13 +21,15 @@
# in multiple virtualenvs. This configuration file will run the
# test suite on all supported python versions.
# new environments will be excluded by default unless explicitly added to
envlist.
-envlist = {py39, py310, py311, py312}-cython
+envlist = {py39, py310, py311, py312, py313}-cython
[testenv]
-whitelist_externals=
- /bin/bash
+allowlist_externals =
+ bash
+ {toxinidir}/dev/install_command.sh
+dependency_groups =
+ dev
deps =
- --group dev
apache-flink-libraries
passenv = *
commands =
diff --git a/tools/azure-pipelines/build-python-wheels.yml
b/tools/azure-pipelines/build-python-wheels.yml
index 9ea8465205f..f0291c79659 100644
--- a/tools/azure-pipelines/build-python-wheels.yml
+++ b/tools/azure-pipelines/build-python-wheels.yml
@@ -20,7 +20,7 @@ jobs:
steps:
- task: UsePythonVersion@0
inputs:
- versionSpec: '3.12'
+ versionSpec: '3.13'
- script: |
cd flink-python
bash dev/build-wheels.sh
@@ -36,7 +36,7 @@ jobs:
steps:
- task: UsePythonVersion@0
inputs:
- versionSpec: '3.12'
+ versionSpec: '3.13'
- script: |
cd flink-python
python -m pip install --upgrade pip
diff --git a/tools/azure-pipelines/e2e-template.yml
b/tools/azure-pipelines/e2e-template.yml
index 8b9bc1b7bf0..9db92fbfb42 100644
--- a/tools/azure-pipelines/e2e-template.yml
+++ b/tools/azure-pipelines/e2e-template.yml
@@ -62,7 +62,7 @@ jobs:
displayName: Free up disk space
- task: UsePythonVersion@0
inputs:
- versionSpec: '3.12'
+ versionSpec: '3.13'
# Install upstream kubectl so we don't use the agent's FIPS-patched build.
- bash: |
set -euo pipefail
diff --git a/tools/releasing/create_binary_release.sh
b/tools/releasing/create_binary_release.sh
index fff64092020..20b641910fa 100755
--- a/tools/releasing/create_binary_release.sh
+++ b/tools/releasing/create_binary_release.sh
@@ -132,8 +132,8 @@ make_python_release() {
cp ${pyflink_actual_name} "${PYTHON_RELEASE_DIR}/${pyflink_release_name}"
wheel_packages_num=0
- # py39,py310,py311,py312 for mac 10.9, 11.0 and linux (12 wheel packages)
- EXPECTED_WHEEL_PACKAGES_NUM=12
+ # py39,py310,py311,py312,py313 for mac 10.9, 11.0 and linux (15 wheel
packages)
+ EXPECTED_WHEEL_PACKAGES_NUM=15
# Need to move the downloaded wheel packages from Azure CI to the directory
flink-python/dist manually.
for wheel_file in *.whl; do
if [[ ! ${wheel_file} =~ ^apache_flink-$PYFLINK_VERSION- ]]; then
