mesa-dev

Rust SDK for the mesa.dev API — manage repositories, branches, commits, content, diffs, and API keys programmatically.

API Documentation

Installation

cargo add mesa-dev

Quick Start

use mesa_dev::{Mesa, MesaError, models::CreateRepoRequest};

#[tokio::main]
async fn main() -> Result<(), MesaError> {
    let client = Mesa::new("my-api-key");

    // Create a repository
    let repo = client
        .repos("my-org")
        .create(&CreateRepoRequest {
            name: "my-repo".to_owned(),
            default_branch: None,
        })
        .await?;
    println!("Created repo: {}", repo.name);

    // List all branches (automatically paginates)
    let branches = client
        .branches("my-org", "my-repo")
        .list_all()
        .collect()
        .await?;
    println!("Found {} branches", branches.len());

    Ok(())
}

Resources

Paginated endpoints expose a list_all() method that returns a PageStream with lazy cursor-based iteration.

HTTP Backends

The SDK is generic over its HTTP transport via the HttpClient trait.

You can also bring your own backend by implementing HttpClient. See the trait documentation for a full guide.

Retry

All requests are retried with exponential backoff and jitter (up to 3 attempts by default). Retryable conditions: HTTP 429, 5xx responses, timeouts, and connection errors. Retry parameters are configurable via ClientBuilder.

Minimum Supported Rust Version

Rust 1.85+ (edition 2024).

Note: A large part of this documentation was generated with the assistance of an LLM. If you spot inaccuracies, please open an issue.