bson-rs

Encoding and decoding support for BSON in Rust

Useful links

• API Documentation
• Serde

Installation

This crate works with Cargo and can be found on crates.io with a Cargo.toml like:

toml [dependencies] bson = "0.7"

Usage

Link the library in main.rs:

```rust

[macro_use(bson, doc)]

extern crate bson; ```

Prepare your struct for Serde serialization:

```rust

[derive(Serialize, Deserialize, Debug)]

pub struct Person { #[serde(rename = "_id")] // Use MongoDB's special primary key field name when serializing pub id: String, pub name: String, pub age: u32 } ```

Serialize the struct:

```rust use bson;

let person = Person { id: "12345", name: "Emma", age: 3 };

let serializedperson = bson::tobson(&person)?; // Serialize

if let bson::Bson::Document(document) = serializedperson { mongoCollection.insertone(document, None)?; // Insert into a MongoDB collection } else { println!("Error converting the BSON object into a MongoDB document"); } ```

Deserialize the struct:

```rust // Read the document from a MongoDB collection let persondocument = mongoCollection.findone(Some(doc! { "_id" => "12345" }), None)? .expect("Document not found");

// Deserialize the document into a Person instance let person = bson::frombson(bson::Bson::Document(persondocument))? ```