MongoDB Go Driver Alpha 3

The MongoDB Go driver team is pleased to release the third alpha of the official Go driver.

This release mainly contains user experience improvements and a refactor of internal driver structure. This is alpha software, so it is not recommended for production use.

Following semver, the v0 version of the public API should not be considered stable and could change.

Documentation can be found 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.

Bug

• [GODRIVER-282] - bson.Decoder cannot decode into bson types inside of a struct
• [GODRIVER-287] - SSL client certificate should support PEM files with passwords
• [GODRIVER-288] - Fix decoding BSON arrays into empty interface
• [GODRIVER-309] - Fix excessive escaping when printing BSON objects
• [GODRIVER-313] - Examples don't reset the document before decode
• [GODRIVER-320] - Document Should Be Reset In Examples
• [GODRIVER-321] - convertValueToElem should copy the attached *bson.Document
• [GODRIVER-323] - Struct with bson tag _id inserts a byte array instead of objectId
• [GODRIVER-339] - Document Set does not always replace the correct field.

New Feature

• [GODRIVER-2] - Implement X-509
• [GODRIVER-32] - Implement Enumerate Indexes Specification
• [GODRIVER-34] - Implement Index Management Specification
• [GODRIVER-38] - add NameOnly to ops.ListDatabasesOptions
• [GODRIVER-78] - Implement Database Enumeration spec
• [GODRIVER-195] - Custom Dialer option for Client
• [GODRIVER-285] - Client should have a Close method

Task

• [GODRIVER-153] - Add client constructor that takes client options
• [GODRIVER-254] - Redesign the private package

Improvement

• [GODRIVER-256] - Ensure Cursor implementations return Close error on Close
• [GODRIVER-315] - Mongo shipped BSON marshaller to support nested structs using embedding
• [GODRIVER-317] - Handle nil properties of a struct in the BSON encoder
• [GODRIVER-324] - Handle objectid.ObjectID in the bson.Encoder
• [GODRIVER-327] - Migrate to new library structure
• [GODRIVER-330] - Create Collection using Database's read and write selectors
• [GODRIVER-331] - Use description.WriteSelector instead of a ReadPrefSelector
• [GODRIVER-332] - Use db.writeSelector in Database.RunCommand
• [GODRIVER-333] - ReadPref selector should use feature.MaxStaleness
• [GODRIVER-334] - Remove topology server selectors and use description server selectors
• [GODRIVER-336] - Move TLS configuration out of connection.New
• [GODRIVER-346] - Refactor Client Options
• [GODRIVER-353] - Add license notice for core library

MongoDB Go Driver Alpha 2

The MongoDB Go driver team is pleased to release the second alpha of the official Go driver.

This release mainly contains improvements to the user experience and bug fixes. This is alpha software, so it is not recommended for production use.

Following semver, the v0 version of the public API should not be considered stable and could change.

Documentation can be found 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.

Changes since the prior release:

Bug

• [GODRIVER-238] - Lookup should properly traverse Arrays
• [GODRIVER-241] - Clarify the documentation for the bson package wrt the builder.Builder type
• [GODRIVER-245] - Ensure methods of *Document handle the case where *Document is nil
• [GODRIVER-246] - Update bson.ErrTooSmall
• [GODRIVER-253] - bson.Reader.Lookup should return ErrElementNotFound if no element is found

New Feature

• [GODRIVER-203] - Create examples for sample shell commands
• [GODRIVER-236] - Add Marshal, Unmarshal, and UnmarshalDocument functions to BSON library
• [GODRIVER-265] - Implement Stringer for objectid.ObjectID

Improvement

• [GODRIVER-135] - Test new BSON library against BSON corpus
• [GODRIVER-143] - Split ReplaceOptions from UpdateOptions
• [GODRIVER-158] - Resync CRUD tests to update insertMany test format to a map
• [GODRIVER-229] - Add namespace type for options in mongo package.
• [GODRIVER-231] - Add DecodeBytes method to the Cursor
• [GODRIVER-232] - Add a method to bson.Value to get the offset into the underlying []byte
• [GODRIVER-237] - Make mongo.Cursor its own interface
• [GODRIVER-239] - Improve Document.ElementAt usability
• [GODRIVER-248] - Rename bson.ArrayConstructor to bson.ValueConstructor
• [GODRIVER-252] - Add FromHex function to the objectid package

MongoDB Go Driver Alpha 1

The MongoDB Go driver team is pleased to release the first alpha of the official Go driver.

We will be making several alpha releases of the driver. This version, Alpha 1, supports MongoDB versions 3.2.x, 3.4.x, and 3.6.x. Note that the new features of MongoDB 3.6 (e.g. ChangeStreams, Sessions, Retryable Writes, etc...) are not yet supported. This is alpha software, so it is not recommended for production use.

Following semver, the v0 version of the public API should not be considered stable and could change.

Documentation can be found 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.

If you would like to contribute to development, please read the CONTRIBUTING.md guide.

The following is a non-exhaustive list of supported driver specifications:

• BSON (with Decimal data type)
• Authentication (SCRAM-SHA-1, MONGODB CR, PLAIN, GSSAPI)
• TLS/SSL
• Server Discovery and Monitoring
• Server Selection
• Read and Write Concern
• MongoDB Handshake
• Collation
• TCP Keepalive
• Initial DNS Seedlist Discovery
• Connection String
• CRUD (except for Bulk Write)
• Find, getMore and killCursors commands
• Out aggregation pipeline operator
• Server write commands