Start process of migrating API documentation to source code.

Author: anthony-tuininga

doc/src/api_manual/async_connection.rst

@@ -2154,13 +2154,6 @@ Oracledb Methods
 
         The ``connection_id_prefix`` parameter was added.
 
-.. function:: Cursor(connection)
-
-    Constructor for creating a cursor.  Returns a new
-    :ref:`cursor object <cursorobj>` using the connection.
-
-    .. dbapimethodextension::
-
 .. function:: Date(year, month, day)
 
     Constructs an object holding a date value.

doc/src/api_manual/async_cursor.rst

@@ -12,11 +12,15 @@
 # serve to show the default value.
 
 import os
+import pathlib
 import sys
 
 # If your extensions are in another directory, add it here.
 sys.path.append(os.path.abspath("_ext"))
 
+# include the path of the source so that autodoc willfunction
+sys.path.insert(0, str(pathlib.Path("..", "src").resolve()))
+
 # General configuration
 # ---------------------
 
@@ -27,8 +31,12 @@
     "oracle_deprecated",
     "dbapi_extension",
     "sphinx_rtd_theme",
+    "sphinx.ext.autodoc",
 ]
 
+# preserve defaults in function signatures
+autodoc_preserve_defaults = True
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = [".templates"]
 

doc/src/api_manual/connection.rst

@@ -23,6 +23,8 @@ Thick Mode Changes
 Common Changes
 ++++++++++++++
 
+#)  API documentation is now generated from the source code.
+
 
 oracledb `3.3.0 <https://github.com/oracle/python-oracledb/compare/v3.2.0...v3.3.0>`__ (July 2025)
 --------------------------------------------------------------------------------------------------