runtime config clean

[cboulay]

Clean rebase of #245 by @zeyus

Original PR: #245

Which was itself a redo of #234 but from a dedicated branch and targeting cboulay/apple_framework

On non-desktop platforms, often apps are sandboxed and don't have (read/write) access at all to $HOME, /etc/ or even the current working directory. These paths may not exist.

In addition, environment variables don't necessarily make a lot of sense in the context of a mobile app, and the application data paths might contain GUIDs or other aspects of the path that make it difficult to determine at compile-time.

This PR adds the ability to set a configuration file path for liblsl provided that the static member function lsl_set_config_filename is called before any other LSL function.

In addition, there's also an option to read config directly from a string stream via set_api_config_content which is loaded into the INI and discarded.

[Copilot]

Pull request overview

This PR introduces runtime configuration capabilities for liblsl to support sandboxed environments where traditional file paths may be inaccessible. It enables applications to specify configuration either via direct string content or custom file paths before LSL initialization.

Changes:

• Added two new C API functions (lsl_set_config_filename and lsl_set_config_content) for runtime configuration
• Refactored configuration loading logic to support multiple configuration sources with defined precedence
• Updated documentation to reflect the new configuration priority order

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File	Description
src/common.cpp	Implements the new C API wrapper functions for setting config filename and content
src/api_config.h	Declares new static methods and member variables for runtime config, updates documentation
src/api_config.cpp	Implements configuration loading from content/custom files with proper precedence handling
include/lsl/common.h	Adds public C API declarations for the new configuration functions

Comments suppressed due to low confidence (2)

include/lsl/common.h:1

• The documentation for lsl_set_config_filename contains a sentence fragment. The sentence starting with 'If, and only if...' should be integrated into the previous sentence or rewritten as a complete sentence. Consider: 'This setting only takes effect if this function is called before any other LSL function.'

#pragma once

include/lsl/common.h:1

• The documentation for lsl_set_config_content contains the same sentence fragment as lsl_set_config_filename. The sentence starting with 'If, and only if...' should be integrated into the previous sentence or rewritten as a complete sentence. Consider: 'This setting only takes effect if this function is called before any other LSL function.'

#pragma once

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Inconsistent indentation: this line uses spaces instead of tabs like the surrounding code. The function should be indented with a single tab to match the style of other methods in this class.

Suggested change

	static void set_api_config_content(const std::string &content) {
	api_config_content_ = content;
	}
	static void set_api_config_content(const std::string &content) {
	api_config_content_ = content;
	}

[cboulay]

Comparison with PR #152

There's an older PR #152 by @tstenner that also attempted to make the config runtime-configurable. Here's how the two approaches differ:

PR #152 (tstenner) - Architectural Refactor

• Refactors the entire config system with cleaner architecture
• Callback-based INI parser instead of map-based
• Adds set_option(section, key, value) method for per-option configuration
• Default values moved to member initializers
• Constructor takes bool skip_load_settings for testing
• No new C API functions yet - internal only

PR #245 (zeyus) - Minimal Feature Addition

• Minimal changes - adds two C API functions
• Static members store config before singleton initialization
• Targeted at sandboxed platforms (iOS/Android) that can't use env vars

  // New C API functions
  extern LIBLSL_C_API void lsl_set_config_filename(const char *filename);
  extern LIBLSL_C_API void lsl_set_config_content(const char *content);

Summary

Aspect	PR #152	PR #245
Scope	Large refactor	Minimal addition
C API	Not exposed yet	Two new functions
Flexibility	Set individual options	Set file path or full content
Use case	General runtime config	Sandboxed platforms
Architecture	Cleaner, callback-based	Simple static strings
Merge difficulty	High (stale, touches many areas)	Low (small diff, but branch has conflicts)

PR #245's approach is simpler and addresses the immediate need for sandboxed platforms. PR #152's set_option() could be added later as an enhancement.

I'm planning to cherry-pick the relevant commits from this PR onto a clean branch to resolve the merge conflicts. Credit will be preserved via git history.