Allow building of specified packages.

Author: anthony-tuininga

.github/workflows/build.yaml

@@ -1,15 +1,21 @@
-name: build
+name: Build python-oracledb packages
 
 on:
   push:
     tags:
       - v*
   workflow_dispatch:
+    inputs:
+      tgt:
+        description: List of package targets to build
+        default: 'Linux, macOS, Windows, Source'
+        required: false
 
 jobs:
 
   build_source_package:
     name: Build source package
+    if: contains(inputs.tgt, 'Source') || inputs.tgt == ''
     runs-on: ubuntu-latest
     steps:
 
@@ -36,6 +42,7 @@ jobs:
 
   build_linux_wheels:
     name: Build wheels for Linux
+    if: contains(inputs.tgt, 'Linux') || inputs.tgt == ''
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
@@ -82,12 +89,13 @@ jobs:
           name: Linux_${{ matrix.platform }}_wheels
           path: dist/*.whl
 
-  build_non_linux_wheels:
+  build_macos_wheels:
     name: Build wheels for ${{ matrix.os }} Python-${{ matrix.python-version}}-${{ matrix.arch }}
+    if: contains(inputs.tgt, 'macOS') || inputs.tgt == ''
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        os: [windows-latest, macos-latest]
+        os: [macos-latest]
         python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
         arch: ['x86', '']
         exclude:
@@ -118,9 +126,44 @@ jobs:
           name: python-oracledb-${{ matrix.os }}-${{ matrix.python-version }}-${{ matrix.arch }}
           path: dist/*.whl
 
+  build_windows_wheels:
+    name: Build wheels for ${{ matrix.os }} Python-${{ matrix.python-version}}-${{ matrix.arch }}
+    if: contains(inputs.tgt, 'Windows') || inputs.tgt == ''
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [windows-latest]
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+        arch: ['x86', '']
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+
+      - uses: actions/setup-python@v5
+        with:
+          cache: 'pip'
+          python-version: ${{ matrix.python-version }}
+          architecture: ${{ matrix.arch }}
+          allow-prereleases: true
+
+      - name: Ensure build package is present
+        run: python -m pip install build
+
+      - name: Build wheel for Python ${{ matrix.python-version }}
+        run: python -m build
+
+      - name: Upload the artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-oracledb-${{ matrix.os }}-${{ matrix.python-version }}-${{ matrix.arch }}
+          path: dist/*.whl
+
   combine_artifacts:
     name: Combine artifacts into single artifact
-    needs: [build_source_package, build_linux_wheels, build_non_linux_wheels]
+    if: ${{ always() }}
+    needs: [build_source_package, build_linux_wheels, build_macos_wheels, build_windows_wheels]
     runs-on: ubuntu-latest
 
     steps:

doc/src/release_notes.rst

@@ -68,10 +68,14 @@ Common Changes
 
 #)  Added parameter ``pool_name`` to connection and pool creation methods to
     support Oracle Database 23ai multi-pool :ref:`drcp`.
-#)  Use GitHub Arm Linux runner for builds. Supplied by wojiushixiaobai
-    (`PR 496 <https://github.com/oracle/python-oracledb/pull/496>`__).
-#)  Fix bug with GitHub build action merge artifacts step
-    (`issue 495 <https://github.com/oracle/python-oracledb/issues/495>`__).
+#)  :ref:`GitHub Action <installghactions>` workflow updates:
+
+    - Use GitHub Arm Linux runner for builds. Supplied by wojiushixiaobai
+      (`PR 496 <https://github.com/oracle/python-oracledb/pull/496>`__).
+    - Allow the GitHub build action to build a user-chosen subset of packages.
+    - Fix bug with GitHub build action merge artifacts step
+      (`issue 495 <https://github.com/oracle/python-oracledb/issues/495>`__).
+
 #)  Error ``DPY-2064: parameter 'max' should be greater than or equal to
     parameter 'min'`` is now raised when a call to
     :meth:`oracledb.create_pool()`, :meth:`oracledb.create_pool_async()`

doc/src/user_guide/installation.rst

@@ -1010,19 +1010,20 @@ Python versions.
    `ODPI-C repository <https://github.com/oracle/odpi/fork>`__, keeping the
    default name.
 
-2. Optionally edit ``.github/workflows/build.yaml`` and remove platforms and
-   versions that you are not interested in. Building all packages can take some
-   time.
-
-3. In your python-oracledb fork, go to the Actions tab
+2. In your python-oracledb fork, go to the Actions tab
    ``https://github.com/<your name>/python-oracledb/actions/``.  If this is
    your first time using Actions, confirm enabling them.
 
-4. In the "All workflows" list on the left-hand side, select the "build" entry.
+3. In the "All workflows" list on the left-hand side, select the "Build
+   python-oracledb packages" entry.
 
-5. Navigate to the "Run workflow" drop-down, select the branch to build from
+4. Navigate to the "Run workflow" drop-down, select the branch to build from
    (for example, "main"), and run the workflow.
 
+5. Optionally edit the input field list of package targets and remove targets
+   you do not want to build. For example, remove "Linux" if you do not want
+   Linux packages.
+
 6. When the build has completed, download the "python-oracledb-wheels"
    artifact, unzip it, and install the one for your architecture and Python
    version.  For example, when using Python 3.12 on macOS, install::