depiction 0.0.1

Depiction
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

use super::context::*;

/// Depiction configuration: format.
pub const DEPICTION_CONFIGURATION_FORMAT: &str = "format";

//
// DepictionFormat
//

/// Depiction format.
#[derive(Clone, Copy, Debug, Default, Eq, PartialEq)]
pub enum DepictionFormat {
    /// A single-line depiction with minimal use of whitespace.
    ///
    /// Some optional information may be omitted.
    Compact,

    /// A combination of compact and verbose formatting.
    ///
    /// Some optional information may be omitted.
    ///
    /// This is the default format.
    #[default]
    Optimized,

    /// A consistent full depiction with all optional information.
    Verbose,
}

//
// DepictionFormatUtilities
//

/// Utilities for [DepictionFormat].
pub trait DepictionFormatUtilities {
    /// Get [DepictionFormat].
    fn get_format(&self) -> DepictionFormat;

    /// Set [DepictionFormat].
    fn with_format(self, format: DepictionFormat) -> Self;
}

impl<'own> DepictionFormatUtilities for DepictionContext<'own> {
    fn get_format(&self) -> DepictionFormat {
        match self.configuration.get(DEPICTION_CONFIGURATION_FORMAT) {
            Some(format) => match format.as_str() {
                "compact" => DepictionFormat::Compact,
                "verbose" => DepictionFormat::Verbose,
                _ => DepictionFormat::Optimized,
            },

            None => DepictionFormat::Optimized,
        }
    }

    fn with_format(self, format: DepictionFormat) -> Self {
        self.with_configuration(
            DEPICTION_CONFIGURATION_FORMAT,
            match format {
                DepictionFormat::Compact => "compact",
                DepictionFormat::Verbose => "verbose",
                DepictionFormat::Optimized => "reduced",
            },
        )
    }
}