sas7bdat 0.2.0

Rust library + CLI for decoding SAS7BDAT datasets and streaming them to modern formats.
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

use super::{labels::LabelSet, variables::Variable};
use std::collections::HashMap;
use time::OffsetDateTime;

/// High-level metadata for a SAS dataset.
#[derive(Debug, Clone)]
pub struct DatasetMetadata {
    pub row_count: u64,
    pub column_count: u32,
    pub version: SasVersion,
    pub compression: Compression,
    pub endianness: Endianness,
    pub timestamps: DatasetTimestamps,
    pub table_name: Option<String>,
    pub file_label: Option<String>,
    pub file_encoding: Option<String>,
    pub vendor: Vendor,
    pub variables: Vec<Variable>,
    pub label_sets: HashMap<String, LabelSet>,
    pub column_list: Vec<i16>,
}

impl DatasetMetadata {
    #[must_use]
    pub fn new(column_count: u32) -> Self {
        Self {
            row_count: 0,
            column_count,
            version: SasVersion::default(),
            compression: Compression::None,
            endianness: Endianness::Little,
            timestamps: DatasetTimestamps::default(),
            table_name: None,
            file_label: None,
            file_encoding: None,
            vendor: Vendor::Sas,
            variables: Vec::with_capacity(column_count as usize),
            label_sets: HashMap::new(),
            column_list: Vec::new(),
        }
    }

    #[must_use]
    pub fn column_index(&self, name: &str) -> Option<usize> {
        let trimmed = name.trim_end();
        for variable in &self.variables {
            if variable.name == name || variable.name.trim_end() == trimmed {
                return Some(variable.index as usize);
            }
        }
        None
    }
}

/// Dataset creation and modification times.
#[derive(Debug, Clone, Default)]
pub struct DatasetTimestamps {
    pub created: Option<OffsetDateTime>,
    pub modified: Option<OffsetDateTime>,
}

/// SAS version components extracted from the header.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub struct SasVersion {
    pub major: u16,
    pub minor: u16,
    pub revision: u16,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Vendor {
    Sas,
    StatTransfer,
    Other(u16),
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Compression {
    None,
    Row,
    Binary,
    Unknown(u16),
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Endianness {
    Little,
    Big,
}