Add sourcelink

refs #1

Author: fredemmott

.github/workflows/build.yml

@@ -37,7 +37,8 @@ jobs:
             "-DCMAKE_LIBRARY_OUTPUT_DIRECTORY=$(pwd)/build/output/bin" `
             "-DCMAKE_PDB_OUTPUT_DIRECTORY=$(pwd)/build/output/pdb" `
             -DPROJECT_VERSION_TWEAK=${{github.run_number}} `
-            "-DBUILD_METADATA=gha.${{github.run_number}}"
+            "-DBUILD_METADATA=gha.${{github.run_number}}" `
+            "-DSOURCELINK=https://raw.githubusercontent.com/${{github.repository}}/${{github.sha}}"
       - name: Build
         run: cmake --build build --config ${{matrix.kind}} --parallel
       - name: Upload artifacts

CMakeLists.txt

@@ -3,6 +3,7 @@ cmake_minimum_required(VERSION 3.25..4.2 FATAL_ERROR)
 list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_LIST_DIR}/cmake")
 include(hybrid-crt)
 include(smol-binaries)
+include(sourcelink)
 
 if (NOT PROJECT_VERSION_TWEAK)
   set(PROJECT_VERSION_TWEAK 0)

cmake/sourcelink.cmake

@@ -0,0 +1,24 @@
+set(SOURCELINK "" CACHE STRING "URL to retrieve the source")
+if (NOT SOURCELINK)
+  return()
+endif ()
+
+if (NOT CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
+  message(WARNING "SOURCELINK was specified, but not using MSVC-compatible compiler ID")
+  return()
+endif ()
+
+message(STATUS "Using SOURCELINK: ${SOURCELINK}")
+cmake_path(
+  NATIVE_PATH
+  CMAKE_SOURCE_DIR
+  NORMALIZE
+  NATIVE_SOURCE
+)
+string(REPLACE "\\" "\\\\" NATIVE_SOURCE "${NATIVE_SOURCE}")
+file(
+  WRITE
+  "${CMAKE_CURRENT_BINARY_DIR}/sourcelink.json"
+  "{ \"documents\": { \"${NATIVE_SOURCE}\\\\*\": \"${SOURCELINK}/*\" } }"
+)
+add_link_options("/SOURCELINK:${CMAKE_CURRENT_BINARY_DIR}/sourcelink.json")