dta 0.1.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
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

use std::fs::File;

use dta::stata::dta::dta_reader::DtaReader;

#[test]
#[ignore = "Using local file that requires a license"]
fn read_auto_dta_section_counts() {
    let file = File::open("/mnt/c/Publish/auto.dta").expect("failed to open auto.dta");
    let header_reader = DtaReader::default().from_file(file);

    // Header + Schema
    let schema_reader = header_reader.read_header().expect("failed to read header");
    assert_eq!(schema_reader.header().variable_count(), 12);
    assert_eq!(schema_reader.header().observation_count(), 74);

    let mut characteristic_reader = schema_reader.read_schema().expect("failed to read schema");

    // Characteristics
    let mut characteristic_count = 0;
    while characteristic_reader
        .read_characteristic()
        .expect("failed to read characteristic")
        .is_some()
    {
        characteristic_count += 1;
    }
    assert_eq!(characteristic_count, 4);

    let mut record_reader = characteristic_reader
        .into_record_reader()
        .expect("failed to transition to record reader");

    // Records
    let mut record_count = 0u64;
    while record_reader
        .read_record()
        .expect("failed to read record")
        .is_some()
    {
        record_count += 1;
    }
    assert_eq!(record_count, 74);

    // Long strings (strls come before value labels in the file)
    let mut long_string_reader = record_reader
        .into_long_string_reader()
        .expect("failed to transition to long string reader");

    let mut long_string_count = 0;
    while long_string_reader
        .read_long_string()
        .expect("failed to read long string")
        .is_some()
    {
        long_string_count += 1;
    }
    assert_eq!(long_string_count, 0);

    // Value labels
    let mut value_label_reader = long_string_reader
        .into_value_label_reader()
        .expect("failed to transition to value label reader");

    let mut value_label_set_count = 0;
    while value_label_reader
        .read_value_label_set()
        .expect("failed to read value label set")
        .is_some()
    {
        value_label_set_count += 1;
    }
    assert_eq!(value_label_set_count, 1);
}