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
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

//! Analyzer configuration resolution.
//!
//! Builds AnalyzerConfig instances from resolved package parameters,
//! handling complex interactions between global config, package
//! config, and CLI overrides.

use regex::Regex;
use std::rc::Rc;

use crate::{
    analyzer::config::AnalyzerConfig,
    config::{prerelease::PrereleaseConfig, resolved::ResolvedConfig},
};

/// Parameters for building an analyzer configuration.
///
/// This is an internal type used to pass resolved values from
/// package configuration into the analyzer config builder.
#[derive(Debug)]
pub struct AnalyzerParams {
    pub config: Rc<ResolvedConfig>,
    pub package_name: String,
    pub prerelease: Option<PrereleaseConfig>,
    pub tag_prefix: String,
    pub breaking_always_increment_major: bool,
    pub custom_major_increment_regex: Option<String>,
    pub features_always_increment_minor: bool,
    pub custom_minor_increment_regex: Option<String>,
}

/// Builds an AnalyzerConfig from resolved parameters.
///
/// This function combines global configuration, package-specific
/// settings, and generates package-specific patterns (like release
/// commit matcher).
pub fn build_analyzer_config(params: AnalyzerParams) -> AnalyzerConfig {
    let release_commit_matcher =
        build_release_commit_matcher(&params.package_name);

    AnalyzerConfig {
        body: params.config.changelog.body.clone(),
        breaking_always_increment_major: params.breaking_always_increment_major,
        custom_major_increment_regex: params.custom_major_increment_regex,
        custom_minor_increment_regex: params.custom_minor_increment_regex,
        features_always_increment_minor: params.features_always_increment_minor,
        include_author: params.config.changelog.include_author,
        prerelease: params.prerelease,
        release_commit_matcher,
        release_link_base_url: Some(
            params.config.release_link_base_url.clone(),
        ),
        compare_link_base_url: Some(
            params.config.compare_link_base_url.clone(),
        ),
        skip_chore: params.config.changelog.skip_chore,
        skip_ci: params.config.changelog.skip_ci,
        skip_doc: params.config.changelog.skip_doc,
        skip_perf: params.config.changelog.skip_perf,
        skip_test: params.config.changelog.skip_test,
        skip_refactor: params.config.changelog.skip_refactor,
        skip_revert: params.config.changelog.skip_revert,
        skip_style: params.config.changelog.skip_style,
        skip_merge_commits: params.config.changelog.skip_merge_commits,
        skip_miscellaneous: params.config.changelog.skip_miscellaneous,
        tag_prefix: Some(params.tag_prefix),
        commit_modifiers: params.config.commit_modifiers.clone(),
    }
}

/// Builds a regex matcher for release commits for this package.
///
/// Release commits follow the pattern:
/// `chore(base_branch): release package_name`
fn build_release_commit_matcher(package_name: &str) -> Option<Regex> {
    Regex::new(&format!(
        r#"^chore\(.*\): release {}"#,
        regex::escape(package_name)
    ))
    .ok()
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn builds_release_commit_matcher_correctly() {
        let matcher = build_release_commit_matcher("my-package");
        assert!(matcher.is_some());

        let regex = matcher.unwrap();
        assert!(regex.is_match("chore(main): release my-package"));
        assert!(regex.is_match("chore(dev): release my-package"));
        assert!(!regex.is_match("chore(main): release other-package"));
    }

    #[test]
    fn escapes_special_regex_characters() {
        let matcher = build_release_commit_matcher("my-package");
        assert!(matcher.is_some());

        let regex = matcher.unwrap();
        // Parentheses in package name should be escaped
        assert!(!regex.is_match("chore(main): release my(package"));
    }
}