Add template force regeneration capability

FORCE_INIT MECHANISM:
- Added FORCE_INIT option to cpp_library_setup()
- Added global CPP_LIBRARY_FORCE_INIT CMake option
- Added 'init' preset for convenient template regeneration
- Updated presets and CI modules to respect FORCE_INIT

USAGE:
  Method 1: cmake -S . -B build -DCPP_LIBRARY_FORCE_INIT=ON
  Method 2: cmake --preset=init (after initial generation)

REGENERATES:
- CMakePresets.json from template
- .github/workflows/ci.yml from template
- Future template files will respect this flag too

Author: sean-parent

cmake/cpp-library-ci.cmake

@@ -3,16 +3,20 @@
 # cpp-library-ci.cmake - CI setup functionality
 
 function(_cpp_library_setup_ci)
+    set(options FORCE_INIT)
     set(oneValueArgs
         NAME
         VERSION
         DESCRIPTION
     )
 
-    cmake_parse_arguments(ARG "" "${oneValueArgs}" "" ${ARGN})
+    cmake_parse_arguments(ARG "${options}" "${oneValueArgs}" "" ${ARGN})
 
-    # Only generate CI files if they don't exist
-    if(NOT EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/.github/workflows/ci.yml")
+    # Only generate CI files if they don't exist (unless forcing)
+    if(NOT EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/.github/workflows/ci.yml" OR ARG_FORCE_INIT)
+        if(ARG_FORCE_INIT)
+            message(STATUS "Force regenerating .github/workflows/ci.yml")
+        endif()
         # Create .github/workflows directory
         file(MAKE_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/.github/workflows")
 

cmake/cpp-library-presets.cmake

@@ -3,11 +3,18 @@
 # cpp-library-presets.cmake - CMakePresets.json generation
 
 function(_cpp_library_generate_presets)
-    # Only generate if CMakePresets.json doesn't already exist
-    if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/CMakePresets.json")
+    set(options FORCE_INIT)
+    cmake_parse_arguments(ARG "${options}" "" "" ${ARGN})
+    
+    # Only generate if CMakePresets.json doesn't already exist (unless forcing)
+    if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/CMakePresets.json" AND NOT ARG_FORCE_INIT)
         return()
     endif()
 
+    if(ARG_FORCE_INIT)
+        message(STATUS "Force regenerating CMakePresets.json")
+    endif()
+    
     set(PRESETS_TEMPLATE ${CPP_LIBRARY_ROOT}/templates/CMakePresets.json.in)
     set(PRESETS_OUT ${CMAKE_CURRENT_SOURCE_DIR}/CMakePresets.json)
 

cpp-library.cmake

@@ -25,6 +25,7 @@ function(cpp_library_setup)
         CUSTOM_INSTALL          # Skip default installation
         NO_PRESETS             # Skip CMakePresets.json generation
         NO_CI                  # Skip CI generation (CI enabled by default)
+        FORCE_INIT             # Force regeneration of template files
     )
     set(oneValueArgs
         NAME                    # Project name (e.g., "stlab-enum-ops")
@@ -66,6 +67,11 @@ function(cpp_library_setup)
         set(ARG_REQUIRES_CPP_VERSION 17)
     endif()
 
+    # Check for global FORCE_INIT option (can be set via -DCPP_LIBRARY_FORCE_INIT=ON)
+    if(CPP_LIBRARY_FORCE_INIT)
+        set(ARG_FORCE_INIT TRUE)
+    endif()
+    
     # Create the basic library target (always done)
     _cpp_library_setup_core(
         NAME "${ARG_NAME}"
@@ -95,7 +101,7 @@ function(cpp_library_setup)
 
     # Generate CMakePresets.json (unless disabled)
     if(NOT ARG_NO_PRESETS)
-        _cpp_library_generate_presets()
+        _cpp_library_generate_presets(FORCE_INIT ${ARG_FORCE_INIT})
     endif()
 
     # Setup testing (if tests are specified)
@@ -123,6 +129,7 @@ function(cpp_library_setup)
             NAME "${ARG_NAME}"
             VERSION "${ARG_VERSION}"
             DESCRIPTION "${ARG_DESCRIPTION}"
+            FORCE_INIT ${ARG_FORCE_INIT}
         )
     endif()
 

templates/CMakePresets.json.in

@@ -41,18 +41,30 @@
       "binaryDir": "${sourceDir}/build/clang-tidy",
       "inherits": "test",
       "cacheVariables": {
-        "CMAKE_CXX_CLANG_TIDY": "clang-tidy;-checks=*,-fuchsia-*,-google-*,-zircon-*,-abseil-*,-llvm-*,-llvmlibc-*,-altera-*,-android-*,-darwin-*,-objc-*,-openmp-*"
+        "CMAKE_CXX_CLANG_TIDY": "clang-tidy;"
+      }
+    },
+    {
+      "name": "init",
+      "displayName": "Initialize Templates",
+      "description": "Force regeneration of template files (CMakePresets.json, CI, etc.)",
+      "binaryDir": "${sourceDir}/build/init",
+      "inherits": "test",
+      "cacheVariables": {
+        "CPP_LIBRARY_FORCE_INIT": "ON"
       }
     }
   ],
   "buildPresets": [
     { "name": "default", "displayName": "Default Build", "configurePreset": "default" },
     { "name": "test", "displayName": "Build Tests", "configurePreset": "test" },
     { "name": "docs", "displayName": "Build Docs", "configurePreset": "docs", "targets": ["docs"] },
-    { "name": "clang-tidy", "displayName": "Build with Clang-Tidy", "configurePreset": "clang-tidy" }
+    { "name": "clang-tidy", "displayName": "Build with Clang-Tidy", "configurePreset": "clang-tidy" },
+    { "name": "init", "displayName": "Initialize Templates", "configurePreset": "init" }
   ],
   "testPresets": [
     { "name": "test", "displayName": "Run All Tests", "configurePreset": "test", "output": { "outputOnFailure": true } },
-    { "name": "clang-tidy", "displayName": "Run Tests with Clang-Tidy", "configurePreset": "clang-tidy", "output": { "outputOnFailure": true } }
+    { "name": "clang-tidy", "displayName": "Run Tests with Clang-Tidy", "configurePreset": "clang-tidy", "output": { "outputOnFailure": true } },
+    { "name": "init", "displayName": "Initialize Templates", "configurePreset": "init", "output": { "outputOnFailure": true } }
   ]
 }