netspd 0.1.0

A beautiful, modern, minimalistic network speed testing terminal application
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

//! Streaming download measurement.

use std::sync::atomic::{AtomicU64, Ordering};
use std::sync::Arc;
use std::time::Duration;

use reqwest::Client;
use tokio::sync::mpsc;
use tokio::task::JoinSet;
use tokio_util::sync::CancellationToken;

use crate::engine::event::EngineEvent;
use crate::engine::models::{TestPhase, TransferStats};
use crate::engine::TransferConfig;
use crate::errors::EngineResult;

use super::transfer;

/// Pause between retries after a failed request, so a broken server does
/// not turn the worker into a busy loop.
const RETRY_DELAY: Duration = Duration::from_millis(250);

/// Runs the download phase.
///
/// Spawns `config.connections` workers that stream the payload without ever
/// buffering it, counting bytes as chunks arrive. Progress is emitted on
/// `events`; the phase ends after `config.duration` or on cancellation.
pub async fn run_download(
    client: &Client,
    url: &str,
    config: &TransferConfig,
    events: &mpsc::Sender<EngineEvent>,
    cancel: &CancellationToken,
) -> EngineResult<TransferStats> {
    let counter = Arc::new(AtomicU64::new(0));
    let workers_cancel = cancel.child_token();
    let mut workers = JoinSet::new();

    for _ in 0..config.connections.max(1) {
        workers.spawn(worker(
            client.clone(),
            url.to_owned(),
            Arc::clone(&counter),
            workers_cancel.clone(),
        ));
    }

    transfer::monitor(
        TestPhase::Download,
        config,
        counter,
        &mut workers,
        &workers_cancel,
        events,
        cancel,
    )
    .await
}

/// A single download connection: request, stream, count, repeat.
///
/// Individual request failures are retried after a short delay; the worker
/// only stops when cancelled.
async fn worker(client: Client, url: String, counter: Arc<AtomicU64>, cancel: CancellationToken) {
    while !cancel.is_cancelled() {
        let response = tokio::select! {
            () = cancel.cancelled() => return,
            result = client.get(&url).send() => result,
        };

        let mut response = match response {
            Ok(response) if response.status().is_success() => response,
            // Failed request or error status: back off briefly and retry.
            Ok(_) | Err(_) => {
                tokio::select! {
                    () = cancel.cancelled() => return,
                    () = tokio::time::sleep(RETRY_DELAY) => continue,
                }
            }
        };

        loop {
            let chunk = tokio::select! {
                () = cancel.cancelled() => return,
                result = response.chunk() => result,
            };
            match chunk {
                Ok(Some(bytes)) => {
                    counter.fetch_add(bytes.len() as u64, Ordering::Relaxed);
                }
                // Stream finished cleanly or errored mid-body; either way,
                // start a fresh request.
                Ok(None) | Err(_) => break,
            }
        }
    }
}