#unleash #sdk #domain #experimental #extracted #yggdrasil #own

unleash-yggdrasil

This is the Unleash SDK domain logic extracted into a library to facilitate building your own Unleash SDKs in anything, anywhere

26 releases (10 breaking)

0.11.0 Feb 29, 2024
0.9.0 Jan 23, 2024
0.8.0 Nov 13, 2023
0.5.9 Jul 18, 2023
0.5.3 Mar 3, 2023

#1 in #yggdrasil

Download history 23/week @ 2023-12-17 34/week @ 2024-01-14 28/week @ 2024-01-21 14/week @ 2024-02-11 10/week @ 2024-02-18 327/week @ 2024-02-25 25/week @ 2024-03-03 70/week @ 2024-03-10 25/week @ 2024-03-17 2/week @ 2024-03-24 38/week @ 2024-03-31

137 downloads per month
Used in 3 crates

MIT license

145KB
3.5K 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–14MB
~140K SLoC