A configuration is a list of key-value string pairs.
Reading configuration
Using the schema validator conformist it is easy to validate and decode configuration values. Conformist schemas can express a richer set of requirements than static types, which can be used in services to validate configurations at start time.
Validating configuration when starting services can lead to run-time exceptions, but they occur early in the app lifecycle. This minimizes the feedback loop and makes sure, that services start only with valid configuration.
env_files_path contains the path where the env files are kept. It reads the value of ENV_FILES_PATH. If that environment variable is not set, it goes up directories until a .git, .hg, .svn, .bzr or _darcs directory is found. If none of these are found until / is reached, None is returned.
val env_files_path : unit ->string option
read_env_file () reads an .env file from the directory given by env_files_path and returns the key-value pairs as data. If SIHL_ENV is set to test, .env.test is read. Otherwise .env is read. If the file doesn't exist or the directory containing the file can't be found, None is returned.
read schema returns the decoded, statically typed version of configuration t of the schema. This is used in services to declaratively define a valid configuration.
The configuration data t is merged with the environment variable and, if present, an .env file.
It fails with Exception and prints descriptive message of invalid configuration.
val read_string : string ->string option
read_string key returns the configuration value with key if present. The function is memoized, the first call caches the returned value and subsequent calls are fast.
val read_int : string ->int option
read_int key returns the configuration value with key if present. the first call caches the returned value and subsequent calls are fast.
val read_bool : string ->bool option
read_bool key returns the configuration value with key if present. the first call caches the returned value and subsequent calls are fast.
val is_testing : unit -> bool
is_testing () returns true if Sihl is running in a test environment, meaning if tests are executing parts of Sihl.
val is_production : unit -> bool
is_production () returns true if Sihl is running in a production environment.