33 releases (13 breaking)
0.14.1 | Nov 27, 2024 |
---|---|
0.13.3 | Oct 22, 2024 |
0.13.0 | Jul 19, 2024 |
0.11.0 | Feb 29, 2024 |
0.5.3 | Mar 3, 2023 |
#104 in Math
303 downloads per month
Used in 3 crates
155KB
4K
SLoC
Yggdrasil
Yggdrasil is a Rust project designed to create the core of the Unleash SDK domain logic in a single language. This crate is the Rust logic extracted into a standalone crate so that the logic can be used natively inside a Rust application. This is a very experimental crate, so if you're looking to connect a Rust application to Unleash, you should use the official Rust SDK instead, the API and philosophy here are subject to change until this is in stable.
Using Yggdrasil in a Rust project
The heart of Yggdrasil is the EngineState
struct, this is a lightweight struct that does very little on its own, it's cheap to create but you probably only need/want one of them:
let engine = EngineState::default();
The engine needs to be populated with an Unleash response before it will return anything useful. The shape of the data here should be identical to the response returned by Unleash, if you'd like to handroll your own data, you can check out the format of the ClientFeatures
struct here.
let spec_data = "";// Some json blob, matching the Unleash format
let unleash_data: ClientFeatures = serde_json::from_str(&spec_data).unwrap();
engine.take_state(unleash_data);
Now you can query the engine for a given toggle:
let context = InnerContext::default();
let enabled = engine.is_enabled("my-toggle-name", &context);
//Do something with the enabled state here
Releasing
cargo smart-release -u -b patch unleash-yggdrasil
Dependencies
~6–30MB
~451K SLoC