scapix-com/cmodule

Non-intrusive CMake dependency management

cmodule

🇺🇦 If you like this project, please consider donating to one of the funds helping victims of russian aggression against Ukraine: ukraine.ua

Non-intrusive CMake dependency management.

Normally CMake's find_package() looks for packages installed on host system (and compiled for host system). When using cmodule, find_package() downloads packages and compiles them using current CMake toolchain. This allows using C/C++ libraries (like boost) whether you are building for host system or cross-compiling for Android, iOS, WebAssembly, etc.

CMake integration

After initializing cmodule, regular find_package() calls will work in top level CMake project and all subprojects:

include(FetchContent)
FetchContent_Declare(
  cmodule
  URL "https://github.com/scapix-com/cmodule/archive/refs/tags/v2.0.0.tar.gz"
  URL_HASH SHA256=58695a9d73dc95a2c214097729917c7d9c366bf511e162d566cf55dd2b9cd7be
)
FetchContent_MakeAvailable(cmodule)

find_package(Boost REQUIRED COMPONENTS filesystem)
target_link_libraries(mytarget PUBLIC Boost::filesystem)

find_package(Boost REQUIRED COMPONENTS iostreams)
target_link_libraries(mytarget PUBLIC Boost::iostreams)

find_package(ZLIB REQUIRED)
target_link_libraries(mytarget PRIVATE ZLIB::ZLIB)

find_package(BZip2 REQUIRED)
target_link_libraries(mytarget PRIVATE BZip2::BZip2)

find_package(CURL REQUIRED)
target_link_libraries(mytarget PRIVATE CURL::libcurl)

How cmodule differs from other package managers?

Instead of providing compiled binaries, cmodule builds libraries as part of your project build.

This has multiple advantages:

• libraries seamlessly build for any target, including cross-compiling targets (iOS, Android, etc.)
• libraries build using the same settings (compiler options) as the rest of the project
• non intrusive syntax: automatically works for projects with regular find_package() calls
• downloaded and extracted sources are cached by cmodule to speedup builds for different targets and builds of different projects

More info

Documentation
Example

cmodule's Issues

More Info Links in Readme are Broken

Not sure if it's just me but both links under "more info" are broken (404 errors).

Unknown arguments specified

CMakeLists.txt

cmake_minimum_required(VERSION 3.24)
project(mytarget LANGUAGES NONE)

include(FetchContent)
FetchContent_Declare(
  cmodule
  URL "https://github.com/scapix-com/cmodule/archive/refs/tags/v1.0.37.tar.gz"
  URL_HASH SHA256=c2a4df7f824e4460c23be8d1bd3d6aaa3f7b86f8bceae2eb7b78fa47d765c57f
)
FetchContent_MakeAvailable(cmodule)
find_package(CURL REQUIRED)
target_link_libraries(mytarget PRIVATE CURL::libcurl)

mkdir build && cd build/ && cmake ..

CMake Error at build/_deps/cmodule-src/cmake/cmodule.cmake:27 (if):
  if given arguments:

    "STREQUAL" "MSVC"

  Unknown arguments specified
Call Stack (most recent call first):
  build/_deps/cmodule-src/cmake/cmodule.cmake:84 (cmodule_set_local_options)
  build/_deps/cmodule-src/cmake/FindCURL.cmake:6 (cmodule_add)
  CMakeLists.txt:12 (find_package)


-- Configuring incomplete, errors occurred!
See also "/home/bincat/coding/cmake/third_libs_fetch/cmodule/build/CMakeFiles/CMakeOutput.log".

cat /home/bincat/coding/cmake/third_libs_fetch/cmodule/build/CMakeFiles/CMakeOutput.log
The system is: Linux - 5.17.7-gentoo - x86_64