[Shared] add a custom CMake target to copy compilation DB from build …

…dir to source dir (#1177)

* add a custom cmake target to copy compilation DB from build dir to source dir

see https://clang.llvm.org/docs/JSONCompilationDatabase.html for further details

* gitignore compile_commands.json

.gitignore

@@ -182,6 +182,7 @@ pip-log.txt
 ## clangd
 #############
 .clangd
+compile_commands.json
 
 #############
 ## CLion
@@ -192,4 +193,4 @@ pip-log.txt
 ## CMake Builds
 #############
 [Bb]uild*/
-cmake-build-*
+cmake-build-*

CMakeLists.txt

@@ -96,6 +96,14 @@ endif()
 #=============================================================================
 list(INSERT CMAKE_MODULE_PATH 0 "${CMAKE_SOURCE_DIR}/cmake/Modules")
 
+if(CMAKE_EXPORT_COMPILE_COMMANDS)
+	add_custom_target(
+		copy-compile-commands ALL
+		${CMAKE_COMMAND} -E copy_if_different
+		${CMAKE_BINARY_DIR}/compile_commands.json
+		${CMAKE_CURRENT_LIST_DIR})
+endif()
+
 #=============================================================================
 #
 # Architecture/OS defines