Mongo Rust driver built on top of the Mongo C driver
Go to file
Thijs Cadier 74c38fe32a Show code and domain in bsonc error debug output
mongoc-sys Enable mongoc trace log
src Show code and domain in bsonc error debug output
tests Show code and domain in bsonc error debug output
.gitignore Rename wrapper package and use openssl-sys crate
Cargo.toml Add log handling
LICENSE Initial version
README.md Add log handling

README.md

Mongo Rust Driver

About

Mongo Rust driver built on top of the Mongo C driver. This drivers aims to be a thin wrapper around the production-ready C driver, while providing a safe and ergonomic Rust interface that handles all the gnarly usage details of the C driver for you.

Bson encoding and decoding is handled by the bson crate, the bindings are generated using bindgen.

The API is experimental, it might change at any time.

Compatibility

The driver currently only builds on Unix, tested on Mac Os X and Linux so far. On Mac Os X you might need to set this environment var for building to work (see https://github.com/crabtw/rust-bindgen#building for details):

export DYLD_LIBRARY_PATH=/Library/Developer/CommandLineTools/usr/lib

Logging

All internal logging by mongoc is redirected to the macros in the log crate. See the log docs to configure output in your application.

Examples

See the tests directory for examples of how to use the driver.

Contributing

Contributions are very welcome, only the parts of the C driver we need have been wrapped so far. Please write a test for any behavior you add.