Subversion bindings for Rust

This rust crate provides idiomatic bindings for the Subversion C libraries.

At the moment, it only covers the "client" library but the aim is to support all of the public C API.

Example:

use subversion::client::CheckoutOptions;

let mut ctx = subversion::client::Context::new().unwrap();

ctx.checkout(
    "http://svn.apache.org/repos/asf/subversion/trunk/subversion/libsvn_client",
    std::path::Path::new("libsvn_client"),
    CheckoutOptions {
        peg_revision: Revision::Head,
        revision: Revision::Head,
        depth: Depth::Infinity,
        ..default::Default()
    }
)
.unwrap();

lib.rs:

Rust bindings for the Subversion version control system.

This crate provides idiomatic Rust bindings for the Subversion C libraries, enabling Rust applications to interact with Subversion repositories and working copies.

Overview

The subversion crate provides bindings to Subversion's functionality through several modules, each corresponding to a major component of the Subversion API:

• client - High-level client operations (checkout, commit, update, diff, merge, etc.)
• wc - Working copy management and status operations
• ra - Repository access layer for network operations
• repos - Repository administration (create, load, dump, verify)
• fs - Filesystem layer for direct repository access
• delta - Editor interface for efficient tree transformations

Features

Enable specific functionality via Cargo features:

• client - Client operations
• wc - Working copy management
• ra - Repository access layer
• delta - Delta/editor operations
• repos - Repository administration
• url - URL parsing utilities

Default features: ["ra", "wc", "client", "delta", "repos"]

Error Handling

All operations return a Result<T, Error<'static>> where Error wraps Subversion's error chain. Errors can be inspected for detailed information:

use subversion::client::Context;

let mut ctx = Context::new().unwrap();
match ctx.checkout("https://svn.example.com/repo", "/tmp/wc", None, true) {
    Ok(_) => println!("Checkout succeeded"),
    Err(e) => {
        eprintln!("Error: {}", e.full_message());
        eprintln!("At: {:?}", e.location());
    }
}

Thread Safety

The Subversion libraries are not thread-safe. Each thread should have its own client::Context or other Subversion objects.