torrent 0.1.6

High-level async BitTorrent library — session management, HTTP/UDP tracker communication, DHT networking, peer connections, and file storage. Built on torrent-core with tokio.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

//! Parse a .torrent file and inspect its metadata.
//!
//! Uses a real Ubuntu 26.04 torrent file bundled in `examples/data/`.
//! Run with: `cargo run -p torrent --example parse_metainfo`

use torrent::metainfo::{Metainfo, Mode};
use tracing_subscriber::EnvFilter;

fn main() {
    tracing_subscriber::fmt()
        .with_env_filter(EnvFilter::from_default_env())
        .init();

    // Load a real .torrent file (embedded at compile time)
    let data = include_bytes!("data/ubuntu-26.04-live-server-amd64.iso.torrent");

    // Parse it
    let meta = Metainfo::try_from(data).expect("failed to parse .torrent file");

    println!("=== Torrent Metadata ===");
    println!("Tracker URL:    {}", meta.announce);
    println!("Info hash:      {:02x?}", meta.info_hash());
    println!("Piece length:   {} bytes", meta.info.piece_length);
    println!("Total size:     {} bytes", meta.info.total_size());
    println!("Number of pieces: {}", meta.info.num_pieces());

    // Optional fields
    if let Some(date) = meta.creation_date {
        println!("Created:        {}", date);
    }
    if let Some(ref comment) = meta.comment {
        println!("Comment:        {}", comment);
    }
    if let Some(ref created_by) = meta.created_by {
        println!("Created by:     {}", created_by);
    }

    // Announce tiers (BEP 12 multi-tracker)
    if !meta.announce_list.is_empty() {
        println!();
        println!("=== Tracker Tiers ===");
        for (i, tier) in meta.announce_list.iter().enumerate() {
            println!("  Tier {}:", i);
            for url in tier {
                println!("    {}", url);
            }
        }
    }

    // File layout
    match &meta.info.mode {
        Mode::Single { name, length } => {
            println!();
            println!("=== File Layout (single-file) ===");
            println!("  {} ({} bytes)", name, length);
        }
        Mode::Multiple { name, files } => {
            println!();
            println!("=== File Layout (multi-file) ===");
            println!("  Root: {}", name);
            for f in files {
                println!("  {} ({} bytes)", f.path.join("/"), f.length);
            }
        }
    }
}