debbugs-rs

A Rust client library for the Debian Bug Tracking System (Debbugs).

This crate provides a simple wrapper around the SOAP API for the Debian bug tracking system, allowing you to query bug reports, search for bugs, and retrieve detailed information programmatically.

Features

Async and blocking interfaces: Choose between debbugs::Debbugs (async) and debbugs::blocking::Debbugs (blocking)
Comprehensive bug data: Access bug reports, logs, and metadata
Search functionality: Search bugs by package, status, severity, and more
Mail parsing: Optional mail parsing support with the mailparse feature

Installation

Add this to your Cargo.toml:

[dependencies]
debbugs = "0.1"

Feature Flags

blocking (default): Enables the blocking client interface
tokio (default): Enables the async client interface
mailparse (default): Enables parsing of email messages in bug logs

Usage

Async Interface

use debbugs::Debbugs;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Debbugs::default();
    
    // Get the 10 newest bugs
    let bugs = client.newest_bugs(10).await?;
    println!("Latest bugs: {:?}", bugs);
    
    // Get detailed status for specific bugs
    let reports = client.get_status(&[12345, 67890]).await?;
    for report in reports {
        println!("Bug #{}: {}", report.bugnumber, report.subject);
    }
    
    // Search for bugs in a specific package
    let search = debbugs::SearchQuery {
        package: Some("rust-debbugs".to_string()),
        ..Default::default()
    };
    let found_bugs = client.get_bugs(search).await?;
    println!("Found {} bugs in package", found_bugs.len());
    
    Ok(())
}

Blocking Interface

use debbugs::blocking::Debbugs;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Debbugs::default();
    
    // Get the 10 newest bugs
    let bugs = client.newest_bugs(10)?;
    println!("Latest bugs: {:?}", bugs);
    
    // Get bug logs with messages
    let logs = client.get_bug_log(12345)?;
    for log in logs {
        println!("Message: {}", log.header);
    }
    
    Ok(())
}

Custom Server

use debbugs::Debbugs;

let client = Debbugs::new("https://custom-debbugs.example.com/soap.cgi");

Examples

The repository includes several examples in the examples/ directory:

newest.rs - Fetch the newest bugs
get_status.rs - Get detailed status for specific bugs
get_bugs.rs - Search for bugs matching criteria
get_bug_log.rs - Retrieve bug logs and messages
wnpp_bugs.rs - Find Work-Needing and Prospective Packages (WNPP) bugs
all.rs - Fetch all bugs (use with caution!)

Run an example with:

cargo run --example newest --features tokio

Documentation

License

Licensed under the Apache License, Version 2.0.

debbugs 0.1.9