Release v3.0.0 · mongodb/bson-rust

The MongoDB Rust driver team is pleased to announce the v3.0.0 release of the bson crate.

Highlighted Changes

3.0 updates several APIs in backwards-incompatible ways; in most cases these changes should require only minor updates in application code.

Most notably:

Unified Error Hierarchy: 3.0 adds the bson::error::Error type, with fields for values common across errors like message or associated key and a kind enum that provides granular root cause information.
&CStr: The bson crate now provides types that directly model the BSON spec "cstring" type, removing a potential source of panic!s and allowing validation at either run-time or compile-time for constant strings.
Optional serde: Integration with serde is now an optional feature; in support of this, the API has been updated to clarify where methods are for encoding (directly converting Rust BSON values into BSON bytes) or for serialization (converting arbitrary Rust structs to BSON values or bytes via the serde crate).

For detailed information on breaking changes and code examples, please see the migration guide.

Impactful changes are listed below; for a full list of changes see this GitHub query.

RUST-1906 Remove human readable options (#531)
RUST-1380 Drop support for uuid 0.8 (#534)
RUST-2169 Clean up and future-proof features (#544)
RUST-1887 Convince append to be more accepting (#541)
RUST-1960 Make large-dates time feature optional (#546)
RUST-1406 Add crate-wide error types, convert value access errors (#551)
RUST-1406 Convert raw errors to standard error type (#552)
RUST-1998 Remove lossy utf8 as a decoder option (#550)
RUST-1869 Rename RawElement::len to RawElement::size (#557)
RUST-1992 Make serde an optional feature (#554)
RUST-1406 Add type-specific errors to standard error type (#555)
RUST-1406 Convert serde errors to standard error type (#562)
RUST-1887 Make BindRawBsonRef a little more user-friendly (#565)
RUST-1748 Convert serde helpers to serde_with::(De)SerializeAs implementations for some converters between ObjectId, String, and DateTime (#559)
RUST-1992 Introduce the &CStr and CString types for keys and regular expressions (#563)
RUST-2241 Convert panic from malformed input to error (#568)
RUST-2240 Move serde_json API behind a feature flag (#567)
RUST-1748 Convert unsigned serde helpers to use serde_conv (#575)
RUST-1748 Convert UUID serde helpers to use serde_conv (#579)
RUST-2228 Normalize conversions between raw types and base crate types (#580)
RUST-1998 Remove now-redundant to_document_utf8_lossy method (#592)