Releases · mongodb/mongo-go-driver

05 Feb 16:43

v1.3.0

f002b1f

MongoDB Go Driver 1.3.0

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

This release contains new functions to construct BSON registries, a new BSON registry that mimics the behavior of the globalsign/mgo/bson library, and new URI options to specify TLS certificates and keys as separate files. As part of this release, support for Go modules has been added and the README has been changed to reflect this. There is still a vendor directory in the source code so projects can be compiled with versions of Go that do not support modules.

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.

mgo compatible BSON

A new mgocompat package has been added under the top-level bson package. This package exports Registry, which is a BSON registry compatible with globalsign/mgo/bson and RegistryRespectNilValues, which is compatible with globalsign/mgo/bson with the RespectNilValues flag set to true. These registries can be used via the ClientOptions.SetRegistry method. The package also exports a RegistryBuilder for each of the registries so additional changes can be made. See the bson/bsoncodec package documentation for more information.

`RegistryBuilder` method changes

The existing RegisterEncoder methods has been deprecated and replaced by RegisterTypeEncoder and RegisterHookEncoder. A corresponding change has been made for RegisterDecoder as well.

Release Notes

Bug

[GODRIVER-1002] - Credential.PasswordSet doesn't work or is incorrectly documented
[GODRIVER-1411] - Data race between creating a new connection and disconnecting topology
[GODRIVER-1466] - Overriding the type map entry for embedded document does not work
[GODRIVER-1476] - mongodb+srv doesn't work with a fully qualified DNS name
[GODRIVER-1478] - Pooled sessions should have use time updated when retrieved from the pool

New Feature

[GODRIVER-580] - Need to be able to unmarshall to bson.D field within a struct
[GODRIVER-917] - Difference in BSON/JSON serialization of nil primitive.D compared to mgo
[GODRIVER-1175] - allow BSON null values to decode into non-nilable Go types
[GODRIVER-1354] - Create ObjectIDCodec that accepts bsontype.String for decoding
[GODRIVER-1356] - Support mgo's Getter and Setter interfaces
[GODRIVER-1358] - Add UIntCodec for mgocompat
[GODRIVER-1361] - Create mgocompat.Registry
[GODRIVER-1362] - Add SliceCodec for mgocompat

Task

[GODRIVER-904] - Improve docs for how to write custom codecs
[GODRIVER-938] - cannot convert types that use mgobson.ObjectId to new bson library.
[GODRIVER-1381] - GridFS GoDoc examples
[GODRIVER-1427] - Add more sessions tests with more read and write commands
[GODRIVER-1448] - Read operations options documentation

Improvement

[GODRIVER-543] - Enable support for Go 1.11 modules
[GODRIVER-1421] - Add EmptyInterfaceCodec for mgocompat
[GODRIVER-1429] - add ByteArrayCodec for mgocompat
[GODRIVER-1430] - allow strings and binaries to decode to symbols
[GODRIVER-1433] - Add RespectNilValues equivalent for the mgo registry
[GODRIVER-1435] - Please add tlsCertificateFile and tlsKeyFile connection string options.
[GODRIVER-1438] - Separate RegisterEncoder/Decoder functions to "types" and "hooks"
[GODRIVER-1455] - Use a pure go implementation for zstd
[GODRIVER-1460] - Document mgocompat
[GODRIVER-1461] - Validate that mongocryptd is not spawned if bypassAutoEncryption=true

Assets 2

08 Jan 14:57

divjotarora

v1.2.1

55b507b

MongoDB Go Driver 1.2.1

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

This release contains several bug fixes.

Release Notes

Bug

[GODRIVER-1428] - operation.CreateIndexes doesn't support WriteConcern
[GODRIVER-1439] - Only close heartbeat connections after they're opened
[GODRIVER-1442] - Fix connection error handling in ProcessError
[GODRIVER-1450] - BulkWriteError's request is not the correct one
[GODRIVER-1456] - Extended JSON writer should escape keys

Assets 2

17 Dec 19:17

divjotarora

v1.1.4

c5d1ddd

MongoDB Go Driver 1.1.4

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

This release contains a bug fix for error checking in the driver's monitoring routine. Prior to this fix, the driver would try to close a monitoring connection if the underlying net.Conn was non-nil. This caused issues for some users with custom dialers due to the nil-interface behavior in Go (see https://golang.org/doc/faq#nil_error). This fix makes it so the driver does not call any methods on connections returned by dialers if the error returned is non-nil.

Release Notes

Bug

[GODRIVER-1439] - Only close heartbeat connections after they're opened

Assets 2

10 Dec 18:55

divjotarora

v1.2.0

b414b89

MongoDB Go Driver 1.2.0

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

This release contains GA support for client-side field level encryption, a new bson.MarshalValue function to marshal Go values to BSON, and various documentation improvements to add more details and examples to GoDoc.

Release Notes

Bug

[GODRIVER-1061] - bson docs refer to non-existent RawArray and Array types
[GODRIVER-1234] - Deadlock on 1.1.0 release
[GODRIVER-1254] - Fix libmongocrypt wrapper test failure
[GODRIVER-1405] - "appname" is not not always sent in isMaster
[GODRIVER-1423] - Nil interface panics in BSON marshalling

Epic

[GODRIVER-1237] - Client-side Field Level Encryption

New Feature

[GODRIVER-276] - Implement a testing framework
[GODRIVER-420] - integration tests should detect topology from connection, not TOPOLOGY envvar
[GODRIVER-626] - Support Client-side Field Level Encryption
[GODRIVER-783] - Add support for Zstandard compression
[GODRIVER-1158] - Enhance Decimal128
[GODRIVER-1220] - Mark the FLE feature as "Beta" in driver docs
[GODRIVER-1349] - Implement mgocompat StructCodec options
[GODRIVER-1352] - Create StringCodec with options for non-bsontype.String inputs
[GODRIVER-1353] - Port mgobson tests for mgocompat testing
[GODRIVER-1355] - Create TimeCodec to match mgo behavior
[GODRIVER-1357] - Add IntCodec for mgocompat
[GODRIVER-1358] - Add UIntCodec for mgocompat
[GODRIVER-1359] - Add BoolCodec for mgocompat
[GODRIVER-1360] - Add FloatCodec for mgocompat
[GODRIVER-1416] - Add function to marshal generic BSON values

Story

[GODRIVER-990] - Implement Zeroer for primitive.Binary

Task

[GODRIVER-1249] - Implement a mock deployment
[GODRIVER-1250] - Change Client to depend on Deployment instead of Topology
[GODRIVER-1253] - Create assertion library
[GODRIVER-1256] - Assert that test closes all connections and sessions in testing framework
[GODRIVER-1261] - Unified test runner
[GODRIVER-1265] - causal_consistency tests
[GODRIVER-1266] - change stream spec tests
[GODRIVER-1267] - change stream prose tests
[GODRIVER-1268] - client tests
[GODRIVER-1269] - client side encryption prose tests
[GODRIVER-1270] - client side encryption spec tests
[GODRIVER-1271] - collection tests
[GODRIVER-1272] - command monitoring spec tests
[GODRIVER-1273] - crud v1 spec tests
[GODRIVER-1274] - crud v2 spec tests
[GODRIVER-1275] - cursor tests
[GODRIVER-1276] - database tests
[GODRIVER-1277] - index view tests
[GODRIVER-1278] - mongo_test tests
[GODRIVER-1279] - legacy operation tests
[GODRIVER-1280] - primary stepdown tests
[GODRIVER-1281] - read/write concern spec tests
[GODRIVER-1282] - results_test tests
[GODRIVER-1283] - retryable reads spec tests
[GODRIVER-1284] - retryable writes spec tests
[GODRIVER-1285] - sessions tests
[GODRIVER-1286] - SingleResult tests
[GODRIVER-1287] - mongos pinning transactions tests
[GODRIVER-1288] - transactions spec tests
[GODRIVER-1289] - convenient transactions spec tests
[GODRIVER-1293] - Delete legacy_helpers_test after all tests are ported
[GODRIVER-1309] - Update from Go1.8 to 1.9 in Evergreen config
[GODRIVER-1310] - convenient transactions prose tests
[GODRIVER-1327] - gridfs tests
[GODRIVER-1331] - Remove ns assertions in index_view_test.go
[GODRIVER-1336] - initial seedlist discovery tests
[GODRIVER-1368] - Create language specific copy/pasteable FLE tutorials
[GODRIVER-1369] - Expectations of listIndexNames.json should refer to command as listIndexes
[GODRIVER-1376] - Docs for client methods
[GODRIVER-1377] - Docs for database methods
[GODRIVER-1378] - Docs for...

Assets 2

05 Nov 18:42

divjotarora

v1.1.3

797e0a6

MongoDB Go Driver 1.1.3

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

This release contains several bug fixes.

Release Notes

Bug

[GODRIVER-1345] - Cancel in-progress heartbeats when disconnecting
[GODRIVER-1351] - nil panic on conn close for change stream aggregation operation

Improvement

[GODRIVER-1364] - Allow authentication to all server types except arbiters

Assets 2

07 Oct 16:02

divjotarora

v1.1.2

1261197

MongoDB Go Driver 1.1.2

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

This release contains several bug fixes.

Release Notes

Bug

[GODRIVER-1245] - Transactions Bugs
[GODRIVER-1292] - ListCollectionNames does not appear to close the cursor it creates
[GODRIVER-1298] - Panic in topology/pool.go:416
[GODRIVER-1301] - Data race around topology subscription
[GODRIVER-1302] - Topology.String should take {{serversLock}}
[GODRIVER-1311] - Running v1.1.0+ against mongot doesn't work
[GODRIVER-1322] - operations bug fixes
[GODRIVER-1323] - Cleanup connection close logic
[GODRIVER-1324] - Can't insert 16 MiB documents
[GODRIVER-1325] - Getting a new Database from mongo.Client does not honor a Registry from DatabaseOptions

Assets 2

05 Sep 18:10

skriptble

v1.1.1

c520d02

Mongo Go Driver 1.1.1

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

This release contains several bug fixes.

Release Notes

Backport

[GODRIVER-1290] - Backport "Deadlock on 1.1.0 release"

Bug

[GODRIVER-1011] - Struct decoder only works for lowercased fields
[GODRIVER-1233] - Truncate Bug
[GODRIVER-1238] - Closing a change stream without reading it returns an error
[GODRIVER-1239] - mongo.Client's Ping method ignores read preference
[GODRIVER-1245] - Transactions Bugs
[GODRIVER-1246] - Cursor.All() should end implicit session
[GODRIVER-1247] - connection leak with change stream

Assets 2

13 Aug 16:12

skriptble

v1.1.0

d42ea72

MongoDB Go Driver 1.1.0

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

This release contains support for MongoDB server version 4.2.

Core Driver Redesign

The lower-level driver implementation was redesigned. The improved lower-level driver contained improvements to increase maintainability and greatly increase performance.

Connection Pool Monitoring

The Connection Monitoring and Pooling specification has been implemented. This changes the pool implementation to LIFO, which improves connection utilization. The addition of event.PoolMonitor enables users to monitor various connection and connection pool related events.

Release Notes

Bug

[GODRIVER-1018] - record codeName for WriteConcernErrors
[GODRIVER-1073] - ChangeStream spec's Resumable Error definition is too broad
[GODRIVER-1084] - Data race in topology tests
[GODRIVER-1085] - Change stream test failures on Evergreen
[GODRIVER-1100] - Closing batch cursor after find gets "ended session was used"
[GODRIVER-1107] - SetHint causes InvalidBSON error
[GODRIVER-1108] - Operation.addReadConcern encodes "empty" ReadConcern
[GODRIVER-1114] - RunCommandCursor always fails and returns an error message referencing internal driver details
[GODRIVER-1130] - Pinned Servers should be cleared properly
[GODRIVER-1153] - nil pointer asMDoc
[GODRIVER-1160] - driver.BatchCursor Next returns true when first batch is empty
[GODRIVER-1187] - Find() uses a write selector instead of a read selector
[GODRIVER-1215] - lastWriteDate is parsed from isMaster incorrectly
[GODRIVER-1224] - Race detected in x/mongo/driver/topology
[GODRIVER-1226] - localThresholdMS does not default to 15 ms

New Feature

[GODRIVER-620] - Implement Unified URI Options
[GODRIVER-621] - Implement Convenient API for Transactions
[GODRIVER-622] - Implement Connection Monitoring and Pooling spec
[GODRIVER-623] - Support mongos pinning for sharded transactions
[GODRIVER-624] - Retryable Reads
[GODRIVER-625] - Support polling SRV records for mongos discovery
[GODRIVER-628] - Connections survive primary stepdown
[GODRIVER-637] - Support sharded transactions recovery token
[GODRIVER-680] - Support running commands as aggregation
[GODRIVER-690] - Transaction test runner should use "local" read concern when asserting the final collection state
[GODRIVER-723] - Missing ListCollectionNames
[GODRIVER-736] - Add comparison methods to primitive.Timestamp
[GODRIVER-745] - Resync change stream tests to test all new notification types
[GODRIVER-765] - Support 'startAfter' option to the $changeStream stage
[GODRIVER-808] - Add support for Split-Horizon Topology
[GODRIVER-822] - Support Retryable Writes on by Default
[GODRIVER-824] - Support postBatchResumeToken in change streams
[GODRIVER-841] - Resync SDAM tests to only examine non-unknown server descriptions to determine incompatibility
[GODRIVER-845] - Add support for majority read concern level to Aggregation $out
[GODRIVER-913] - countDocuments should use group with _id: 1
[GODRIVER-916] - Cursor method to decode all results into a slice
[GODRIVER-919] - Add the ability to specify a pipeline to an update command
[GODRIVER-927] - Create new driver package
[GODRIVER-928] - Update topology.Topology type
[GODRIVER-929] - Create topology.pool type
[GODRIVER-930] - Implement base driver.Connection type
[GODRIVER-931] - Implement topology.legacyConnection type
[GODRIVER-932] - Update topology.Server type
[GODRIVER-978] - Implement driver.Operation
[GODRIVER-984] - Add support for legacy find, getMore, and killCursors to driver.Operation
[GODRIVER-985] - Design & Implement drivergen
[GODRIVER-992] - Add compression to driver.Operation
[GODRIVER-993] - Add command monitoring to driver.Operation
[GODRIVER-1081] - Allow applications to set maxTimeMS for commitTransaction
[GODRIVER-1209] - Create LocalAddresser interface and make topology.Connection implement it
[GODRIVER-1219] - Raise an actionable error message when retryWrites fails due to using an unsupported storage engine

Task

[GODRIVER-589] - Bump wire protocol version for 4.2
[GODRIVER-968] - Add tests for postBatchResumeToken support
[GODRIVER-969] - Test writes in transactions do not send writeConcern when collection write concern is w=0
[GODRIVER-970] - Amend change stream missing resume token tests for wire version 8+
[GODRIVER-1009] - Implement batch cursor in driver lib
[GODRIVER-1015] - Set OP_MSG flags in driver.Operation
[GODRIVER-1026] - Skip ReadWireMessage for unacknowledged writes
[GODRIVER-1035] - Clear pinned server on TransientTransa...

Assets 2

09 Jul 18:42

skriptble

v1.0.4

0d1270e

MongoDB Go Driver 1.0.4

The MongoDB Go driver team is pleased to release version 1.0.4 of the official Go driver.

This release contains several bug fixes. Please refer to the Jira issues below for more information.

Release Notes

Bug

[GODRIVER-1013] - When reading whole file at once next read doesn't return EOF
[GODRIVER-1096] - When limit is set with a BatchCursor connected to a legacy server, a connection is leaked
[GODRIVER-1131] - QueryFailureError not wrapped in CommandError
[GODRIVER-1132] - Legacy ListCollections in driverlegacy does not filter indexes

Improvement

[GODRIVER-1021] - Specify behavior where connection string contain auth database but no credentials

Assets 2

06 Jun 21:15

skriptble

v1.0.3

582ff34

MongoDB Go Driver 1.0.3

The MongoDB Go driver team is pleased to release version 1.0.3 of the official Go driver.

This release contains several bug fixes. Please refer to the Jira issues below for more information.

Release Notes

Bug

[GODRIVER-1012] - Downloading big files from gridfs ends with ErrWrongSize
[GODRIVER-1016] - Get current op on MongoDB 2.6
[GODRIVER-1068] - Need to call ping in Ping()
[GODRIVER-1078] - Allow specifying empty value for connection URI readPreferenceTags option
[GODRIVER-1086] - Can leak creds through errors from URI Parsing

Assets 2

Releases: mongodb/mongo-go-driver

MongoDB Go Driver 1.3.0

mgo compatible BSON

RegistryBuilder method changes

Release Notes

Bug

New Feature

Task

Improvement

Uh oh!

MongoDB Go Driver 1.2.1

Release Notes

Bug

Uh oh!

MongoDB Go Driver 1.1.4

Release Notes

Bug

Uh oh!

MongoDB Go Driver 1.2.0

Release Notes

Bug

Epic

New Feature

Story

Task

Uh oh!

MongoDB Go Driver 1.1.3

Release Notes

Bug

Improvement

Uh oh!

MongoDB Go Driver 1.1.2

Release Notes

Bug

Uh oh!

Mongo Go Driver 1.1.1

Release Notes

Backport

Bug

Uh oh!

MongoDB Go Driver 1.1.0

Core Driver Redesign

Connection Pool Monitoring

Release Notes

Bug

New Feature

Task

Uh oh!

MongoDB Go Driver 1.0.4

Release Notes

Bug

Improvement

Uh oh!

MongoDB Go Driver 1.0.3

Release Notes

Bug

Uh oh!

`RegistryBuilder` method changes