Trait git_repository::config::tree::Key

pub trait Key: Debug {
    // Required methods
    fn name(&self) -> &str;
    fn validate(&self, value: &BStr) -> Result<(), Error>;
    fn section(&self) -> &dyn Section;

    // Provided methods
    fn subsection_requirement(&self) -> Option<&SubSectionRequirement> { ... }
    fn link(&self) -> Option<&Link> { ... }
    fn note(&self) -> Option<&Note> { ... }
    fn environment_override(&self) -> Option<&str> { ... }
    fn the_environment_override(&self) -> &str { ... }
    fn logical_name(&self) -> String { ... }
    fn full_name(&self, subsection: Option<&BStr>) -> Result<BString, String> { ... }
    fn validated_assignment(&self, value: &BStr) -> Result<BString, Error> { ... }
    fn validated_assignment_fmt(
        &self,
        value: &dyn Display
    ) -> Result<BString, Error> { ... }
    fn validated_assignment_with_subsection(
        &self,
        value: &BStr,
        subsection: &BStr
    ) -> Result<BString, Error> { ... }
}

A leaf-level entry in the git configuration, like url in remote.origin.url.

Required Methods

fn name(&self) -> &str

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

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.

fn section(&self) -> &dyn Section

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

Provided Methods

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

The return value encodes three possible states to indicate subsection requirements

• None = subsections may or may not be used, the most flexible setting.
• Some([Requirement][SubSectionRequirement]) = subsections must or must not be used, depending on the value

fn link(&self) -> Option<&Link>

Return the link to other resources, if available.

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

Return a note about this key, if available.

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

fn the_environment_override(&self) -> &str

Return the environment override that must be set on this key.

Panics

If no environment variable is set

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.

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.

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.

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.

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.

Implementors

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