refactor: update web module, connection examples, tests framework and CI workflows

Author: AstroAir

.github/workflows/ci.yml

@@ -8,9 +8,6 @@ name: Continuous Integration
     branches: [main, develop]
   workflow_dispatch:
 
-env:
-  VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"
-
 jobs:
   # Quick code quality checks
   code-quality:
@@ -56,105 +53,155 @@ jobs:
           find atom/ -name "*.cpp" -o -name "*.hpp" | head -20 | \
             xargs cpplint --filter=-whitespace/tab,-build/include_subdir || true
 
-  # Build matrix using CMakePresets for multiple platforms and configurations
+  # Build matrix using CMakePresets for multiple platforms, compilers, and module/features combinations
   build:
     name: Build (${{ matrix.name }})
     runs-on: ${{ matrix.os }}
+    env:
+      VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"
     strategy:
       fail-fast: false
       matrix:
         include:
-          # Linux x64 builds
-          - name: "Linux x64 Debug"
+          # Linux GCC
+          - name: "Linux GCC Debug (all modules)"
             os: ubuntu-latest
             preset: debug
             build_preset: debug
             triplet: x64-linux
             arch: x64
-          - name: "Linux x64 Release"
+            compiler: gcc
+            module_set: all
+            build_tests: true
+            build_examples: true
+            build_python: true
+            build_docs: false
+          - name: "Linux GCC Release (all modules)"
             os: ubuntu-latest
             preset: release
             build_preset: release
             triplet: x64-linux
             arch: x64
-          - name: "Linux x64 RelWithDebInfo"
+            compiler: gcc
+            module_set: all
+            build_tests: true
+            build_examples: true
+            build_python: true
+            build_docs: false
+          - name: "Linux GCC RelWithDebInfo (core modules)"
             os: ubuntu-latest
             preset: relwithdebinfo
             build_preset: relwithdebinfo
             triplet: x64-linux
             arch: x64
-          - name: "Linux x64 Makefile Debug"
+            compiler: gcc
+            module_set: core
+            build_tests: true
+            build_examples: false
+            build_python: false
+            build_docs: false
+
+          # Linux Clang coverage of RelWithDebInfo + docs
+          - name: "Linux Clang RelWithDebInfo (all modules + docs)"
             os: ubuntu-latest
-            preset: debug-make
-            build_preset: debug-make
+            preset: relwithdebinfo
+            build_preset: relwithdebinfo
             triplet: x64-linux
             arch: x64
-
-          # Windows x64 builds
-          - name: "Windows x64 Debug"
-            os: windows-latest
-            preset: debug
-            build_preset: debug
-            triplet: x64-windows
-            arch: x64
-          - name: "Windows x64 Release"
+            compiler: clang
+            module_set: all
+            build_tests: true
+            build_examples: true
+            build_python: true
+            build_docs: true
+
+          # Windows MSVC (vcpkg)
+          - name: "Windows MSVC Release (all modules)"
             os: windows-latest
-            preset: release
-            build_preset: release
+            preset: release-vs
+            build_preset: release-vs
             triplet: x64-windows
             arch: x64
-          - name: "Windows x64 VS Debug"
+            compiler: msvc
+            module_set: all
+            build_tests: true
+            build_examples: true
+            build_python: true
+            build_docs: false
+          - name: "Windows MSVC Debug (all modules)"
             os: windows-latest
             preset: debug-vs
             build_preset: debug-vs
             triplet: x64-windows
             arch: x64
-          - name: "Windows x64 VS Release"
-            os: windows-latest
-            preset: release-vs
-            build_preset: release-vs
-            triplet: x64-windows
-            arch: x64
-          - name: "Windows x64 RelWithDebInfo"
+            compiler: msvc
+            module_set: all
+            build_tests: true
+            build_examples: false
+            build_python: false
+            build_docs: false
+          - name: "Windows MSVC RelWithDebInfo (IO/NET modules)"
             os: windows-latest
             preset: relwithdebinfo-vs
             build_preset: relwithdebinfo-vs
             triplet: x64-windows
             arch: x64
-
-          # macOS Intel builds
-          - name: "macOS x64 Debug"
-            os: macos-13
-            preset: debug
-            build_preset: debug
-            triplet: x64-osx
-            arch: x64
-          - name: "macOS x64 Release"
+            compiler: msvc
+            module_set: io_net
+            build_tests: true
+            build_examples: false
+            build_python: false
+            build_docs: false
+
+          # macOS Intel + Apple Silicon
+          - name: "macOS x64 Release (all modules)"
             os: macos-13
             preset: release
             build_preset: release
             triplet: x64-osx
             arch: x64
-          - name: "macOS x64 RelWithDebInfo"
+            compiler: clang
+            module_set: all
+            build_tests: true
+            build_examples: true
+            build_python: true
+            build_docs: false
+          - name: "macOS x64 Debug (core modules)"
             os: macos-13
-            preset: relwithdebinfo
-            build_preset: relwithdebinfo
+            preset: debug
+            build_preset: debug
             triplet: x64-osx
             arch: x64
-
-          # macOS Apple Silicon builds
-          - name: "macOS ARM64 Debug"
+            compiler: clang
+            module_set: core
+            build_tests: true
+            build_examples: false
+            build_python: false
+            build_docs: false
+          - name: "macOS ARM64 RelWithDebInfo (core modules + docs)"
             os: macos-14
-            preset: debug
-            build_preset: debug
+            preset: relwithdebinfo
+            build_preset: relwithdebinfo
             triplet: arm64-osx
             arch: arm64
-          - name: "macOS ARM64 Release"
+            compiler: clang
+            module_set: core
+            build_tests: true
+            build_examples: false
+            build_python: false
+            build_docs: true
+          - name: "macOS ARM64 Release (all modules)"
             os: macos-14
             preset: release
             build_preset: release
             triplet: arm64-osx
             arch: arm64
+            compiler: clang
+            module_set: all
+            build_tests: true
+            build_examples: true
+            build_python: true
+            build_docs: false
 
     steps:
       - uses: actions/checkout@v4
@@ -189,10 +236,10 @@ jobs:
         with:
           path: build
           key: >-
-            ${{ runner.os }}-${{ matrix.arch }}-cmake-${{ matrix.preset }}-
-            ${{ hashFiles('CMakeLists.txt', 'cmake/**') }}
+            ${{ runner.os }}-${{ matrix.arch }}-${{ matrix.compiler }}-cmake-${{ matrix.preset }}-
+            ${{ hashFiles('CMakeLists.txt', 'cmake/**', 'CMakePresets.json') }}
           restore-keys: |
-            ${{ runner.os }}-${{ matrix.arch }}-cmake-${{ matrix.preset }}-
+            ${{ runner.os }}-${{ matrix.arch }}-${{ matrix.compiler }}-cmake-${{ matrix.preset }}-
 
       - name: Install system dependencies (Ubuntu)
         if: startsWith(matrix.os, 'ubuntu')
@@ -222,16 +269,42 @@ jobs:
           ccache --set-config=max_size=2G
           ccache --zero-stats
 
+      - name: Select compiler (clang/GCC)
+        if: matrix.compiler == 'clang'
+        run: |
+          echo "CC=clang" >> $GITHUB_ENV
+          echo "CXX=clang++" >> $GITHUB_ENV
+
       - name: Configure with CMakePresets
+        shell: bash
         run: |
+          MODULE_ARGS=()
+          case "${{ matrix.module_set }}" in
+            all)
+              MODULE_ARGS+=(-DATOM_BUILD_ALL=ON)
+              ;;
+            core)
+              MODULE_ARGS+=(-DATOM_BUILD_ALL=OFF -DATOM_BUILD_ERROR=ON -DATOM_BUILD_UTILS=ON)
+              MODULE_ARGS+=(-DATOM_BUILD_TYPE=ON -DATOM_BUILD_LOG=ON -DATOM_BUILD_META=ON -DATOM_BUILD_COMPONENTS=ON)
+              ;;
+            io_net)
+              MODULE_ARGS+=(-DATOM_BUILD_ALL=OFF -DATOM_BUILD_IO=ON -DATOM_BUILD_IMAGE=ON)
+              MODULE_ARGS+=(-DATOM_BUILD_SERIAL=ON -DATOM_BUILD_CONNECTION=ON -DATOM_BUILD_WEB=ON -DATOM_BUILD_ASYNC=ON)
+              ;;
+            *)
+              MODULE_ARGS+=(-DATOM_BUILD_ALL=ON)
+              ;;
+          esac
+
           cmake --preset ${{ matrix.preset }} \
             -DCMAKE_TOOLCHAIN_FILE=${{ github.workspace }}/vcpkg/scripts/buildsystems/vcpkg.cmake \
             -DUSE_VCPKG=ON \
             -DVCPKG_TARGET_TRIPLET=${{ matrix.triplet }} \
-            -DATOM_BUILD_EXAMPLES=ON \
-            -DATOM_BUILD_TESTS=ON \
-            -DATOM_BUILD_PYTHON_BINDINGS=ON \
-            -DATOM_BUILD_DOCS=ON
+            -DATOM_BUILD_TESTS=${{ matrix.build_tests }} \
+            -DATOM_BUILD_EXAMPLES=${{ matrix.build_examples }} \
+            -DATOM_BUILD_PYTHON_BINDINGS=${{ matrix.build_python }} \
+            -DATOM_BUILD_DOCS=${{ matrix.build_docs }} \
+            "${MODULE_ARGS[@]}"
 
       - name: Build with CMakePresets
         run: |
@@ -285,7 +358,7 @@ jobs:
         run: ccache --show-stats
 
       - name: Generate documentation
-        if: matrix.os == 'ubuntu-latest' && matrix.preset == 'release'
+        if: matrix.build_docs == true
         run: |
           cmake --build build --target doc
 

.github/workflows/code-quality.yml

@@ -9,14 +9,13 @@ on:
     - cron: "0 2 * * 1"  # Weekly on Monday at 2 AM
   workflow_dispatch:
 
-env:
-  VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"
-
 jobs:
   # Static analysis with multiple tools
   static-analysis:
     name: Static Analysis
     runs-on: ubuntu-latest
+    env:
+      VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"
     steps:
       - uses: actions/checkout@v4
         with:
@@ -40,6 +39,14 @@ jobs:
             iwyu include-what-you-use \
             valgrind lcov cmake ninja-build
 
+      - name: Setup vcpkg
+        uses: lukka/run-vcpkg@v11
+        with:
+          vcpkgGitCommitId: "dbe35ceb30c688bf72e952ab23778e009a578f18"
+
+      - name: Setup CMake
+        uses: lukka/get-cmake@latest
+
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
@@ -49,6 +56,35 @@ jobs:
         run: |
           pip install cpplint lizard complexity-report
 
+      - name: Cache vcpkg
+        uses: actions/cache@v4
+        with:
+          path: |
+            ${{ github.workspace }}/vcpkg
+            ~/.cache/vcpkg
+          key: ${{ runner.os }}-analysis-vcpkg-${{ hashFiles('vcpkg.json') }}
+          restore-keys: |
+            ${{ runner.os }}-analysis-vcpkg-
+
+      - name: Cache CMake configure (compile commands)
+        uses: actions/cache@v4
+        with:
+          path: build
+          key: >-
+            ${{ runner.os }}-analysis-cmake-${{ hashFiles('CMakeLists.txt', 'cmake/**', 'CMakePresets.json') }}
+          restore-keys: |
+            ${{ runner.os }}-analysis-cmake-
+
+      - name: Configure project (compile_commands)
+        run: |
+          cmake --preset debug \
+            -DCMAKE_TOOLCHAIN_FILE=${{ github.workspace }}/vcpkg/scripts/buildsystems/vcpkg.cmake \
+            -DUSE_VCPKG=ON \
+            -DATOM_BUILD_TESTS=ON \
+            -DATOM_BUILD_EXAMPLES=OFF \
+            -DATOM_BUILD_PYTHON_BINDINGS=OFF \
+            -DATOM_BUILD_DOCS=OFF
+
       - name: Run cppcheck
         run: |
           cppcheck --enable=all \
@@ -64,9 +100,6 @@ jobs:
 
       - name: Run clang-tidy
         run: |
-          # Generate compile commands using CMakePresets
-          cmake --preset debug -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
-
           # Run clang-tidy on source files
           find atom/ -name "*.cpp" | head -20 | xargs -I {} \
             clang-tidy {} -p build/ \
@@ -271,12 +304,14 @@ jobs:
           lcov --list coverage.info
 
       - name: Upload coverage to Codecov
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+        if: ${{ env.CODECOV_TOKEN != '' }}
         uses: codecov/codecov-action@v4
         with:
           file: build/coverage.info
           flags: unittests
           name: codecov-umbrella
-          token: ${{ secrets.CODECOV_TOKEN }}
 
   # Documentation quality
   documentation-quality: