Adding `xdcc_request` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add xdcc-request

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

xdcc-request = "0.1.0"

The xdcc_request library will be automatically available globally. Read the xdcc_request library documentation.

Back to the crate overview.

Readme

xdcc-request

Asynchronous XDCC (X Direct Client-to-Client) request library for Rust.

xdcc-request lets you interact with IRC bots that support XDCC to programmatically request files. It handles IRC connections, nickname generation, and DCC SEND message parsing, all in a clean, async interface.

Features

Connects to IRC servers and joins channels.
Sends XDCC commands to bots.
Parses and extracts DCC SEND responses (filename, IP, port, file size).
Timeout handling and nickname generation included.

Example

# Cargo.toml
[dependencies]
xdcc-request = "0.1"
tokio = { version = "1", features = ["full"] }

use xdcc_request::Engine;

#[tokio::main]
async fn main() {
    let engine = Engine::default();

    let request = engine.create_request(
        "irc.example.net",
        "#channel",
        "BotNick",
        123, // XDCC pack number
    );

    match request.execute().await {
        Ok(response) => {
            println!("Filename: {}", response.filename);
            println!("Address: {}", response.address);
            println!("Port: {}", response.port);
            println!("Filesize: {}", response.filesize);
        }
        Err(e) => eprintln!("XDCC request failed: {:?}", e),
    }
}

Documentation

Full API docs available at docs.rs/xdcc-request

License

MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

Disclaimer

This library is for educational and legal use only. Use responsibly and only on servers and with bots where you have permission to interact.

Adding xdcc_request library as a dependency

Adding `xdcc_request` library as a dependency