Migrated build configuration completely to pyproject.toml and added test

dependencies; upgraded Black to version 25.1.

Author: anthony-tuininga

.pre-commit-config.yaml

@@ -7,7 +7,7 @@ repos:
     -   id: check-yaml
     -   id: check-added-large-files
 -   repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.4.2
+    rev: 25.1.0
     hooks:
     -   id: black
 -   repo: https://github.com/astral-sh/ruff-pre-commit

doc/src/release_notes.rst

@@ -68,6 +68,9 @@ Common Changes
 
     Note the data frame support in python-oracledb 3.3 is a pre-release, and
     may change in a future version.
+#)  Internal change: migrated build configuration completely to pyproject.toml,
+    which allows for optional dependencies for the test suite on the numpy,
+    pandas and pyarrow modules.
 
 
 oracledb `3.2.0 <https://github.com/oracle/python-oracledb/compare/v3.1.1...v3.2.0>`__ (June 2025)

pyproject.toml

@@ -1,13 +1,82 @@
 [build-system]
-requires = ["setuptools >= 77.0.0", "wheel", "cython"]
+requires = [
+    "setuptools >= 77.0.0",
+    "wheel",
+    "cython == 3.1",
+]
 build-backend = "setuptools.build_meta"
 
+[project]
+name = "oracledb"
+description = "Python interface to Oracle Database"
+keywords = ["Oracle", "database"]
+authors = [{name = "Anthony Tuininga", email = "anthony.tuininga@oracle.com"}]
+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",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Cython",
+    "Topic :: Database",
+]
+requires-python = ">=3.9"
+dependencies = ["cryptography>=3.2.1"]
+dynamic = ["version"]
+
+[project.readme]
+file = "README.md"
+content-type = "text/markdown"
+
+[project.urls]
+Homepage = "https://oracle.github.io/python-oracledb"
+Installation = "https://python-oracledb.readthedocs.io/en/latest/user_guide/installation.html"
+Samples = "https://github.com/oracle/python-oracledb/tree/main/samples"
+Documentation = "http://python-oracledb.readthedocs.io"
+"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"
+
+[tool.setuptools]
+zip-safe = false
+packages = [
+    "oracledb",
+    "oracledb.plugins",
+]
+package-dir = {"" = "src"}
+include-package-data = false
+
+[tool.setuptools.package-data]
+"*" = ["py.typed"]
+
+[tool.setuptools.dynamic]
+version = {attr = "oracledb.version.__version__"}
+
 [tool.black]
 line-length = 79
-target-version = ["py39", "py310", "py311", "py312", "py313", "py314"]
-required-version = 24
+required-version = 25
 
 [tool.ruff]
 line-length = 79
 target-version = "py39"
 exclude = ["templates"]
+
+[project.optional-dependencies]
+test = [
+    "numpy",
+    "pandas",
+    "pyarrow",
+]

setup.cfg

@@ -1310,7 +1310,7 @@ def unsubscribe(self, subscr: Subscription) -> None:
 
 
 def _connection_factory(
-    f: Callable[..., Connection]
+    f: Callable[..., Connection],
 ) -> Callable[..., Connection]:
     """
     Decorator which checks the validity of the supplied keyword parameters by
@@ -2238,7 +2238,7 @@ async def tpc_rollback(self, xid: Optional[Xid] = None) -> None:
 
 
 def _async_connection_factory(
-    f: Callable[..., AsyncConnection]
+    f: Callable[..., AsyncConnection],
 ) -> Callable[..., AsyncConnection]:
     """
     Decorator which checks the validity of the supplied keyword parameters by

src/oracledb/connection.py

@@ -572,7 +572,7 @@ def reconfigure(
 
 
 def _pool_factory(
-    f: Callable[..., ConnectionPool]
+    f: Callable[..., ConnectionPool],
 ) -> Callable[..., ConnectionPool]:
     """
     Decorator which checks the validity of the supplied keyword parameters by
@@ -1107,7 +1107,7 @@ async def release(
 
 
 def _async_pool_factory(
-    f: Callable[..., AsyncConnectionPool]
+    f: Callable[..., AsyncConnectionPool],
 ) -> Callable[..., AsyncConnectionPool]:
     """
     Decorator which checks the validity of the supplied keyword parameters by

src/oracledb/pool.py

@@ -31,16 +31,9 @@
 import decimal
 
 import oracledb
-
-try:
-    import numpy
-    import pandas
-    import pyarrow
-
-    HAS_INTEROP = True
-except ImportError:
-    HAS_INTEROP = False
-
+import numpy
+import pandas
+import pyarrow
 import test_env
 
 # basic
@@ -253,13 +246,6 @@
 
 class TestCase(test_env.BaseTestCase):
 
-    def __check_interop(self):
-        """
-        Checks to see if the pyarrow and pandas modules are available.
-        """
-        if not HAS_INTEROP:
-            self.skipTest("missing numpy, pandas or pyarrow modules")
-
     def __convert_date(self, value):
         """
         Converts a date to the format required by Arrow.
@@ -379,7 +365,6 @@ def __test_df_interop(self, data):
         Tests interoperability with external data frames using the data set
         provided.
         """
-        self.__check_interop()
         self.__populate_table(data)
         ora_df = self.conn.fetch_df_all(QUERY_SQL)
         self.__validate_df(ora_df, data)
@@ -389,7 +374,6 @@ def __test_df_batches_interop(self, data, batch_size, num_batches):
         Tests interoperability with external data frames using the data set
         provided.
         """
-        self.__check_interop()
         self.__populate_table(data)
         batches = list(self.conn.fetch_df_batches(QUERY_SQL, size=batch_size))
         self.assertEqual(len(batches), num_batches)
@@ -462,7 +446,6 @@ def test_8009(self):
 
     def test_8010(self):
         "8010 - verify passing Arrow arrays twice works"
-        self.__check_interop()
         self.__populate_table(DATASET_1)
         ora_df = self.conn.fetch_df_all(QUERY_SQL)
         self.__validate_df(ora_df, DATASET_1)
@@ -507,7 +490,6 @@ def test_8015(self):
 
     def test_8016(self):
         "8016 - verify get_column() returns the correct value"
-        self.__check_interop()
         self.__populate_table(DATASET_1)
         ora_df = self.conn.fetch_df_all(QUERY_SQL)
         array = pyarrow.array(ora_df.get_column(1))
@@ -520,7 +502,6 @@ def test_8017(self):
     def test_8018(self):
         "8018 - fetch_decimals without precision and scale specified"
         data = [(1.0,)]
-        self.__check_interop()
         with test_env.DefaultsContextManager("fetch_decimals", True):
             ora_df = self.conn.fetch_df_all("select 1.0 from dual")
             fetched_tab = pyarrow.Table.from_arrays(
@@ -533,7 +514,6 @@ def test_8018(self):
     def test_8019(self):
         "8019 - fetch clob"
         data = [("test_8023",)]
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             "select to_clob('test_8023') from dual"
         )
@@ -544,7 +524,6 @@ def test_8019(self):
     def test_8020(self):
         "8020 - fetch blob"
         data = [(b"test_8024",)]
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             "select to_blob(utl_raw.cast_to_raw('test_8024')) from dual"
         )
@@ -555,7 +534,6 @@ def test_8020(self):
     def test_8021(self):
         "8021 - fetch raw"
         data = [(b"test_8025",)]
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             "select utl_raw.cast_to_raw('test_8025') from dual"
         )
@@ -567,7 +545,6 @@ def test_8021(self):
     def test_8022(self):
         "8022 - fetch boolean"
         data = [(True,), (False,), (False,), (True,), (True,)]
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             """
             select true
@@ -587,7 +564,6 @@ def test_8022(self):
 
     def test_8023(self):
         "8023 - fetch data with multiple rows containing null values"
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             """
             select to_date('2025-06-12', 'YYYY-MM-DD') as data from dual
@@ -638,7 +614,6 @@ def test_8024(self):
             (array.array("f", [34.6, 77.8]).tolist(),),
             (array.array("f", [34.6, 77.8, 55.9]).tolist(),),
         ]
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             """
             SELECT TO_VECTOR('[34.6, 77.8]', 2, FLOAT32)
@@ -658,7 +633,6 @@ def test_8025(self):
             ([34.6, 77.8],),
             ([34.6, 77.8, 55.9],),
         ]
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             """
             SELECT TO_VECTOR('[34.6, 77.8]', 2, FLOAT64)
@@ -678,7 +652,6 @@ def test_8026(self):
             ([34, -77],),
             ([34, 77, 55],),
         ]
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             """
             SELECT TO_VECTOR('[34, -77]', 2, INT8)
@@ -698,7 +671,6 @@ def test_8027(self):
             ([3, 2, 3],),
             ([3, 2],),
         ]
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             """
             SELECT TO_VECTOR('[3, 2, 3]', 24, BINARY)
@@ -719,7 +691,6 @@ def test_8028(self):
             (array.array("f", [34.6, 77.8, 55.9]).tolist(),),
             (None,),
         ]
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             """
             SELECT TO_VECTOR('[34.6, 77.8]', 2, FLOAT32)
@@ -751,7 +722,6 @@ def test_8029(self):
             ([34.6, 77.8],),
             ([34.6, 77.8],),
         ]
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             """
             SELECT TO_VECTOR('[34.6, 77.8]', 2, FLOAT64)
@@ -803,7 +773,6 @@ def test_8030(self):
                 },
             ),
         ]
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             """
             SELECT TO_VECTOR(
@@ -845,7 +814,6 @@ def test_8031(self):
                 },
             ),
         ]
-        self.__check_interop()
         ora_df = self.conn.fetch_df_all(
             """
             SELECT TO_VECTOR(
@@ -883,7 +851,6 @@ def test_8032(self):
     @test_env.skip_unless_sparse_vectors_supported()
     def test_8033(self):
         "8033 - DPY-4007 -fetch sparse vectors with flexible dimensions"
-        self.__check_interop()
         with self.assertRaisesFullCode("DPY-2065"):
             self.conn.fetch_df_all(
                 """
@@ -914,7 +881,6 @@ def test_8034(self):
             (56.25,),
             (91.25,),
         ]
-        self.__check_interop()
         self.__populate_table(dataset)
 
         # Use numeric expression involving a column