Raxol.Core.Config.ConfigServer (Raxol Core v2.4.0)

Backward-compatible configuration server.

This module maintains the original API but delegates to the pure functional Raxol.Core.Config module and ETS-backed Raxol.Core.Config.Store.

Migration Note

This module is retained for backward compatibility. New code should use:

Raxol.Core.Config for pure functional operations on config data
Raxol.Core.Config.Store for runtime config access with ETS backing

Architecture Change

Previous: All operations serialized through GenServer mailbox Current: Reads go directly to ETS, writes coordinate through GenServer

This change improves:

Read performance (no mailbox serialization)
Concurrent access (ETS read_concurrency)
Code clarity (pure functions separated from process management)

Summary

Types

config_key()

config_namespace()

config_value()

Functions

child_spec(opts)

get(server \\ __MODULE__, namespace, key, default \\ nil)

Gets configuration value from specified namespace and key.

get_namespace(server \\ __MODULE__, namespace)

Gets entire namespace configuration.

load_from_file(server \\ __MODULE__)

Loads configuration from file system.

reset_namespace(server \\ __MODULE__, namespace)

Resets namespace to default configuration.

save_to_file(server \\ __MODULE__)

Saves configuration to file system.

set(server \\ __MODULE__, namespace, key, value)

Sets configuration value in specified namespace and key.

set_namespace(server \\ __MODULE__, namespace, config)

Sets entire namespace configuration.

start_link(opts \\ [])

Starts the configuration store.

validate(server \\ __MODULE__, namespace)

Validates configuration for specified namespace.

Types

config_key()

@type config_key() :: Raxol.Core.Config.key()

config_namespace()

@type config_namespace() :: Raxol.Core.Config.namespace()

config_value()

@type config_value() :: Raxol.Core.Config.value()

Functions

child_spec(opts)

get(server \\ MODULE, namespace, key, default \\ nil)

@spec get(GenServer.server(), config_namespace(), config_key(), any()) :: any()

Gets configuration value from specified namespace and key.

This is now a direct ETS read - fast and concurrent.

get_namespace(server \\ MODULE, namespace)

@spec get_namespace(GenServer.server(), config_namespace()) :: map()

Gets entire namespace configuration.

Direct ETS read - fast and concurrent.

load_from_file(server \\ MODULE)

@spec load_from_file(GenServer.server()) :: :ok | {:error, any()}

Loads configuration from file system.

reset_namespace(server \\ MODULE, namespace)

@spec reset_namespace(GenServer.server(), config_namespace()) :: :ok

Resets namespace to default configuration.

save_to_file(server \\ MODULE)

@spec save_to_file(GenServer.server()) :: :ok | {:error, any()}

Saves configuration to file system.

set(server \\ MODULE, namespace, key, value)

@spec set(
  GenServer.server(),
  config_namespace(),
  config_key(),
  config_value()
) :: :ok | {:error, any()}

Sets configuration value in specified namespace and key.

set_namespace(server \\ MODULE, namespace, config)

@spec set_namespace(GenServer.server(), config_namespace(), map()) :: :ok

Sets entire namespace configuration.

start_link(opts \\ [])

Starts the configuration store.

Kept for backward compatibility - delegates to Config.Store.

validate(server \\ MODULE, namespace)

@spec validate(GenServer.server(), config_namespace()) :: :ok | {:error, [String.t()]}

Validates configuration for specified namespace.