discriminat dev and portable variants (#37)

Author: dlipicar

CMakeLists.txt

@@ -6,6 +6,7 @@ include(GNUInstallDirs)
 set(CMAKE_AUTOMOC ON)
 
 option(LOGOS_PACKAGE_MANAGER_USE_VENDOR "Force use of vendored Logos dependencies" OFF)
+option(LGPM_PORTABLE_BUILD "Build for portable variant selection (selects portable LGX variants instead of dev)" OFF)
 
 # Allow override from environment or command line
 if(NOT DEFINED LOGOS_LIBLOGOS_ROOT)
@@ -171,6 +172,11 @@ else()
     add_library(package_manager_plugin SHARED ${PLUGIN_SOURCES})
 endif()
 
+# Propagate portable build flag to plugin library
+if(LGPM_PORTABLE_BUILD)
+    target_compile_definitions(package_manager_plugin PRIVATE LGPM_PORTABLE_BUILD=1)
+endif()
+
 # Set output name without lib prefix
 set_target_properties(package_manager_plugin PROPERTIES
     PREFIX "")

README.md

@@ -3,9 +3,12 @@
 ## Building with Nix (Recommended)
 
 ### Outputs
-- `.#lib`: builds the plugin library (`package_manager_plugin.{dylib|so}`)
+- `.#lib`: builds the plugin library (`package_manager_plugin.{dylib|so}`) — dev build (selects `-dev` LGX variants)
+- `.#lib-portable`: builds the plugin library — portable build (selects portable LGX variants)
 - `.#logos-package-manager-include`: generates C/C++ headers from the built plugin
-- `.#cli`: builds the command-line tool (`lgpm`)
+- `.#cli`: builds the command-line tool (`lgpm`) — dev build
+- `.#cli-portable`: builds the CLI — portable build
+- `.#cli-bundle-dir`: bundled portable CLI (self-contained directory)
 - `.#default`: combined output exposing both `lib/` and `include/`
 
 ### Build the module
@@ -151,6 +154,19 @@ lgpm --release v2.1.0 install waku-module
 lgpm --release v2.1.0 list --json
 ```
 
+## Dev vs Portable Builds
+
+The package manager supports two build modes controlled by the `LGPM_PORTABLE_BUILD` CMake flag:
+
+- **Dev build** (default): Selects LGX variants with `-dev` suffix (e.g., `linux-amd64-dev`). Used in Nix/development environments where libraries resolve from `/nix/store`.
+- **Portable build** (`-DLGPM_PORTABLE_BUILD=ON`): Selects portable LGX variants without suffix (e.g., `linux-amd64`). Used in self-contained distributed applications.
+
+This is a compile-time choice with no fallback — a dev build will reject packages that only contain portable variants, and vice versa.
+
+### Variant File
+
+When a package is installed, a `variant` text file is written to the module's installation subdirectory containing the name of the installed variant (e.g., `linux-amd64-dev`).
+
 ## Dependencies
 
 - [logos-cpp-sdk](https://github.com/logos-co/logos-cpp-sdk) - Logos C++ SDK and code generator

cmd/CMakeLists.txt

@@ -26,6 +26,11 @@ target_link_libraries(lgpm PRIVATE
 # Link lgx library
 target_link_libraries(lgpm PRIVATE ${LGX_LIB})
 
+# Propagate portable build flag to CLI
+if(LGPM_PORTABLE_BUILD)
+    target_compile_definitions(lgpm PRIVATE LGPM_PORTABLE_BUILD=1)
+endif()
+
 # Set output directory
 set_target_properties(lgpm PROPERTIES
     RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin"