ci: migrate scripts to reusable workflows for docs and build processes

.github/workflows/build-and-test.yml

@@ -0,0 +1,14 @@
+name: Build and Test code
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+
+jobs:
+  call-reusable-workflow:
+    uses: eclipse-keyple/keyple-actions/.github/workflows/reusable-cpp-build-and-test.yml@main # NOSONAR - Same organization, trusted source
+    with:
+      test_executable_name: ''

.github/workflows/publish-doc-release.yml

@@ -1,41 +1,14 @@
-name: Publish API documentation
-
+name: Publish API documentation (release)
 on:
   release:
     types: [published]
 
+permissions:
+  checks: write
+
 jobs:
   publish-doc-release:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check out repository code from ${{ github.repository }}/${{ github.ref }}
-        uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-      - name: Make scripts executable
-        run: chmod +x ./.github/scripts/*.sh
-      - name: Check version
-        working-directory: .
-        run: ./.github/scripts/check_version.sh $(echo "${{ github.ref }}" | sed -e "s,^refs/tags/,,")
-      - name: Patch Doxyfile
-        working-directory: .
-        run: ./.github/scripts/patch_doxyfile.sh ${{ env.PROJECT_VERSION }}
-      - name: Generate project documentation with Doxygen
-        uses: mattnotmitt/doxygen-action@v1.9.2
-        with:
-          working-directory: .github/doxygen/
-          doxyfile-path: ./Doxyfile
-      - name: Prepare Doxygen doc page locally
-        working-directory: .
-        run: ./.github/scripts/prepare_doxygen.sh ${{ env.PROJECT_VERSION }}
-      - name: Deploy to doc branch
-        run: |
-          git config --global user.name "Eclipse Keypop Bot"
-          git config --global user.email "${{ github.repository }}-bot@eclipse.org"
-          cd ${{ github.event.repository.name }}
-          git remote set-url origin "https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git"
-          git add .
-          git commit -m "docs: update ${{ github.event.inputs.version || github.ref_name }} documentation"
-          git push origin doc --force
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    uses: eclipse-keyple/keyple-actions/.github/workflows/reusable-publish-doxygen.yml@main # NOSONAR - Same organization, trusted source
+    with:
+      version: ${{ github.event.inputs.version || github.ref_name }}
+    secrets: inherit # NOSONAR - Same organization, trusted source

.github/workflows/publish-doc-snapshot.yml

@@ -1,44 +1,14 @@
 name: Publish API documentation (snapshot)
-
 on:
   push:
     branches:
       - main
-      - master
-      - doxygen
+  workflow_dispatch:
+
+permissions:
+  checks: write
 
 jobs:
   publish-doc-snapshot:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check out repository code from ${{ github.repository }}/${{ github.ref }}
-        uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-      - name: Make scripts executable
-        run: chmod +x ./.github/scripts/*.sh
-      - name: Check version
-        working-directory: .
-        run: ./.github/scripts/check_version.sh
-      - name: Patch Doxyfile
-        working-directory: .
-        run: ./.github/scripts/patch_doxyfile.sh ${{ env.PROJECT_VERSION }}
-      - name: Generate project documentation with Doxygen
-        uses: mattnotmitt/doxygen-action@v1.9.2
-        with:
-          working-directory: .github/doxygen/
-          doxyfile-path: ./Doxyfile
-      - name: Prepare Doxygen doc page locally
-        working-directory: .
-        run: ./.github/scripts/prepare_doxygen.sh ${{ env.PROJECT_VERSION }}
-      - name: Deploy to doc branch
-        run: |
-          git config --global user.name "Eclipse Keypop Bot"
-          git config --global user.email "${{ github.repository }}-bot@eclipse.org"
-          cd ${{ github.event.repository.name }}
-          git remote set-url origin "https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git"
-          git add .
-          git diff --quiet && git diff --staged --quiet || git commit -m "docs: update snapshot documentation"
-          git push origin doc --force
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    uses: eclipse-keyple/keyple-actions/.github/workflows/reusable-publish-doxygen.yml@main # NOSONAR - Same organization, trusted source
+    secrets: inherit # NOSONAR - Same organization, trusted source

src/main/mainpage.dox

@@ -0,0 +1,23 @@
+/**
+ * @mainpage Keyple Card Calypso C++ Library
+ *
+ * @section overview Overview
+ *
+ * The **Keyple Card Calypso C++ Library** is a Keyple add-on that enables
+ * applications to interact with Calypso card products through high level
+ * functional commands, simplifying Calypso card operations.
+ *
+ * @section key_features Key Features
+ *
+ * - High-level Calypso card commands
+ * - Support for Calypso card operations
+ * - Secure session management
+ * - File and record operations
+ * - Transaction handling and cryptographic operations
+ *
+ * @section resources Resources
+ *
+ * - **Documentation**: [keyple.org](https://keyple.org)
+ * - **API Documentation**: [docs.keyple.org/keyple-card-calypso-cpp-lib](https://docs.keyple.org/keyple-card-calypso-cpp-lib)
+ * - **Examples**: [github.com/eclipse/keyple-cpp-example](https://github.com/eclipse/keyple-cpp-example)
+ */