gix 0.88.0

Interact with git repositories just like git would
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

use crate::{
    config,
    config::tree::{Fetch, Key, Section, keys},
};

impl Fetch {
    /// The `fetch.negotiationAlgorithm` key.
    pub const NEGOTIATION_ALGORITHM: NegotiationAlgorithm = NegotiationAlgorithm::new_with_validate(
        "negotiationAlgorithm",
        &config::Tree::FETCH,
        validate::NegotiationAlgorithm,
    );
    /// The `fetch.recurseSubmodules` key.
    #[cfg(feature = "attributes")]
    pub const RECURSE_SUBMODULES: RecurseSubmodules =
        RecurseSubmodules::new_with_validate("recurseSubmodules", &config::Tree::FETCH, validate::RecurseSubmodules);
}

impl Section for Fetch {
    fn name(&self) -> &str {
        "fetch"
    }

    fn keys(&self) -> &[&dyn Key] {
        &[
            &Self::NEGOTIATION_ALGORITHM,
            #[cfg(feature = "attributes")]
            &Self::RECURSE_SUBMODULES,
        ]
    }
}

/// The `fetch.negotiationAlgorithm` key.
pub type NegotiationAlgorithm = keys::Any<validate::NegotiationAlgorithm>;

/// The `fetch.recurseSubmodules` key.
#[cfg(feature = "attributes")]
pub type RecurseSubmodules = keys::Any<validate::RecurseSubmodules>;

mod algorithm {
    #[cfg(feature = "attributes")]
    use crate::ExnMessageResult;
    #[cfg(any(feature = "credentials", feature = "attributes"))]
    use crate::{Error, Result};
    #[cfg(feature = "credentials")]
    impl crate::config::tree::sections::fetch::NegotiationAlgorithm {
        /// Derive the negotiation algorithm identified by `name`, case-sensitively.
        pub fn try_into_negotiation_algorithm(
            &'static self,
            name: impl gix_utils::AsBStr,
        ) -> Result<crate::remote::fetch::negotiate::Algorithm> {
            use crate::{bstr::ByteSlice, remote::fetch::negotiate::Algorithm};

            let name = name.as_bstr();
            Ok(match name.as_bstr().as_bytes() {
                b"noop" => Algorithm::Noop,
                b"consecutive" | b"default" => Algorithm::Consecutive,
                b"skipping" => Algorithm::Skipping,
                _ => {
                    return Err(Error::from_error(crate::config::key::error_with_value(
                        self,
                        "Invalid configuration value",
                        name,
                    )));
                }
            })
        }
    }

    #[cfg(feature = "attributes")]
    impl crate::config::tree::sections::fetch::RecurseSubmodules {
        /// Obtain the way submodules should be updated.
        pub fn try_into_recurse_submodules(
            &'static self,
            value: ExnMessageResult<Option<bool>>,
        ) -> Result<Option<gix_submodule::config::FetchRecurse>> {
            gix_submodule::config::FetchRecurse::new(value).map_err(|input| {
                Error::from_error(crate::config::key::error_with_value(
                    self,
                    "Invalid configuration value",
                    input,
                ))
            })
        }
    }
}

mod validate {
    use crate::{ExnResult, bstr::BStr, config::tree::keys};
    #[cfg(any(feature = "credentials", feature = "attributes"))]
    use gix_error::ResultExt;

    #[derive(Clone, Copy)]
    pub struct NegotiationAlgorithm;
    impl keys::Validate for NegotiationAlgorithm {
        #[cfg_attr(not(feature = "credentials"), allow(unused_variables))]
        fn validate(&self, value: &BStr) -> ExnResult {
            #[cfg(feature = "credentials")]
            crate::config::tree::Fetch::NEGOTIATION_ALGORITHM
                .try_into_negotiation_algorithm(value)
                .or_erased()?;
            Ok(())
        }
    }

    #[cfg(feature = "attributes")]
    #[derive(Clone, Copy)]
    pub struct RecurseSubmodules;
    #[cfg(feature = "attributes")]
    impl keys::Validate for RecurseSubmodules {
        fn validate(&self, value: &BStr) -> ExnResult {
            {
                let boolean = gix_config::Boolean::try_from(value).map(|b| Some(b.0));
                crate::config::tree::Fetch::RECURSE_SUBMODULES
                    .try_into_recurse_submodules(boolean)
                    .or_erased()?;
            }
            Ok(())
        }
    }
}