knx-rs-prod 0.2.0

Cross-platform .knxprod generator for KNX ETS product databases
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

// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 Fabian Schmieder

//! Error types for knxprod generation.

use std::path::PathBuf;

/// Errors that can occur during .knxprod generation.
#[derive(Debug, thiserror::Error)]
pub enum KnxprodError {
    /// I/O error reading or writing files.
    #[error("I/O error on {path}: {source}")]
    Io {
        /// The file path involved.
        path: PathBuf,
        /// The underlying I/O error.
        source: std::io::Error,
    },

    /// XML parsing error.
    #[error("XML error: {0}")]
    Xml(#[from] quick_xml::Error),

    /// ZIP archive error.
    #[error("ZIP error: {0}")]
    Zip(#[from] zip::result::ZipError),

    /// Required XML element is missing.
    #[error("missing required element: {0}")]
    MissingElement(&'static str),

    /// Invalid XML structure.
    #[error("invalid XML structure: {0}")]
    InvalidStructure(String),
}

impl KnxprodError {
    /// Create an I/O error with path context.
    pub fn io(path: impl Into<PathBuf>, source: std::io::Error) -> Self {
        Self::Io {
            path: path.into(),
            source,
        }
    }
}