This repository has been archived on 2024-07-25. You can view files and clone it, but cannot push or open issues or pull requests.
enve/README.md

71 lines
1.8 KiB
Markdown
Raw Normal View History

2019-12-23 15:24:36 +03:00
# itconfig
2019-12-26 06:31:06 +03:00
[![Build Status](https://travis-ci.org/icetemple/itconfig-rs.svg?branch=master)](https://travis-ci.org/icetemple/itconfig-rs)
2019-12-25 11:16:31 +03:00
[![Documentation](https://docs.rs/itconfig/badge.svg)](https://docs.rs/itconfig)
2019-12-28 23:50:08 +03:00
[![Crates.io](https://img.shields.io/badge/crates.io-v0.5.0-orange.svg?longCache=true)](https://crates.io/crates/itconfig) [![Join the chat at https://gitter.im/icetemple/itconfig-rs](https://badges.gitter.im/icetemple/itconfig-rs.svg)](https://gitter.im/icetemple/itconfig-rs?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
2019-12-24 19:37:55 +03:00
2019-12-23 15:24:36 +03:00
Easy build a configs from environment variables and use it in globally.
We recommend you start with the [documentation].
## Example usage
```rust
#[macro_use] extern crate itconfig;
use std::env;
//use dotenv::dotenv;
2019-12-23 15:24:36 +03:00
config! {
2019-12-24 19:37:55 +03:00
DEBUG: bool => true,
2019-12-23 15:24:36 +03:00
HOST: String => "127.0.0.1".to_string(),
2019-12-25 11:03:33 +03:00
NAMESPACE {
#[env_name = "MY_CUSTOM_NAME"]
FOO: bool,
2019-12-25 11:03:33 +03:00
BAR: i32 => 10,
2019-12-27 23:57:13 +03:00
#[cfg(feature = "feature")]
#[env_name = "POSTGRES_CONNECTION_STRING"]
DATABASE_URL: String
2019-12-25 11:03:33 +03:00
}
2019-12-23 15:24:36 +03:00
}
fn main () {
// dotenv().ok();
env::set_var("MY_CUSTOM_NAME", "t");
2019-12-23 15:24:36 +03:00
cfg::init();
2019-12-25 11:05:13 +03:00
assert_eq(cfg::HOST(), String::from("127.0.0.1"));
assert_eq(cfg::NAMESPACE::FOO(), true);
2019-12-23 15:24:36 +03:00
}
```
2019-12-24 19:37:55 +03:00
## Running tests
```bash
cargo test
```
## Roadmap
2019-12-25 11:04:13 +03:00
* [x] Add namespace for variables
* [x] Custom env name
2019-12-27 23:57:13 +03:00
* [x] Support feature config and other meta directives
* [ ] Concat env variables to one variable
2019-12-24 19:37:55 +03:00
## License
[MIT] © [Ice Temple](https://github.com/icetemple)
## Contributors
[pleshevskiy](https://github.com/pleshevskiy) (Dmitriy Pleshevskiy) creator, maintainer.
2019-12-23 15:24:36 +03:00
[documentation]: https://docs.rs/itconfig
2019-12-24 19:37:55 +03:00
[MIT]: https://github.com/icetemple/itconfig-rs/blob/master/LICENSE