9 unstable releases (3 breaking)
new 0.4.0 | Jan 20, 2025 |
---|---|
0.3.5 | Nov 13, 2024 |
0.3.4 | Oct 5, 2024 |
0.3.3 | Sep 20, 2024 |
0.1.0 | Jun 28, 2024 |
#124 in Configuration
1,438 downloads per month
Used in 9 crates
(3 directly)
135KB
3K
SLoC
rpkl
Language bindings to Pkl for Rust.
Requires the pkl binary to be available on your path. You can install pkl for your os using the steps from their docs: https://pkl-lang.org/main/current/pkl-cli/index.html#installation
Usage
ip = "127.0.0.1"
database {
username = "admin"
password = "secret"
}
#[derive(Deserialize)]
struct Config {
ip: String,
database: Database,
}
#[derive(Deserialize)]
struct Database {
username: String,
password: String,
}
let config: Config = rpkl::from_config("./config.pkl")?;
Evaluator Options
You can pass options to the evaluator, such as properties, by using from_config_with_options
.
username = read("prop:username")
password = read("prop:password")
let options = EvaluatorOptions::default()
.properties([("username", "root"), ("password", "password123")]);
let config: Config = rpkl::from_config_with_options("./config.pkl", Some(options))?;
Codegen
Mostly works, but still a WIP. If you want to try it out, you can enable the codegen
feature.
let mut evaluator = rpkl::evaluator::Evaluator::new()?;
let pkl_mod = evaluator.evaluate_module(PathBuf::from("./config.pkl"))?;
pkl_mod.codegen()?;
Dependencies
~0.8–7MB
~52K SLoC