Add CMake preset

Author: Anton Pantyukhin

.gitignore

@@ -3,5 +3,13 @@ build*/
 _build*/
 cmake-build*/
 
+# CMake
+CMakeUserPresets.json
+
+# IDEs
+.idea/
+.vs/
+.vscode/
+
 # Mac
 .DS_Store

CMakeLists.txt

@@ -92,7 +92,7 @@ set_target_properties(mylib PROPERTIES
     SOVERSION ${PROJECT_VERSION_MAJOR}
     VERSION ${PROJECT_VERSION})
 
-if(MYLIB_INSTALL)
+if(MYLIB_INSTALL AND NOT CMAKE_SKIP_INSTALL_RULES)
     configure_package_config_file(cmake/mylib-config.cmake.in mylib-config.cmake
         INSTALL_DESTINATION "${MYLIB_INSTALL_CMAKEDIR}")
 

CMakePresets.json

@@ -0,0 +1,38 @@
+{
+  "version": 3,
+  "cmakeMinimumRequired": {
+    "major": 3,
+    "minor": 14,
+    "patch": 0
+  },
+  "configurePresets": [
+    {
+      "name": "dev",
+      "description": "Base preset for library developers",
+      "binaryDir": "${sourceDir}/build",
+      "hidden": true,
+      "cacheVariables": {
+        "MYLIB_BUILD_TESTS": "ON",
+        "MYLIB_BUILD_EXAMPLES": "ON"
+      }
+    },
+    {
+      "name": "dev-win",
+      "description": "Windows preset for library developers",
+      "hidden": false,
+      "inherits": ["dev"],
+      "cacheVariables": {
+        "CMAKE_CXX_FLAGS": "/W4 /EHsc /w14242 /w14254 /w14263 /w14265 /w14287 /w14289 /w14296 /w14311 /w14545 /w14546 /w14547 /w14549 /w14555 /w14640 /w14826 /w14928 /WX"
+      }
+    },
+    {
+      "name": "dev-linux",
+      "description": "Linux preset for library developers",
+      "hidden": false,
+      "inherits": ["dev"],
+      "cacheVariables": {
+        "CMAKE_CXX_FLAGS": "-Wall -Wextra -Wpedantic -Wshadow -Wconversion -Wsign-conversion -Wcast-align -Wcast-qual -Wnull-dereference -Woverloaded-virtual -Wformat=2 -Werror"
+      }
+    }
+  ]
+}

README.md

@@ -1,15 +1,13 @@
 # Overview
 
-Simple template repository to be used as a base for creating C++ libraries built with CMake. This repository provides:
+Template repository to be used as a base for creating C++ libraries built with CMake. This repository provides:
 * Commonly accepted directory layout: `cmake` for CMake utilities and package config, `include/<libname>` for public headers, `src` for library sources and private headers, `examples` and `tests` for library examples and tests correspondingly.
 * `CMakeLists.txt` files thoroughly implemented with the following ideas in mind:
   * user should be able to build library both as subproject (probably fetched with CMake's [FetchContent_MakeAvailable](https://cmake.org/cmake/help/latest/module/FetchContent.html)) and as a stand-alone project
   * user should be able to build examples/tests as part of the library build or as a stand-alone projects
   * multi-configuration CMake generators should be supported
   * package systems (conan, vcpkg and others) should be respected, which means that library `CMakeLists.txt` file should contain only **build requirements**, i.e. should not hardcode any compiler/linker flags unless they are absolutely required to build the library
 * Basic [preset](https://cmake.org/cmake/help/latest/manual/cmake-presets.7.html) file `CMakePresets.json` which is a modern way (since CMake 3.19) for specifying build options (instead of hardcoding them in the `CMakeLists.txt` or setting on the command line)
-* My personal worth trying `.clang-format` for code-style
+* My personal `.clang-format` for code-style worth trying
 
 Note, that I prefer [googletest](https://github.com/google/googletest) as a testing framework so it's the one used in this repository. Still it's not a big deal to replace it with any other of your choice.
-
-See also [cmake-init](https://github.com/friendlyanon/cmake-init) tool which is developed under the same principles as this repository but offers much more: CMake executable/library project generation, integrated support for linter/coverage tools for generated projects, etc.

cmake/utils.cmake

@@ -1,6 +1,8 @@
-# set_if_undefined(<variable> [<value>]...) - set variable if it is not defined
+# set_if_undefined(<variable> [<value>]...)
+#
+# Set variable if it is not defined.
 macro(set_if_undefined variable)
-    if(NOT DEFINED ${variable})
-        set(${variable} ${ARGN})
+    if(NOT DEFINED "${variable}")
+        set("${variable}" ${ARGN})
     endif()
 endmacro()

examples/add/main.cpp

@@ -1,6 +1,6 @@
 #include <mylib/mylib.h>
 
-int main(int argc, char* argv[])
+int main(int, char*[])
 {
     return 0;
 }