molframe 0.5.2

A batteries-included structural bioinformatics engine
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

//! Why a validation reference input could not be loaded.

use crate::document::DocumentError;
use molframe_core::Findings;
use molframe_validate::{ReferenceError, RotamerError};

/// Failure while loading a validation reference input.
#[derive(Debug, thiserror::Error)]
pub enum ValidationInputError {
    /// The file could not be read.
    #[error("validation input I/O failed: {0}")]
    Io(#[from] std::io::Error),
    /// JSON syntax or schema was invalid.
    #[error("invalid JSON validation input: {0}")]
    Json(#[from] serde_json::Error),
    /// TOML syntax or schema was invalid.
    #[error("invalid TOML validation input: {0}")]
    Toml(#[from] toml::de::Error),
    /// The file suffix names neither JSON nor TOML.
    #[error("validation inputs must use a .json or .toml suffix")]
    UnsupportedFormat,
    /// A field held a value its schema does not allow.
    #[error("invalid value for {field}: {reason}")]
    InvalidValue {
        /// Dotted field path within the document, such as `distribution.edges`.
        field: String,
        /// What is wrong with the value.
        reason: String,
    },
    /// A reference library or one of its distributions was refused.
    #[error("invalid reference library: {0}")]
    Reference(#[from] ReferenceError),
    /// A rotamer profile was refused.
    #[error("invalid rotamer profile: {0}")]
    Rotamer(#[from] RotamerError),
    /// A selection expression failed to compile or evaluate.
    #[error("selection for {id} failed: {findings}")]
    Selection {
        /// The plane or group the selection belongs to.
        id: String,
        /// The compile or evaluation diagnostics.
        findings: Findings,
    },
}

impl From<DocumentError> for ValidationInputError {
    fn from(error: DocumentError) -> Self {
        match error {
            DocumentError::Io(error) => Self::Io(error),
            DocumentError::Json(error) => Self::Json(error),
            DocumentError::Toml(error) => Self::Toml(error),
            DocumentError::UnsupportedFormat => Self::UnsupportedFormat,
        }
    }
}

impl ValidationInputError {
    pub(super) fn invalid(field: impl Into<String>, reason: impl Into<String>) -> Self {
        Self::InvalidValue {
            field: field.into(),
            reason: reason.into(),
        }
    }
}