README.md

wgconfig

wgconfig provides ini config files support.

Create configuration files:

# My cool config

[database]
host = "localhost"
port = 5432
db_name = "my_db"
db_user = "my_user"

[workers_pool]
num_workers = 20 # number of workers
max_workers = 30

[http_client]
http_timeout = 5000
retry_time = 1000
max_retries = 7

Hash symbol # is used for comments. If you need string value which containing hash inside it, you should quote it with single or double quotes.

some_key = "string with # inside it" # comment
other_key = 'another string with # inside it' # comment
next_key = "string with single quote ' inside it"
yet_another_key = 'string with double quote " inside it'

Start app and load config files:

application:start(wgconfig),
wgconfig:load_configs(["path/to/my_config.ini", "path/to/my_other_config.ini"]),

Read values from config:

wgconfig:get_string(database, host), % "localhost"
wgconfig:get_int(database, port, 5432), % 5432
wgconfig:get_binary(database, db_name), % <<"my_db">>
wgconfig:get_binary(database, db_user), % <<"my_user">>

See Unit Tests for more examples.

Reload config and process changes

To reload config files call

wgconfig:reload().

If you need to be notified and process changes create module with gen_event behaviour

-module(my_handler).
-behaviour(gen_event).

-export([init/1, handle_event/2, terminate/2]).

init(_Args) ->
    {ok, []}.

handle_event(Event, State) ->
    {ok, State}.

terminate(_Args, _State) ->
    ok.

subscribe to get notifications

wgconfig:subscribe(my_handler).

and process wgconfig_reload event.

handle_event(wgconfig_reload, State) ->
    %% process this event
    {ok, State}.