Modernize and update dependencies to 2025.12

tmpl/.devcontainer/devcontainer.json

@@ -33,5 +33,5 @@
             "toolsToInstall": "copier,pipenv"
         }
     },
-    "postCreateCommand": "cd ${containerWorkspaceFolder}/docs && pipenv sync --dev",
+    "postCreateCommand": "cd '${containerWorkspaceFolder}' && mkdir -p build && ln -s -f x64-linux-clang/compile_commands.json ./build/compile_commands.json && cd ./docs && pipenv sync --dev",
 }

tmpl/.github/workflows/cpp-ci.yml

@@ -14,15 +14,15 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-24.04, windows-2022]
+        os: [ubuntu-24.04, windows-2025]
         compiler: [gcc, clang, msvc]
         exclude:
           - os: ubuntu-24.04
             compiler: msvc
-          - os: windows-2022
+          - os: windows-2025
             compiler: gcc
         include:
-          - os: macos-13
+          - os: macos-15-intel
             compiler: gcc
             triplet: x64-macos
           - os: macos-15
@@ -40,7 +40,7 @@ jobs:
               sudo add-apt-repository "deb http://apt.llvm.org/noble/ llvm-toolchain-noble-19 main"
               sudo apt-get -qq update
               sudo apt-get -qq -y install clang-19
-          - os: windows-2022
+          - os: windows-2025
             triplet: x64-windows
 
     permissions:
@@ -50,7 +50,7 @@ jobs:
       CTEST_OUTPUT_ON_FAILURE: "1"
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v6
 
       - name: Install required packages / compilers
         if: ${{ matrix.install }}
@@ -102,7 +102,7 @@ jobs:
         actions: read
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v6
 
       - name: "Install clang-tools-20"
         run: |

tmpl/.github/workflows/gh-pages.yml

@@ -14,17 +14,17 @@ on:
 
 jobs:
   build:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     name: Build docs
     concurrency:
       group: ${{ github.workflow }}-${{ github.ref }}
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v6
 
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v6
         with:
-          python-version: "3.11"
+          python-version: "3.12"
           cache: 'pipenv'
           cache-dependency-path: docs/Pipfile.lock
 

tmpl/CMakeLists.txt.jinja

@@ -10,7 +10,7 @@
 #     http://creativecommons.org/publicdomain/zero/1.0/
 #
 ########################################################################
-cmake_minimum_required(VERSION 3.23...4.0)
+cmake_minimum_required(VERSION 3.25)
 list(APPEND CMAKE_MODULE_PATH "${CMAKE_SOURCE_DIR}/tools/cmake/")
 
 ########################################################################

tmpl/CMakePresets.json

@@ -186,18 +186,18 @@
             }
         },
         {
-            "name": "x64-linux-gcc-12",
+            "name": "x64-linux-gcc-14",
             "inherits": [
                 "x64-linux-gcc"
             ],
             "cacheVariables": {
-                "VCPKG_CHAINLOAD_TOOLCHAIN_FILE": "${sourceDir}/tools/toolchains/x64-linux-gcc-12.cmake"
+                "VCPKG_CHAINLOAD_TOOLCHAIN_FILE": "${sourceDir}/tools/toolchains/x64-linux-gcc-14.cmake"
             }
         },
         {
             "name": "x64-linux-gcc-ci",
             "inherits": [
-                "x64-linux-gcc-12"
+                "x64-linux-gcc-14"
             ]
         },
         {
@@ -229,8 +229,8 @@
                 "base"
             ],
             "cacheVariables": {
-                "VCPKG_TARGET_TRIPLET": "x64-macos-gcc-14",
-                "VCPKG_CHAINLOAD_TOOLCHAIN_FILE": "${sourceDir}/tools/toolchains/x64-macos-gcc-14.cmake"
+                "VCPKG_TARGET_TRIPLET": "x64-macos-gcc-15",
+                "VCPKG_CHAINLOAD_TOOLCHAIN_FILE": "${sourceDir}/tools/toolchains/x64-macos-gcc-15.cmake"
             },
             "vendor": {
                 "microsoft.com/VisualStudioSettings/CMake/1.0": {

tmpl/docs/Pipfile

@@ -4,10 +4,10 @@ verify_ssl = true
 name = "pypi"
 
 [packages]
-sphinx = "~=7.0"
+sphinx = "~=8.2.3"
 sphinx-copybutton = "~=0.5.2"
 sphinx-multiversion = "~=0.2.4"
-furo = "==2023.5.20"
+furo = "==2025.9.25"
 
 [dev-packages]
 esbonio = "*"

tmpl/tools/ports/llfio/portfile.cmake

@@ -0,0 +1,91 @@
+if ("polyfill-cxx20" IN_LIST FEATURES)
+    message(WARNING [=[
+    LLFIO depends on Outcome which depends on QuickCppLib which uses the vcpkg versions of gsl-lite and byte-lite, rather than the versions tested by QuickCppLib's, Outcome's and LLFIO's CI. It is not guaranteed to work with other versions, with failures experienced in the past up-to-and-including runtime crashes. See the warning message from QuickCppLib for how you can pin the versions of those dependencies in your manifest file to those with which QuickCppLib was tested. Do not report issues to upstream without first pinning the versions as QuickCppLib was tested against.
+    ]=])
+endif()
+
+
+vcpkg_from_github(
+    OUT_SOURCE_PATH SOURCE_PATH
+    REPO ned14/llfio
+    REF b3c9308f143e27161c40f6d52a8fd18e8f05761b
+    SHA512 eb1b629b00fc28da939b0766ce567896da098401d71bd65b895f34ccd805d5ac99c0e45cc1733e63ce985c22b6d2118e576fb49a8e3a6f02170b9fe378e801bd
+    HEAD_REF develop
+)
+
+vcpkg_from_github(
+    OUT_SOURCE_PATH NTKEC_SOURCE_PATH
+    REPO ned14/ntkernel-error-category
+    REF 5e50ff9af36a029c8ead9e0a833aa78304e95f28
+    SHA512 a3b8bfba8b22c79913ced23358c4a5ec56d2f2f8ca8da3ebd2e7cfaa783363d92d9de1b49766756c7b008114eee31c1509195232adcc364446eae724489be930
+    HEAD_REF master
+)
+
+vcpkg_check_features(
+    OUT_FEATURE_OPTIONS LLFIO_FEATURE_OPTIONS
+    FEATURES
+      status-code LLFIO_USE_EXPERIMENTAL_SG14_STATUS_CODE
+)
+
+# LLFIO expects ntkernel-error-category to live inside its include directory
+file(REMOVE_RECURSE "${SOURCE_PATH}/include/llfio/ntkernel-error-category")
+file(RENAME "${NTKEC_SOURCE_PATH}" "${SOURCE_PATH}/include/llfio/ntkernel-error-category")
+
+set(extra_config)
+# cmake does not correctly set CMAKE_SYSTEM_PROCESSOR when targeting ARM on Windows
+if(VCPKG_TARGET_IS_WINDOWS AND (VCPKG_TARGET_ARCHITECTURE STREQUAL "arm" OR VCPKG_TARGET_ARCHITECTURE STREQUAL "arm64"))
+  list(APPEND extra_config -DLLFIO_ASSUME_CROSS_COMPILING=ON)
+endif()
+# setting CMAKE_CXX_STANDARD here to prevent llfio from messing with compiler flags
+# the cmake package config requires said C++ standard target transitively via quickcpplib
+if ("cxx20" IN_LIST FEATURES)
+    list(APPEND extra_config -DCMAKE_CXX_STANDARD=20)
+elseif("cxx17" IN_LIST FEATURES)
+    list(APPEND extra_config -DCMAKE_CXX_STANDARD=17)
+endif()
+
+# quickcpplib parses CMAKE_MSVC_RUNTIME_LIBRARY and cannot support the default crt linkage generator expression from vcpkg
+if(VCPKG_TARGET_IS_WINDOWS)
+    if(VCPKG_CRT_LINKAGE STREQUAL "dynamic")
+        list(APPEND extra_config -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreaded$$<$$<CONFIG:Debug>:Debug>DLL)
+    else()
+        list(APPEND extra_config -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreaded$$<$$<CONFIG:Debug>:Debug>)
+    endif()
+endif()
+
+vcpkg_cmake_configure(
+    SOURCE_PATH "${SOURCE_PATH}"
+    OPTIONS
+        -Dllfio_IS_DEPENDENCY=On
+        "-DCMAKE_PREFIX_PATH=${CURRENT_INSTALLED_DIR}"
+        ${LLFIO_FEATURE_OPTIONS}
+        -DLLFIO_FORCE_OPENSSL_OFF=ON
+        -DLLFIO_ENABLE_DEPENDENCY_SMOKE_TEST=ON  # Leave this always on to test everything compiles
+        -DCMAKE_DISABLE_FIND_PACKAGE_Git=ON
+        -DCXX_CONCEPTS_FLAGS=
+        -DCXX_COROUTINES_FLAGS=
+        -DCMAKE_POLICY_DEFAULT_CMP0091=NEW # MSVC <filesystem> detection fails without this
+        ${extra_config}
+)
+
+if(VCPKG_LIBRARY_LINKAGE STREQUAL "dynamic")
+    vcpkg_cmake_build(TARGET install.dl)
+elseif(VCPKG_LIBRARY_LINKAGE STREQUAL "static")
+    vcpkg_cmake_build(TARGET install.sl)
+endif()
+
+if("run-tests" IN_LIST FEATURES)
+    vcpkg_cmake_build(TARGET test)
+endif()
+
+vcpkg_cmake_config_fixup(CONFIG_PATH lib/cmake/llfio)
+
+file(REMOVE_RECURSE "${CURRENT_PACKAGES_DIR}/debug/include" "${CURRENT_PACKAGES_DIR}/debug/share")
+
+if("status-code" IN_LIST FEATURES)
+    set(_USAGE_FEATURE "status-code")
+else()
+    set(_USAGE_FEATURE "error-code")
+endif()
+file(INSTALL "${CURRENT_PORT_DIR}/usage-${_USAGE_FEATURE}-${VCPKG_LIBRARY_LINKAGE}" DESTINATION "${CURRENT_PACKAGES_DIR}/share/${PORT}" RENAME usage)
+vcpkg_install_copyright(FILE_LIST "${SOURCE_PATH}/Licence.txt")

tmpl/tools/ports/llfio/usage-error-code-dynamic

@@ -0,0 +1,10 @@
+The package llfio provides two CMake targets:
+
+    find_package(llfio CONFIG REQUIRED)
+
+- If you want the header-only form of LLFIO:
+    find_package(Threads REQUIRED)
+    target_link_libraries(main PUBLIC llfio::hl)
+
+- If you want the shared library form of LLFIO with shared NT kernel error code category:
+    target_link_libraries(main PUBLIC llfio::dl llfio::ntkernel-error-category::dl)

tmpl/tools/ports/llfio/usage-error-code-static

@@ -0,0 +1,10 @@
+The package llfio provides two CMake targets:
+
+    find_package(llfio CONFIG REQUIRED)
+
+- If you want the header-only form of LLFIO:
+    find_package(Threads REQUIRED)
+    target_link_libraries(main PUBLIC llfio::hl)
+
+- If you want the static library form of LLFIO with static NT kernel error code category:
+    target_link_libraries(main PUBLIC llfio::sl llfio::ntkernel-error-category::sl)

tmpl/tools/ports/llfio/usage-status-code-dynamic

@@ -0,0 +1,10 @@
+The package llfio provides two CMake targets:
+
+    find_package(llfio CONFIG REQUIRED)
+
+- If you want the header-only form of LLFIO:
+    find_package(Threads REQUIRED)
+    target_link_libraries(main PUBLIC llfio::hl)
+
+- If you want the shared library form of LLFIO:
+    target_link_libraries(main PUBLIC llfio::dl)

tmpl/tools/ports/llfio/usage-status-code-static

@@ -0,0 +1,10 @@
+The package llfio provides two CMake targets:
+
+    find_package(llfio CONFIG REQUIRED)
+
+- If you want the header-only form of LLFIO:
+    find_package(Threads REQUIRED)
+    target_link_libraries(main PUBLIC llfio::hl)
+
+- If you want the static library form of LLFIO:
+    target_link_libraries(main PUBLIC llfio::sl)