mirror of
https://github.com/mbierlee/mirage-config.git
synced 2024-11-15 04:44:01 +01:00
62 lines
1.7 KiB
Markdown
62 lines
1.7 KiB
Markdown
# Mirage Config
|
|
|
|
Version 0.0.0
|
|
Copyright 2022 Mike Bierlee
|
|
Licensed under the terms of the MIT license - See [LICENSE.txt](LICENSE.txt)
|
|
|
|
Toolkit for loading and using application configuration from various formats.
|
|
|
|
Features:
|
|
|
|
- Load from various file formats such as JSON and Java properties;
|
|
- Environment variable substitution;
|
|
- Internal configuration substitution (Value in config replaced by other path in config);
|
|
- Parse configuration from string or JSONValue instead of from disk.
|
|
|
|
TODO: add tutorial on:
|
|
|
|
- Config loading
|
|
- Config parsing
|
|
- Config manip
|
|
- Env and config var substitution
|
|
-- Escaping
|
|
|
|
## Getting started
|
|
### DUB Dependency
|
|
See the [DUB project page](https://code.dlang.org/packages/mirage-config) for instructions on how to include Mirage Config into your project.
|
|
|
|
### Quickstart
|
|
```d
|
|
import std.stdio : writeln;
|
|
import mirage : loadConfig, parseJavaProperties;
|
|
|
|
void main() {
|
|
// Load configuration from file (see examples/quickstart/config.json):
|
|
auto config = loadConfig("config.json");
|
|
writeln(config.get("application.name"));
|
|
writeln(config.get!long("application.version"));
|
|
|
|
// Or parse directly from string:
|
|
auto properties = parseJavaProperties("
|
|
databaseDriver = Postgres
|
|
database.host = localhost
|
|
database.port = 5432
|
|
");
|
|
|
|
auto databaseConfig = properties.getConfig("database");
|
|
|
|
writeln(properties.get("databaseDriver"));
|
|
writeln(databaseConfig.get("host"));
|
|
writeln(databaseConfig.get("port"));
|
|
}
|
|
```
|
|
|
|
More formats are available (see [Formats](#formats)).
|
|
For more details and examples, see the [examples](examples) directory.
|
|
|
|
## Formats
|
|
|
|
## History
|
|
|
|
For a full overview of changes, see [CHANGES.md](CHANGES.md)
|