feat(build): support clangd compile commands (#127)

Author: BrandonPacewic

.gitignore

@@ -6,3 +6,4 @@ __pycache__/
 .vscode/
 /build/
 /out/
+compile_commands.json

Makefile

@@ -7,6 +7,7 @@ BUILD_TESTS      ?= ON        # pass BUILD_TESTS=OFF to skip
 BUILD_BENCH      ?= OFF
 BUILD_TOOLS      ?= OFF
 BUILD_TYPE       ?= Debug     # Release | RelWithDebInfo ...
+COMPILE_COMMANDS ?= ON
 JOBS             ?= $(shell nproc 2>/dev/null || sysctl -n hw.ncpu)
 
 CMAKE_FLAGS = \
@@ -15,13 +16,17 @@ CMAKE_FLAGS = \
   -DBUILD_TESTING=$(BUILD_TESTS) \
   -DBUILD_BENCHMARKS=$(BUILD_BENCH) \
   -DBUILD_TOOLS=$(BUILD_TOOLS) \
+  -DCMAKE_EXPORT_COMPILE_COMMANDS=$(COMPILE_COMMANDS)
 
 .PHONY: build test bench tools \
         format clean distclean help
 
 configure:
 	@mkdir -p "$(BUILD_DIR)"
 	@cmake -S . -B "$(BUILD_DIR)" $(CMAKE_FLAGS)
+ifeq ($(COMPILE_COMMANDS),ON)
+	@ln -sf "$(BUILD_DIR)/compile_commands.json" compile_commands.json
+endif
 
 build: configure
 	@cmake --build "$(BUILD_DIR)" -- -j$(JOBS)
@@ -53,6 +58,9 @@ clean:
 
 distclean:
 	@rm -rf "$(BUILD_DIR)"
+ifeq ($(COMPILE_COMMANDS),ON)
+	@rm -f compile_commands.json
+endif
 
 help:
 	@echo "Targets:"