rs-histver 0.4.1

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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

//! Centralized constants for the `rs-histver` project.
//!
//! All channel names, default configuration values, URL endpoints, and magic
//! numbers are defined here. Import via `use crate::constants::*;` for
//! convenience, or reference individually.

// ── Channel name constants ──────────────────────────────────────────────

/// Stable release channel identifier.
pub const CHANNEL_STABLE: &str = "stable";
/// Beta release channel identifier.
pub const CHANNEL_BETA: &str = "beta";
/// Nightly release channel identifier.
pub const CHANNEL_NIGHTLY: &str = "nightly";

/// All three valid channel names, ordered for iteration.
pub const ALL_CHANNELS: &[&str] = &[CHANNEL_STABLE, CHANNEL_BETA, CHANNEL_NIGHTLY];

// ── Default configuration values ────────────────────────────────────────

/// Default number of days to probe for beta/nightly history.
pub const DEFAULT_PROBE_DAYS: u32 = 30;

/// Default HTTP request timeout (seconds).
/// Increased from 15s to 60s for better compatibility with slow network connections
/// (e.g., accessing GitHub from regions like China mainland).
pub const DEFAULT_TIMEOUT_SECS: u64 = 60;

/// Default maximum number of concurrent HTTP requests.
pub const DEFAULT_MAX_CONCURRENCY: usize = 10;

// ── GitHub API constants ────────────────────────────────────────────────

/// Results per page for the GitHub Releases API.
pub const GITHUB_PER_PAGE: u32 = 100;

/// Maximum number of pages to fetch from GitHub Releases API
/// (1500 releases — ~10 years of Rust history).
pub const GITHUB_MAX_PAGES: u32 = 15;

// ── Remote data source URLs ─────────────────────────────────────────────

/// GitHub Releases API endpoint for the Rust language repository.
pub const GITHUB_RELEASES_API: &str = "https://api.github.com/repos/rust-lang/rust/releases";

/// Raw RELEASES.md for full historical stable release data.
pub const RELEASES_MD_URL: &str =
    "https://raw.githubusercontent.com/rust-lang/rust/master/RELEASES.md";

/// Base URL for static.rust-lang.org distribution files.
pub const STATIC_DIST_BASE_URL: &str = "https://static.rust-lang.org/dist";

// ── Package identity ────────────────────────────────────────────────────

/// Package / binary name, used for CLI identity and User-Agent prefix.
pub const PKG_NAME: &str = env!("CARGO_PKG_NAME");

/// Generate the default `User-Agent` header string, e.g. `"rs-histver/0.4.0"`.
#[must_use]
pub fn default_user_agent() -> String {
    format!("{PKG_NAME}/{}", env!("CARGO_PKG_VERSION"))
}