xdcc-search

A library for querying XDCC file distribution engines, such as sunxdcc.com.

This crate provides a lightweight, asynchronous interface to search XDCC bots and retrieve pack metadata. It parses and normalizes the response into structured Rust types.

Features

• 🚀 Asynchronous search using reqwest
• 📦 Typed Entry results with filename, size, bot info, etc.
• 🛠 Error handling for malformed data
• 🔌 Extensible design: future support for multiple XDCC engines

Example

use xdcc_search::sunxdcc::Engine;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let engine = Engine::default();
    let results = engine.search("ubuntu", 1).await?;

    for entry in results {
        println!(
            "Pack #{} from {} on {}: {} ({} bytes, {} downloads)",
            entry.packnum,
            entry.bot_name,
            entry.network,
            entry.filename,
            entry.filesize,
            entry.downloads
        );
    }

    Ok(())
}

Crate Organization

• sunxdcc: Implementation of the search engine for sunxdcc.com.
• lib.rs: Re-exports sunxdcc and acts as an integration point for future engines.

Installation

Add this to your Cargo.toml:

[dependencies]
xdcc-search = "0.1.0"

Note: Replace "0.1.0" with the actual version when publishing to crates.io.

Roadmap

• ✅ SunXDCC support
• 🔜 Add trait-based abstraction for other engines
• 🔍 Support filtering, sorting, or ranking results
• 🧪 Add unit tests and fuzzing for decoders

License

MIT OR Apache-2.0

This project is not affiliated with sunxdcc.com or any XDCC indexing service. Use responsibly.