projvar 0.19.9

A tiny CLI tool that tries to gather project specific meta-data in different ways, to store them into key=value pairs in a file for later use by other tools. See --list for the keys set by this tool.
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

// SPDX-FileCopyrightText: 2021 - 2023 Robin Vobruba <hoijui.quaero@gmail.com>
//
// SPDX-License-Identifier: AGPL-3.0-or-later

use regex::Regex;
use std::sync::LazyLock;

#[derive(Debug, PartialEq, Eq)]
pub struct PartsRef<'a> {
    pub protocol: Option<&'a str>,
    pub user: Option<&'a str>,
    pub host: &'a str,
    pub path_and_rest: &'a str,
}

macro_rules! let_named_cap_opt {
    ($caps:ident,$name:ident) => {
        let $name = $caps.name(stringify!($name)).map(|mtch| mtch.as_str());
    };
}
macro_rules! let_named_cap {
    ($caps:ident,$name:ident) => {
        let $name = $caps
            .name(stringify!($name))
            .map(|mtch| mtch.as_str())
            .expect(concat!(
                "Required regex capture not matched: ",
                stringify!($name)
            ));
    };
}
//pub(crate) use let_named_cap;

impl<'a> PartsRef<'a> {
    /// Parses a git clone URL of any type -
    /// including non URL spec compliant ones -
    /// into a set of basic parts.
    ///
    /// # Errors
    ///
    /// If our internal regex to parse a git clone URL
    /// does not match the supplied string.
    pub fn parse<'b>(any_clone_url: &'b str) -> Result<Self, String>
    where
        'b: 'a,
    {
        // This matches all these 3 types of clone URLs:
        // * git@github.com:hoijui/rust-project-scripts.git
        // * ssh://github.com/hoijui/rust-project-scripts.git
        // * https://github.com/hoijui/rust-project-scripts.git
        static R_CLONE_URL: LazyLock<Regex> = LazyLock::new(|| {
            Regex::new(r"^((?P<protocol>[0-9a-zA-Z._-]+)://)?((?P<user>[0-9a-zA-Z._-]+)@)?(?P<host>[0-9a-zA-Z._-]+)([/:](?P<path_and_rest>.+)?)?$").unwrap()
        });

        R_CLONE_URL
            .captures(any_clone_url.as_ref())
            .map(|caps| {
                let_named_cap_opt!(caps, protocol);
                let_named_cap_opt!(caps, user);
                let_named_cap!(caps, host);
                let_named_cap!(caps, path_and_rest);
                Self {
                    protocol,
                    user,
                    host,
                    path_and_rest,
                }
            })
            .ok_or_else(|| {
                format!("Failed to parse as (any type of) git clone URL: '{any_clone_url}'")
            })
    }
}