yang5 0.1.0

libyang5 bindings for Rust
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
67
68

//
// Copyright (c) The yang-rs Core Contributors
//
// SPDX-License-Identifier: MIT
//

use crate::context::Context;
use crate::utils::*;
use libyang5_sys as ffi;

/// A convenience wrapper around `Result` for `yang5::Error`.
pub type Result<T> = std::result::Result<T, Error>;

/// Enum listing possible errors from yang5.
#[derive(Debug, Eq, PartialEq)]
pub struct Error {
    pub errcode: ffi::LY_ERR::Type,
    pub msg: Option<String>,
    pub path: Option<String>,
    pub apptag: Option<String>,
}

impl Error {
    pub fn new(ctx: &Context) -> Error {
        let error = unsafe { ffi::ly_err_last(ctx.raw) };
        if error.is_null() {
            return Self {
                ..Default::default()
            };
        }

        let errcode = unsafe { (*error).err };
        let msg = unsafe { char_ptr_to_opt_string((*error).msg, false) };
        let path = unsafe { char_ptr_to_opt_string((*error).data_path, false) };
        let apptag = unsafe { char_ptr_to_opt_string((*error).apptag, false) };

        Self {
            errcode,
            msg,
            path,
            apptag,
        }
    }
}

impl Default for Error {
    fn default() -> Self {
        Self {
            errcode: ffi::LY_ERR::LY_EOTHER,
            msg: None,
            path: None,
            apptag: None,
        }
    }
}

impl std::fmt::Display for Error {
    // Print only the base error message by default.
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        if let Some(msg) = &self.msg {
            write!(f, "{}", msg)
        } else {
            write!(f, "Unknown error: {}", self.errcode)
        }
    }
}

impl std::error::Error for Error {}