fastxdr 1.0.2

Generate Rust types from XDR specs with fast, zero-copy deserialisation
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

ident = @{ !basic_type ~ (ASCII_ALPHANUMERIC | "_")+ }
ident_const = { ident }
ident_value = { ASCII_DIGIT+ }
basic_type = @{ 
	("unsigned" ~ WHITESPACE+)? ~ ("int" | "hyper") ~ WHITESPACE+ |
	("float" | "double" | "string"| "opaque") ~ WHITESPACE+
}

// Comment types
comment = { comment_long | comment_short }
comment_long_inner = { (!"*/" ~ ANY)* }
comment_long = { "/*" ~ comment_long_inner ~ "*/" }
comment_short_inner = @{ (!NEWLINE ~ ANY)* }
comment_short = { "//" ~ comment_short_inner }

// Constant declaration
constant = { "const" ~ ident ~ "=" ~ ident ~ ";" }

// Enums
enum_type = { 
	"enum" ~ ident ~ "{" ~ 
	enum_variant+ ~ 
	("," ~ enum_variant)* ~
	"}" ~ ";" 
}
enum_variant = { ident ~ "=" ~ ident }

// A type is a type name and an optional array
array = _{ array_variable | array_fixed }
array_variable = { "<" ~ array_length? ~ ">" }
array_fixed = { "[" ~ array_length ~ "]" }
array_length = _{ ident_value | ident_const }

// Structs
struct_type = { 
	"struct" ~ ident ~ "{" ~ 
	struct_data_field* ~ 
	"}" ~ ";" 
}
struct_data_field = { data_field }
option = { "*" ~ ident }
data_field = _{ (ident | basic_type ) ~ (option | ident) ~ array? ~ ";" }

// Unions
union = { 
	"union" ~ ident ~  
	"switch" ~ "(" ~ (ident | basic_type ) ~ ident ~ ")" ~ 
	"{" ~
	(union_case | union_default)* ~ 
	"}" ~ ";"
}
union_case_value = _{ ident_value | ident_const }
union_data_field = { data_field }
union_case = { "case" ~ union_case_value ~ ":" ~ (union_data_field | union_void)? }
union_void = { "void" ~ ";" }
union_default = { "default" ~ ":" ~ (union_data_field | union_void ) }

// typedefs
typedef = { "typedef" ~ (ident | basic_type) ~ ident ~ array? ~ ";" }

item = { SOI ~ (
	constant | 
	typedef | 
	enum_type | 
	struct_type |
	union
)* ~ EOI }

WHITESPACE = _{ " " | "\t" | NEWLINE }
COMMENT = _{ comment_long | comment_short }