eric-sdk 0.6.0

Rust SDK for the ELSTER Rich Client (ERiC)
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

use crate::{EricApiPayload, ValidationReport};
use thiserror::Error;

#[derive(Debug, Error)]
pub enum EricError {
    #[error("API Error (code={code}): {message}")]
    ApiError {
        code: i32,
        message: String,
        payload: EricApiPayload,
    },
    /// Unstructured catch all for internal errors
    #[error("Internal error: {0}")]
    Internal(#[from] anyhow::Error),
}

impl EricError {
    /// Returns the ERiC error code if this is an API error.
    pub fn code(&self) -> Option<i32> {
        match self {
            Self::ApiError { code, .. } => Some(*code),
            Self::Internal(_) => None,
        }
    }

    /// Returns the raw validation XML returned by ERiC.
    pub fn validation_response(&self) -> Option<&str> {
        match self {
            Self::ApiError { payload, .. } => Some(payload.validation_response.as_str()),
            Self::Internal(_) => None,
        }
    }

    /// Returns the raw server XML returned by ERiC.
    pub fn server_response(&self) -> Option<&str> {
        match self {
            Self::ApiError { payload, .. } => Some(payload.server_response.as_str()),
            Self::Internal(_) => None,
        }
    }

    /// Parses the validation XML into a structured report.
    pub fn validation_report(&self) -> Result<Option<ValidationReport>, EricError> {
        let Some(validation_response) = self.validation_response() else {
            return Ok(None);
        };

        ValidationReport::parse(validation_response).map(Some)
    }
}