Enum ResetDepth 

#[non_exhaustive]
pub enum ResetDepth {
    None,
    File,
    Policy,
    Env,
    All,
}

How much of a Flockfile load overwrites what the operator has set since.

Two independent axes: whether env is reset, and whether a key the template declares (or does not) is reset. Five of the six combinations are named here; each variant’s own doc states its column values.

#[non_exhaustive] buys source compatibility only, forcing an out-of-tree match to carry a wildcard arm. It does nothing for serde: this enum has no #[serde(other)], so an older build fails to deserialize a variant it predates with unknown variant.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

None

Append keys nobody established. Overwrite nothing. The default, because a Flockfile arrives from the app’s own repository.

env: kept. A key the template declares: kept, unless nobody has established it yet, which is the append. A key it does not declare: kept, since there is nothing to append it against.

File

Put back what the template declares, and nothing else.

env: kept. A key the template declares: reset. A key it does not declare: kept, so an app stocked to four instances against a file with no instances line keeps its count.

Policy

Put non-env settings back to the template, env kept. Every setting goes back, declared or not, to the value a fresh start off the template would give it: env is operator data, the rest is operator-tuned policy, and resetting policy is recoverable while resetting data is not.

env: kept. A key the template declares: reset. A key it does not declare: reset too, to the template’s own default.

Env

Reset env back to the template and leave everything else alone.

Touches data, not policy: on the settings axis this behaves like None, append included, since it widens a load rather than narrowing one.

env: reset. A key the template declares: kept, save for the same append None does. A key it does not declare: kept.

All

Put everything back to the template, env included, and drop the override record.

env: reset. A key the template declares: reset. A key it does not declare: reset too, to the template’s own default.

Trait Implementations

impl Clone for ResetDepth

fn clone(&self) -> ResetDepth

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ResetDepth

impl Debug for ResetDepth

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

Formats the value using the given formatter.

impl Default for ResetDepth

fn default() -> ResetDepth

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ResetDepth

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ResetDepth

impl PartialEq for ResetDepth

fn eq(&self, other: &ResetDepth) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ResetDepth

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ResetDepth