dta 0.2.0

Pure Rust streaming reader and writer for Stata's DTA file format, covering every released version (104-119), including XML-framed releases, tagged missing values, value-label sets, and long-string (strL) storage.
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

use core::fmt;

/// Unified error type for Stata value parsing.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum StataError {
    /// A raw value does not encode a Stata missing value.
    NotMissingValue,
    /// A tagged missing value (`.a`–`.z`) was encountered in a
    /// context that only supports the system missing value (`.`) —
    /// pre-V113 DTA formats do not carry tagged missings.
    TaggedMissingUnsupported,
    /// A timestamp string does not match the expected DTA format
    /// `"dd Mon yyyy hh:mm"`.
    InvalidTimestamp,
}

impl fmt::Display for StataError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.write_str(match self {
            Self::NotMissingValue => "value is not a Stata missing value",
            Self::TaggedMissingUnsupported => {
                "tagged missing values (.a–.z) are not supported by this DTA format"
            }
            Self::InvalidTimestamp => "invalid DTA timestamp",
        })
    }
}

impl std::error::Error for StataError {}

/// Convenience alias for results using [`StataError`].
pub type Result<T> = std::result::Result<T, StataError>;