From 662777d3630a14fc4453b09ff6979028e4aee9ff Mon Sep 17 00:00:00 2001 From: Dirk Kulawiak Date: Fri, 13 Nov 2026 14:08:33 +0100 Subject: [PATCH 1/5] Drop pre-3.9 typing fallback and fix documented Python floor --- README.rst | 2 +- docs/index.rst | 2 +- weaviate/collections/classes/internal.py | 10 ++++------ 3 files changed, 6 insertions(+), 8 deletions(-) diff --git a/README.rst b/README.rst index 3f45a3d3b..546f6fe9e 100644 --- a/README.rst +++ b/README.rst @@ -19,7 +19,7 @@ Weaviate python client A python native client for easy interaction with a Weaviate instance. -The client is tested for python 3.9 and higher. +The client is tested for python 3.10 and higher. Visit the official `Weaviate `_ website for more information about the Weaviate and how to use it in production. diff --git a/docs/index.rst b/docs/index.rst index 2b004e62c..cc9cb6796 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -15,7 +15,7 @@ Welcome to Weaviate Python Client's documentation! |build-status| |pypi-version| -The Weaviate Python client makes it easy to work with `Weaviate `_, an AI Native vector database. The client is tested for Python 3.8 and higher. +The Weaviate Python client makes it easy to work with `Weaviate `_, an AI Native vector database. The client is tested for Python 3.10 and higher. The current major version is **v4** while the older **v3** client is deprecated and should be avoided. You can find further documentation for both versions: diff --git a/weaviate/collections/classes/internal.py b/weaviate/collections/classes/internal.py index b1c04077d..6fd63732b 100644 --- a/weaviate/collections/classes/internal.py +++ b/weaviate/collections/classes/internal.py @@ -1,8 +1,8 @@ import datetime -import sys import uuid as uuid_package from dataclasses import dataclass, field from typing import ( + Annotated, Any, Dict, Generic, @@ -14,15 +14,13 @@ Type, Union, cast, + get_args, + get_origin, + get_type_hints, ) from typing_extensions import TypeAlias, deprecated -if sys.version_info < (3, 9): - from typing_extensions import Annotated, get_args, get_origin, get_type_hints -else: - from typing import Annotated, get_args, get_origin, get_type_hints - from weaviate.collections.classes.generative import ( _GenerativeConfigRuntime, _GenerativeConfigRuntimeOptions, From bd287e74d4b68138416b7596c96660cc8eede1b9 Mon Sep 17 00:00:00 2001 From: Dirk Kulawiak Date: Fri, 13 Nov 2026 14:13:18 +0100 Subject: [PATCH 2/5] Drop support for Python 3.10 --- .github/workflows/main.yaml | 16 +++++++--------- README.rst | 2 +- docs/changelog.rst | 1 + docs/index.rst | 2 +- packages/web/pyproject.toml | 2 +- setup.cfg | 2 +- weaviate/collections/classes/grpc.py | 4 +--- 7 files changed, 13 insertions(+), 16 deletions(-) diff --git a/.github/workflows/main.yaml b/.github/workflows/main.yaml index 233e708d5..ed0b4b7f4 100644 --- a/.github/workflows/main.yaml +++ b/.github/workflows/main.yaml @@ -63,7 +63,7 @@ jobs: strategy: fail-fast: false matrix: - version: ["3.10", "3.11", "3.12", "3.13", "3.14"] + version: ["3.11", "3.12", "3.13", "3.14"] folder: ["weaviate", "integration", "integration_embedded"] steps: - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6 @@ -84,7 +84,7 @@ jobs: strategy: fail-fast: false matrix: - version: ["3.10", "3.11", "3.12", "3.13", "3.14"] + version: ["3.11", "3.12", "3.13", "3.14"] folder: ["test", "mock_tests"] steps: - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6 @@ -96,7 +96,7 @@ jobs: - name: Run unittests run: pytest --cov -v --cov-report=term-missing --cov=weaviate --cov-report xml:coverage-${{ matrix.folder }}.xml ${{ matrix.folder }} - name: Archive code coverage results - if: matrix.version == '3.10' && (github.ref_name != 'main') + if: matrix.version == '3.11' && (github.ref_name != 'main') uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7 with: name: coverage-report-${{ matrix.folder }} @@ -188,7 +188,7 @@ jobs: timeout-minutes: 30 strategy: matrix: - version: ["3.10", "3.11", "3.12", "3.13", "3.14"] + version: ["3.11", "3.12", "3.13", "3.14"] optional_dependencies: [false] steps: - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6 @@ -206,7 +206,7 @@ jobs: if: ${{ !github.event.pull_request.head.repo.fork }} run: pytest -v --cov --cov-report=term-missing --cov=weaviate --cov-report xml:coverage-integration-embedded.xml integration_embedded - name: Archive code coverage results - if: matrix.version == '3.10' && (github.ref_name != 'main') && !github.event.pull_request.head.repo.fork + if: matrix.version == '3.11' && (github.ref_name != 'main') && !github.event.pull_request.head.repo.fork uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7 with: name: coverage-report-integration-embedded @@ -220,8 +220,7 @@ jobs: fail-fast: false matrix: versions: [ - { py: "3.10", weaviate: $WEAVIATE_140, grpc: "1.59.5", protobuf: "4.25.9"}, - { py: "3.11", weaviate: $WEAVIATE_140, grpc: "1.66.0", protobuf: "5.29.6"}, + { py: "3.11", weaviate: $WEAVIATE_140, grpc: "1.59.5", protobuf: "4.25.9"}, { py: "3.12", weaviate: $WEAVIATE_140, grpc: "1.70.0", protobuf: "5.29.6"}, { py: "3.13", weaviate: $WEAVIATE_140, grpc: "1.72.1", protobuf: "6.33.6"}, { py: "3.14", weaviate: $WEAVIATE_140, grpc: "1.76.0", protobuf: "6.33.6"}, @@ -262,7 +261,7 @@ jobs: if: ${{ github.event.pull_request.head.repo.fork || github.triggering_actor == 'dependabot[bot]' }} run: pytest -n auto --dist loadgroup -v --cov --cov-report=term-missing --cov=weaviate --cov-report xml:coverage-integration.xml integration - name: Archive code coverage results - if: matrix.versions.py == '3.10' && (github.ref_name != 'main') + if: matrix.versions.py == '3.11' && (github.ref_name != 'main') uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7 with: name: coverage-report-integration @@ -278,7 +277,6 @@ jobs: fail-fast: false matrix: versions: [ - { py: "3.10", weaviate: $WEAVIATE_140}, { py: "3.11", weaviate: $WEAVIATE_140}, { py: "3.12", weaviate: $WEAVIATE_140}, { py: "3.13", weaviate: $WEAVIATE_140}, diff --git a/README.rst b/README.rst index 546f6fe9e..1f1fc366f 100644 --- a/README.rst +++ b/README.rst @@ -19,7 +19,7 @@ Weaviate python client A python native client for easy interaction with a Weaviate instance. -The client is tested for python 3.10 and higher. +The client is tested for python 3.11 and higher. Visit the official `Weaviate `_ website for more information about the Weaviate and how to use it in production. diff --git a/docs/changelog.rst b/docs/changelog.rst index 1e0c98c56..6ae8345a9 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -6,6 +6,7 @@ Version 4.25.0 This minor version includes: - Remove support for Weaviate versions < 1.32.0. Connecting to an older server now raises ``WeaviateStartUpError`` even with ``skip_init_checks=True``. Please update your Weaviate instances - Support ``protobuf`` 7 + - Remove support for Python 3.10, which reached its end of life in October 2026. The client now requires Python 3.11 or newer - Remove the legacy GraphQL aggregation path together with the ``weaviate.gql`` and ``weaviate.error_msgs`` modules, ``weaviate.util.is_weaviate_too_old`` and ``weaviate.util.MINIMUM_NO_WARNING_VERSION``, and the ``weaviate.AdditionalProperties`` and ``weaviate.LinkTo`` attributes (which already pointed at names that did not exist). Aggregations always use gRPC now. ``client.graphql_raw_query()`` is unchanged Version 4.24.1 diff --git a/docs/index.rst b/docs/index.rst index cc9cb6796..820a92c96 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -15,7 +15,7 @@ Welcome to Weaviate Python Client's documentation! |build-status| |pypi-version| -The Weaviate Python client makes it easy to work with `Weaviate `_, an AI Native vector database. The client is tested for Python 3.10 and higher. +The Weaviate Python client makes it easy to work with `Weaviate `_, an AI Native vector database. The client is tested for Python 3.11 and higher. The current major version is **v4** while the older **v3** client is deprecated and should be avoided. You can find further documentation for both versions: diff --git a/packages/web/pyproject.toml b/packages/web/pyproject.toml index 0f4872e18..e9520377e 100644 --- a/packages/web/pyproject.toml +++ b/packages/web/pyproject.toml @@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta" name = "weaviate-client-web" description = "grpc-web / WASM (Pyodide) transport for the Weaviate Python client" readme = "README.md" -requires-python = ">=3.10" +requires-python = ">=3.11" license = { text = "BSD-3-Clause" } authors = [{ name = "Weaviate", email = "hello@weaviate.io" }] keywords = ["weaviate", "grpc-web", "pyodide", "wasm", "emscripten"] diff --git a/setup.cfg b/setup.cfg index 26075543d..6b3daa241 100644 --- a/setup.cfg +++ b/setup.cfg @@ -43,7 +43,7 @@ install_requires = grpcio>=1.59.5,<2.0.0; sys_platform != "emscripten" protobuf>=4.21.6,<8.0.0 packaging>=21.0 -python_requires = >=3.10 +python_requires = >=3.11 [options.extras_require] agents = diff --git a/weaviate/collections/classes/grpc.py b/weaviate/collections/classes/grpc.py index 4b0f003c2..d3b701d2b 100644 --- a/weaviate/collections/classes/grpc.py +++ b/weaviate/collections/classes/grpc.py @@ -2,7 +2,6 @@ from datetime import datetime, timedelta, timezone from enum import Enum, auto from typing import ( - Any, Dict, Generic, List, @@ -644,8 +643,7 @@ def mmr(limit: Optional[int] = None, balance: Optional[float] = None) -> MMR: @dataclass class BM25OperatorOptions: - # replace with ClassVar[base_search_pb2.SearchOperatorOptions.Operator] once python 3.10 is removed - operator: ClassVar[Any] + operator: ClassVar[base_search_pb2.SearchOperatorOptions.Operator] @dataclass From 7f06dee99990b41b44aa2f9de89fa71c6ad28844 Mon Sep 17 00:00:00 2001 From: Dirk Kulawiak Date: Fri, 13 Nov 2026 14:14:47 +0100 Subject: [PATCH 3/5] Cleanup more old code --- weaviate/util.py | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/weaviate/util.py b/weaviate/util.py index b06978b8c..52b24b2ef 100644 --- a/weaviate/util.py +++ b/weaviate/util.py @@ -22,7 +22,7 @@ UnexpectedStatusCodeError, WeaviateInvalidInputError, ) -from weaviate.types import BLOB_INPUT, NUMBER, TIME, UUIDS +from weaviate.types import BLOB_INPUT, NUMBER, TIME, UUID, UUIDS from weaviate.warnings import _Warnings PYPI_PACKAGE_URL = "https://pypi.org/pypi/weaviate-client/json" @@ -670,9 +670,7 @@ def _type_request_response(json_response: Any) -> Optional[Dict[str, Any]]: def _to_beacons(uuids: UUIDS, to_class: str = "") -> List[Dict[str, str]]: - if isinstance(uuids, uuid_lib.UUID) or isinstance( - uuids, str - ): # replace with isinstance(uuids, UUID) in 3.10 + if isinstance(uuids, UUID): uuids = [uuids] if len(to_class) > 0: From ad74c7f5e9f66c80d8f5fac722048f1343946b8a Mon Sep 17 00:00:00 2001 From: Dirk Kulawiak Date: Fri, 13 Nov 2026 14:29:42 +0100 Subject: [PATCH 4/5] Support Python 3.15 --- .github/workflows/main.yaml | 12 +++++++----- docs/changelog.rst | 1 + {profiling => profiling_tests}/__init__.py | 0 {profiling => profiling_tests}/conftest.py | 6 +++--- {profiling => profiling_tests}/constants.py | 0 {profiling => profiling_tests}/pyspy.py | 0 .../test_import_and_query.py | 0 {profiling => profiling_tests}/test_profiling.py | 4 ++-- {profiling => profiling_tests}/test_refs.py | 0 {profiling => profiling_tests}/test_shutdown.py | 0 {profiling => profiling_tests}/test_sphere.py | 0 requirements-devel.txt | 15 ++++++++++----- 12 files changed, 23 insertions(+), 15 deletions(-) rename {profiling => profiling_tests}/__init__.py (100%) rename {profiling => profiling_tests}/conftest.py (97%) rename {profiling => profiling_tests}/constants.py (100%) rename {profiling => profiling_tests}/pyspy.py (100%) rename {profiling => profiling_tests}/test_import_and_query.py (100%) rename {profiling => profiling_tests}/test_profiling.py (98%) rename {profiling => profiling_tests}/test_refs.py (100%) rename {profiling => profiling_tests}/test_shutdown.py (100%) rename {profiling => profiling_tests}/test_sphere.py (100%) diff --git a/.github/workflows/main.yaml b/.github/workflows/main.yaml index ed0b4b7f4..2bdb7d933 100644 --- a/.github/workflows/main.yaml +++ b/.github/workflows/main.yaml @@ -63,7 +63,7 @@ jobs: strategy: fail-fast: false matrix: - version: ["3.11", "3.12", "3.13", "3.14"] + version: ["3.11", "3.12", "3.13", "3.14", "3.15"] folder: ["weaviate", "integration", "integration_embedded"] steps: - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6 @@ -84,7 +84,7 @@ jobs: strategy: fail-fast: false matrix: - version: ["3.11", "3.12", "3.13", "3.14"] + version: ["3.11", "3.12", "3.13", "3.14", "3.15"] folder: ["test", "mock_tests"] steps: - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6 @@ -188,7 +188,7 @@ jobs: timeout-minutes: 30 strategy: matrix: - version: ["3.11", "3.12", "3.13", "3.14"] + version: ["3.11", "3.12", "3.13", "3.14", "3.15"] optional_dependencies: [false] steps: - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6 @@ -225,7 +225,8 @@ jobs: { py: "3.13", weaviate: $WEAVIATE_140, grpc: "1.72.1", protobuf: "6.33.6"}, { py: "3.14", weaviate: $WEAVIATE_140, grpc: "1.76.0", protobuf: "6.33.6"}, { py: "3.14", weaviate: $WEAVIATE_140, grpc: "1.85.0", protobuf: "6.33.6"}, - { py: "3.14", weaviate: $WEAVIATE_140, grpc: "1.85.0", protobuf: "7.36.2"} + { py: "3.14", weaviate: $WEAVIATE_140, grpc: "1.85.0", protobuf: "7.36.2"}, + { py: "3.15", weaviate: $WEAVIATE_140, grpc: "1.85.0", protobuf: "7.36.2"} ] optional_dependencies: [false] steps: @@ -280,7 +281,8 @@ jobs: { py: "3.11", weaviate: $WEAVIATE_140}, { py: "3.12", weaviate: $WEAVIATE_140}, { py: "3.13", weaviate: $WEAVIATE_140}, - { py: "3.14", weaviate: $WEAVIATE_140} + { py: "3.14", weaviate: $WEAVIATE_140}, + { py: "3.15", weaviate: $WEAVIATE_140} ] optional_dependencies: [false] steps: diff --git a/docs/changelog.rst b/docs/changelog.rst index 6ae8345a9..ea8735ba2 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -7,6 +7,7 @@ This minor version includes: - Remove support for Weaviate versions < 1.32.0. Connecting to an older server now raises ``WeaviateStartUpError`` even with ``skip_init_checks=True``. Please update your Weaviate instances - Support ``protobuf`` 7 - Remove support for Python 3.10, which reached its end of life in October 2026. The client now requires Python 3.11 or newer + - Support Python 3.15 - Remove the legacy GraphQL aggregation path together with the ``weaviate.gql`` and ``weaviate.error_msgs`` modules, ``weaviate.util.is_weaviate_too_old`` and ``weaviate.util.MINIMUM_NO_WARNING_VERSION``, and the ``weaviate.AdditionalProperties`` and ``weaviate.LinkTo`` attributes (which already pointed at names that did not exist). Aggregations always use gRPC now. ``client.graphql_raw_query()`` is unchanged Version 4.24.1 diff --git a/profiling/__init__.py b/profiling_tests/__init__.py similarity index 100% rename from profiling/__init__.py rename to profiling_tests/__init__.py diff --git a/profiling/conftest.py b/profiling_tests/conftest.py similarity index 97% rename from profiling/conftest.py rename to profiling_tests/conftest.py index f99cf6bc1..5681355f8 100644 --- a/profiling/conftest.py +++ b/profiling_tests/conftest.py @@ -20,10 +20,10 @@ def get_file_path(file_name: str) -> str: - if not os.path.exists(file_name) and not os.path.exists("profiling/" + file_name): + if not os.path.exists(file_name) and not os.path.exists("profiling_tests/" + file_name): pytest.skip("data does not exist") - if os.path.exists("profiling/" + file_name): - file_name = "profiling/" + file_name + if os.path.exists("profiling_tests/" + file_name): + file_name = "profiling_tests/" + file_name return file_name diff --git a/profiling/constants.py b/profiling_tests/constants.py similarity index 100% rename from profiling/constants.py rename to profiling_tests/constants.py diff --git a/profiling/pyspy.py b/profiling_tests/pyspy.py similarity index 100% rename from profiling/pyspy.py rename to profiling_tests/pyspy.py diff --git a/profiling/test_import_and_query.py b/profiling_tests/test_import_and_query.py similarity index 100% rename from profiling/test_import_and_query.py rename to profiling_tests/test_import_and_query.py diff --git a/profiling/test_profiling.py b/profiling_tests/test_profiling.py similarity index 98% rename from profiling/test_profiling.py rename to profiling_tests/test_profiling.py index 4c4d7cb9e..526ec2e00 100644 --- a/profiling/test_profiling.py +++ b/profiling_tests/test_profiling.py @@ -1,6 +1,6 @@ # run: -# - profiling: pytest -m profiling profiling/test_profiling.py --profile-svg -# - benchmark: pytest profiling/test_profiling.py --benchmark-only --benchmark-disable-gc +# - profiling: pytest -m profiling profiling_tests/test_profiling.py --profile-svg +# - benchmark: pytest profiling_tests/test_profiling.py --benchmark-only --benchmark-disable-gc import concurrent.futures import math import uuid diff --git a/profiling/test_refs.py b/profiling_tests/test_refs.py similarity index 100% rename from profiling/test_refs.py rename to profiling_tests/test_refs.py diff --git a/profiling/test_shutdown.py b/profiling_tests/test_shutdown.py similarity index 100% rename from profiling/test_shutdown.py rename to profiling_tests/test_shutdown.py diff --git a/profiling/test_sphere.py b/profiling_tests/test_sphere.py similarity index 100% rename from profiling/test_sphere.py rename to profiling_tests/test_sphere.py diff --git a/requirements-devel.txt b/requirements-devel.txt index 48a3ae3e5..6e4e5c520 100644 --- a/requirements-devel.txt +++ b/requirements-devel.txt @@ -1,10 +1,15 @@ httpx==0.26.0 validators==0.34.0 authlib==1.9.1 -grpcio==1.75.1 -grpcio-tools==1.75.1 -grpcio-health-checking==1.75.1 -pydantic==2.12.0 +# Python 3.15 needs the first releases with cp315 wheels; older ones build from source. +grpcio==1.75.1; python_version < "3.15" +grpcio-tools==1.75.1; python_version < "3.15" +grpcio-health-checking==1.75.1; python_version < "3.15" +pydantic==2.12.0; python_version < "3.15" +grpcio==1.84.0; python_version >= "3.15" +grpcio-tools==1.84.0; python_version >= "3.15" +grpcio-health-checking==1.84.0; python_version >= "3.15" +pydantic==2.14.0; python_version >= "3.15" packaging==26.2 build @@ -20,7 +25,7 @@ importlib_metadata==8.7.0 tomli==2.4.0 types-protobuf==6.30.2.20250703 types-urllib3==1.26.25.14 -typing_extensions==4.15.0 +typing_extensions==4.16.0 pre-commit flake8 From 536e1de1027a3962c1d426e5099f25b32407b500 Mon Sep 17 00:00:00 2001 From: Dirk Kulawiak Date: Fri, 13 Nov 2026 14:38:01 +0100 Subject: [PATCH 5/5] Run the tests with the correct python version --- .github/workflows/main.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/main.yaml b/.github/workflows/main.yaml index 2bdb7d933..cfdb969e4 100644 --- a/.github/workflows/main.yaml +++ b/.github/workflows/main.yaml @@ -289,7 +289,7 @@ jobs: - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6 - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5 with: - python-version: "3.11" + python-version: ${{ matrix.versions.py }} cache: 'pip' # caching pip dependencies - name: Login to Docker Hub uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121 # v4