Warning This SDK is experimental. Please do not use it for anything mission-critical. Possible issues include:

• Missing features
• Stability issues
• Performance issues
• Lack of polish
• Upcoming breaking changes
• Incomplete or out-of-date documentation

Please report any issues you encounter. We appreciate and encourage contributions. If you are a Rust developer interested in contributing to this SDK, we welcome you!

Dagger Rust SDK

Plan for next release

• Introduce thiserror for better errors
• Add compatibility with dagger run
• Add open telemetry tracing to the sdk
• Remove id().await? from passing to other dagger graphs, this should make the design much cleaner
• Update to newest upstream release
• Fix bugs
  • Run in conjunction with golang and other sdks
  • Stabilize the initial Arc<Query> model into something more extensible

Examples

See examples.

Run them like so:

cargo run --example first-pipeline

The examples match the folder name in each directory in examples.

Install

Simply install like:

cargo add dagger-sdk

Usage

#[tokio::main]
async fn main() -> eyre::Result<()> {
    dagger_sdk::connect(|client| async move {
        let version = client
            .container()
            .from("golang:1.19")
            .with_exec(vec!["go", "version"])
            .stdout()
            .await?;

        println!("Hello from Dagger and {}", version.trim());
        Ok(())
    })
    .await?;

    Ok(())
}

And run it like a normal application:

cargo run

Contributing

See CONTRIBUTING

or just cargo make codegen