ConfigLoader | SignalWire

ConfigLoader loads JSON configuration files and substitutes environment variables using ${VAR|default} syntax. It is used internally by SecurityConfig and the mcp-gateway service, and can be used directly for custom configuration needs.

from signalwire.core.config_loader import ConfigLoader

Properties

config_paths

list[str]

List of file paths checked during initialization. The first existing file is loaded.

Methods

find_config_file

Static method to locate a config file without loading it.

get

Get a configuration value by dot-notation path.

get_config

Get the raw configuration dictionary before environment variable substitution.

get_config_file

Get the path of the loaded config file.

get_section

Get an entire configuration section with environment variables substituted.

has_config

Check whether a configuration file was successfully loaded.

merge_with_env

Merge configuration with environment variables matching a prefix.

substitute_vars

Recursively substitute environment variables in configuration values.

Example

from signalwire.core.config_loader import ConfigLoader
# Auto-discover config file
loader = ConfigLoader()
print(f"Config loaded: {loader.has_config()}")
# Explicit config file path
loader = ConfigLoader(["./my-config.json", "/etc/myapp/config.json"])
print(f"Config file: {loader.get_config_file()}")