Skip to content

MongoDB Go Driver 1.0.0 Release Candidate 1

Pre-release
Pre-release
Compare
Choose a tag to compare
@skriptble skriptble released this 22 Feb 20:41
· 1491 commits to master since this release

The MongoDB Go driver team is pleased to release v1.0.0-rc1 of the official Go driver.

This release changes the import path for the driver from github.com/mongodb/mongo-go-driver to go.mongodb.org/mongo-driver. If you have previously downloaded the driver you will need to move it to the new location within your GOPATH.

Documentation can be found on GoDoc and the MongoDB documentation site. BSON library documentation is also available on GoDoc. Questions and inquiries can be asked on the mongo-go-driver Google Group. Bugs can be reported in the Go Driver Jira where a list of current issues can be found.

New Import Path

The base import path for the driver has changed. The new path is go.mongodb.org/mongo-driver. Package locations under the import path remain the same, e.g. the mongo package is located under go.mongodb.org/mongo-driver/mongo.

mongo.Client Creation

The mongo.Client construction functions no longer take a string URI parameter. Instead, a MongoDB URI can be provided as an option.

Previous API: mongo.NewClient("mongodb://localhost:27017/")
New API: mongo.NewClient(options.Client().ApplyURI("mongodb://localhost:27017/"))

Release Notes

Bug

  • [GODRIVER-767] - client.Disconnect(nil) causes a panic
  • [GODRIVER-768] - documentation example test failing
  • [GODRIVER-789] - Deprecated Count method is still in the public API
  • [GODRIVER-802] - Document fields corrupted in transformAndEnsureID
  • [GODRIVER-805] - BSON field '$changeStream.maxAwaitTimeMS' is an unknown field
  • [GODRIVER-811] - Modify change stream test to only run if WireVersion < 8
  • [GODRIVER-812] - Server String() function access unprotected variables
  • [GODRIVER-813] - Aggregate Test Failing
  • [GODRIVER-815] - Can only interact with GridFS files by id via ObjectIds
  • [GODRIVER-817] - Fix killCursor helper in collection tests
  • [GODRIVER-819] - driver.KillCursors broken
  • [GODRIVER-831] - GSSAPI Authentication starts SASL conversation wrong
  • [GODRIVER-833] - GridFS default chunk size is 255 kB, not 255 KiB
  • [GODRIVER-839] - GoDoc for mongo.Client does not match API
  • [GODRIVER-846] - Unable to authenticate to a replica set member using the keyfile

New Feature

  • [GODRIVER-524] - Implement SDAM Error Handling
  • [GODRIVER-775] - Cannot parse MongoDB Extended JSON from mongoexport
  • [GODRIVER-803] - Add option to allow authenticating with an arbiter

Task

  • [GODRIVER-194] - Add pipeline stage to ChangeStreams example for Docs
  • [GODRIVER-422] - Provide Transactions example for Docs
  • [GODRIVER-788] - Update Transactions Retry Example 3 to include read preference

Improvement

  • [GODRIVER-120] - Alternative Import Path
  • [GODRIVER-572] - TransformDocument should document how it handles nil
  • [GODRIVER-600] - Add test that read operations ignore db/collection readConcern in transaction
  • [GODRIVER-727] - Clean up mongo.newClient
  • [GODRIVER-731] - Maps inside structs are not zeroed
  • [GODRIVER-747] - Allow TLSConfig as a client option
  • [GODRIVER-787] - Make file should run documentation examples
  • [GODRIVER-793] - Remove all public use of 'x' packages in the options package
  • [GODRIVER-800] - Modify BatchCursor to return batch as a single slice of documents
  • [GODRIVER-807] - Add attribution for Gopher logo
  • [GODRIVER-828] - Create mongo.CommandError to wrap command.Error