Skip to main content

Crate tensorlake

Crate tensorlake 

Source
Expand description

§Tensorlake Cloud SDK

A Rust SDK for interacting with Tensorlake Cloud APIs. This SDK provides a high-level, ergonomic interface for managing applications, functions, and execution requests in the Tensorlake Cloud platform.

§Quick Start

use tensorlake::{Sdk, applications::models::ListApplicationsRequest};

async fn example() -> Result<(), Box<dyn std::error::Error>> {
    // Create the SDK client
    let sdk = Sdk::new("https://api.tensorlake.ai", "your-api-key")?;

    // Get the applications client
    let apps_client = sdk.applications();

    // List applications in the default namespace
    let request = ListApplicationsRequest::builder()
        .namespace("default".to_string())
        .build()?;
    apps_client.list(&request).await?;
    Ok(())
}

§Authentication

The SDK uses Bearer token authentication, either a Personal Access Token (PAT) or a Project API key. Provide your token when creating the SDK:

use tensorlake::Sdk;

let sdk = Sdk::new("https://api.tensorlake.ai", "your-token").unwrap();

§Available Clients

§Error Handling

The SDK provides detailed error types for different scenarios:

use tensorlake::{Sdk, applications::models::ListApplicationsRequest};

async fn example() -> Result<(), Box<dyn std::error::Error>> {
    let sdk = Sdk::new("https://api.tensorlake.ai", "your-api-key")?;
    let apps_client = sdk.applications();

    let request = ListApplicationsRequest::builder()
        .namespace("default".to_string())
        .build()?;
    match apps_client.list(&request).await {
        Ok(apps) => println!("Success: {:?}", apps.applications.len()),
        Err(e) => eprintln!("Error: {}", e),
    }
    Ok(())
}

Modules§

applications
Tensorlake Cloud SDK - Applications
artifact_storage
cron
docker_config
Capture Docker configuration and resolve registry credentials for one operation.
error
SDK Error Types
http_transport
HTTP trust policy for shipped SDKs and CLIs.
image_builds
CAS image build operations: start, get, wait and cancel a CAS image build or import as a first-class operation (ADR 0107).
images
Tensorlake Cloud SDK - Images
retry
Retry policy shared by every binding.
sandbox_image_catalog
The merged sandbox-image catalog: one client-side view over the platform sandbox-template registry (legacy .tlsnap images) and the CAS image registry catalog (CAS images), so describe, ls, rm and the SDK lookups behave identically for both families.
sandbox_images
sandbox_templates
sandboxes
secrets
Secret management through the regional Secret Service.
sse
Server-sent events (SSE) response bodies.
usage
Sandbox usage and attributed cost for an organization.

Structs§

Client
HTTP client that interacts with the Tensorlake Cloud API.
ClientBuilder
Builder for creating a Client with a fluent API.
ReadRetryConfig
Retry limits for sandbox metadata reads. All attempts, DNS lookups, body reads and backoff share total_timeout, further capped by request timeout. Long-running operations and response streams do not use this policy.
Sdk
The main entry point for the Tensorlake Cloud SDK.
Traced
Wraps any SDK operation result with the W3C trace_id so callers can correlate the request with its server-side spans in Datadog APM or any other OTEL-compatible backend.

Constants§

SANDBOX_API_URL_ENV
Environment variable that overrides the sandbox API (lifecycle) base URL.

Functions§

resolve_artifact_storage_url
Derive the Artifact Storage Git base URL from the API URL.
resolve_sandbox_lifecycle_url
Derive the sandbox lifecycle base URL from the API URL.
sandbox_api_url_override
The validated TENSORLAKE_SANDBOX_API_URL override, if set and usable.