releasaurus-core 0.20.0

A comprehensive release automation tool that streamlines the software release process across multiple programming languages and forge platforms
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

use schemars::JsonSchema;
use serde::{Deserialize, Serialize};
use strum::{Display, EnumString};

use crate::result::{ReleasaurusError, Result};

/// Determines how prerelease identifiers should be appended to versions
#[derive(
    Debug,
    Clone,
    Copy,
    Serialize,
    Deserialize,
    JsonSchema,
    PartialEq,
    Eq,
    Default,
    Display,
    EnumString,
)]
#[serde(rename_all = "lowercase")]
#[strum(serialize_all = "lowercase")]
pub enum PrereleaseStrategy {
    /// Adds numeric suffixes like `.1`, `.2`, etc. to prerelease identifiers.
    #[default]
    Versioned,
    /// Reuses the exact prerelease identifier without numeric suffixes
    Static,
}

/// Configurable prerelease settings for both global and package scopes
#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, Default)]
#[serde(default)]
pub struct PrereleaseConfig {
    /// Prerelease identifier (e.g., "alpha", "beta", "rc", "SNAPSHOT")
    pub suffix: Option<String>,
    /// How prerelease suffixes should be applied to versions
    pub strategy: PrereleaseStrategy,
}

impl PrereleaseConfig {
    /// Returns the suffix for configs that have been resolved
    pub fn suffix(&self) -> Result<&str> {
        self.suffix.as_deref().ok_or_else(|| {
            ReleasaurusError::invalid_config(
                "resolved prerelease config must include suffix",
            )
        })
    }
}