Added support for maintainers to specify optional compilation arguments

when building python-oracledb.

Author: anthony-tuininga

doc/src/release_notes.rst

@@ -25,6 +25,12 @@ Thick Mode Changes
 Common Changes
 ++++++++++++++
 
+#)  Added support for maintainers to specify optional compilation arguments
+    when building python-oracledb. A new environment variable
+    ``PYO_COMPILE_ARGS`` can be set :ref:`before building <installsrc>`.
+#)  Python wheel package binaries for Linux on `PyPI
+    <https://pypi.org/project/oracledb/>`__ are now stripped to reduce their
+    size.
 #)  Error ``DPY-2049: invalid flags for tpc_begin()`` is now raised when
     invalid flags are passed to :meth:`Connection.tpc_begin()`.  Previously,
     ``TypeError`` or ``ORA-24759: invalid transaction start flags``

doc/src/user_guide/installation.rst

@@ -853,6 +853,8 @@ To use python-oracledb without the cryptography package:
 - Add a call to :meth:`oracledb.init_oracle_client()` in your application, see
   :ref:`enablingthick`.
 
+.. _installsrc:
+
 Installing from Source Code
 ===========================
 
@@ -866,6 +868,16 @@ code:
 
 - C Compiler: A C99 compiler is needed.
 
+**Optional Compilation Arguments**
+
+Before building python-oracledb, the optional environment variable
+``PYO_COMPILE_ARGS`` can be set to change the compilation arguments.  For
+example, to build stripped binaries on Linux, first set::
+
+    export PYO_COMPILE_ARGS='-g0'
+
+After this, one of the following installation methods can be used.
+
 .. _installgh:
 
 Install Using GitHub
@@ -879,8 +891,20 @@ commands::
     python setup.py build
     python setup.py install
 
+If you do not have access to system directories, the ``--user`` option can be
+used to install into a local directory::
+
+    python setup.py install --user
+
+Note that if you download a source zip file directly from GitHub then you will
+also need to download an `ODPI-C <https://github.com/oracle/odpi>`__ source zip
+file and put the extracted contents inside the "odpi" subdirectory, for example
+in "python-oracledb-main/src/oracledb/impl/thick/odpi".
+
 .. _whlpkg:
 
+**Creating a package for installation**
+
 To create a package suitable for installing on other computers, run the
 following commands::
 
@@ -896,15 +920,6 @@ version. To install the wheel, run::
 
     python -m pip install oracledb-2.2.0-cp312-cp312-macosx_10_9_universal2.whl
 
-If you do not have access to system directories, the ``--user`` option can be
-used to install into a local directory::
-
-    python setup.py install --user
-
-Note that if you download a source zip file directly from GitHub then you will
-also need to download an `ODPI-C <https://github.com/oracle/odpi>`__ source zip
-file and put the extracted contents inside the "odpi" subdirectory, for example
-in "python-oracledb-main/src/oracledb/impl/thick/odpi".
 
 Install Using opensource.oracle.com
 -----------------------------------

setup.py

@@ -76,7 +76,7 @@
 #  - add argument required for cross-compilation for both x86_64 and arm64
 #    architectures if the python interpreter is a universal2 version.
 
-extra_compile_args = []
+extra_compile_args = os.environ.get("PYO_COMPILE_ARGS", "").split()
 if sys.platform == "darwin":
     extra_compile_args.extend(["-mmacosx-version-min=10.9"])
     if "universal2" in sysconfig.get_platform():