dpp-digital-link 0.12.0

GS1 Digital Link parser/builder and JSON-LD helpers for Odal Node
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

//! Error type for GS1 Digital Link parsing.

use dpp_domain::GtinError;
use thiserror::Error;

#[derive(Debug, Error)]
pub enum DigitalLinkError {
    #[error("URI is missing the '/01/' GTIN segment")]
    MissingGtin,
    #[error("GTIN must be 8, 12, 13, or 14 digits, got '{0}'")]
    InvalidGtin(String),
    #[error("GTIN check digit invalid for '{gtin}': expected {expected}, got {actual}")]
    InvalidGtinCheckDigit {
        gtin: String,
        expected: u32,
        actual: u32,
    },
    #[error("URI scheme must be 'https', got '{0}'")]
    InvalidScheme(String),
    #[error("Unknown Application Identifier '{0}' in URI path")]
    UnknownApplicationIdentifier(String),
    #[error(
        "Qualifiers out of canonical order: '{after}' (order {after_ord}) must not follow '{before}' (order {before_ord})"
    )]
    QualifiersOutOfOrder {
        before: String,
        before_ord: u8,
        after: String,
        after_ord: u8,
    },
    #[error("URI contains more than one '/01/' GTIN (primary key) segment")]
    DuplicatePrimaryKey,
    #[error("URI has a trailing Application Identifier '{0}' with no value")]
    TrailingUnpairedSegment(String),
    #[error(
        "Application Identifier '{code}' value exceeds its maximum length of {max_len} (got {actual})"
    )]
    ValueTooLong {
        code: String,
        max_len: usize,
        actual: usize,
    },
}

impl From<GtinError> for DigitalLinkError {
    fn from(e: GtinError) -> Self {
        match e {
            GtinError::InvalidFormat(s) => DigitalLinkError::InvalidGtin(s),
            GtinError::InvalidCheckDigit {
                gtin,
                expected,
                actual,
            } => DigitalLinkError::InvalidGtinCheckDigit {
                gtin,
                expected: u32::from(expected),
                actual: u32::from(actual),
            },
            // Forward-compat: map any future GtinError variant onto the generic
            // invalid-GTIN error, preserving its message.
            other => DigitalLinkError::InvalidGtin(other.to_string()),
        }
    }
}