CMake & Submodules Integration¶

CosmosClient provides an INTERFACE library target cosmoscl::cosmoscl requiring C++23.

Using CPM (Recommended)¶

CPM.cmake is a cross-platform CMake dependency manager.

# Add CPM.cmake to your CMake setup
include(path/to/CPM.cmake)

# Pull CosmosClient directly from GitHub
CPMAddPackage("gh:SiddiqSoft/CosmosClient#3.2.0")

# Link to target
target_link_libraries(your_target PRIVATE cosmoscl::cosmoscl)

Using FetchContent¶

Standard CMake 3.14+ FetchContent:

include(FetchContent)

FetchContent_Declare(
    CosmosClient
    GIT_REPOSITORY https://github.com/SiddiqSoft/CosmosClient.git
    GIT_TAG        v3.2.0
)

FetchContent_MakeAvailable(CosmosClient)

target_link_libraries(your_target PRIVATE cosmoscl::cosmoscl)

Using Git Submodules¶

If you vendor dependencies into 3rdparty/:

git submodule add https://github.com/SiddiqSoft/CosmosClient.git 3rdparty/CosmosClient
git submodule update --init --recursive

In CMakeLists.txt:

add_subdirectory(3rdparty/CosmosClient)
target_link_libraries(your_target PRIVATE cosmoscl::cosmoscl)

CMake Build Options & Debug Tracing¶

CosmosClient relies on restcl for HTTP transport. You can enable HTTP request/response payload tracing by configuring the restcl_DEBUG_TRACE option:

# Enable HTTP payload debug tracing in CMake
set(restcl_DEBUG_TRACE ON CACHE BOOL "" FORCE)

Or configure via the command line:

cmake -B build -Drestcl_DEBUG_TRACE=ON

Options Matrix¶

Option	Default	Description
`cosmoscl_BUILD_TESTS`	`OFF`	Build unit and integration test suite (`BUILD_TESTS`).
`restcl_DEBUG_TRACE`	`OFF`	Enable verbose HTTP header and payload trace logging to `std::cerr`.