Struct WebSeedManager 

pub struct WebSeedManager { /* private fields */ }

Manages multiple web-seed endpoints with automatic fallback.

When downloading a piece, tries each configured web-seed URL in order until one succeeds. If all fail, returns an aggregated error.

Implementations

impl WebSeedManager

pub fn new(urls: Vec<String>, piece_length: u32, total_length: u64) -> Self

Create a new WebSeedManager from a list of web-seed URLs.

Arguments

• urls - List of HTTP(S) URLs serving the torrent content
• piece_length - Length of each piece in the torrent
• total_length - Total file length

Example

use aria2_core::engine::bt_web_seed::WebSeedManager;
let manager = WebSeedManager::new(
    vec![
        "http://mirror1.example.com/file.bin".to_string(),
        "http://mirror2.example.com/file.bin".to_string(),
    ],
    16384,  // piece_length
    1048576 // total_length
);

pub fn stats(&self) -> &WebSeedStats

Get the shared statistics.

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

Request a piece from any available web seed.

This method uses the new request_piece API with concurrency control.

Arguments

• piece_index - Index of the piece to download

Returns

• Ok(Vec<u8>) - Piece data from first successful web-seed
• Err(String) - All web-seeds failed

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

Attempt to download a piece from any available web-seed.

Tries each web-seed in order; returns data from the first successful response. Collects errors from all failed attempts if all fail.

Arguments

• piece_index - Logical index of the piece
• piece_length - Total length of this piece
• piece_offset - Byte offset within the file
• length - Number of bytes to download

Returns

• Ok(Vec<u8>) - Piece data from first successful web-seed
• Err(String) - All web-seeds failed (contains error details)

pub fn len(&self) -> usize

Get the number of configured web-seed URLs.

pub fn is_empty(&self) -> bool

Check if any web-seeds are configured.

pub fn clients(&self) -> &[WebSeedClient]

Get reference to the underlying web-seed clients.