Skip to content

fix(documentai-toolbox): Drop support for Python <= 3.9 #16967

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
chalmerlowe wants to merge 11 commits into
base: main
Choose a base branch
from
Open

fix(documentai-toolbox): Drop support for Python <= 3.9 #16967

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
b7b3446
feat(documentai-toolbox): update setup.py metadata and python_requires
chalmerlowe May 6, 2026
9b80743
feat(documentai-toolbox): update Nox sessions to remove old versions
chalmerlowe May 6, 2026
0d145be
docs(documentai-toolbox): update README and CONTRIBUTING documentation
chalmerlowe May 6, 2026
4543bc7
feat(documentai-toolbox): update version check in __init__.py
chalmerlowe May 6, 2026
2b0390f
test(documentai-toolbox): remove obsolete pragmas in pytest.ini
chalmerlowe May 6, 2026
72c6153
fix(documentai-toolbox): resolve dependency conflicts for Python 3.10
chalmerlowe May 6, 2026
cf585dd
fix(documentai-toolbox): pin setuptools to 79.0.0 to avoid deprecatio…
chalmerlowe May 6, 2026
2e8b593
chore(documentai-toolbox): update constraints file header
chalmerlowe May 7, 2026
e30487d
feat(documentai-toolbox): update lower bounds for Python 3.10 compati…
chalmerlowe May 7, 2026
fc0a6b3
feat(documentai-toolbox): settle on lowest workable bounds for storag…
chalmerlowe May 7, 2026
109b198
chore(documentai-toolbox): remove unnecessary setuptools references i…
chalmerlowe May 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 2 additions & 15 deletions packages/google-cloud-documentai-toolbox/CONTRIBUTING.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ In order to add a feature:
documentation.

- The feature must work fully on the following CPython versions:
3.9, 3.10, 3.11, 3.12, 3.13 and 3.14 on both UNIX and Windows.
3.10, 3.11, 3.12, 3.13 and 3.14 on both UNIX and Windows.

- The feature must not add unnecessary dependencies (where
"unnecessary" is of course subjective, but new dependencies should
Expand Down Expand Up @@ -148,8 +148,7 @@ Running System Tests

.. note::

System tests are only configured to run under Python 3.9 and 3.14.
For expediency, we do not run them in older versions of Python 3.
System tests are only configured to run under Python 3.10 and 3.14.
Copy link
Copy Markdown
Contributor

@parthea parthea May 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: I believe system tests only run with Python 3.12. For this specific package, there are no system tests. We can remove this line altogether

https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-documentai-toolbox/tests


This alone will not run the tests. You'll need to change some local
auth settings and change some configuration in your project to
Expand Down Expand Up @@ -197,14 +196,12 @@ Supported Python Versions

We support:

- `Python 3.9`_
- `Python 3.10`_
- `Python 3.11`_
- `Python 3.12`_
- `Python 3.13`_
- `Python 3.14`_

.. _Python 3.9: https://docs.python.org/3.9/
.. _Python 3.10: https://docs.python.org/3.10/
.. _Python 3.11: https://docs.python.org/3.11/
.. _Python 3.12: https://docs.python.org/3.12/
Expand All @@ -217,17 +214,7 @@ Supported versions can be found in our ``noxfile.py`` `config`_.
.. _config: https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-documentai-toolbox/noxfile.py


We also explicitly decided to support Python 3 beginning with version 3.9.
Reasons for this include:

- Encouraging use of newest versions of Python 3
- Taking the lead of `prominent`_ open-source `projects`_
- `Unicode literal support`_ which allows for a cleaner codebase that
works in both Python 2 and Python 3

.. _prominent: https://docs.djangoproject.com/en/1.9/faq/install/#what-python-version-can-i-use-with-django
.. _projects: http://flask.pocoo.org/docs/0.10/python3/
.. _Unicode literal support: https://www.python.org/dev/peps/pep-0414/

**********
Versioning
Expand Down
4 changes: 2 additions & 2 deletions packages/google-cloud-documentai-toolbox/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,14 +63,14 @@ Supported Python Versions
Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
Python.

Python >= 3.9
Python >= 3.10

.. _active: https://devguide.python.org/devcycle/#in-development-main-branch
.. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches

Unsupported Python Versions
^^^^^^^^^^^^^^^^^^^^^^^^^^^
Python <= 3.8
Python <= 3.9

If you are using an `end-of-life`_
version of Python, we recommend that you update as soon as possible to an actively supported version.
Expand Down
4 changes: 2 additions & 2 deletions packages/google-cloud-documentai-toolbox/docs/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,14 +63,14 @@ Supported Python Versions
Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
Python.

Python >= 3.9
Python >= 3.10

.. _active: https://devguide.python.org/devcycle/#in-development-main-branch
.. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches

Unsupported Python Versions
^^^^^^^^^^^^^^^^^^^^^^^^^^^
Python <= 3.8
Python <= 3.9

If you are using an `end-of-life`_
version of Python, we recommend that you update as soon as possible to an actively supported version.
Expand Down
18 changes: 6 additions & 12 deletions packages/google-cloud-documentai-toolbox/google/cloud/documentai_toolbox/__init__.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,17 +35,11 @@
)


class Python37DeprecationWarning(DeprecationWarning): # pragma: NO COVER
"""
Deprecation warning raised when Python 3.7 runtime is detected.
Python 3.7 support will be dropped after January 1, 2024.
"""


# Checks if the current runtime is Python 3.7.
if sys.version_info.major == 3 and sys.version_info.minor == 7: # pragma: NO COVER
# Checks if the current runtime is Python < 3.10.
if sys.version_info < (3, 10): # pragma: NO COVER
message = (
"After January 1, 2024, new releases of this library will drop support "
"for Python 3.7."
"The google-cloud-documentai-toolbox library no longer supports Python 3.7, 3.8, and 3.9. "
"We recommend that you update soon to ensure ongoing support. For "
"more details, see: [Google Cloud Client Libraries Supported Python Versions policy](https://cloud.google.com/python/docs/supported-python-versions)"
)
warnings.warn(message, Python37DeprecationWarning)
warnings.warn(message, FutureWarning)
4 changes: 1 addition & 3 deletions packages/google-cloud-documentai-toolbox/noxfile.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,6 @@
DEFAULT_PYTHON_VERSION = "3.14"

UNIT_TEST_PYTHON_VERSIONS: List[str] = [
"3.9",
"3.10",
"3.11",
"3.12",
Expand All @@ -57,7 +56,7 @@
UNIT_TEST_EXTRAS: List[str] = []
UNIT_TEST_EXTRAS_BY_PYTHON: Dict[str, List[str]] = {}

SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.9", "3.14"]
SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.10", "3.14"]
SYSTEM_TEST_STANDARD_DEPENDENCIES: List[str] = [
"mock",
"pytest",
Expand All @@ -72,7 +71,6 @@
CURRENT_DIRECTORY = pathlib.Path(__file__).parent.absolute()

nox.options.sessions = [
"unit-3.9",
"unit-3.10",
"unit-3.11",
"unit-3.12",
Expand Down
8 changes: 2 additions & 6 deletions packages/google-cloud-documentai-toolbox/pytest.ini
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,11 @@ filterwarnings =
ignore:.*custom tp_new.*in Python 3.14:DeprecationWarning
# Remove once https://github.com/dateutil/dateutil/issues/1314 is fixed
ignore:datetime.datetime.utcfromtimestamp\(\) is deprecated:DeprecationWarning:dateutil.tz.tz
# Remove once Python3.7 support is dropped https://github.com/googleapis/python-documentai-toolbox/issues/209
ignore:distutils Version classes are deprecated:DeprecationWarning
# Remove after support for Python 3.7 is dropped
ignore:After January 1, 2024, new releases of this library will drop support for Python 3.7:DeprecationWarning

# Remove once the minimum supported version of `google-api-core` is 2.15.0
ignore:.*pkg_resources.declare_namespace:DeprecationWarning
ignore:.*pkg_resources is deprecated as an API:DeprecationWarning
# Remove once the minimum supported Python runtime of this library is Python 3.9
ignore:The python-bigquery library will stop supporting Python 3.7 and Python 3.8:PendingDeprecationWarning

# This error is expected for python versions that approach EOL
ignore:.*Please upgrade to the latest Python version.*:FutureWarning
ignore:(?s).*using a Python version.*past its end of life.*:FutureWarning
7 changes: 3 additions & 4 deletions packages/google-cloud-documentai-toolbox/setup.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,21 +62,20 @@
"grpc-google-iam-v1>=0.12.6, <1.0.0",
"google-cloud-bigquery>=3.14.0, <4.0.0",
"google-cloud-documentai>=2.29.2, <4.0.0",
"google-cloud-storage>=1.31.0, <4.0.0",
"google-cloud-vision>=2.7.0, <4.0.0",
"google-cloud-storage>=2.3.0, <4.0.0",
"google-cloud-vision>=3.2.0, <4.0.0",
"numpy>=1.23.5, <3.0.0",
"intervaltree>=3.0.0",
"pikepdf>=8.0.0, <11.0.0",
"immutabledict>=2.0.0, <5.0.0",
"Pillow>=10.0.0, <12.0.0",
"Jinja2>=3.1.0, <4.0.0",
),
python_requires=">=3.9",
python_requires=">=3.10",
classifiers=[
"Development Status :: 3 - Alpha",
"Intended Audience :: Developers",
"Operating System :: OS Independent",
"Programming Language :: Python :: 3.9",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
Expand Down
34 changes: 22 additions & 12 deletions packages/google-cloud-documentai-toolbox/testing/constraints-3.10.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,22 @@
# -*- coding: utf-8 -*-
# This constraints file is required for unit tests.
# List all library dependencies and extras in this file.
google-api-core
pandas
proto-plus
grpc-google-iam-v1
google-cloud-bigquery
google-cloud-documentai
google-cloud-storage
numpy
pikepdf
# This constraints file is used to check that lower bounds
# are correct in setup.py
# List all library dependencies and extras in this file,
# pinning their versions to their lower bounds.
# For example, if setup.py has "google-cloud-foo >= 1.14.0, < 2.0.0",
# then this file should have google-cloud-foo==1.14.0
google-api-core==2.15.0
pandas==2.0.0
pyarrow==15.0.0
tabulate==0.9.0
proto-plus==1.22.3
grpc-google-iam-v1==0.12.6
google-cloud-bigquery==3.14.0
google-cloud-documentai==2.29.2
google-cloud-storage==2.3.0
google-cloud-vision==3.2.0
numpy==1.23.5
intervaltree==3.0.0
pikepdf==8.0.0
immutabledict==2.0.0
Pillow==10.0.0
Jinja2==3.1.0
17 changes: 0 additions & 17 deletions packages/google-cloud-documentai-toolbox/testing/constraints-3.9.txt
View file
Open in desktop

This file was deleted.

Loading