sscanf 0.5.0

A sscanf (inverse of format!()) macro with near unlimited parsing capabilities
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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182

///// NoAttributes /////
#[derive(sscanf::FromScanf)]
struct TestNoAttributes;
//~    ^^^^^^^^^^^^^^^^ FromScanf: structs must have a format string as an attribute.
//~                     Please add either of #[sscanf(format = "...")], #[sscanf(format_regex = "...")] or #[sscanf("...")]

///// EmptyAttribute /////
#[derive(sscanf::FromScanf)]
#[sscanf]
struct TestEmptyAttribute;

//~~~~~~~~~~~~~~~~~~~~ errors ~~~~~~~~~~~~~~~~~~~~//

// error: expected attribute arguments in parentheses: `sscanf(...)`
//  --> derive_struct_attributes.rs:2:3
//   |
// 2 | #[sscanf]
//   |   ^^^^^^

///// EmptyAttribute2 /////
#[derive(sscanf::FromScanf)]
#[sscanf()]
struct TestEmptyAttribute2;
//~    ^^^^^^^^^^^^^^^^^^^ FromScanf: structs must have a format string as an attribute.
//~                        Please add either of #[sscanf(format = "...")], #[sscanf(format_regex = "...")] or #[sscanf("...")]

///// AssignedAttribute /////
#[derive(sscanf::FromScanf)]
#[sscanf = ""]
struct TestAssignedAttribute;

//~~~~~~~~~~~~~~~~~~~~ errors ~~~~~~~~~~~~~~~~~~~~//

// error: attribute arguments must be in parentheses: `sscanf("")`
//  --> derive_struct_attributes.rs:2:3
//   |
// 2 | #[sscanf = ""]
//   |   ^^^^^^^^^^^

///// TooManyAttributes /////
#[derive(sscanf::FromScanf)]
#[sscanf(format = "", format_regex = "")]
//~                   ^^^^^^^^^^^^^^^^^ cannot specify both `format` and `format_regex`
//~      ^^^^^^^^^^^ cannot specify both `format` and `format_regex`
struct TestTooManyAttributes;

///// TooManyAttributes2 /////
#[derive(sscanf::FromScanf)]
#[sscanf(format = "", format_regex = "", transparent)]
//~                                      ^^^^^^^^^^^ only one of `format`, `format_regex`, or `transparent` is allowed
//~                   ^^^^^^^^^^^^^^^^^ only one of `format`, `format_regex`, or `transparent` is allowed
//~      ^^^^^^^^^^^ only one of `format`, `format_regex`, or `transparent` is allowed
struct TestTooManyAttributes2;

///// MultipleAttributes /////
#[derive(sscanf::FromScanf)]
#[sscanf(format = "")]
//~      ^^^^^^^^^^^ previous use here
#[sscanf(format = "")]
//~      ^^^^^^^^^^^ attribute `format` is specified multiple times
struct TestMultipleAttributes;

///// MultipleDifferentAttributes /////
#[derive(sscanf::FromScanf)]
#[sscanf(format = "")]
//~      ^^^^^^^^^^^ cannot specify both `format` and `format_regex`
#[sscanf(format_regex = "")]
//~      ^^^^^^^^^^^^^^^^^ cannot specify both `format` and `format_regex`
struct TestMultipleDifferentAttributes;

///// InvalidAttribute /////
#[derive(sscanf::FromScanf)]
#[sscanf(format = "", bob = "")]
//~                   ^^^ unknown attribute `bob`. Valid attributes are: `format`, `format_regex`, or `transparent`
struct TestInvalidAttribute;

///// MultipleInvalidAttribute /////
#[derive(sscanf::FromScanf)]
#[sscanf(format = "")]
#[sscanf(bob = "")]
//~      ^^^ unknown attribute `bob`. Valid attributes are: `format`, `format_regex`, or `transparent`
struct TestMultipleInvalidAttribute;

///// MissingComma /////
#[derive(sscanf::FromScanf)]
#[sscanf(format = "" bob = "")]
//~                  ^^^ expected `,`
struct TestMissingComma;

///// FormatNotString /////
#[derive(sscanf::FromScanf)]
#[sscanf(format = 5)]
//~               ^ expected string literal
struct TestFormatNotString;

///// FormatMissingValue /////
#[derive(sscanf::FromScanf)]
#[sscanf(format =)]
//~              ^ expected an expression after `=`
struct TestFormatMissingValue;

///// FormatMissingEquals /////
#[derive(sscanf::FromScanf)]
#[sscanf(format "")]
//~             ^^ expected `,` or `=`
struct TestFormatMissingEquals;

///// FormatJustIdent /////
#[derive(sscanf::FromScanf)]
#[sscanf(format)]
//~      ^^^^^^ attribute `format` has the format: `#[sscanf(format = "<format>")]`
//~             where `<format>` is a format string using the field names inside of its placeholders
struct TestFormatJustIdent;

///// FormatMissingName /////
#[derive(sscanf::FromScanf)]
#[sscanf(= "")]
//~      ^ expected identifier
struct TestFormatMissingName;

///// DefaultOnStruct /////
#[derive(sscanf::FromScanf)]
#[sscanf(default)]
//~      ^^^^^^^ attribute `default` can only be used on fields.
//~              structs can have the following attributes: `format`, `format_regex`, or `transparent`
struct TestDefaultOnStruct;

///// DefaultWithValueOnStruct /////
#[derive(sscanf::FromScanf)]
#[sscanf(default = "")]
//~      ^^^^^^^ attribute `default` can only be used on fields.
//~              structs can have the following attributes: `format`, `format_regex`, or `transparent`
struct TestDefaultWithValueOnStruct;

///// InvalidIdent /////
#[derive(sscanf::FromScanf)]
#[sscanf(bob)]
//~      ^^^ unknown attribute `bob`. Valid attributes are: `format`, `format_regex`, or `transparent`
struct TestInvalidIdent;

///// TypoInIdent /////
#[derive(sscanf::FromScanf)]
#[sscanf(formt)]
//~      ^^^^^ unknown attribute `formt`. Did you mean `format`?
struct TestTypoInIdent;

///// MoreTyposInIdent /////
#[derive(sscanf::FromScanf)]
#[sscanf(formad_reggae)]
//~      ^^^^^^^^^^^^^ unknown attribute `formad_reggae`. Did you mean `format_regex`?
struct TestMoreTyposInIdent;

///// TyposAndWrongIdent /////
#[derive(sscanf::FromScanf)]
#[sscanf(defauld)]
//~      ^^^^^^^ unknown attribute `defauld` is similar to `default`, which can only be used on fields.
//~              structs can have the following attributes: `format`, `format_regex`, or `transparent`
struct TestTyposAndWrongIdent;

///// TransparentNoField /////
#[derive(sscanf::FromScanf)]
#[sscanf(transparent)]
//~      ^^^^^^^^^^^ structs or variants marked as `transparent` must have exactly one field
struct TestTransparentNoField;

///// TransparentMultiField /////
#[derive(sscanf::FromScanf)]
#[sscanf(transparent)]
//~      ^^^^^^^^^^^ structs or variants marked as `transparent` must have exactly one field
struct TestTransparentMultiField(usize, u8);

///// TransparentArg /////
#[derive(sscanf::FromScanf)]
#[sscanf(transparent(5))]
//~                 ^ expected `,` or `=`
struct TestTransparentArg(usize);

///// TransparentValue /////
#[derive(sscanf::FromScanf)]
#[sscanf(transparent = "true")]
//~                    ^^^^^^ attribute `transparent` does not take a value
struct TestTransparentValue(usize);