pulith-verify 0.2.0

Content verification primitives for downloaded artifacts
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

use std::io;
use thiserror::Error;

/// Error types for verification operations.
///
/// Follows the error handling patterns specified in [AGENT.md](../../docs/AGENT.md).
#[derive(Error, Debug)]
pub enum VerifyError {
    /// Hash mismatch between expected and actual digest
    #[error("hash mismatch: expected {expected:?}, got {actual:?}")]
    HashMismatch {
        /// The expected hash digest
        expected: Vec<u8>,
        /// The actual computed hash digest
        actual: Vec<u8>,
    },

    /// Processed stream length did not match expectation
    #[error("stream length mismatch: expected {expected} bytes, got {actual}")]
    SizeMismatch {
        /// Expected number of bytes to be processed
        expected: u64,
        /// Actual number of bytes processed
        actual: u64,
    },

    /// I/O error during verification process
    #[error("I/O error during verification: {0}")]
    Io(#[from] io::Error),

    /// Hexadecimal decoding error when parsing expected hash
    #[error("hex decoding error: {0}")]
    HexDecode(#[from] hex::FromHexError),
}

/// Result type alias for verification operations.
pub type Result<T> = std::result::Result<T, VerifyError>;