Yggdrasil

Bindings for the Unleash Yggdrasil SDK core.

This repository contains language bindings for the Unleash Yggdrasil core. The core SDK domain logic lives in that project; this repository packages and exposes it for Java, .NET, Ruby, and Python.

Language-specific build and test instructions live in each binding's README.

Rust FFI

The shared Rust FFI layer can be built and tested from the repository root:

cargo test

To run the client specs, you'll first need to clone them:

git clone --depth 5 --branch v5.1.9 https://github.com/Unleash/client-specification.git client-specification

Language Bindings

Bumping the Yggdrasil Crate

Use the release helper when updating the dependency on the Yggdrasil crate:

./scripts/bump-yggdrasil-core.py 0.21.3 --dry-run
./scripts/bump-yggdrasil-core.py 0.21.3

The script requires the target core version to be greater than the current highest core pin. It updates the Rust core pins, the Java/Python/Ruby/.NET native core metadata, and patch-bumps the Java, Python, Ruby, and .NET package versions.

Releasing Yggdrasil FFI

The FFI release version is read from the version field in yggdrasilffi/Cargo.toml.

Bump the package version in yggdrasilffi/Cargo.toml.
Merge the change to main.
Run the Release FFI and Upload Binaries GitHub Actions workflow.