cleaner / consistency

README.md

@@ -23,6 +23,22 @@ sudo apt-get install cmake cmake-curses-gui g++ ninja-build make ccache
 Random number reference: https://xkcd.com/221
 
 
+# Homework
+
+Create a CMake project that generates a python3 module using nanobind in C++
+
+https://github.com/wjakob/nanobind
+
+https://nanobind.readthedocs.io/en/latest/building.html
+
+The cmake should generate a python module with a name similar to
+
+`my_module.cpython-311-x86_64-linux-gnu.so`
+
+As an example if you're using python3.11
+
+So the following python3 code should work: https://gist.github.com/PhilipDeegan/08984d7243e69e7dd1e244f78a6f0423
+With the following C++ module file: https://gist.github.com/PhilipDeegan/775f4acd668ef46d046714c3d4863287
 
 
 # misc

tut/000/README.md

@@ -1,2 +1,6 @@
 
 ## Create simple executable
+
+Exercise:
+
+Comment out the first line (cmake_minimum_required) and execute `./run.sh`

tut/001/CMakeLists.txt

@@ -4,4 +4,4 @@ project(hello_world)
 
 add_executable(${PROJECT_NAME} main.cpp)
 enable_testing()
-add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR})
+add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME})

tut/001/README.md

@@ -1,2 +1,16 @@
 
 ## Create simple executable and configure it as a test via ctest
+
+Exercise:
+
+Add to run.sh
+
+```
+export CXX=ccg
+```
+
+or to cmake command
+
+```
+-DCMAKE_CXX_COMPILER=ccg
+```

tut/001/run.sh

@@ -2,5 +2,11 @@
 set -e
 CWD="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" && cd $CWD
 
-rm -rf build && mkdir build && cd build && cmake .. && make
+# export CXX=ccg
+
+rm -rf build
+mkdir build
+cd build
+cmake .. # -DCMAKE_CXX_COMPILER=ccg
+make
 ctest -V

tut/002/CMakeLists.txt

@@ -1,5 +1,4 @@
 cmake_minimum_required (VERSION 3.18)
-
 project(hello_library)
 
 set(PROJECT_DIR ${CMAKE_CURRENT_SOURCE_DIR})
@@ -9,9 +8,7 @@ include_directories(${PROJECT_DIR}/inc) # global headers
 add_subdirectory(src)
 
 add_executable(${PROJECT_NAME} main.cpp)
-target_link_libraries(${PROJECT_NAME} project_library)
+target_link_libraries(${PROJECT_NAME} PRIVATE project_library)
 
 enable_testing()
-add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR})
-
-
+add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME})

tut/002/README.md

@@ -1,2 +1,17 @@
 
 ## Create static library and link it to executable
+
+Scope keywords
+
+PRIVATE    - Only used for target
+INTERFACE  - Only used for targets that consume this target
+PUBLIC     - Both
+
+https://cmake.org/cmake/help/latest/command/target_link_libraries.html#command:target_link_libraries
+
+
+Exercise: try add in `src/CMakeLists.txt`
+
+```
+target_compile_definitions(${PROJECT_NAME} PRIVATE ABC=1 INTERFACE XYZ=2)
+```

tut/002/run.sh

@@ -4,6 +4,5 @@ CWD="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" && cd $CWD
 
 rm -rf build
 cmake -B build
-cd build
-cmake --build .
-ctest -V
+cmake --build build -v
+cmake --build build -t test

tut/002/src/CMakeLists.txt

@@ -1,7 +1,6 @@
-project(project_library)
-
+cmake_minimum_required (VERSION 3.18)
 
-set(SOURCE_CPP src.cpp)
-
-add_library(${PROJECT_NAME} STATIC ${SOURCE_CPP} ${SOURCE_INC})
+project(project_library)
 
+add_library(${PROJECT_NAME} STATIC src.cpp)
+# target_compile_definitions(${PROJECT_NAME} PRIVATE ABC=1 INTERFACE XYZ=2)

tut/003/CMakeLists.txt

@@ -8,9 +8,9 @@ include_directories(${PROJECT_DIR}/inc) # global headers
 add_subdirectory(src)
 
 add_executable(${PROJECT_NAME} main.cpp)
-target_link_libraries(${PROJECT_NAME} project_library)
+target_link_libraries(${PROJECT_NAME} PRIVATE project_library)
 
 enable_testing()
-add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR})
+add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME})
 
 

tut/003/src/CMakeLists.txt

@@ -1,7 +1,5 @@
-project(project_library)
-
+cmake_minimum_required (VERSION 3.18)
 
-set(SOURCE_CPP src.cpp)
-
-add_library(${PROJECT_NAME} SHARED ${SOURCE_CPP} ${SOURCE_INC})
+project(project_library)
 
+add_library(${PROJECT_NAME} SHARED src.cpp)

tut/004/CMakeLists.txt

@@ -11,7 +11,7 @@ include_directories(${PROJECT_DIR}/inc) # global headers
 add_subdirectory(src)
 
 add_executable(${PROJECT_NAME} main.cpp)
-target_link_libraries(${PROJECT_NAME} project_library)
+target_link_libraries(${PROJECT_NAME} PRIVATE project_library)
 
 enable_testing()
-add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR})
+add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME})

tut/004/run.sh

@@ -5,7 +5,11 @@ CWD="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" && cd $CWD
 time (
   date
 
-  rm -rf build && mkdir build && cd build && cmake .. -DCMAKE_BUILD_TYPE=Debug && make VERBOSE=1
+  rm -rf build
+  mkdir build
+  cd build
+  cmake .. -DCMAKE_BUILD_TYPE=Debug
+  make VERBOSE=1
   ctest -V
 
 ) 1> >(tee $CWD/.run.sh.out ) 2> >(tee $CWD/.run.sh.err >&2 )

tut/004/src/CMakeLists.txt

@@ -1,6 +1,7 @@
+cmake_minimum_required (VERSION 3.18)
+
 project(project_library)
 
-set(SOURCE_CPP src.cpp)
 
-add_library(${PROJECT_NAME} STATIC ${SOURCE_CPP} ${SOURCE_INC})
+add_library(${PROJECT_NAME} STATIC src.cpp)
 

tut/005/CMakeLists.txt

@@ -11,9 +11,9 @@ include_directories(${PROJECT_DIR}/inc) # global headers
 add_subdirectory(src)
 
 add_executable(${PROJECT_NAME} main.cpp)
-target_link_libraries(${PROJECT_NAME} project_library)
+target_link_libraries(${PROJECT_NAME} PRIVATE project_library)
 
 enable_testing()
-add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR})
+add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME})
 
 

tut/005/run.sh

@@ -5,7 +5,11 @@ CWD="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" && cd $CWD
 time (
   date
 
-  rm -rf build && mkdir build && cd build && cmake .. -DCMAKE_BUILD_TYPE=Release && make VERBOSE=1
+  rm -rf build
+  mkdir build
+  cd build
+  cmake .. -DCMAKE_BUILD_TYPE=Release
+  make VERBOSE=1
   ctest -V
 
 ) 1> >(tee $CWD/.run.sh.out ) 2> >(tee $CWD/.run.sh.err >&2 )

tut/005/src/CMakeLists.txt

@@ -1,7 +1,8 @@
+cmake_minimum_required (VERSION 3.18)
+
 project(project_library)
 
 
-set(SOURCE_CPP src.cpp)
 
-add_library(${PROJECT_NAME} STATIC ${SOURCE_CPP} ${SOURCE_INC})
+add_library(${PROJECT_NAME} STATIC src.cpp)
 

tut/006/CMakeLists.txt

@@ -8,9 +8,9 @@ include_directories(${PROJECT_DIR}/inc) # global headers
 add_subdirectory(src)
 
 add_executable(${PROJECT_NAME} main.cpp)
-target_link_libraries(${PROJECT_NAME} project_library)
+target_link_libraries(${PROJECT_NAME} PRIVATE project_library)
 
 enable_testing()
-add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR})
+add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME})
 
 

tut/006/README.md

@@ -2,3 +2,6 @@
 ## Create release static library and link it to executable with Ninja
 
 Ninja is typically faster than Make
+
+Generators:
+    https://cmake.org/cmake/help/latest/manual/cmake-generators.7.html

tut/006/src/CMakeLists.txt

@@ -1,7 +1,8 @@
+cmake_minimum_required (VERSION 3.18)
+
 project(project_library)
 
 
-set(SOURCE_CPP src.cpp)
 
-add_library(${PROJECT_NAME} STATIC ${SOURCE_CPP} ${SOURCE_INC})
+add_library(${PROJECT_NAME} STATIC src.cpp)
 

tut/007/CMakeLists.txt

@@ -8,9 +8,9 @@ include_directories(${PROJECT_DIR}/inc) # global headers
 add_subdirectory(src)
 
 add_executable(${PROJECT_NAME} main.cpp)
-target_link_libraries(${PROJECT_NAME} project_library)
+target_link_libraries(${PROJECT_NAME} PRIVATE project_library)
 
 enable_testing()
-add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR})
+add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME})
 
 

tut/007/src/CMakeLists.txt

@@ -1,7 +1,7 @@
-project(project_library)
+cmake_minimum_required (VERSION 3.18)
 
+project(project_library)
 
-set(SOURCE_CPP src.cpp)
 
-add_library(${PROJECT_NAME} STATIC ${SOURCE_CPP} ${SOURCE_INC})
+add_library(${PROJECT_NAME} STATIC src.cpp)
 

tut/008/CMakeLists.txt

@@ -10,6 +10,6 @@ endif(BUILD_RELEASE)
 
 enable_testing()
 add_executable(${PROJECT_NAME} main.cpp)
-add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR})
+add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME})
 
 

tut/009/CMakeLists.txt

@@ -14,7 +14,7 @@ set(CMAKE_CXX_STANDARD_REQUIRED ON)
 
 enable_testing()
 add_executable(${PROJECT_NAME} main.cpp)
-add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR})
+add_test(NAME ${PROJECT_NAME} COMMAND ./${PROJECT_NAME})
 
 include(FetchContent)
 
@@ -25,4 +25,4 @@ FetchContent_Declare(
     GIT_REPOSITORY https://github.com/LaboratoryOfPlasmaPhysics/cppdict
 )
 FetchContent_MakeAvailable(cppdict)
-target_link_libraries(${PROJECT_NAME} cppdict)
+target_link_libraries(${PROJECT_NAME} PRIVATE cppdict)

tut_adv/001/CMakeLists.txt

@@ -1,4 +1,4 @@
-cmake_minimum_required (VERSION 3.18)
+cmake_minimum_required (VERSION 3.19)
 
 project(tracer CXX)
 add_executable(${PROJECT_NAME} main.cpp)

tut_adv/001/CMakePresets.json

@@ -0,0 +1,24 @@
+{
+  "version": 3,
+  "cmakeMinimumRequired": {
+    "major": 3,
+    "minor": 19,
+    "patch": 0
+  },
+  "configurePresets": [
+    {
+      "name": "default",
+      "description": "Base preset for library developers",
+      "binaryDir": "${sourceDir}/build"
+    },
+    {
+      "name": "dev-werror",
+      "description": "Linux preset for library developers",
+      "hidden": false,
+      "inherits": "default",
+      "cacheVariables": {
+        "CMAKE_CXX_FLAGS": "-Wall -Wextra -Wpedantic -Wshadow -Wconversion -Wsign-conversion -Wcast-align -Wcast-qual -Wnull-dereference -Woverloaded-virtual -Wformat=2 -Werror"
+      }
+    }
+  ]
+}

tut_adv/001/run.sh

@@ -2,5 +2,9 @@
 set -e
 CWD="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" && cd $CWD
 
-rm -rf build && mkdir build && cd build && cmake .. && make VERBOSE=1
+rm -rf build
+mkdir build
+cd build
+cmake .. # --preset dev-werror
+make VERBOSE=1
 gdb -batch -ex run -ex bt --args ./tracer || true # non-zero exit code expected

tut_adv/002/CMakeLists.txt

@@ -3,8 +3,6 @@ cmake_minimum_required (VERSION 3.18)
 project(optimizations CXX)
 add_executable(${PROJECT_NAME} main.cpp)
 
-# set(CMAKE_BUILD_TYPE "Debug")
-
 add_executable(optimize_O0 main.cpp)
 target_compile_options(optimize_O0 PRIVATE -O0 -g3 -fopt-info-vec)
 target_link_options(optimize_O0 PRIVATE -O0  -g3 )

tut_adv/003/.gitignore

@@ -0,0 +1 @@
+.run.sh.*

tut_adv/003/CMakeLists.txt

@@ -0,0 +1,10 @@
+cmake_minimum_required (VERSION 3.18)
+project(linkage)
+
+SET(CMAKE_SKIP_RPATH FALSE)
+
+add_subdirectory(lib1)
+add_subdirectory(lib2)
+
+add_executable(${PROJECT_NAME} main.cpp)
+target_link_libraries(${PROJECT_NAME} PRIVATE lib2)

tut_adv/003/README.md

@@ -0,0 +1,6 @@
+
+
+# Multi library link chain visibility
+
+Here we will demonstrate how private shared linking works.
+And how it can minimize project configuration complexity

tut_adv/003/lib1/CMakeLists.txt

@@ -0,0 +1,5 @@
+project(lib1)
+
+
+add_library(${PROJECT_NAME} SHARED src/src.cpp inc/lib1.hpp)
+target_include_directories( ${PROJECT_NAME} PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/inc)

tut_adv/003/lib1/inc/lib1.hpp

@@ -0,0 +1,10 @@
+#ifndef _LIB1_NS_INC_HPP_
+#define _LIB1_NS_INC_HPP_
+
+namespace lib1_ns{
+
+void func();
+
+}
+
+#endif /*_LIB1_NS_INC_HPP_*/

tut_adv/003/lib1/src/src.cpp

@@ -0,0 +1,11 @@
+
+#include "lib1.hpp"
+
+#include <iostream>
+
+namespace lib1_ns{
+
+void func(){ std::cout << __FILE__ << " " << __LINE__ << std::endl; }
+
+}
+

tut_adv/003/lib2/CMakeLists.txt

@@ -0,0 +1,7 @@
+project(lib2)
+
+
+add_library(${PROJECT_NAME} SHARED src/src.cpp inc/lib2.hpp)
+target_include_directories( ${PROJECT_NAME} PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/inc)
+
+target_link_libraries(${PROJECT_NAME} PRIVATE lib1)