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

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

impl Checkout {
    /// The `checkout.workers` key.
    pub const WORKERS: Workers = Workers::new_with_validate("workers", &config::Tree::CHECKOUT, validate::Workers)
        .with_deviation("if unset, uses all cores instead of just one");
}

/// The `checkout.workers` key.
pub type Workers = keys::Any<validate::Workers>;

impl Section for Checkout {
    fn name(&self) -> &str {
        "checkout"
    }

    fn keys(&self) -> &[&dyn Key] {
        &[&Self::WORKERS]
    }
}

mod workers {
    use gix_error::ResultExt;

    use crate::{ExnMessageResult, Result, config::tree::checkout::Workers};

    impl Workers {
        /// Return the amount of threads to use for checkout, with `0` meaning all available ones, after decoding our integer value from `config`,
        /// or `None` if the value isn't set which is typically interpreted as "as many threads as available"
        pub fn try_from_workers(&'static self, value: ExnMessageResult<Option<i64>>) -> Result<Option<usize>> {
            match value.or_raise(|| crate::config::key::error(self, "Could not decode checkout workers"))? {
                Some(v) if v < 0 => Ok(Some(0)),
                Some(v) => Ok(Some(v.try_into().expect("positive i64 can always be usize on 64 bit"))),
                None => Ok(None),
            }
        }
    }
}

///
pub mod validate {
    use crate::{ExnResult, bstr::BStr, config::tree::keys};
    use gix_error::{ErrorExt, ResultExt};

    pub struct Workers;
    impl keys::Validate for Workers {
        fn validate(&self, value: &BStr) -> ExnResult {
            super::Checkout::WORKERS
                .try_from_workers(
                    gix_config::Integer::try_from(value)
                        .and_then(|i| {
                            i.to_decimal().ok_or_else(|| {
                                gix_error::validation("Integer overflow")
                                    .with("input", value.to_owned())
                                    .raise()
                            })
                        })
                        .map(Some),
                )
                .or_erased()?;
            Ok(())
        }
    }
}