fixcol 0.2.0

A library for reading and writing fixed width / column delimited data files.
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

extern crate fixcol;

use fixcol::ReadFixed;

#[derive(PartialEq, Eq, Debug, ReadFixed)]
#[fixcol(strict = true)]
struct PointS {
    #[fixcol(width = 3)]
    x: u8,
    #[fixcol(skip = 1, width = 3)]
    y: u8,
}

impl PointS {
    fn new(x: u8, y: u8) -> Self {
        Self { x, y }
    }
}

#[derive(PartialEq, Eq, Debug, ReadFixed)]
#[fixcol(strict = false)]
struct PointL {
    #[fixcol(width = 3)]
    x: u8,
    #[fixcol(skip = 1, width = 3)]
    y: u8,
}

impl PointL {
    fn new(x: u8, y: u8) -> Self {
        Self { x, y }
    }
}

// strict mode should require unread columns to contain only whitespace
///////////////////////////////////////////////////////////////////////

#[test]
fn whitespace_well_formed_lax() {
    let point = PointL::read_fixed_str("123 201").unwrap();
    assert_eq!(point, PointL::new(123, 201));
}

#[test]
fn whitespace_malformed_lax() {
    let point = PointL::read_fixed_str("1234201").unwrap();
    assert_eq!(point, PointL::new(123, 201));
}

#[test]
fn whitespace_well_formed_strict() {
    let point = PointS::read_fixed_str("123 201").unwrap();
    assert_eq!(point, PointS::new(123, 201));
}

#[test]
fn whitespace_malformed_strict() {
    let err = PointS::read_fixed_str("1234201").unwrap_err();
    assert_eq!(
        err.to_string(),
        "Error handling data from \"4201\": Found non-whitespace \
        character between data fields (strict)\n",
    );

    let err = PointS::read_fixed_str("1  42  ").unwrap_err();
    assert_eq!(
        err.to_string(),
        "Error handling data from \"42  \": Found non-whitespace \
        character between data fields (strict)\n",
    );
}

// strict mode should require last field of line to be full length when reading
///////////////////////////////////////////////////////////////////////////////

#[test]
fn short_line_lax() {
    let point = PointL::read_fixed_str("7   21").unwrap();
    assert_eq!(point, PointL::new(7, 21));
}

#[test]
fn short_line_strict() {
    let err = PointS::read_fixed_str("7   21").unwrap_err();
    // TODO: need better error messaging for this
    assert_eq!(err.to_string(), "failed to fill whole buffer");
}

#[test]
fn full_line_lax() {
    let point = PointL::read_fixed_str("7   21 ").unwrap();
    assert_eq!(point, PointL::new(7, 21));
}

#[test]
fn full_line_strict() {
    let point = PointS::read_fixed_str("7   21 ").unwrap();
    assert_eq!(point, PointS::new(7, 21));
}