This is an automated email from the ASF dual-hosted git repository.
jshao pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/gravitino.git
The following commit(s) were added to refs/heads/main by this push:
new 5d8946a777 [#10109] fix(docs): update Python version requirements in
build and usage documentation (#10179)
5d8946a777 is described below
commit 5d8946a777be9538c0d846d8bfa526b633a3839e
Author: Qi Yu <[email protected]>
AuthorDate: Thu Mar 5 15:49:54 2026 +0800
[#10109] fix(docs): update Python version requirements in build and usage
documentation (#10179)
### What changes were proposed in this pull request?
This pull request updates the documentation to reflect changes in the
supported Python versions for building and using the Gravitino Python
client and GVFS. The main changes involve raising the minimum required
Python version and clarifying the default and supported versions for
different components.
**Python version requirements and build instructions:**
* Updated the minimum required Python version for building the Gravitino
Python client to 3.10, removing support for Python 3.9 in
`docs/how-to-build.md`.
* Changed the default Python version for building the Python client to
3.12, and updated instructions to support Python 3.10, 3.11, and 3.13
instead of 3.9, 3.10, 3.11, and 3.12 in `docs/how-to-build.md`.
* Updated the minimum required Python version for using GVFS to 3.12,
replacing references to Python 3.9 in `docs/how-to-use-gvfs.md`.
### Why are the changes needed?
Python 3.9 is not supported any more.
Fix: #10109
### Does this PR introduce _any_ user-facing change?
N/A
### How was this patch tested?
It's docs.
---
docs/how-to-build.md | 10 ++--------
docs/how-to-use-gvfs.md | 4 ++--
2 files changed, 4 insertions(+), 10 deletions(-)
diff --git a/docs/how-to-build.md b/docs/how-to-build.md
index 4a30e489e4..eecc87ff41 100644
--- a/docs/how-to-build.md
+++ b/docs/how-to-build.md
@@ -13,7 +13,7 @@ license: "This software is licensed under the Apache License
version 2."
+ Linux or macOS operating system
+ Git
+ A Java Development Kit, version 17, installed in your environment to launch
Gradle
-+ Python 3.9, 3.10, 3.11, or 3.12 to build the Gravitino Python client
++ Python 3.10, 3.11, or 3.12 to build the Gravitino Python client.
+ Optionally, Docker to run integration tests
:::info Please read the following notes before trying to build Gravitino.
@@ -47,13 +47,7 @@ license: "This software is licensed under the Apache License
version 2."
The `./gradlew build` command builds all the Gravitino components, including
the Gravitino server, Java and Python clients, Trino and Spark connectors, and
more.
- For the Python client, the `./gradlew build` command builds the Python
client with Python 3.9 by default. If you want to use Python 3.10, 3.11, or
3.12 to build, please modify the property `pythonVersion` to 3.10, 3.11, or
3.12 in the `gradle.properties` file, or specify the version with `-P` like:
-
- ```shell
- ./gradlew build -PpythonVersion=3.9
- ```
-
- Or:
+ For the Python client, the `./gradlew build` command builds the Python
client with Python 3.12 by default. If you want to use Python 3.10 or 3.11 to
build, please modify the property `pythonVersion` to 3.10 or 3.11 in the
`gradle.properties` file, or specify the version with `-P` like:
```shell
./gradlew build -PpythonVersion=3.10
diff --git a/docs/how-to-use-gvfs.md b/docs/how-to-use-gvfs.md
index bc07174ad9..7f252a8f42 100644
--- a/docs/how-to-use-gvfs.md
+++ b/docs/how-to-use-gvfs.md
@@ -401,8 +401,8 @@ FileSystem fs = filesetPath.getFileSystem(conf);
+ A Hadoop environment with HDFS or other Hadoop Compatible File System (HCFS)
implementations like S3, GCS, etc. GVFS has been tested against Hadoop 3.3.1.
It is recommended to use Hadoop 3.3.1 or later, but it should work with Hadoop
2.x. Please create an [issue](https://www.github.com/apache/gravitino/issues)
if you find any compatibility issues.
-+ Python version >= 3.9. It has been tested GVFS works well with Python 3.9.
- Your Python version should be at least higher than Python 3.9.
++ Python version >= 3.12. It has been tested GVFS works well with Python 3.12.
+ Your Python version should be at least Python 3.12.
Attention: If you are using macOS or Windows operating system, you need to
follow the steps in the
[Hadoop official building
documentation](https://github.com/apache/hadoop/blob/trunk/BUILDING.txt)(Need
match your Hadoop version)
