tagver 0.1.2

Core library for minimalistic versioning using Git tags
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

//! Configuration for TagVer operations.

use std::path::PathBuf;
use std::str::FromStr;

/// Verbosity levels for logging.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum Verbosity {
    Quiet,
    Normal,
    Verbose,
    Debug,
    Trace,
}

impl FromStr for Verbosity {
    type Err = String;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s.to_lowercase().as_str() {
            "quiet" => Ok(Verbosity::Quiet),
            "normal" => Ok(Verbosity::Normal),
            "verbose" | "info" => Ok(Verbosity::Verbose),
            "debug" => Ok(Verbosity::Debug),
            "trace" => Ok(Verbosity::Trace),
            _ => Err(format!("Invalid verbosity level: {}", s)),
        }
    }
}

/// Version parts that can be auto-incremented.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum VersionPart {
    Major,
    Minor,
    Patch,
}

impl FromStr for VersionPart {
    type Err = String;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s.to_lowercase().as_str() {
            "major" => Ok(VersionPart::Major),
            "minor" => Ok(VersionPart::Minor),
            "patch" => Ok(VersionPart::Patch),
            _ => Err(format!("Invalid version part: {}", s)),
        }
    }
}

/// Major.minor constraint.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct MajorMinor {
    pub major: u32,
    pub minor: u32,
}

impl MajorMinor {
    /// Parse a MajorMinor from a string in the format "major.minor"
    pub fn parse(s: &str) -> Result<Self, String> {
        let parts: Vec<&str> = s.split('.').collect();
        if parts.len() != 2 {
            return Err(format!("Expected format 'major.minor', got: {}", s));
        }

        let major = parts[0]
            .parse::<u32>()
            .map_err(|_| format!("Invalid major version: {}", parts[0]))?;
        let minor = parts[1]
            .parse::<u32>()
            .map_err(|_| format!("Invalid minor version: {}", parts[1]))?;

        Ok(MajorMinor { major, minor })
    }
}

/// Runtime configuration for TagVer operations.
///
/// # Defaults
/// - `work_dir`: current directory (`.`)
/// - `tag_prefix`: empty (accept all tags)
/// - `auto_increment`: [`VersionPart::Patch`](crate::config::VersionPart)
/// - `default_prerelease_identifiers`: `"alpha.0"`
/// - `ignore_height`: `false`
/// - `verbosity`: [`Verbosity::Normal`](crate::config::Verbosity)
///
/// # Examples
/// ```rust
/// use tagver::{Config, VersionPart};
///
/// let mut config = Config::default();
/// config.tag_prefix = "v".into();
/// config.auto_increment = VersionPart::Minor;
/// config.ignore_height = true;
///
/// assert_eq!(config.tag_prefix, "v");
/// assert_eq!(config.auto_increment, VersionPart::Minor);
/// assert!(config.ignore_height);
/// ```
#[derive(Debug, Clone)]
pub struct Config {
    pub work_dir: PathBuf,
    pub tag_prefix: String,
    pub auto_increment: VersionPart,
    pub minimum_major_minor: Option<MajorMinor>,
    pub default_prerelease_identifiers: Vec<String>,
    pub build_metadata: Option<String>,
    pub ignore_height: bool,
    pub verbosity: Verbosity,
}

impl Default for Config {
    fn default() -> Self {
        Self {
            work_dir: ".".into(),
            tag_prefix: "".into(),
            auto_increment: VersionPart::Patch,
            minimum_major_minor: None,
            default_prerelease_identifiers: vec!["alpha".into(), "0".into()],
            build_metadata: None,
            ignore_height: false,
            verbosity: Verbosity::Normal,
        }
    }
}