Skip to content

v0.11.0
Compare
Choose a tag to compare
@saghm saghm released this 03 Jun 18:46
v0.11.0
7156e1e
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

Description

The MongoDB Rust driver team is pleased to announce the first release candidate of the driver, v0.11.0.

Major Features

In preparation of stabilizing the API of the driver, we made a number of breaking changes. The
individual changes are listed below in the release notes, each with a short description of why we
made the change.

Release Notes

Breaking Changes

  • RUST-261 Mark enums and options struct as non-exhaustible
    • In order to ensure that adding new variants to our enums (e.g. mongodb::error::ErrorKind) in
      the future will not cause breaking changes for users who are pattern matching them, we've
      marked some of them as non-exhaustive. Additionally, in order to be able to add new options to
      our options structs in the future, we've also marked them as non-exhaustive. This has the
      side-effect of making them impossible to instantiate with struct literals. The workaround is to
      use the auto-generated builder pattern API for them, which continues to be available as before.
  • RUST-434 Rewrite ReadConcern as a struct
    • In order to allow us to add any potential new read concern options that might be added in the
      future, we've changed mongodb::options::ReadConcern to be a (non-exhaustive) struct rather
      than an enum. To ensure that it's easy to use, we've added a helper method for each ReadConcern
      level to faciliatate construction.
  • RUST-433 Rename "Tag" Acknowledgement case to "Custom"
    • The original name for this enum variant was a bit misleading. The official documentation for
      write
      concerns
      has since been updated to describe this type of write concern as "custom" rather than "tag", so
      we changed the API of the driver accordingly.
  • RUST-435 Standardize on options exporting strategy
    • We previously exported the authentication options exposed by the driver under the namespace
      mongodb::options::auth, whereas the rest of the driver's options were exported directly from
      mongodb::options. We now export the auth options directly from mongodb::options for
      consistency.

Bug fixes

  • RUST-408 Sync API not included in the generated documentation

New Features

  • RUST-289 Implicit Sessions
  • RUST-392 Suppress "ns not found" errors
  • RUST-396 run_command should parse server errors
  • RUST-409 Add DriverInfoOptions to client metadata

Improvements

  • RUST-439 Return errors when unacknowledged write concerns are passed in
Assets 2
Loading