Struct metrix::snapshot::Snapshot

pub struct Snapshot {
    pub items: Vec<(String, ItemKind)>,
}

A Snapshot which contains measured values at a point in time.

Fields

items: Vec<(String, ItemKind)>

Methods

impl Snapshot

pub fn push<K: Into<String>, V: Into<ItemKind>>(&mut self, k: K, v: V)

pub fn find_with_separator(&self, path: &str, separator: char) -> FindItem

Find an item on a path with a given a separator.

Same as find but with a configurable separator.

pub fn find(&self, path: &str) -> FindItem

Find an item on a path with a / as a separator.

If the path is empty None is returned.

Since a Snapshot may contain multiple items with the same name only the first found will be returned.

If a prefix of a path leads to a value that value is returned and the rest of the path is discarded.

Empty segments of a path are ignored.

Example

use metrix::snapshot::*;
use metrix::snapshot::FindItem::*;

// a -> 23
// b -> c -> 42

let inner = ItemKind::Snapshot(Snapshot {
    items: vec![("c".to_string(), ItemKind::UInt(42))],
});

let snapshot = Snapshot {
    items: vec![
        ("a".to_string(), ItemKind::UInt(23)),
        ("b".to_string(), inner.clone()),
    ],
};

assert_eq!(snapshot.find("a"), Found(&ItemKind::UInt(23)));
assert_eq!(snapshot.find("a/x"), Found(&ItemKind::UInt(23)));
assert_eq!(snapshot.find("/a/x"), Found(&ItemKind::UInt(23)));

assert_eq!(snapshot.find("b"), Found(&inner));

assert_eq!(snapshot.find("b/c"), Found(&ItemKind::UInt(42)));
assert_eq!(snapshot.find("/b//c"), Found(&ItemKind::UInt(42)));

assert_eq!(snapshot.find("b/c/x"), Found(&ItemKind::UInt(42)));

assert_eq!(snapshot.find(""), NotFound);

assert_eq!(snapshot.find("/"), NotFound);

pub fn to_default_json(&self) -> String

Output JSON with default settings.

pub fn to_json(&self, config: &JsonConfig) -> String

Output JSON with the given settings.

Trait Implementations

impl Clone for Snapshot

fn clone(&self) -> Snapshot

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Snapshot

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

Formats the value using the given formatter.

impl Default for Snapshot

fn default() -> Snapshot

Returns the "default value" for a type.

impl From<Snapshot> for ItemKind

fn from(what: Snapshot) -> ItemKind

Performs the conversion.

impl PartialEq<Snapshot> for Snapshot

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralPartialEq for Snapshot