Struct SheepApplied 

#[non_exhaustive]
pub struct SheepApplied {
    pub name: String,
    pub applied: Vec<String>,
    pub pending: Vec<String>,
    pub refused: Option<String>,
}

What one app’s Request::ApplyConfig did: the answer a load owes the operator who ran it

One of these per app the request named, found or not and changed or not.

Self::applied and Self::pending carry field names only, never their values, as SheepDrift does; the merged config never reaches a client. Self::refused is prose and is scoped out of that rule: it quotes values out of the file the caller just sent, never out of the flock’s stored config. Debug is derived on that basis: nothing here needs redacting.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

The sheep’s name, exactly as the request spelled it.

applied: Vec<String>

Fields now in force, in field-name order. Empty when the load changed nothing the daemon could act on immediately.

pending: Vec<String>

Fields the app picks up at its next spawn, in field-name order. Empty when nothing is waiting.

shep reload <name> promotes them; a client rendering this list says so, since a pending list with no remedy beside it cannot be acted on.

refused: Option<String>

Why some or all of this app’s change did not land, in the daemon’s own words, or None when the whole of it did.

Not the same question as the two lists being empty: a refusal raised before anything was touched leaves both empty, and so does a load with nothing to do. It is a sentence rather than a code because the message is what tells them apart.

Implementations

impl SheepApplied

pub fn new( name: impl Into<String>, applied: Vec<String>, pending: Vec<String>, refused: Option<String>, ) -> Self

Builds one app’s report.

Trait Implementations

impl Clone for SheepApplied

fn clone(&self) -> SheepApplied

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SheepApplied

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SheepApplied

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SheepApplied

impl PartialEq for SheepApplied

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SheepApplied

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 SheepApplied