Drop support for Python 3.8; make use of license declarations for PEP

anthony-tuininga · anthony-tuininga · commit 911cbc38d711 · 2025-03-25T11:32:37.000-06:00
639.
diff --git a/README.md b/README.md
@@ -18,7 +18,7 @@ See [python-oracledb Installation][installation].
 
 ## Dependencies and Interoperability
 
-- Python versions 3.8 through 3.13.
+- Python versions 3.9 through 3.13.
 
   Pre-built packages are available on [PyPI][pypi] and other repositories.
 
diff --git a/doc/src/release_notes.rst b/doc/src/release_notes.rst
@@ -52,8 +52,9 @@ Thick Mode Changes
 Common Changes
 ++++++++++++++
 
-#) Improvements to data frame fetching with :meth:`Connection.fetch_df_all()`
-   and :meth:`Connection.fetch_df_batches()`:
+#)  Dropped support for Python 3.8.
+#)  Improvements to data frame fetching with :meth:`Connection.fetch_df_all()`
+    and :meth:`Connection.fetch_df_batches()`:
 
     - Added support for CLOB, BLOB and RAW data types
     - Fixed bug when NUMBER data is fetched that does not have a precision or
diff --git a/doc/src/user_guide/installation.rst b/doc/src/user_guide/installation.rst
@@ -36,7 +36,9 @@ Python-oracledb is typically installed from Python's package repository
 1. Install `Python 3 <https://www.python.org/downloads>`__ if it is not already
    available.
 
-   Use any version from Python 3.8 through 3.13.
+   Use any version from Python 3.9 through 3.13.
+
+   Previous versions of python-oracledb supported older Python versions.
 
 2. Install python-oracledb, for example:
 
@@ -154,7 +156,7 @@ Installation Requirements
 
 To use python-oracledb, you need:
 
-- Python 3.8, 3.9, 3.10, 3.11, 3.12 or 3.13
+- Python 3.9, 3.10, 3.11, 3.12 or 3.13
 
 - The Python cryptography package. This package is automatically installed as a
   dependency of python-oracledb.  It is strongly recommended that you keep the
@@ -705,8 +707,8 @@ Database 23ai.
 Installing python-oracledb on macOS
 ===================================
 
-Python-oracledb is available as a Universal binary for Python 3.8, or later, on
-Apple macOS Intel x86-64 and Apple macOS ARM64 (M1, M2, M3) architectures.
+Python-oracledb is available as a Universal binary for Python 3.9, or later, on
+Apple macOS Intel x86-64 and Apple macOS ARM64 (M1, M2, M3, M4) architectures.
 
 Install python-oracledb
 -----------------------
diff --git a/doc/src/user_guide/introduction.rst b/doc/src/user_guide/introduction.rst
@@ -18,9 +18,9 @@ The module is available from standard package repositories including `PyPI
 hosted at `github.com/oracle/python-oracledb
 <https://github.com/oracle/python-oracledb>`__.
 
-This module is currently tested with Python 3.8, 3.9, 3.10, 3.11, 3.12 and 3.13
-against Oracle Database 23ai, 21c, 19c, 18c, 12c, and 11gR2.  Older versions of
-python-oracledb may support older versions of Python.
+This module is currently tested with Python 3.9, 3.10, 3.11, 3.12, and 3.13
+against Oracle Database 23ai, 21c, 19c, 18c, 12c, and 11gR2. Previous versions
+of python-oracledb supported older Python versions.
 
 Changes in python-oracledb
 releases can be found in the :ref:`release notes <releasenotes>`.
diff --git a/doc/src/user_guide/troubleshooting.rst b/doc/src/user_guide/troubleshooting.rst
@@ -115,27 +115,28 @@ Some warnings may appear while using python-oracledb in Thick or Thin mode.
 
 .. _pythwarning:
 
-Deprecated Python Versions 3.6 and 3.7 Warning
-----------------------------------------------
+Deprecated Python Version Warning
+---------------------------------
 
 **Warning:** ``Python 3.6 is no longer supported by the Python core team.
 Therefore, support for it is deprecated in python-oracledb and will be removed
 in a future release.`` (A similar warning will also be displayed for Python
-version 3.7.)
+versions 3.7 and 3.8.)
 
-**Cause:** ``import oracledb`` gives this warning because you are using Python
-version 3.6 or 3.7.  These versions are no longer maintained by the Python core
-team.
+**Cause:** ``import oracledb`` gives this warning because you are using a
+version of Python that is longer maintained by the Python core team.
 
 **Action:**  You can either:
 
-- Upgrade your Python version to 3.8 or later.
+- Upgrade your Python version to 3.9 or later.
 
 - Or you can temporarily suppress the warning by importing the
   `warnings <https://docs.python.org/3/library/warnings.html>`__ module and
   adding a call like ``warnings.filterwarnings(action='ignore',
   module="oracledb")`` *before* importing ``oracledb``.
 
+- Install an older version of python-oracledb
+
 .. _runtimetroubleshooting:
 
 Error Messages
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,13 +1,13 @@
 [build-system]
-requires = ["setuptools >= 40.6.0", "wheel", "cython"]
+requires = ["setuptools >= 77.0.0", "wheel", "cython"]
 build-backend = "setuptools.build_meta"
 
 [tool.black]
 line-length = 79
-target-version = ["py37", "py38", "py39", "py310", "py311", "py312"]
+target-version = ["py39", "py310", "py311", "py312", "py313"]
 required-version = 24
 
 [tool.ruff]
 line-length = 79
-target-version = "py38"
+target-version = "py39"
 exclude = ["templates"]
diff --git a/setup.cfg b/setup.cfg
@@ -15,20 +15,17 @@ project_urls =
     Release Notes = https://python-oracledb.readthedocs.io/en/latest/release_notes.html
     Issues = https://github.com/oracle/python-oracledb/issues
     Source = https://github.com/oracle/python-oracledb
-license = Apache and/or UPL
+license = UPL-1.0 OR Apache-2.0
 license_files =
     LICENSE.txt
     THIRD_PARTY_LICENSES.txt
     NOTICE.txt
 classifiers =
     Development Status :: 5 - Production/Stable
     Intended Audience :: Developers
-    License :: OSI Approved :: Universal Permissive License (UPL)
-    License :: OSI Approved :: Apache Software License
     Natural Language :: English
     Operating System :: OS Independent
     Programming Language :: Python :: 3 :: Only
-    Programming Language :: Python :: 3.8
     Programming Language :: Python :: 3.9
     Programming Language :: Python :: 3.10
     Programming Language :: Python :: 3.11
@@ -40,7 +37,7 @@ classifiers =
 
 [options]
 zip_safe = false
-python_requires = >=3.8
+python_requires = >=3.9
 setup_requires = cython>=3.0.10
 install_requires = cryptography>=3.2.1
 test_suite = tests
diff --git a/src/oracledb/__init__.py b/src/oracledb/__init__.py
@@ -32,7 +32,7 @@
 import sys
 import warnings
 
-if sys.version_info[:2] < (3, 8):
+if sys.version_info[:2] < (3, 9):
     message = (
         f"Python {sys.version_info[0]}.{sys.version_info[1]} is no longer "
         "supported by the Python core team. Therefore, support for it is "
diff --git a/tox.ini b/tox.ini
@@ -1,5 +1,5 @@
 [tox]
-envlist = py{38,39,310,311,312,313}-{thin,thick}
+envlist = py{39,310,311,312,313}-{thin,thick}
 
 [testenv]
 commands = {envpython} -m unittest discover -v -s tests
@@ -18,10 +18,10 @@ passenv =
     DPI_DEBUG_LEVEL
     ORACLE_HOME
 
-[testenv:py{38,39,310,311,312,313}-thick]
+[testenv:py{39,310,311,312,313}-thick]
 setenv =
     PYO_TEST_DRIVER_MODE=thick
 
-[testenv:py{38,39,310,311,312,313}-thin]
+[testenv:py{39,310,311,312,313}-thin]
 setenv =
     PYO_TEST_DRIVER_MODE=thin
