chore: Add enough files to begin with the project

Author: tan-wei

.env.sample

@@ -0,0 +1 @@
+LEETCODE_COOKIE=

CMakeLists.txt

@@ -11,6 +11,18 @@ include(cmake/defaults.cmake)
 include(FindThreads)
 include(CTest)
 
+# Ensure tests are built by default so files under src/solution/ are compiled
+# unless the user explicitly disables BUILD_TESTING in the cache.
+if(NOT DEFINED BUILD_TESTING)
+  set(BUILD_TESTING
+      ON
+      CACHE BOOL "Build tests" FORCE)
+endif()
+
+# Find CURL provided by Conan or system
+find_package(CURL REQUIRED)
+find_package(nlohmann_json CONFIG REQUIRED)
+
 add_library(warnings INTERFACE)
 set_target_warnings(warnings)
 
@@ -20,16 +32,76 @@ enable_sanitizers(options)
 enable_hardenings(options)
 enable_coverage(options)
 
-# put platform-agnostic code here
-add_subdirectory(lib)
+# Top-level executable (from CMakeLists-ref.txt)
+add_executable(leetcode_cpp src/main.cpp src/fetcher.cpp)
+target_include_directories(leetcode_cpp PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/src)
+target_link_libraries(
+  leetcode_cpp PRIVATE CURL::libcurl nlohmann_json::nlohmann_json warnings
+                       options)
 
-# put platform-specific code here and guard it with an option to exclude it from
-# build when building unit tests (e.g. you develop an embedded firmware)
-if(CMAKE_CROSSCOMPILING OR TRUE)
-  add_subdirectory(src)
+# Add a convenient run target so callers can invoke `cmake --build --target
+# run_leetcode_cpp`
+if(TARGET leetcode_cpp)
+  add_custom_target(
+    run_leetcode_cpp
+    COMMAND ${CMAKE_COMMAND} -E echo "Running leetcode_cpp..."
+    COMMAND $<TARGET_FILE:leetcode_cpp>
+    DEPENDS leetcode_cpp
+    WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR})
 endif()
 
 # put unit tests that run on your pc here
 if(NOT CMAKE_CROSSCOMPILING AND BUILD_TESTING)
-  add_subdirectory(test)
+  # Tests target: compile all src/solution/*.cpp into a test executable and link
+  # gtest Use CONFIGURE_DEPENDS so CMake will re-run configure when files are
+  # added/removed
+  enable_testing()
+  file(GLOB_RECURSE SOLUTION_SRC CONFIGURE_DEPENDS
+       "${CMAKE_CURRENT_SOURCE_DIR}/src/solution/*.cpp")
+  if(SOLUTION_SRC)
+    # Ensure GTest is available (from Conan or system)
+    find_package(GTest REQUIRED)
+    add_executable(leetcode_tests ${SOLUTION_SRC})
+    target_include_directories(leetcode_tests
+                               PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/src)
+    target_compile_definitions(leetcode_tests PRIVATE ENABLE_GTEST=1)
+    target_link_libraries(leetcode_tests PRIVATE GTest::gtest_main
+                                                 CURL::libcurl)
+    # Register individual GoogleTest cases with CTest so each gtest is reported
+    # as a separate test (gtest_discover_tests requires the GoogleTest CMake
+    # module)
+    include(GoogleTest)
+    gtest_discover_tests(leetcode_tests)
+  else()
+    message(
+      WARNING
+        "No solution sources found in src/solution; skipping leetcode_tests target"
+    )
+  endif()
+
+  # Optional: build and run a single solution via -DSOLUTION=<filename without
+  # .cpp>
+  set(SOLUTION
+      ""
+      CACHE STRING
+            "Solution file basename in src/solution (e.g. s0001_two_sum)")
+  if(SOLUTION)
+    set(SOLUTION_SRC "${CMAKE_CURRENT_SOURCE_DIR}/src/solution/${SOLUTION}.cpp")
+    if(EXISTS ${SOLUTION_SRC})
+      add_executable(run_solution_exec
+                     ${SOLUTION_SRC} ${CMAKE_CURRENT_SOURCE_DIR}/src/runner.cpp)
+      target_include_directories(run_solution_exec
+                                 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/src)
+      add_custom_target(
+        run_solution
+        COMMAND $<TARGET_FILE:run_solution_exec>
+        DEPENDS run_solution_exec
+        WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR})
+    else()
+      message(
+        WARNING
+          "SOLUTION ${SOLUTION_SRC} not found; run_solution target will not be created"
+      )
+    endif()
+  endif()
 endif()

conanfile.py

@@ -7,9 +7,15 @@ class Example(ConanFile):
     settings = "os", "arch", "compiler", "build_type"
     languages = "C", "C++"
     options = {
-        "fPIC": [True, False]
+        "fPIC": [True, False],
+    }
+    default_options = {
+        "fPIC": True,
+        "libcurl/*:with_brotli": True,
+        "libcurl/*:with_zstd": True,
+        "libcurl/*:with_zlib": True,
+        "libcurl/*:with_openssl": True,
     }
-    default_options = {"fPIC": True}
 
     def layout(self):
         cmake_layout(self)
@@ -19,9 +25,9 @@ def config_options(self):
             del self.options.fPIC
 
     def requirements(self):
-        self.requires("fmt/12.0.0")
-        if not self.conf.get("tools.build:skip_test"):
-            self.requires("gtest/1.17.0")
+        self.requires("nlohmann_json/3.12.0")
+        self.requires("libcurl/8.18.0")
+        self.requires("gtest/1.17.0")
 
     def generate(self):
         deps = CMakeDeps(self)

justfile

@@ -0,0 +1,110 @@
+set shell := ["bash", "-eu", "-o", "pipefail", "-c"]
+
+# Defaults (edit as needed)
+build_type := "Debug" # choices: "Debug" "Release" "RelWithDebInfo" "MinSizeRel"
+preset := "conan-debug" # choices: "conan-debug" "conan-release"
+profile := "conan/clang21" # choices: "conan/gcc15" "conan/clang21" "conan/default"
+generator := "Ninja" # choices: "Ninja" "Unix Makefiles"
+CC := "clang" # choices: "gcc" "clang"
+CXX := "clang++" # choices: "g++" "clang++"
+skip_test := "False" # choices: "True" "False"
+cache_option := "ccache" # choices: "ccache" "sccache" "none"
+enable_cppcheck := "False" # choices: "True" "False"
+enable_clang_tidy := "False" # choices: "True" "False"
+enable_coverage := "False" # choices: "True" "False"
+run_binary := "leetcode_cpp" # executable name produced by the build
+
+# Show available recipes
+help:
+	@just --list
+
+# Setup virtual environment using uv (from README)
+venv:
+	uv venv
+
+sync:
+	uv sync
+
+pre-commit-install:
+	uv run pre-commit install
+
+conan-profile-detect:
+	# idempotent: only run detect if the default profile file does not already exist
+	if [ -f "$HOME/.conan2/profiles/default" ]; then echo "Conan profile 'default' exists -- skipping"; else uv run conan profile detect; fi
+
+# One-shot setup: run venv, sync, pre-commit install and conan profile detect
+setup: venv sync pre-commit-install conan-profile-detect
+	@echo "Setup finished. To activate the virtualenv run: source .venv/bin/activate"
+
+# Install dependencies via Conan (edit variables above before running)
+conan-install:
+	uv run conan install -pr:a default \
+	  -pr:h {{profile}} \
+	  -c:a tools.cmake.cmaketoolchain:generator={{generator}} \
+	  -c:h tools.build:compiler_executables='{"c": "{{CC}}", "cpp": "{{CXX}}"}' \
+	  -c:h tools.build:skip_test={{skip_test}} \
+	  -s:h build_type={{build_type}} -b missing .
+
+# Activate virtualenv (prints instruction because sourcing won't persist)
+activate:
+	@echo "Run: source .venv/bin/activate"
+
+# Configure project using CMake presets (adjust -D flags as needed)
+configure:
+	uv run cmake --preset {{preset}} \
+	  -D ENABLE_CPPCHECK={{enable_cppcheck}} \
+	  -D ENABLE_CLANG_TIDY={{enable_clang_tidy}} \
+	  -D ENABLE_IPO=OFF \
+	  -D ENABLE_CACHE=OFF \
+	  -D CACHE_OPTION={{cache_option}} \
+	  -D ENABLE_COVERAGE={{enable_coverage}} \
+	  -D ENABLE_HARDENINGS=OFF \
+	  -D ENABLE_FORTIFY_SOURCE=OFF \
+	  -D ENABLE_ASAN=OFF \
+	  -D ENABLE_LSAN=OFF \
+	  -D ENABLE_UBSAN=OFF \
+	  -D ENABLE_TSAN=OFF
+
+# Build and test
+build:
+	uv run cmake --build --preset {{preset}}
+
+test:
+	uv run ctest --preset {{preset}}
+
+# Run the compiled leetcode_cpp executable. Depends on `build` so the binary
+# is up-to-date. Override `run_binary` or `build_type` locally if needed.
+run: build
+	uv run ./build/{{build_type}}/{{run_binary}} ${RUN_ARGS:-}
+
+# Cleaning targets
+# - `clean-setup`: remove setup artifacts (virtualenv, pre-commit hooks)
+# - `clean-build`: remove build artifacts
+# - `clean-all`: remove both setup and build artifacts
+# Keep `clean` as an alias to `clean-build` for backwards compatibility.
+clean-setup:
+	# If a virtualenv exists, attempt to uninstall pre-commit (without creating a venv), then remove it
+	if [ -d .venv ]; then if [ -x .venv/bin/pre-commit ]; then .venv/bin/pre-commit uninstall || true; elif command -v uv >/dev/null 2>&1; then uv run pre-commit uninstall || true; fi; fi; rm -rf .venv/ || true
+
+clean-build:
+	# Remove common build directories and artifacts
+	for d in build "{{build_type}}" Debug Release "build/{{build_type}}" build/Debug build/Release build/bin; do if [ -d "$d" ]; then rm -rf "$d" || true; fi; done
+	# remove CMake-generated files in project root if present
+	rm -f CMakeCache.txt cmake_install.cmake compile_commands.json CMakeUserPresets.json CMakeSettings.json || true
+
+clean-all: clean-setup clean-build
+
+clean: clean-build
+
+# Collect coverage (use appropriate gcov value for your toolchain)
+coverage:
+	GCOV="gcov" uv run gcovr
+
+# Format C/C++ sources under src/ using clang-format
+fmt:
+	if ! command -v clang-format >/dev/null 2>&1; then echo "clang-format not found; install clang-format to use just fmt"; exit 2; fi
+	find src -type f \( -name '*.cpp' -o -name '*.cc' -o -name '*.cxx' -o -name '*.h' -o -name '*.hpp' \) -print0 | xargs -0 clang-format -i
+	@echo "Formatted C/C++ sources under src/"
+
+# Default task
+default: help