Experiment/cpp26 reflection ffi

.github/workflows/compile_checks.yml

@@ -0,0 +1,47 @@
+name: 'Compile Checks'
+
+on:
+  push:
+    branches:
+      - '*'
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  compile_checks:
+    name: 'Compile checks'
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: 'Checkout repository'
+        uses: actions/checkout@v6
+
+      - name: 'Install GCC 16.1 toolchain'
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y software-properties-common
+          sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
+          sudo apt-get update -qq
+          sudo apt-get install -y gcc-16 g++-16 ninja-build cmake
+
+      - name: 'Show toolchain versions'
+        run: |
+          cmake --version
+          ninja --version
+          gcc-16 --version
+          g++-16 --version
+
+      - name: 'Configure CMAKE'
+        run: |
+          cmake -S . -B build/ci -G Ninja \
+            -DCMAKE_BUILD_TYPE=Debug \
+            -DCMAKE_C_COMPILER=gcc-16 \
+            -DCMAKE_CXX_COMPILER=g++-16
+
+      - name: 'Build compile checks'
+        run: |
+          cmake --build build/ci --target cpp_core_compile_tests
+
+      - name: 'Run CTest if registered tests exist'
+        run: |
+          ctest --test-dir build/ci --output-on-failure --no-tests=ignore

.github/workflows/doxygen.yml

@@ -6,43 +6,48 @@ on:
     paths:
       - 'include/**'
       - 'Doxyfile'
+      - 'README.md'
+      - 'LICENSE'
       - '.github/workflows/doxygen.yml'
   workflow_dispatch:
 
 # Required for GitHub Pages deployment
 permissions:
-  contents: write        
-  pages: write           
-  id-token: write        
+  contents: read
+  pages: write
+  id-token: write
 
 jobs:
   build-docs:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     name: 'Build Doxygen HTML'
     steps:
-      - name: Checkout
-        uses: actions/checkout@v3
+      - name: 'Checkout repository'
+        uses: actions/checkout@v6
 
-      - name: Install Doxygen + Graphviz
+      - name: 'Install Doxygen + Graphviz'
         run: |
           sudo apt-get update -qq
           sudo apt-get install -y doxygen graphviz
 
-      - name: Generate documentation
+      - name: 'Generate documentation'
         run: |
           doxygen -v
           doxygen Doxyfile
 
-      - name: Upload Pages artifact
-        uses: actions/upload-pages-artifact@v3
+      - name: 'Upload Pages artifact'
+        uses: actions/upload-pages-artifact@v5
         with:
           path: docs/html
 
   deploy:
     needs: build-docs
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     name: 'Deploy to GitHub Pages'
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     steps:
-      - name: Deploy
+      - name: 'Deploy'
         id: deployment
-        uses: actions/deploy-pages@v4 
+        uses: actions/deploy-pages@v5

CMakeLists.txt

@@ -3,6 +3,34 @@ cmake_minimum_required(VERSION 3.30)
 # Export compile commands to root directory
 set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
 
+project(cpp-core LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 26)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+set(CMAKE_CXX_MODULE_STD 26)
+set(CMAKE_CXX_MODULE_EXTENSIONS OFF)
+
+option(CPP_CORE_ENABLE_AST_EXPORT "Enable clang-based JSON AST export for the FFI headers" ON)
+set(
+    CPP_CORE_AST_JSON_OUTPUT
+    "${CMAKE_BINARY_DIR}/ast/cpp_core_ffi_ast.json"
+    CACHE FILEPATH
+    "Output path for the generated FFI AST JSON file"
+)
+set(
+    CPP_CORE_AST_CLANGXX
+    ""
+    CACHE FILEPATH
+    "Path to the clang++ executable used for AST JSON export"
+)
+set(
+    CPP_CORE_AST_SLIM_JSON_OUTPUT
+    "${CMAKE_BINARY_DIR}/ast/cpp_core_ffi_api.json"
+    CACHE FILEPATH
+    "Output path for the reduced FFI API JSON metadata"
+)
+
 include(cmake/CPM.cmake)
 
 CPMAddPackage(
@@ -18,17 +46,28 @@ include(${cmake-git-versioning_SOURCE_DIR}/cmake/cmake-git-versioning.cmake)
 get_git_version_info()
 generate_git_version(OUTPUT_DIR ${CMAKE_CURRENT_SOURCE_DIR}/include/cpp_core)
 
-project(
-    cpp-core
-    VERSION "${GIT_VERSION_MAJOR}.${GIT_VERSION_MINOR}.${GIT_VERSION_PATCH}"
-    DESCRIPTION "Cross-platform helper library shared by cpp-linux-bindings and cpp-windows-bindings"
-    LANGUAGES CXX
-)
+set(PROJECT_VERSION "${GIT_VERSION_MAJOR}.${GIT_VERSION_MINOR}.${GIT_VERSION_PATCH}")
+set(PROJECT_DESCRIPTION "Cross-platform helper library shared by cpp-linux-bindings and cpp-windows-bindings")
 
 # Header-only library --------------------------------------------------------
 add_library(cpp_core INTERFACE)
 add_library(cpp_core::cpp_core ALIAS cpp_core)
 
+add_library(cpp_core_strict_warnings INTERFACE)
+
+target_compile_options(
+    cpp_core_strict_warnings
+    INTERFACE
+    -Wall
+    -Wextra
+    -Wpedantic
+    -Wconversion
+    -Wsign-conversion
+    -Wshadow
+    -Wundef
+    -Werror
+)
+
 # Public include directories
 target_include_directories(
     cpp_core
@@ -37,23 +76,100 @@ target_include_directories(
     $<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>
 )
 
-# Set C++ standard
-set(CMAKE_CXX_STANDARD 23)
-set(CMAKE_CXX_STANDARD_REQUIRED ON)
-set(CMAKE_CXX_EXTENSIONS OFF)
-
-# Require C++23
-target_compile_features(cpp_core INTERFACE cxx_std_23)
+target_compile_options(cpp_core INTERFACE -freflection)
 
-# Enable C++23 module support
-set(CMAKE_CXX_MODULE_STD 23)
-set(CMAKE_CXX_MODULE_EXTENSIONS OFF)
+target_compile_features(cpp_core INTERFACE cxx_std_26)
 
 include(CTest)
 
 if(BUILD_TESTING)
-    add_library(cpp_core_status_code_compile_test OBJECT tests/status_code_compile_test.cpp)
-    target_link_libraries(cpp_core_status_code_compile_test PRIVATE cpp_core::cpp_core)
+    file(
+        GLOB_RECURSE CPP_CORE_COMPILE_TEST_SOURCES
+        CONFIGURE_DEPENDS
+        "${CMAKE_CURRENT_SOURCE_DIR}/include/*.test.cpp"
+    )
+    add_library(cpp_core_compile_tests OBJECT ${CPP_CORE_COMPILE_TEST_SOURCES})
+    target_link_libraries(cpp_core_compile_tests PRIVATE cpp_core::cpp_core)
+    target_link_libraries(cpp_core_compile_tests PRIVATE cpp_core_strict_warnings)
+endif()
+
+if(CPP_CORE_ENABLE_AST_EXPORT)
+    find_package(Python3 COMPONENTS Interpreter REQUIRED)
+
+    file(
+        GLOB _cpp_core_ast_interface_headers
+        CONFIGURE_DEPENDS
+        "${CMAKE_CURRENT_SOURCE_DIR}/include/cpp_core/interface/*.h"
+    )
+
+    set(
+        _cpp_core_ast_headers
+        "${CMAKE_CURRENT_SOURCE_DIR}/include/cpp_core/serial.h"
+        "${CMAKE_CURRENT_SOURCE_DIR}/include/cpp_core/error_callback.h"
+        "${CMAKE_CURRENT_SOURCE_DIR}/include/cpp_core/module_api.h"
+        "${CMAKE_CURRENT_SOURCE_DIR}/include/cpp_core/version.hpp"
+        ${_cpp_core_ast_interface_headers}
+    )
+
+    if(CPP_CORE_AST_CLANGXX)
+        set(_cpp_core_ast_clangxx "${CPP_CORE_AST_CLANGXX}")
+    else()
+        find_program(_cpp_core_ast_clangxx NAMES clang++)
+    endif()
+
+    if(NOT _cpp_core_ast_clangxx)
+        message(
+            FATAL_ERROR
+            "CPP_CORE_ENABLE_AST_EXPORT=ON requires clang++. "
+            "Install clang++ or set CPP_CORE_AST_CLANGXX to an explicit path."
+        )
+    endif()
+
+    set(_cpp_core_ast_wrapper "${CMAKE_CURRENT_BINARY_DIR}/ast/cpp_core_ffi_ast.cpp")
+    get_filename_component(_cpp_core_ast_json_dir "${CPP_CORE_AST_JSON_OUTPUT}" DIRECTORY)
+    get_filename_component(_cpp_core_ast_slim_json_dir "${CPP_CORE_AST_SLIM_JSON_OUTPUT}" DIRECTORY)
+
+    file(
+        GENERATE
+        OUTPUT "${_cpp_core_ast_wrapper}"
+        CONTENT "#include <cpp_core/serial.h>\n"
+    )
+
+    add_custom_command(
+        OUTPUT "${CPP_CORE_AST_JSON_OUTPUT}"
+        COMMAND ${CMAKE_COMMAND} -E make_directory "${_cpp_core_ast_json_dir}"
+        COMMAND
+            ${CMAKE_COMMAND}
+            -DCPP_CORE_AST_CLANGXX=${_cpp_core_ast_clangxx}
+            -DCPP_CORE_AST_INCLUDE_DIR=${CMAKE_CURRENT_SOURCE_DIR}/include
+            -DCPP_CORE_AST_OUTPUT=${CPP_CORE_AST_JSON_OUTPUT}
+            -DCPP_CORE_AST_SOURCE=${_cpp_core_ast_wrapper}
+            -DCPP_CORE_AST_STANDARD=${CMAKE_CXX_STANDARD}
+            -P ${CMAKE_CURRENT_SOURCE_DIR}/cmake/export_ast_json.cmake
+        DEPENDS "${_cpp_core_ast_wrapper}" ${_cpp_core_ast_headers}
+        COMMENT "Exporting FFI header AST JSON with clang++"
+        VERBATIM
+    )
+
+    add_custom_command(
+        OUTPUT "${CPP_CORE_AST_SLIM_JSON_OUTPUT}"
+        COMMAND ${CMAKE_COMMAND} -E make_directory "${_cpp_core_ast_slim_json_dir}"
+        COMMAND
+            "${Python3_EXECUTABLE}"
+            "${CMAKE_CURRENT_SOURCE_DIR}/tools/clang_ast_to_ffi_json.py"
+            --input "${CPP_CORE_AST_JSON_OUTPUT}"
+            --output "${CPP_CORE_AST_SLIM_JSON_OUTPUT}"
+            --source-root "${CMAKE_CURRENT_SOURCE_DIR}"
+            --public-header "cpp_core/serial.h"
+        DEPENDS
+            "${CPP_CORE_AST_JSON_OUTPUT}"
+            "${CMAKE_CURRENT_SOURCE_DIR}/tools/clang_ast_to_ffi_json.py"
+        COMMENT "Reducing clang AST JSON to compact FFI API metadata"
+        VERBATIM
+    )
+
+    add_custom_target(cpp_core_ast_raw_json DEPENDS "${CPP_CORE_AST_JSON_OUTPUT}")
+    add_custom_target(cpp_core_ast_slim_json DEPENDS "${CPP_CORE_AST_SLIM_JSON_OUTPUT}")
 endif()
 
 # Install rules --------------------------------------------------------------
@@ -69,6 +185,14 @@ install(
     DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
 )
 
+if(CPP_CORE_ENABLE_AST_EXPORT)
+    install(
+        FILES "${CPP_CORE_AST_SLIM_JSON_OUTPUT}"
+        DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/cpp_core
+        OPTIONAL
+    )
+endif()
+
 # CMake package configuration ------------------------------------------------
 include(CMakePackageConfigHelpers)
 

CMakePresets.json

@@ -39,6 +39,17 @@
                 "value": "x64",
                 "strategy": "external"
             }
+        },
+        {
+            "name": "mingw",
+            "displayName": "MinGW-w64 (cross)",
+            "description": "Cross-compile for Windows using MinGW-w64",
+            "generator": "Ninja",
+            "binaryDir": "${sourceDir}/build/mingw",
+            "toolchainFile": "${sourceDir}/cmake/mingw-toolchain.cmake",
+            "cacheVariables": {
+                "CMAKE_BUILD_TYPE": "Debug"
+            }
         }
     ],
     "buildPresets": [
@@ -77,6 +88,18 @@
             "displayName": "MSVC Release",
             "configurePreset": "msvc",
             "configuration": "Release"
+        },
+        {
+            "name": "mingw-debug",
+            "displayName": "MinGW Debug",
+            "configurePreset": "mingw",
+            "configuration": "Debug"
+        },
+        {
+            "name": "mingw-release",
+            "displayName": "MinGW Release",
+            "configurePreset": "mingw",
+            "configuration": "Release"
         }
     ]
 }

Doxyfile

@@ -6,7 +6,7 @@
 PROJECT_NAME           = "cpp-core"
 PROJECT_BRIEF          = "Header-only C++ helper library"
 PROJECT_NUMBER         = "1.0"
-OUTPUT_DIRECTORY       = docs/html
+OUTPUT_DIRECTORY       = docs
 CREATE_SUBDIRS         = NO
 
 # Build options ----------------------------------------------------------
@@ -22,7 +22,7 @@ RECURSIVE              = YES
 
 # HTML output ------------------------------------------------------------
 GENERATE_HTML          = YES
-HTML_OUTPUT            = .
+HTML_OUTPUT            = html
 HTML_COLORSTYLE_HUE    = 220
 HTML_COLORSTYLE_SAT    = 100
 HTML_COLORSTYLE_GAMMA  = 80