sail-rs

The official Rust SDK for Sail. Create and drive sailboxes, sandboxed cloud VMs, from Rust: lifecycle, streaming exec, file transfer, and ingress.

This crate is the canonical core that the Sail Python SDK and the sail CLI are both built on, so the Rust API is the source of truth for behavior.

[dependencies]
sail-rs = "0.1"

The crate is published as sail-rs and imported as sail:

use sail::Client;

Quickstart

The client reads its API key from SAIL_API_KEY (falling back to the credential stored under ~/.sail), the same configuration the CLI uses.

use sail::exec::ExecOptions;
use sail::Client;

#[tokio::main]
async fn main() -> Result<(), sail::error::SailError> {
    let client = Client::from_env()?;

    // List the sailboxes in your org.
    let page = client.list_sailboxes(&Default::default()).await?;
    println!("{} sailboxes", page.items.len());

    // Run a command in one and read its output.
    let proc = client
        .exec(
            "sb_...",
            vec!["echo".to_string(), "hello from the guest".to_string()],
            ExecOptions::default(),
        )
        .await?;
    let result = proc.wait().await?;
    print!("{}", result.stdout);

    Ok(())
}

Runtime

Every method is async. The client is meant to be driven on a Tokio runtime:

Async hosts await the methods directly on their own runtime. Streaming operations (exec, download_file, upload_file) spawn their background pump on the calling task's runtime, so call them from within one.
Synchronous code can drive any method with [sail::block_on], which runs it to completion on a shared internal runtime. Do not call block_on from inside an existing runtime; await the method instead.

[Client] is cheap to clone (it shares its connection pools and config behind an Arc), so clone it to share across tasks. Use one client per runtime.

Sail in other languages

Python: pip install sail-sdk (this crate compiled as a native extension).
CLI: the sail command, built on this crate.

Stability

sail-rs is pre-1.0; minor releases may make breaking changes. Items hidden from this documentation (including the internal module) are used by the first-party bindings and are not part of the public API.

License