[Docs] Add hybrid plugin system notebook

Part of OpenAssetIO/OpenAssetIO#1202. Add a Jupyter Notebook
illustrating the design and usage of the hybrid plugin system.

Update CI to ensure SimpleCppManager is built with OpenAssetIO, and use
a dedicated job for the hybrid plugin system notebook to supply the
built SimpleCppManager. Bump the minimum versions of OpenAssetIO and BAL
in `requirements.txt` to support the required features for the notebook
to run.

Signed-off-by: David Feltell <[email protected]>

.github/build_openassetio/action.yml

@@ -22,7 +22,7 @@ runs:
       run: |
         cd openassetio-checkout
         mkdir build
-        cmake -G Ninja -S . -B build
+        cmake -G Ninja -S . -B build -DOPENASSETIO_ENABLE_SIMPLECPPMANAGER=ON
         cmake --build build
         cmake --install build
     - uses: actions/upload-artifact@v3

.github/workflows/examples.yml

@@ -18,6 +18,9 @@ jobs:
       matrix:
         os: ["windows-2022", "ubuntu-22.04", "macos-13"]
         python: ["3.10", "3.11"]
+    defaults:
+      run:
+        shell: bash
     steps:
       - uses: actions/checkout@v3
       - uses: actions/setup-python@v4
@@ -28,4 +31,38 @@ jobs:
           python -m pip install .
           python -m pip install -r examples/resources/requirements.txt
       - name: Test Notebooks
-        run: jupyter nbconvert --to html --execute examples/*.ipynb
+        # Execute all the notebooks apart from the Hybrid Plugin System,
+        # which requires a build of SimpleCppManager
+        run: >
+          find examples -maxdepth 1 -name "*.ipynb"
+          ! -name "hybrid_plugin_system.ipynb"
+          -exec jupyter nbconvert --to html --execute {} \;
+
+  test-cpp-notebooks:
+    # A special job just for the Hybrid Plugin System because it needs a
+    # build of SimpleCppManager. Use the OpenAssetIO Docker container to
+    # get a build. If/when OpenAssetIO publishes SimpleCppManager with
+    # its release artifacts, this could be simplified.
+    name: Test Hybrid Plugin System notebook
+    runs-on: ubuntu-latest
+    container:
+      image: ghcr.io/openassetio/openassetio-build
+    steps:
+      - uses: actions/checkout@v3
+      - name: Install Dependencies
+        run: |
+          python -m pip install .
+          python -m pip install -r examples/resources/requirements.txt
+
+      - name: Build SimpleCppManager
+        uses: ./.github/build_openassetio
+
+      - name: Copy SimpleCppManager to expected location for notebook
+        run: >
+          cp openassetio-checkout/build/dist/SimpleCppManager.so 
+          examples/resources/hybrid_plugin_system/SimpleCppManager/
+
+      - name: Test notebook
+        run: jupyter nbconvert --to html --execute examples/hybrid_plugin_system.ipynb
+
+