Magnet，一个 JSON 架构生成器

这两个相关 crate，magnet_derive 和 magnet_schema 帮助您定义（并在大多数情况下自动推导）适用于您的领域模型类型的 MongoDB 风格的 JSON 架构。目前，该库的主要用例是在使用 Avocado 或 MongoDB Rust 驱动程序时轻松验证可序列化类型。

定义的 BsonSchema trait 定义了一个函数，bson_schema，它应该/将返回一个 Bson Document，该文档是一个有效的 JSON 架构，描述了实现类型的结构。示例

#[macro_use]
extern crate serde_derive;
extern crate serde;
#[macro_use]
extern crate bson;
#[macro_use]
extern crate magnet_derive;
extern crate magnet_schema;
extern crate mongodb;

use std::collections::HashSet;
use magnet_schema::BsonSchema;

use mongodb::{ Client, ThreadedClient, CommandType };
use mongodb::db::{ ThreadedDatabase };

#[derive(BsonSchema)]
struct Person {
    name: String,
    nicknames: HashSet<String>,
    age: usize,
    contact: Option<Contact>,
}

#[derive(BsonSchema, Serialize, Deserialize)]
#[serde(tag = "type", content = "value")]
enum Contact {
    Email(String),
    Phone(u64),
}

fn main() {
    let schema = Person::bson_schema();
    let spec = doc! {
        "create": "Person",
        "validator": { "$jsonSchema": schema },
    };
    let client = Client::connect("localhost", 27017).expect("can't connect to mongod");
    let db = client.db("Example");
    db.command(spec, CommandType::CreateCollection, None).expect("network error");
    // etc.
}

有关里程碑和自定义 #[attributes]，请参阅 文档。

发布说明

v0.8.0

• 为 VecDeque、BinaryHeap、LinkedList、Range、RangeInclusive 和 PhantomData 实现 BsonSchema
• 在适当的地方对映射键和集合元素添加了 Eq + Hash 和 Ord 约束