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
//!# Native JSON for Rust
//!
//!This crate provides native JSON syntax for Rust, it brings with a powerful way of parsing JSON syntax into native Rust structs. You can declare the JSON object natively as you do with JavaScript, JSON in Rust was made easy!
//!
//!> Note: This crate is just a crude proc-macro (compiler plugin), for more features, please refer to [native-json](https://crates.io/crates/native-json)
//!
//!## Usage
//!Add dependencies to your Cargo.toml, `serde_json` is only needed if you want to stringify the JSON object.
//!```toml
//![dependencies]
//!native-json = "1.2"
//!serde = {version = "1.0", features = ["derive"] }
//!serde_json = "1.0"
//!```
//!
//!## Example of using native JSON object
//!```rust
//!use native_json::json;
//!use std::collections::HashMap;
//!use serde::{Deserialize, Serialize};
//!
//!fn main()
//!{
//! let mut json = json!{
//! name: "native json",
//! style: {
//! color: "red",
//! size: 12,
//! bold: true,
//! range: null
//! },
//! array: [5,4,3,2,1],
//! vector: vec![1,2,3,4,5],
//! hashmap: HashMap::from([ ("a", 1), ("b", 2), ("c", 3) ]);,
//! students: [
//! {name: "John", age: 18},
//! {name: "Jack", age: 21},
//! ],
//! };
//!
//! // Native access
//! json.style.size += 1;
//! json.students[0].age += 2;
//!
//! // Debug
//! println!("{:#?}", t);
//!
//! // Stringify
//! let text = json.string().unwrap();
//! println!("{}", text);
//!}
//!```
//!## Declare a named JSON struct
//!
//!With JSON declare syntax, you can declare nested native JSON object in place.
//!Note: Identifier with underscore suffix will be renamed when serialize and deserialize, `type_` will be renamed to `type`.
//!
//!### JSON Declare Syntax
//!```rust
//!json!{
//!JSON_OBJECT_NAME {
//! name : type,
//! value: type?, // optional field when serialize & deserialize
//! type_: String, // suffix underscore will be removed when serialize & deserialize
//! array: [type],
//! object: {
//! name: type,
//! ...
//! },
//! ...
//!}}
//!```
//!
//!The native-json will generate native Rust structs for you, each object is named by object hierarchy path, concatenated with underscore.
//!
//! 1. `JSON_OBJECT_NAME.object` was converted to `JSON_OBJECT_NAME_object`
//! 2. `JSON_OBJECT_NAME.array's item` was converted to `JSON_OBJECT_NAME_array_item`
//!
//!## Example of using named JSON object
//!
//!```rust
//!use native_json::json;
//!use serde::{Deserialize, Serialize};
//!use std::collections::HashMap;
//!
//!json!{
//!School {
//! name: String,
//! rank: u32?, // optional
//! students: [
//! { name: String, age: u16 },
//! ...
//! ],
//! map: HashMap<String, String>,
//! nullable: Option<String>
//!}}
//!
//!fn main()
//!{
//! let mut school = School::new();
//!
//! school.name = "MIT".to_string();
//! school.map.insert("Tom".to_owned(), "Profile".to_owned());
//!
//! // using initializer
//! let mut john = School_students_item::new();
//! john.name = "John".to_owned();
//! john.age = 18;
//! school.students.push(john);
//!
//! // using struct
//! let jack = School_students_item { name: "Jack".to_string(), age: 21 };
//! school.students.push(jack);
//!
//! // show
//! println!("{:#?}", school);
//!}
//!```
//!
extern crate proc_macro;
use *;
use TokenStream;
use FromStr;
use parse_macro_input;
/// Declare or instantiate a native JSON object, please refere to module [json](index.html)