#configuration #http #derive

macro choices-derive

HTTP configuration service by defining a struct, derive crate

6 releases (1 stable)

1.0.0 May 26, 2022
0.4.0 May 8, 2021
0.3.0 Feb 27, 2021
0.2.0 Feb 18, 2021
0.1.1 Feb 11, 2021

#510 in #config


Used in choices

MIT license

34KB
799 lines

choices

works badge Released API docs License: MIT

Do you like structops and clap? Do you write microservices? Continue reading!

choices is a library that lets you expose your application's configuration over HTTP with a simple struct!

Look, it's easy

Given the following code:

use choices::Choices;
use lazy_static::lazy_static;
use std::sync::{Arc, Mutex};

#[derive(Choices)]
struct Config {
    debug: bool,
    id: Option<i32>,
    log_file: String,
}

lazy_static! {
    static ref CONFIG: Arc<Mutex<Config>> = {
        Arc::new(Mutex::new(Config {
            debug: false,
            id: Some(3),
            log_file: "log.txt".to_string()
        }))
    };
}

#[tokio::main]
async fn main() {
    CONFIG.run((std::net::Ipv4Addr::LOCALHOST, 8081)).await;
}

You can see all configuration fields at localhost:8081/config and the individual fields' values at localhost:8081/config/<field name>.
A field's value can be changed with a PUT, for instance curl -X PUT localhost:8081/config/debug -d "true".

More examples in examples.

Also check out the documentation.

Features

  • show all configuration fields
  • GET configuration field
  • PUT configuration field
  • user defined types
  • JSON support
  • custom validators
  • on set callbacks

Thanks

Special thanks to the authors of structops. It served as an inspiration to learn procedural macros.


lib.rs:

Proc macros for the choices crate.

Dependencies

~1.2–1.6MB
~38K SLoC