Struct Document 

pub struct Document(/* private fields */);

A resolved configuration section.

Debug prints shape, never values

Hand-written for the reason Snapshot and Value are: this type holds the resolved configuration, passwords included, and {:?} in a log line is exactly how a resolved secret escapes. The values leave this process through one door — the document endpoint — and a Debug that rendered them would quietly open a second.

Implementations

impl Document

pub fn as_json(&self) -> &Value

The document as JSON, for the one endpoint that serves values.

pub fn leaf_paths(&self) -> Vec<String>

The dotted path of every leaf, in order.

The same walk Snapshot::leaf_paths performs, and for the same purpose: a caller that wants to know which keys exist without being handed what is in them. An array is a leaf — its elements are values, not configuration keys — and so is an empty table, which would otherwise vanish from the listing entirely.

Trait Implementations

impl Clone for Document

fn clone(&self) -> Document

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Document

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Document

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Document

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

where __S: Serializer,

Serialize this value into the given Serde serializer.