rs-histver 0.4.2

Library for querying Rust historical release versions (stable/beta/nightly)
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

mod beta;
mod http;
mod nightly;
mod stable;

use crate::constants::{CHANNEL_BETA, CHANNEL_NIGHTLY, CHANNEL_STABLE};
use crate::domain::RustRelease;
use crate::options::NetworkConfig;
use anyhow::Result;
use async_trait::async_trait;

/// Release fetcher strategy trait (Strategy Pattern).
///
/// Each Rust release channel implements this trait with its own remote data
/// source and parsing logic.
#[async_trait]
pub trait ReleaseFetcher: Send + Sync {
    /// Human-readable channel name (e.g. "stable", "beta", "nightly").
    fn channel_name(&self) -> &str;
    /// Human-readable description of the data source being used.
    fn source_description(&self) -> &str;
    /// Fetch release data from the remote source.
    async fn fetch(&self, network: &NetworkConfig) -> Result<Vec<RustRelease>>;
}

/// Factory function: create the appropriate fetcher for a given channel.
///
/// - `channel`: one of `"stable"`, `"beta"`, or `"nightly"`.
/// - `full`: if `true`, stable fetcher uses RELEASES.md full history instead of GitHub API.
/// - `days`: how many days of history to probe (beta/nightly only).
///
/// # Errors
///
/// Returns an error if the channel name is not recognized.
pub fn create_fetcher(channel: &str, full: bool, days: u32) -> Result<Box<dyn ReleaseFetcher>> {
    match channel {
        CHANNEL_STABLE => Ok(Box::new(stable::StableFetcher::new(full))),
        CHANNEL_BETA => Ok(Box::new(beta::BetaFetcher::new(days))),
        CHANNEL_NIGHTLY => Ok(Box::new(nightly::NightlyFetcher::new(days))),
        _ => anyhow::bail!("Unknown channel: '{channel}'. Must be one of: stable, beta, nightly"),
    }
}