[go: up one dir, main page]
gix::config::tree::keys

Struct Any

Source 
pub struct Any<T: Validate = All> {
    pub name: &'static str,
    pub section: &'static dyn Section,
    pub subsection_requirement: Option<SubSectionRequirement>,
    pub link: Option<Link>,
    pub note: Option<Note>,
    /* private fields */
}
Expand description

Implements a value without any constraints, i.e. a any value.

Fields§

§name: &'static str

The key of the value in the git configuration.

§section: &'static dyn Section

The parent section of the key.

§subsection_requirement: Option<SubSectionRequirement>

The subsection requirement to use.

§link: Option<Link>

A link to other resources that might be eligible as value.

§note: Option<Note>

A note about this key.

Implementations§

Source§

impl Any<FullNameRef>

Source

pub fn try_into_fullrefname( value: Cow<'_, BStr>, ) -> Result<Cow<'_, FullNameRef>, Error>

Return the validated full ref name from value if it is valid.

Source§

impl Any<Workers>

Source

pub fn try_from_workers( &'static self, value: Result<i64, Error>, ) -> Result<usize, Error>

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”

Source§

impl Any<CheckRoundTripEncoding>

Source

pub fn try_into_encodings( &'static self, value: Option<Cow<'_, BStr>>, ) -> Result<Vec<&'static Encoding>, Error>

Available on crate feature attributes only.

Convert value into a list of encodings, which are either space or coma separated. Fail if an encoding is unknown. If None, the default is returned.

Source§

impl Any<Eol>

Source

pub fn try_into_eol( &'static self, value: Cow<'_, BStr>, ) -> Result<Mode, GenericErrorWithValue>

Available on crate feature attributes only.

Convert value into the default end-of-line mode.

§Deviation

git will allow any value and silently leaves it unset, we will fail if the value is not known.

Source§

impl Any<SafeCrlf>

Source

pub fn try_into_safecrlf( &'static self, value: Cow<'_, BStr>, ) -> Result<CrlfRoundTripCheck, GenericErrorWithValue>

Available on crate feature attributes only.

Convert value into the safe-crlf enumeration, if possible.

Source§

impl Any<AutoCrlf>

Source

pub fn try_into_autocrlf( &'static self, value: Cow<'_, BStr>, ) -> Result<AutoCrlf, GenericErrorWithValue>

Available on crate feature attributes only.

Convert value into the safe-crlf enumeration, if possible.

Source§

impl Any<Disambiguate>

Source

pub fn try_into_object_kind_hint( &'static self, value: Cow<'_, BStr>, ) -> Result<Option<ObjectKindHint>, GenericErrorWithValue>

Available on crate feature revision only.

Convert a disambiguation marker into the respective enum.

Source§

impl Any<LogAllRefUpdates>

Source

pub fn try_into_ref_updates( &'static self, value: Option<Result<bool, Error>>, ) -> Result<Option<WriteReflog>, GenericErrorWithValue>

Returns the mode for ref-updates as parsed from value. If value is not a boolean, we try to interpret the string value instead. For correctness, this two step process is necessary as the interpretation of booleans in special in git-config, i.e. we can’t just treat it as string.

Source§

impl Any<CheckStat>

Source

pub fn try_into_checkstat( &'static self, value: Cow<'_, BStr>, ) -> Result<bool, GenericErrorWithValue>

Returns true if the full set of stat entries should be checked, and it’s just as lenient as git.

Source§

impl Any<Abbrev>

Source

pub fn try_into_abbreviation( &'static self, hex_len_str: Cow<'_, BStr>, object_hash: Kind, ) -> Result<Option<usize>, Error>

Convert the given hex_len_str into the amount of characters that a short hash should have. If None is returned, the correct value can be determined based on the amount of objects in the repo.

Source§

impl Any<Algorithm>

Source

pub fn try_into_algorithm( &self, name: Cow<'_, BStr>, ) -> Result<Algorithm, Error>

Available on crate feature blob-diff only.

Derive the diff algorithm identified by name, case-insensitively.

Source§

impl Any<Binary>

Source

pub fn try_into_binary( &'static self, value: Option<Cow<'_, BStr>>, ) -> Result<Option<bool>, GenericErrorWithValue>

Available on crate feature blob-diff only.

Convert value into a tri-state boolean that can take the special value auto, resulting in None, or is a boolean. If None is given, it’s treated as implicit boolean true, as this method is made to be used with gix_config::file::section::Body::value_implicit().

Source§

impl Any<Renames>

Source

pub const fn new_renames( name: &'static str, section: &'static dyn Section, ) -> Self

Available on crate feature blob-diff only.

Create a new instance.

Source

pub fn try_into_renames( &'static self, value: Result<bool, Error>, ) -> Result<Tracking, GenericError>

Available on crate feature blob-diff only.

Try to convert the configuration into a valid rename tracking variant. Use value and if it’s an error, interpret the boolean as string

Source§

impl Any<ObjectFormat>

Source

pub fn try_into_object_format( &'static self, value: Cow<'_, BStr>, ) -> Result<Kind, GenericErrorWithValue>

Source§

impl Any<NegotiationAlgorithm>

Source

pub fn try_into_negotiation_algorithm( &'static self, name: Cow<'_, BStr>, ) -> Result<Algorithm, GenericErrorWithValue>

Available on crate feature credentials only.

Derive the negotiation algorithm identified by name, case-sensitively.

Source§

impl Any<RecurseSubmodules>

Source

pub fn try_into_recurse_submodules( &'static self, value: Result<bool, Error>, ) -> Result<FetchRecurse, GenericErrorWithValue>

Available on crate feature attributes only.

Obtain the way submodules should be updated.

Source§

impl Any<RefsNamespace>

Source

pub fn try_into_refs_namespace( &'static self, name: Cow<'_, BStr>, ) -> Result<Namespace, Error>

Derive the negotiation algorithm identified by name, case-sensitively.

Source§

impl Any<SslVersion>

Source

pub const fn new_ssl_version( name: &'static str, section: &'static dyn Section, ) -> Self

Source§

impl Any<ProxyAuthMethod>

Source

pub const fn new_proxy_auth_method( name: &'static str, section: &'static dyn Section, ) -> Self

Source§

impl Any<FollowRedirects>

Source

pub fn try_into_follow_redirects( &'static self, value: Cow<'_, BStr>, boolean: impl FnOnce() -> Result<Option<bool>, Error>, ) -> Result<FollowRedirects, GenericErrorWithValue>

Available on crate features blocking-http-transport-reqwest or blocking-http-transport-curl only.

Convert value into the redirect specification, or query the same value as boolean for additional possible input values.

Note that boolean only queries the underlying key as boolean, which is a necessity to handle empty booleans correctly, that is those without a value separator.

Source§

impl Any<ExtraHeader>

Source

pub fn try_into_extra_header( &'static self, values: Vec<Cow<'_, BStr>>, ) -> Result<Vec<String>, Error>

Convert a list of values into extra-headers, while failing entirely on illformed UTF-8.

Source§

impl Any<Version>

Source

pub fn try_into_http_version( &'static self, value: Cow<'_, BStr>, ) -> Result<HttpVersion, GenericErrorWithValue>

Available on crate features blocking-http-transport-reqwest or blocking-http-transport-curl only.
Source§

impl Any<ProxyAuthMethod>

Source

pub fn try_into_proxy_auth_method( &'static self, value: Cow<'_, BStr>, ) -> Result<ProxyAuthMethod, GenericErrorWithValue>

Available on crate features blocking-http-transport-reqwest or blocking-http-transport-curl only.
Source§

impl Any<SslVersion>

Source

pub fn try_into_ssl_version( &'static self, value: Cow<'_, BStr>, ) -> Result<SslVersion, Error>

Available on crate features blocking-http-transport-reqwest or blocking-http-transport-curl only.
Source§

impl Any<IndexThreads>

Source

pub fn try_into_index_threads( &'static self, value: Cow<'_, BStr>, ) -> Result<usize, GenericErrorWithValue>

Parse value into the amount of threads to use, with 1 being single-threaded, or 0 indicating to select the amount of threads, with any other number being the specific amount of threads to use.

Source§

impl Any<ConflictStyle>

Source

pub fn try_into_conflict_style( &'static self, name: Cow<'_, BStr>, ) -> Result<ConflictStyle, GenericErrorWithValue>

Available on crate feature merge only.

Derive the diff algorithm identified by name, case-insensitively.

Source§

impl Any<IndexVersion>

Source

pub fn try_into_index_version( &'static self, value: Result<i64, Error>, ) -> Result<Version, GenericError>

Try to interpret an integer value as index version.

Source§

impl Any<Allow>

Source

pub fn try_into_allow( &'static self, value: Cow<'_, BStr>, scheme: Option<&str>, ) -> Result<Allow, Error>

Available on crate features blocking-network-client or async-network-client only.

Convert value into its respective Allow variant, possibly informing about the scheme we are looking at in the error.

Source§

impl Any<Version>

Source

pub fn try_into_protocol_version( &'static self, value: Option<Result<i64, Error>>, ) -> Result<Protocol, GenericErrorWithValue>

Available on crate features blocking-network-client or async-network-client only.

Convert value into the corresponding protocol version, possibly applying the correct default.

Source§

impl Any<Default>

Source

pub fn try_into_default( &'static self, value: Cow<'_, BStr>, ) -> Result<Default, GenericErrorWithValue>

Try to interpret value as push.default.

Source§

impl Any<TagOpt>

Source

pub fn try_into_tag_opt( &'static self, value: Cow<'_, BStr>, ) -> Result<Tags, GenericErrorWithValue>

Try to interpret value as tag option.

§Note

It’s heavily biased towards the git command-line unfortunately, and the only value of its kind. Maybe in future more values will be supported which are less about passing them to a sub-process.

Source§

impl Any<Variant>

Source

pub fn try_into_variant( &'static self, value: Cow<'_, BStr>, ) -> Result<Option<ProgramKind>, GenericErrorWithValue>

Available on crate feature blocking-network-client only.
Source§

impl Any<ShowUntrackedFiles>

Source

pub fn try_into_show_untracked_files( &'static self, value: Cow<'_, BStr>, ) -> Result<UntrackedFiles, GenericErrorWithValue>

Available on crate feature status only.
Source§

impl Any<DurationInMilliseconds>

Source

pub const fn new_duration( name: &'static str, section: &'static dyn Section, ) -> Self

Create a new instance.

Source

pub fn try_into_duration( &'static self, value: Result<i64, Error>, ) -> Result<Duration, Error>

Return a valid duration as parsed from an integer that is interpreted as milliseconds.

Source§

impl Any<LockTimeout>

Source

pub const fn new_lock_timeout( name: &'static str, section: &'static dyn Section, ) -> Self

Create a new instance.

Source

pub fn try_into_lock_timeout( &'static self, value: Result<i64, Error>, ) -> Result<Fail, Error>

Return information on how long to wait for locked files.

Source§

impl Any<PushRefSpec>

Source

pub const fn new_push_refspec( name: &'static str, section: &'static dyn Section, ) -> Self

Create a new instance.

Source§

impl Any<FetchRefSpec>

Source

pub const fn new_fetch_refspec( name: &'static str, section: &'static dyn Section, ) -> Self

Create a new instance.

Source§

impl Any<Url>

Source

pub const fn new_url(name: &'static str, section: &'static dyn Section) -> Self

Create a new instance.

Source

pub fn try_into_url(&'static self, value: Cow<'_, BStr>) -> Result<Url, Error>

Try to parse value as URL.

Source§

impl Any<UnsignedInteger>

Source

pub const fn new_unsigned_integer( name: &'static str, section: &'static dyn Section, ) -> Self

Create a new instance.

Source

pub fn try_into_usize( &'static self, value: Result<i64, Error>, ) -> Result<usize, Error>

Convert value into a usize or wrap it into a specialized error.

Source

pub fn try_into_u64( &'static self, value: Result<i64, Error>, ) -> Result<u64, Error>

Convert value into a u64 or wrap it into a specialized error.

Source

pub fn try_into_u32( &'static self, value: Result<i64, Error>, ) -> Result<u32, Error>

Convert value into a u32 or wrap it into a specialized error.

Source§

impl Any<Time>

Source

pub const fn new_time(name: &'static str, section: &'static dyn Section) -> Self

Create a new instance.

Source

pub fn try_into_time( &self, value: Cow<'_, BStr>, now: Option<SystemTime>, ) -> Result<Time, Error>

Convert the value into a date if possible, with now as reference time for relative dates.

Source§

impl Any<Boolean>

Source

pub const fn new_boolean( name: &'static str, section: &'static dyn Section, ) -> Self

Create a new instance.

Source

pub fn enrich_error( &'static self, value: Result<bool, Error>, ) -> Result<bool, Error>

Process the value into a result with an improved error message.

value is expected to be provided by gix_config::File::boolean().

Source§

impl Any<RemoteName>

Source

pub const fn new_remote_name( name: &'static str, section: &'static dyn Section, ) -> Self

Create a new instance.

Source

pub fn try_into_symbolic_name( &'static self, name: Cow<'_, BStr>, ) -> Result<BString, Error>

Try to validate name as symbolic remote name and return it.

Source§

impl Any<All>

Init

Source

pub const fn new(name: &'static str, section: &'static dyn Section) -> Self

Create a new instance from name and section

Source§

impl<T: Validate> Any<T>

Init other validate implementations

Source

pub const fn new_with_validate( name: &'static str, section: &'static dyn Section, validate: T, ) -> Self

Create a new instance from name and section

Source§

impl<T: Validate> Any<T>

Builder

Source

pub const fn with_subsection_requirement( self, requirement: Option<SubSectionRequirement>, ) -> Self

Set the subsection requirement to non-default values.

Source

pub const fn with_environment_override(self, var: &'static str) -> Self

Associate an environment variable with this key.

This is mainly useful for enriching error messages.

Source

pub const fn with_fallback(self, key: &'static dyn Key) -> Self

Set a link to another key which serves as fallback to provide a value if this key is not set.

Source

pub const fn with_note(self, message: &'static str) -> Self

Attach an informative message to this key.

Source

pub const fn with_deviation(self, message: &'static str) -> Self

Inform about a deviation in how this key is interpreted.

Source§

impl<T: Validate> Any<T>

Conversion

Source

pub fn try_into_refspec( &'static self, value: Cow<'_, BStr>, op: Operation, ) -> Result<RefSpec, Error>

Try to convert value into a refspec suitable for the op operation.

Source

pub fn try_into_string( &'static self, value: Cow<'_, BStr>, ) -> Result<String, Error>

Try to interpret value as UTF-8 encoded string.

Source§

impl Any<String>

Source

pub const fn new_string( name: &'static str, section: &'static dyn Section, ) -> Self

Create a new instance.

Source§

impl Any<Program>

Source

pub const fn new_program( name: &'static str, section: &'static dyn Section, ) -> Self

Create a new instance.

Source§

impl Any<Executable>

Source

pub const fn new_executable( name: &'static str, section: &'static dyn Section, ) -> Self

Create a new instance.

Source§

impl Any<Path>

Source

pub const fn new_path(name: &'static str, section: &'static dyn Section) -> Self

Create a new instance.

Trait Implementations§

Source§

impl<T: Validate> AsKey for Any<T>

Source§

fn as_key(&self) -> KeyRef<'_>

Return a parsed key reference, containing all relevant parts of a key. For instance, remote.origin.url such key would yield access to ("remote", Some("origin"), "url") while user.name would yield ("user", None, "name"). Read more
Source§

fn try_as_key(&self) -> Option<KeyRef<'_>>

Return a parsed key reference, containing all relevant parts of a key. For instance, remote.origin.url such key would yield access to ("remote", Some("origin"), "url") while user.name would yield ("user", None, "name").
Source§

impl<T: Validate> Debug for Any<T>

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl<T: Validate> Display for Any<T>

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl<T: Validate> Key for Any<T>

Source§

fn name(&self) -> &str

The key’s name, like url in remote.origin.url.
Source§

fn validate(&self, value: &BStr) -> Result<(), Error>

See if value is allowed as value of this key, or return a descriptive error if it is not.
Source§

fn section(&self) -> &dyn Section

The section containing this key. Git configuration has no free-standing keys, they are always underneath a section.
Source§

fn subsection_requirement(&self) -> Option<&SubSectionRequirement>

The return value encodes three possible states to indicate subsection requirements Read more
Return the link to other resources, if available.
Source§

fn note(&self) -> Option<&Note>

Return a note about this key, if available.
Source§

fn environment_override(&self) -> Option<&str>

Return the name of an environment variable that would override this value (after following links until one is found).
Source§

fn the_environment_override(&self) -> &str

Return the environment override that must be set on this key. Read more
Source§

fn logical_name(&self) -> String

Produce a name that describes how the name is composed. This is core.bare for statically known keys, or branch.<name>.key for complex ones.
Source§

fn full_name(&self, subsection: Option<&BStr>) -> Result<BString, String>

The full name of the key for use in configuration overrides, like core.bare, or remote.<subsection>.url if subsection is not None. May fail if this key needs a subsection, or may not have a subsection.
Source§

fn validated_assignment(&self, value: &BStr) -> Result<BString, Error>

Return an assignment with the keys full name to value, suitable for configuration overrides. Note that this will fail if the key requires a subsection name.
Source§

fn validated_assignment_fmt( &self, value: &dyn Display, ) -> Result<BString, Error>

Return an assignment with the keys full name to value, suitable for configuration overrides. Note that this will fail if the key requires a subsection name.
Source§

fn validated_assignment_with_subsection( &self, value: &BStr, subsection: &BStr, ) -> Result<BString, Error>

Return an assignment to value with the keys full name within subsection, suitable for configuration overrides. Note that this is only valid if this key supports parameterized sub-sections, or else an error is returned.

Auto Trait Implementations§

§

impl<T> Freeze for Any<T>
where T: Freeze,

§

impl<T = All> !RefUnwindSafe for Any<T>

§

impl<T = All> !Send for Any<T>

§

impl<T = All> !Sync for Any<T>

§

impl<T> Unpin for Any<T>
where T: Unpin,

§

impl<T = All> !UnwindSafe for Any<T>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> ErasedDestructor for T
where T: 'static,