Struct WebSeedClient 

pub struct WebSeedClient { /* private fields */ }

HTTP client for downloading individual BT pieces from a single web-seed URL.

Uses HTTP Range requests (Range: bytes={start}-{end}) to fetch specific byte ranges corresponding to torrent pieces.

Implementations

impl WebSeedClient

pub fn new(base_url: &str) -> Self

Create a new WebSeedClient for the given base URL.

Arguments

• base_url - The root URL for HTTP piece requests

Example

use aria2_core::engine::bt_web_seed::WebSeedClient;
let client = WebSeedClient::new("http://cdn.example.com/torrent/");

pub fn with_shared_stats(base_url: &str, stats: Arc<WebSeedStats>) -> Self

Create a WebSeedClient with shared stats (for aggregated statistics).

pub fn can_request(&self, piece_index: u32) -> bool

Check if a piece can be requested (not already active).

pub fn mark_requesting(&self, piece_index: u32)

Mark a piece as being requested.

pub fn clear_request(&self, piece_index: u32)

Mark a piece as no longer being requested.

pub fn active_request_count(&self) -> usize

Get the number of active requests.

pub fn stats(&self) -> &WebSeedStats

Get reference to the stats.

pub async fn download_piece( &self, piece_index: u32, _piece_length: u64, piece_offset: u64, length: u64, ) -> Result<Vec<u8>, String>

Download a specific piece range via HTTP GET with Range header.

Constructs an HTTP request to fetch bytes [piece_offset, piece_offset+length) from the web-seed server using the Range header.

Arguments

• piece_index - Logical index of the piece (for logging)
• piece_length - Total length of this piece (unused in request but for context)
• piece_offset - Byte offset within the full file where this piece starts
• length - Number of bytes to download

Returns

• Ok(Vec<u8>) - Raw piece data on success (HTTP 206 Partial Content or 200 OK)
• Err(String) - Network error or non-success HTTP status

pub async fn request_piece( &self, piece_index: u32, piece_length: u32, total_length: u64, ) -> Result<Vec<u8>, String>

Request a piece from this web seed with concurrency control.

This method:

1. Checks if the piece is already being requested
2. Marks the piece as active
3. Downloads the piece
4. Clears the active flag

Arguments

• piece_index - Index of the piece to download
• piece_length - Length of each piece
• total_length - Total file length (for calculating the last piece size)

Returns

• Ok(Vec<u8>) - Piece data
• Err(String) - Error or “already active”

pub fn is_available(&self) -> bool

Check whether this web-seed appears to be available.

Currently returns true unconditionally; a future implementation could perform a lightweight HEAD request or health check.

pub fn url(&self) -> &str

Get the base URL of this web-seed (for display/logging).