datasynth-fingerprint 5.36.0

Privacy-preserving synthetic data fingerprinting for DataSynth
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

//! Error types for the fingerprint crate.

use thiserror::Error;

/// Result type for fingerprint operations.
pub type FingerprintResult<T> = Result<T, FingerprintError>;

/// Errors that can occur during fingerprint operations.
#[derive(Debug, Error)]
pub enum FingerprintError {
    /// I/O error during file operations.
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

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

    /// Error during JSON serialization/deserialization.
    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),

    /// Error during YAML serialization/deserialization.
    #[error("YAML error: {0}")]
    Yaml(#[from] serde_yaml::Error),

    /// Error during CSV parsing.
    #[error("CSV error: {0}")]
    Csv(#[from] csv::Error),

    /// Error during Parquet operations.
    #[error("Parquet error: {0}")]
    Parquet(#[from] parquet::errors::ParquetError),

    /// Error during Arrow operations.
    #[error("Arrow error: {0}")]
    Arrow(#[from] arrow::error::ArrowError),

    /// Invalid fingerprint format.
    #[error("Invalid fingerprint format: {0}")]
    InvalidFormat(String),

    /// Missing required component in fingerprint.
    #[error("Missing required component: {0}")]
    MissingComponent(String),

    /// Checksum mismatch.
    #[error("Checksum mismatch for {file}: expected {expected}, got {actual}")]
    ChecksumMismatch {
        file: String,
        expected: String,
        actual: String,
    },

    /// Version mismatch.
    #[error("Unsupported fingerprint version: {0}")]
    UnsupportedVersion(String),

    /// Privacy budget exhausted.
    #[error("Privacy budget exhausted: epsilon={spent}, limit={limit}")]
    PrivacyBudgetExhausted { spent: f64, limit: f64 },

    /// Insufficient data for extraction.
    #[error("Insufficient data: need at least {required} rows, got {actual}")]
    InsufficientData { required: usize, actual: usize },

    /// Statistical computation error.
    #[error("Statistical error: {0}")]
    StatisticalError(String),

    /// Data validation error.
    #[error("Validation error: {0}")]
    ValidationError(String),

    /// Configuration synthesis error.
    #[error("Config synthesis error: {0}")]
    SynthesisError(String),

    /// Extraction error.
    #[error("Extraction error in {extractor}: {message}")]
    ExtractionError { extractor: String, message: String },

    /// Privacy constraint violation.
    #[error("Privacy constraint violated: {0}")]
    PrivacyViolation(String),

    /// Matrix operation error.
    #[error("Matrix operation error: {0}")]
    MatrixError(String),

    /// Distribution fitting error.
    #[error("Distribution fitting error: {0}")]
    DistributionFitError(String),

    /// PII denylist load or parse error (SP6 Phase B).
    #[error("pii denylist: {0}")]
    PiiDenylist(String),
}

impl FingerprintError {
    /// Create an extraction error.
    pub fn extraction(extractor: &str, message: impl Into<String>) -> Self {
        Self::ExtractionError {
            extractor: extractor.to_string(),
            message: message.into(),
        }
    }
}