feat: Add CMakeLists.txt files and helper function for building interface libraries.

.gersemirc

@@ -1,5 +1,6 @@
 # yamllint disable-line rule:line-length
 # yaml-language-server: $schema=https://raw.githubusercontent.com/BlankSpruce/gersemi/master/gersemi/configuration.schema.json
 
+definitions: ["CMake/ystdlib-cpp-helpers.cmake"]
 line_length: 100
 list_expansion: "favour-expansion"

CMake/ystdlib-cpp-helpers.cmake

@@ -0,0 +1,29 @@
+set(CPP_LIB_BUILD_INTERFACE ${YSTDLIB_CPP_BUILD_INCLUDE_DIRS})
+set(CPP_LIB_INSTALL_INTERFACE ${YSTDLIB_CPP_INSTALL_INCLUDE_DIRS})
+
+# cpp_library()
+#
+# CMake function for adding C++ libraries with sources, dependencies, and build settings.
+#
+# Parameters:
+# NAME: name of the library target
+# NAMESPACE: namespace of the library
+function(cpp_library)
+    set(options)
+    set(oneValueArgs
+        NAME
+        NAMESPACE
+    )
+    set(multiValueArgs)
+    cmake_parse_arguments(arg_cpp_lib "${options}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN})
+
+    add_library(${arg_cpp_lib_NAME} INTERFACE)
+    target_include_directories(
+        ${arg_cpp_lib_NAME}
+        INTERFACE
+            "$<BUILD_INTERFACE:${CPP_LIB_BUILD_INTERFACE}>"
+            "$<INSTALL_INTERFACE:${CPP_LIB_INSTALL_INTERFACE}>"
+    )
+    target_compile_features(${arg_cpp_lib_NAME} INTERFACE cxx_std_20)
+    add_library(${arg_cpp_lib_NAMESPACE}::${arg_cpp_lib_NAME} ALIAS ${arg_cpp_lib_NAME})
+endfunction()

CMakeLists.txt

@@ -11,6 +11,20 @@ set(CMAKE_EXPORT_COMPILE_COMMANDS
     FORCE
 )
 
+# Configure include paths for building ystdlib-cpp.
+list(APPEND YSTDLIB_CPP_BUILD_INCLUDE_DIRS ${PROJECT_SOURCE_DIR}/src)
+
+# Configure include paths for projects using ystdlib-cpp.
+list(APPEND YSTDLIB_CPP_INSTALL_INCLUDE_DIRS ${PROJECT_SOURCE_DIR}/src)
+
+# Import CMake helper functions
+list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/CMake)
+include(ystdlib-cpp-helpers)
+
+add_subdirectory(src/ystdlib)
+
+# Test dummy project
 add_executable(dummy)
 target_sources(dummy PRIVATE src/ystdlib/hello.cpp)
+target_link_libraries(dummy PRIVATE ystdlib::hello)
 target_compile_features(dummy PRIVATE cxx_std_20)

src/ystdlib/CMakeLists.txt

@@ -0,0 +1 @@
+add_subdirectory(hello)

src/ystdlib/hello.cpp

@@ -1,6 +1,7 @@
 #include <iostream>
+#include <ystdlib/hello/hello.hpp>
 
 [[nodiscard]] auto main() -> int {
-    std::cout << "Hello, world!" << '\n';
+    std::cout << ystdlib::hello() << '\n';
     return 0;
 }

src/ystdlib/hello/CMakeLists.txt

@@ -0,0 +1 @@
+cpp_library(NAME hello NAMESPACE ystdlib)

src/ystdlib/hello/hello.hpp

@@ -0,0 +1,12 @@
+#ifndef YSTDLIB_ARRAY_HPP
+#define YSTDLIB_ARRAY_HPP
+
+#include <string>
+
+namespace ystdlib {
+[[nodiscard]] inline auto hello() -> std::string {
+    return "Hello, world!";
+}
+}  // namespace ystdlib
+
+#endif  // YSTDLIB_ARRAY_HPP

taskfiles/lint-cmake.yaml

@@ -9,7 +9,11 @@ tasks:
       - "{{.ROOT_DIR}}/**/*.cmake.in"
       - "{{.ROOT_DIR}}/**/CMakeLists.txt"
       - "{{.TASKFILE}}"
+      - "{{.ROOT_DIR}}/.gersemirc"
+      - "{{.G_YSTDLIB_CPP_SRC_DIR}}/.gersemirc"
       - exclude: "{{.ROOT_DIR}}/**/build/*"
+      - exclude: "{{.ROOT_DIR}}/**/cmake_install.cmake"
+      - exclude: "{{.ROOT_DIR}}/**/CMakeFiles/*"
       - exclude: "{{.ROOT_DIR}}/**/submodules/*"
       - exclude: "{{.ROOT_DIR}}/**/tools/*"
     deps:
@@ -44,7 +48,8 @@ tasks:
       - |-
         . "{{.G_LINT_VENV_DIR}}/bin/activate"
         find . \
-          \( -path '**/build' -o -path '**/submodules' -o -path '**/tools' \) -prune -o \
+          \( -path '**/build' -o -path '**/cmake_install.cmake' -o -path '**/CMakeFiles' \
+          -o -path '**/submodules' -o -path '**/tools' \) -prune -o \
           \( -iname "CMakeLists.txt" -o -iname "*.cmake" -o -iname "*.cmake.in" \) \
           -print0 | \
             xargs -0 gersemi {{.FLAGS}}