rs-histver 0.2.1

A CLI tool and library for querying Rust historical release versions with local redb cache
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

use clap::{Parser, Subcommand, ValueEnum};

/// Rust release channel.
///
/// Represents the three Rust release tracks: stable, beta, and nightly.
#[derive(Clone, ValueEnum)]
pub enum Channel {
    Stable,
    Beta,
    Nightly,
}

impl std::fmt::Display for Channel {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Channel::Stable => write!(f, "stable"),
            Channel::Beta => write!(f, "beta"),
            Channel::Nightly => write!(f, "nightly"),
        }
    }
}

/// CLI definition
#[derive(Parser)]
#[command(name = "rs-histver")]
#[command(about = "Query Rust historical release versions")]
#[command(version)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Commands,
}

/// Subcommands
#[derive(Subcommand)]
pub enum Commands {
    /// Sync release data from remote to local cache
    Sync {
        /// Release channel (stable/beta/nightly), default: stable
        #[arg(short, long, value_enum, default_value = "stable")]
        channel: Channel,

        /// Use RELEASES.md as data source (stable only, more complete)
        #[arg(long)]
        full: bool,

        /// Probe recent N days of history (beta/nightly only, default: 30)
        #[arg(short, long, default_value = "30")]
        days: u32,
    },
    /// List cached releases
    List {
        /// Maximum number of entries to display
        #[arg(short, long, default_value = "20")]
        limit: usize,

        /// Filter by channel (stable/beta/nightly)
        #[arg(short, long, value_enum)]
        channel: Option<Channel>,
    },
    /// Search releases (fuzzy match by version or date)
    Search {
        /// Search keyword (e.g. "1.75" or "2024")
        keyword: String,

        /// Filter by channel (stable/beta/nightly)
        #[arg(short, long, value_enum)]
        channel: Option<Channel>,
    },
    /// Show local cache statistics
    Info {
        /// Filter by channel (stable/beta/nightly)
        #[arg(short, long, value_enum)]
        channel: Option<Channel>,
    },
}