dade is a framework for defining data structure to Rust structures, like pydantic in Python.
For the easy handle of data, the following will support it. + [x] validation for (primitive) types. + [x] numeric types; u8, u16, u32, u64, u128, usize, i8, i16, i32, i64, i128, isize, f32, f64 + [x] boolean + [x] String + [x] Optional + [x] Vec + [x] nested model + [x] enum + [x] export a data schema conforms JsonSchema. + [x] load a model from JSON. + [x] dump a JSON-string from a model. + [ ] implements for useful types. e.g. URL, email and etc. + [ ] publish a trait that for you implements any custom type with your validation.
See documentation for more details.
To define a model, You need the below module.
rust
use dade::{Model, model};
For example, define user-model. ```rust
struct User {
#[field(ge = 1)]
id: u64,
#[field(minlength = 1, maxlength = 100)]
name: String,
#[field(default = "en")]
lang: String,
#[field(minlength = 1, maxlength = 255, default = null)]
url: Option
Then you create an instance of the model by the below.
rust
let input = "{\"id\": 1, \"name\": \"James Smith\"}";
let user = User::parse(input).unwrap();
And you get a Json string for the instance by the below.
rust
let json_string = user.json(false);
// json_string = "{\"id\":1,\"name\":\"James Smith\",\"lang\":\"en\",\"url\":null,\"verified\":false}"
If you want to validate a value, you will get a schema that conforms JsonSchema, for the given model, by the below.
rust
let schema = User::schema();
The schema is
json
{
"$ref": "#/definitions/User",
"definitions": {
"User": {
"title": "User",
"type": "object",
"properties": {
"id": {
"type": "integer",
"title": "Id",
"minimum": 1
},
"name": {
"type": "string",
"title": "Name",
"minLength": 1,
"maxLength": 100
},
"lang": {
"type": "string",
"title": "Lang",
"default": "en"
},
"url": {
"type": "string",
"title": "Url",
"default": null,
"minLength": 1,
"maxLength": 255
},
"verified": {
"type": "boolean",
"title": "Verified",
"default": false
}
},
"required": ["id", "name"]
}
}
}
struct User { id: u64, #[field(alias = "FirstName")] firstname: String, #[field(alias = "LastName")] lastname: String, } ```
```rust
struct Name { firstname: String, lastname: String, }
struct User { id: u64, name: Name, } ```
```rust
struct Item {
id: u64,
name: String,
value: u128,
related_items: Option