maps_io_ros 0.3.0

Fundamental IO for 2D ROS grid maps.
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

//! Error handling for the `maps_io_ros` crate.

use thiserror::Error;

pub type Result<T> = std::result::Result<T, Error>;

/// Error types for the `maps_io_ros` crate.
/// Allows to wrap external errors in a unified way.
#[derive(Error, Debug)]
pub enum Error {
    /// An I/O error with additional context.
    #[error("[IO error] {context} ({source})")]
    Io {
        context: String,
        #[source]
        source: std::io::Error,
    },

    /// An image loading error with additional context.
    #[error("[Image error] {context} ({source})")]
    Image {
        context: String,
        #[source]
        source: image::ImageError,
    },

    /// YAML serialization or deserialization error with additional context.
    #[error("[YAML error] {context} ({source})")]
    Yaml {
        context: String,
        #[source]
        source: serde_yaml_ng::Error,
    },
}

/// Macro for generating wrapping error constructors with doc comments.
#[macro_export]
macro_rules! impl_error_constructors {
    ($($method_name:ident => $variant:ident, $error_type:ty);* $(;)?) => {
        $(
            #[doc = concat!("Wrap a `", stringify!($error_type), "` with additional context message.")]
            pub fn $method_name(context: impl ToString, source: $error_type) -> Self {
                Self::$variant {
                    context: context.to_string(),
                    source,
                }
            }
        )*
    };
}

impl Error {
    // Generate the wrapping error constructors.
    impl_error_constructors! {
        io => Io, std::io::Error;
        image => Image, image::ImageError;
        yaml => Yaml, serde_yaml_ng::Error;
    }
}