Skip to content

GODRIVER-3523 Drop support for MongoDB 4.0.#2221

Merged
qingyang-hu merged 2 commits into
masterfrom
godriver3523
Oct 15, 2025
Merged

GODRIVER-3523 Drop support for MongoDB 4.0.#2221
qingyang-hu merged 2 commits into
masterfrom
godriver3523

Conversation

@qingyang-hu

Copy link
Copy Markdown
Contributor

GODRIVER-3523

Summary

Drop support for MongoDB 4.0.

Background & Motivation

@github-actions github-actions Bot added the review-priority-normal Medium Priority PR for Review: within 1 business day label Oct 8, 2025
@mongodb-drivers-pr-bot

mongodb-drivers-pr-bot Bot commented Oct 8, 2025

Copy link
Copy Markdown
Contributor

🧪 Performance Results

Commit SHA: 0ce103e

The following benchmark tests for version 68e6e20231536c0007d047c8 had statistically significant changes (i.e., |z-score| > 1.96):

Benchmark Measurement % Change Patch Value Stable Region H-Score Z-Score
BenchmarkBSONDeepDocumentDecoding ops_per_second_min 22.4338 2431.1203 Avg: 1985.6613
Med: 1996.0917
Stdev: 167.1050
0.8135 2.6657
BenchmarkBSONFullDocumentDecoding total_bytes_allocated 16.6299 415701824.0000 Avg: 356428068.9091
Med: 360143680.0000
Stdev: 20551053.1642
0.8523 2.8842
BenchmarkBSONFlatDocumentEncoding total_mem_allocs 14.6900 265352.0000 Avg: 231364.4690
Med: 231799.0000
Stdev: 7007.6800
0.8902 4.8500
BenchmarkBSONFlatDocumentEncoding total_bytes_allocated 14.5871 548957360.0000 Avg: 479074249.7699
Med: 479913704.0000
Stdev: 14431557.6550
0.8900 4.8424
BenchmarkBSONFullDocumentDecoding total_mem_allocs 14.4795 10044222.0000 Avg: 8773820.6042
Med: 8779734.5000
Stdev: 288604.3175
0.8907 4.4019
BenchmarkBSONFullDocumentEncoding total_bytes_allocated 11.3008 270292128.0000 Avg: 242848379.7522
Med: 242696304.0000
Stdev: 4809646.2804
0.9080 5.7060
BenchmarkBSONDeepDocumentEncoding total_mem_allocs 6.1892 235280.0000 Avg: 221566.8407
Med: 222611.0000
Stdev: 5710.6696
0.7789 2.4013
BenchmarkBSONDeepDocumentEncoding total_bytes_allocated 6.0998 167701848.0000 Avg: 158060451.2566
Med: 158826416.0000
Stdev: 4081994.8518
0.7770 2.3619
BenchmarkBSONDeepDocumentEncoding ns_per_op -5.8332 15295.0000 Avg: 16242.4602
Med: 16170.0000
Stdev: 429.8394
0.7613 -2.2042
BenchmarkBSONFullDocumentEncoding total_mem_allocs 2.7863 1561856.0000 Avg: 1519518.0000
Med: 1519518.0000
Stdev: 11602.2081
0.9031 3.6491
BenchmarkBSONFullDocumentDecoding ns_per_op -1.7321 73073.0000 Avg: 74361.0000
Med: 74361.0000
Stdev: 67.8823
0.9814 -18.9740
BenchmarkBSONFullDocumentEncoding ns_per_op -1.2220 23279.0000 Avg: 23567.0000
Med: 23567.0000
Stdev: 21.2132
0.9740 -13.5765
BenchmarkBSONFlatDocumentEncoding allocated_bytes_per_op -0.1070 6265.0000 Avg: 6271.7080
Med: 6272.0000
Stdev: 2.8806
0.7656 -2.3287
BenchmarkSingleRunCommand allocated_bytes_per_op -0.0939 12186.0000 Avg: 12197.4583
Med: 12197.0000
Stdev: 5.3154
0.7521 -2.1557
BenchmarkBSONFullDocumentDecoding allocated_bytes_per_op 0.0253 25330.0000 Avg: 25323.6042
Med: 25324.0000
Stdev: 1.0865
0.9144 5.8868

For a comprehensive view of all microbenchmark results for this PR's commit, please check out the Evergreen perf task for this patch.

@mongodb-drivers-pr-bot

Copy link
Copy Markdown
Contributor

API Change Report

No changes found!

@qingyang-hu qingyang-hu marked this pull request as ready for review October 8, 2025 23:10
@qingyang-hu qingyang-hu requested a review from a team as a code owner October 8, 2025 23:10

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This pull request drops support for MongoDB 4.0, updating the minimum supported MongoDB version to 4.2.

  • Updated minimum wire version from 7 (MongoDB 4.0) to 8 (MongoDB 4.2)
  • Removed version checks and constraints for MongoDB 4.0 throughout the codebase
  • Added skip entries for pre-4.2 SDAM tests that are no longer relevant

Reviewed Changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated no comments.

Show a summary per file
File Description
x/mongo/driver/topology/topology_test.go Updated error message to reflect new minimum wire version requirement
x/mongo/driver/topology/sdam_spec_test.go Added CheckSkip call to skip irrelevant pre-4.2 tests
x/mongo/driver/topology/fsm.go Updated MinSupportedMongoDBVersion constant from "4.0" to "4.2"
x/mongo/driver/integration/scram_test.go Removed MongoDB 4.0 version check and unused import
mongo/options/listcollectionsoptions.go Removed MongoDB 4.0 version constraint from documentation
mongo/options/changestreamoptions.go Removed MongoDB 4.0 version constraint from documentation
internal/spectest/skip.go Added skip entries for pre-4.2 SDAM tests
internal/integration/sdam_error_handling_test.go Removed MongoDB 4.0 version constraints from test options
internal/integration/primary_stepdown_test.go Simplified test cases by removing version constraints
internal/integration/change_stream_test.go Removed MongoDB 4.0 specific test cases and helper functions
internal/driverutil/description.go Updated MinWireVersion constant from 7 to 8
internal/docexamples/examples_test.go Simplified causal consistency examples by removing version filtering
README.md Updated documentation to reflect MongoDB 4.2 as minimum version
.evergreen/config.yml Removed MongoDB 4.0 build variants from CI configuration

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@qingyang-hu qingyang-hu requested review from matthewdale and removed request for prestonvasquez October 8, 2025 23:10

@matthewdale matthewdale left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good! 👍

@qingyang-hu qingyang-hu merged commit 0261c36 into master Oct 15, 2025
35 checks passed
@qingyang-hu qingyang-hu deleted the godriver3523 branch October 15, 2025 21:45
riverajo added a commit to riverajo/fitness-app that referenced this pull request Jan 28, 2026
This PR contains the following updates:

| Package | Change | [Age](https://docs.renovatebot.com/merge-confidence/) | [Confidence](https://docs.renovatebot.com/merge-confidence/) |
|---|---|---|---|
| [go.mongodb.org/mongo-driver](https://github.com/mongodb/mongo-go-driver) | `v1.17.7` → `v2.4.2` | ![age](https://developer.mend.io/api/mc/badges/age/go/go.mongodb.org%2fmongo-driver/v2.4.2?slim=true) | ![confidence](https://developer.mend.io/api/mc/badges/confidence/go/go.mongodb.org%2fmongo-driver/v1.17.7/v2.4.2?slim=true) |

---

### Release Notes

<details>
<summary>mongodb/mongo-go-driver (go.mongodb.org/mongo-driver)</summary>

### [`v2.4.2`](https://github.com/mongodb/mongo-go-driver/releases/tag/v2.4.2): MongoDB Go Driver 2.4.2

[Compare Source](mongodb/mongo-go-driver@v2.4.1...v2.4.2)

The MongoDB Go Driver Team is pleased to release version 2.4.2 of the official MongoDB Go Driver.

#### Release Highlights

This release fixes buffer handling in GSSAPI error description and username functions.

<!-- Release notes generated using configuration in .github/release.yml at v2.4.2 -->

#### What's Changed

##### 🐛 Fixed

- GODRIVER-3770 Fix buffer handling in GSSAPI error description and username functions  by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2297](mongodb/mongo-go-driver#2297)

**Full Changelog**: <mongodb/mongo-go-driver@v2.4.1...v2.4.2>

For a full list of tickets included in this release, please see the [list of fixed issues](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20fixVersion%3D2.4.2).

Documentation for the Go Driver can be found on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo?tab=doc) and the [MongoDB documentation site](https://docs.mongodb.com/ecosystem/drivers/go/). BSON library documentation is also available on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson?tab=doc). For issues with, questions about, or feedback for the Go Driver, please look into our [support channels](https://www.mongodb.com/docs/manual/support/), including [StackOverflow](https://stackoverflow.com/questions/tagged/mongodb%20go?sort=Newest). Bugs can be reported in the [Go Driver project in the MongoDB JIRA](https://jira.mongodb.org/secure/CreateIssue!default.jspa?pid=14289) where a list of [current issues](https://jira.mongodb.org/browse/GODRIVER) can be found. Your feedback on the Go Driver is greatly appreciated!

### [`v2.4.1`](https://github.com/mongodb/mongo-go-driver/releases/tag/v2.4.1): MongoDB Go Driver 2.4.1

[Compare Source](mongodb/mongo-go-driver@v2.4.0...v2.4.1)

The MongoDB Go Driver Team is pleased to release version 2.4.1 of the official MongoDB Go Driver.

<!-- Release notes generated using configuration in .github/release.yml at v2.4.1 -->

#### What's Changed

##### 🐛 Fixed

- GODRIVER-3704 Fix search index failure on empty "Options". by [@&#8203;qingyang-hu](https://github.com/qingyang-hu) in [#&#8203;2247](mongodb/mongo-go-driver#2247)

##### 📝 Other Changes

- GODRIVER-3696: Add CI/CD label to label checker by [@&#8203;alcaeus](https://github.com/alcaeus) in [#&#8203;2243](mongodb/mongo-go-driver#2243)

**Full Changelog**: <mongodb/mongo-go-driver@v2.4.0...v2.4.1>

For a full list of tickets included in this release, please see the [list of fixed issues](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20fixVersion%3D2.4.1).

Documentation for the Go Driver can be found on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo?tab=doc) and the [MongoDB documentation site](https://docs.mongodb.com/ecosystem/drivers/go/). BSON library documentation is also available on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson?tab=doc). For issues with, questions about, or feedback for the Go Driver, please look into our [support channels](https://www.mongodb.com/docs/manual/support/), including [StackOverflow](https://stackoverflow.com/questions/tagged/mongodb%20go?sort=Newest). Bugs can be reported in the [Go Driver project in the MongoDB JIRA](https://jira.mongodb.org/secure/CreateIssue!default.jspa?pid=14289) where a list of [current issues](https://jira.mongodb.org/browse/GODRIVER) can be found. Your feedback on the Go Driver is greatly appreciated!

### [`v2.4.0`](https://github.com/mongodb/mongo-go-driver/releases/tag/v2.4.0): MongoDB Go Driver 2.4.0

[Compare Source](mongodb/mongo-go-driver@v2.3.1...v2.4.0)

The MongoDB Go Driver Team is pleased to release version 2.4.0 of the official MongoDB Go Driver.

#### Release Highlights

> \[!IMPORTANT]
> Go Driver v2.4 requires MongoDB 4.2 or newer.

This release adds a new method [Client.AppendDriverInfo](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2@&#8203;v2.4.0/mongo#Client.AppendDriverInfo) that adds information to the driver metadata sent on subsequent connection handshakes.

<!-- Release notes generated using configuration in .github/release.yml at v2.4.0 -->

#### What's Changed

##### ✨ New Features

- GODRIVER-3544, GODRIVER-3653 Allow Client to Send Client Metadata On-Demand by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2197](mongodb/mongo-go-driver#2197)

##### 📝 Other Changes

- GODRIVER-3523 Drop support for MongoDB 4.0. by [@&#8203;qingyang-hu](https://github.com/qingyang-hu) in [#&#8203;2221](mongodb/mongo-go-driver#2221)
- GODRIVER-3288 Stop gossiping $clusterTime on SDAM commands. by [@&#8203;qingyang-hu](https://github.com/qingyang-hu) in [#&#8203;2150](mongodb/mongo-go-driver#2150)
- GODRIVER-3632: Reroute to use perfcomp from DET by [@&#8203;zhouselena](https://github.com/zhouselena) in [#&#8203;2163](mongodb/mongo-go-driver#2163)
- Update README.md by [@&#8203;NiteshSingh17](https://github.com/NiteshSingh17) in [#&#8203;2176](mongodb/mongo-go-driver#2176)
- Rewrite mongo.Connect documentation. by [@&#8203;matthewdale](https://github.com/matthewdale) in [#&#8203;2185](mongodb/mongo-go-driver#2185)
- Allow ignore-for-release label to satisfy label checker \[v2] by [@&#8203;matthewdale](https://github.com/matthewdale) in [#&#8203;2209](mongodb/mongo-go-driver#2209)
- Merge release/2.3 into master by [@&#8203;mongodb-drivers-pr-bot](https://github.com/mongodb-drivers-pr-bot)\[bot] in [#&#8203;2210](mongodb/mongo-go-driver#2210)
- GODRIVER-3667 Update support links. by [@&#8203;matthewdale](https://github.com/matthewdale) in [#&#8203;2215](mongodb/mongo-go-driver#2215)
- GODRIVER-3675 Rename `internal/decimal/decinal128.go` to `decimal128.go` by [@&#8203;ggyuchive](https://github.com/ggyuchive) in [#&#8203;2220](mongodb/mongo-go-driver#2220)

#### New Contributors

- [@&#8203;NiteshSingh17](https://github.com/NiteshSingh17) made their first contribution in [#&#8203;2176](mongodb/mongo-go-driver#2176)
- [@&#8203;ggyuchive](https://github.com/ggyuchive) made their first contribution in [#&#8203;2220](mongodb/mongo-go-driver#2220)

**Full Changelog**: <mongodb/mongo-go-driver@v2.3.1...v2.4.0>

For a full list of tickets included in this release, please see the [list of fixed issues](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20fixVersion%3D2.4.0).

Documentation for the Go Driver can be found on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo?tab=doc) and the [MongoDB documentation site](https://docs.mongodb.com/ecosystem/drivers/go/). BSON library documentation is also available on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson?tab=doc). For issues with, questions about, or feedback for the Go Driver, please look into our [support channels](https://www.mongodb.com/docs/manual/support/), including [StackOverflow](https://stackoverflow.com/questions/tagged/mongodb%20go?sort=Newest). Bugs can be reported in the [Go Driver project in the MongoDB JIRA](https://jira.mongodb.org/secure/CreateIssue!default.jspa?pid=14289) where a list of [current issues](https://jira.mongodb.org/browse/GODRIVER) can be found. Your feedback on the Go Driver is greatly appreciated!

### [`v2.3.1`](https://github.com/mongodb/mongo-go-driver/releases/tag/v2.3.1): MongoDB Go Driver 2.3.1

[Compare Source](mongodb/mongo-go-driver@v2.3.0...v2.3.1)

The MongoDB Go Driver Team is pleased to release version 2.3.1 of the official MongoDB Go Driver.

#### Release Highlights

This release applies client-level timeouts for tailable/awaitData cursors, and fixes a bug that causes a tight loop when there are no selectable servers.

<!-- Release notes generated using configuration in .github/release.yml at v2.3.1 -->

#### What's Changed

##### 🐛 Fixed

- GODRIVER-3616 Apply client-level timeout to tailable cursors by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2174](mongodb/mongo-go-driver#2174)
- GODRIVER-3648 Make server selection block on topology updates. by [@&#8203;matthewdale](https://github.com/matthewdale) in [#&#8203;2211](mongodb/mongo-go-driver#2211)

##### 📝 Other Changes

- Merge release/1.17 into release/2.2 by [@&#8203;mongodb-drivers-pr-bot](https://github.com/mongodb-drivers-pr-bot)\[bot] in [#&#8203;2193](mongodb/mongo-go-driver#2193)
- Merge release/2.2 into release/2.3 by [@&#8203;mongodb-drivers-pr-bot](https://github.com/mongodb-drivers-pr-bot)\[bot] in [#&#8203;2204](mongodb/mongo-go-driver#2204)

**Full Changelog**: <mongodb/mongo-go-driver@v2.3.0...v2.3.1>

For a full list of tickets included in this release, please see the [list of fixed issues](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20fixVersion%3D2.3.1).

Documentation for the Go Driver can be found on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo?tab=doc) and the [MongoDB documentation site](https://docs.mongodb.com/ecosystem/drivers/go/). BSON library documentation is also available on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson?tab=doc). For issues with, questions about, or feedback for the Go Driver, please look into our [support channels](https://www.mongodb.com/docs/manual/support/), including [StackOverflow](https://stackoverflow.com/questions/tagged/mongodb%20go?sort=Newest). Bugs can be reported in the [Go Driver project in the MongoDB JIRA](https://jira.mongodb.org/secure/CreateIssue!default.jspa?pid=14289) where a list of [current issues](https://jira.mongodb.org/browse/GODRIVER) can be found. Your feedback on the Go Driver is greatly appreciated!

### [`v2.3.0`](https://github.com/mongodb/mongo-go-driver/releases/tag/v2.3.0): MongoDB Go Driver 2.3.0

[Compare Source](mongodb/mongo-go-driver@v2.2.3...v2.3.0)

The MongoDB Go Driver Team is pleased to release version 2.3.0 of the official MongoDB Go Driver.

#### Release Highlights

> \[!IMPORTANT]\
> Go Driver v2.3 will be the last release to support MongoDB 4.0. Go Driver v2.4 will require MongoDB 4.2 or newer.

> \[!IMPORTANT]\
> The minimum Go version for Go Driver v2.3 is Go 1.19.

This release improves BSON unmarshal performance to fix the regression in v2.0 and fixes bugs in logging truncation and cursor timeouts.

<!-- Release notes generated using configuration in .github/release.yml at v2.3.0 -->

#### What's Changed

##### 🐛 Fixed

- GODRIVER-3473 Short-cicruit cursor.next() on invalid timeouts by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2135](mongodb/mongo-go-driver#2135)
- GODRIVER-3605 Refactor StringN by [@&#8203;qingyang-hu](https://github.com/qingyang-hu) in [#&#8203;2128](mongodb/mongo-go-driver#2128)
- fix wiremessage oob in case of intmin by [@&#8203;kobrineli](https://github.com/kobrineli) in [#&#8203;2076](mongodb/mongo-go-driver#2076)

##### 📦 Dependency Updates

- GODRIVER-3515 Bump the minimum Go Version to 1.19 by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2054](mongodb/mongo-go-driver#2054)

##### 📝 Other Changes

- GODRIVER-3587 Use raw bytes in valueReader by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2120](mongodb/mongo-go-driver#2120)
- optimize allocations in redactStartedInformationCmd by [@&#8203;isopov](https://github.com/isopov) in [#&#8203;2129](mongodb/mongo-go-driver#2129)
- GODRIVER-3102: Perf comparison by [@&#8203;zhouselena](https://github.com/zhouselena) in [#&#8203;2134](mongodb/mongo-go-driver#2134)
- GODRIVER-3102: Perf comp PR comment pipeline by [@&#8203;zhouselena](https://github.com/zhouselena) in [#&#8203;2149](mongodb/mongo-go-driver#2149)
- Add CODEOWNERS file by [@&#8203;alcaeus](https://github.com/alcaeus) in [#&#8203;2018](mongodb/mongo-go-driver#2018)
- GODRIVER-3444 Adjust getMore maxTimeMS Calculation for tailable awaitData Cursors by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;1925](mongodb/mongo-go-driver#1925)
- DEVPROD-17319 - update perf.send command to new results end point by [@&#8203;MAhmadShah](https://github.com/MAhmadShah) in [#&#8203;2029](mongodb/mongo-go-driver#2029)
- GODRIVER-3550 Update Documentation for Go Driver Branching and Merge … by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2045](mongodb/mongo-go-driver#2045)
- GODRIVER-3361 Improve connection error message. by [@&#8203;qingyang-hu](https://github.com/qingyang-hu) in [#&#8203;2027](mongodb/mongo-go-driver#2027)
- Add configuration for automated release notes by [@&#8203;alcaeus](https://github.com/alcaeus) in [#&#8203;2047](mongodb/mongo-go-driver#2047)
- Update README.md by [@&#8203;rishitb-mongodb](https://github.com/rishitb-mongodb) in [#&#8203;2055](mongodb/mongo-go-driver#2055)
- GODRIVER-3494 Deprecate hedged read preference methods. by [@&#8203;matthewdale](https://github.com/matthewdale) in [#&#8203;2100](mongodb/mongo-go-driver#2100)
- GODRIVER-3457: Pilot using OpenSSF Scorecard by [@&#8203;zhouselena](https://github.com/zhouselena) in [#&#8203;2104](mongodb/mongo-go-driver#2104)
- GODRIVER-3457: Add OpenSSF Scorecard to README by [@&#8203;zhouselena](https://github.com/zhouselena) in [#&#8203;2105](mongodb/mongo-go-driver#2105)
- GODRIVER-3518: Test flexible numeric comparisons with $$lte by [@&#8203;zhouselena](https://github.com/zhouselena) in [#&#8203;2106](mongodb/mongo-go-driver#2106)
- drivertest: name an anonymous error by [@&#8203;mmcclimon](https://github.com/mmcclimon) in [#&#8203;2115](mongodb/mongo-go-driver#2115)
- GODRIVER-3397 Remove the MONGODB-CR auth mechanism. by [@&#8203;matthewdale](https://github.com/matthewdale) in [#&#8203;2103](mongodb/mongo-go-driver#2103)
- GODRIVER-3399: PoolClearedError should have TransientTransactionError label appended to it by [@&#8203;zhouselena](https://github.com/zhouselena) in [#&#8203;2114](mongodb/mongo-go-driver#2114)
- Add guidelines for contributing features to the Go Driver by [@&#8203;alcaeus](https://github.com/alcaeus) in [#&#8203;2125](mongodb/mongo-go-driver#2125)

#### New Contributors

- [@&#8203;MAhmadShah](https://github.com/MAhmadShah) made their first contribution in [#&#8203;2029](mongodb/mongo-go-driver#2029)
- [@&#8203;rishitb-mongodb](https://github.com/rishitb-mongodb) made their first contribution in [#&#8203;2055](mongodb/mongo-go-driver#2055)
- [@&#8203;mmcclimon](https://github.com/mmcclimon) made their first contribution in [#&#8203;2115](mongodb/mongo-go-driver#2115)

**Full Changelog**: <mongodb/mongo-go-driver@v2.2.3...v2.3.0>

For a full list of tickets included in this release, please see the [list of fixed issues](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20fixVersion%3D2.3.0).

Documentation for the Go Driver can be found on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo?tab=doc) and the [MongoDB documentation site](https://docs.mongodb.com/ecosystem/drivers/go/). BSON library documentation is also available on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson?tab=doc). Questions and inquiries can be asked on the [MongoDB Developer Community](https://www.mongodb.com/community/forums/tag/golang). Bugs can be reported in the [Go Driver project in the MongoDB JIRA](https://jira.mongodb.org/secure/CreateIssue!default.jspa?pid=14289) where a list of [current issues](https://jira.mongodb.org/browse/GODRIVER) can be found. Your feedback on the Go Driver is greatly appreciated!

### [`v2.2.3`](https://github.com/mongodb/mongo-go-driver/releases/tag/v2.2.3): MongoDB Go Driver 2.2.3

[Compare Source](mongodb/mongo-go-driver@v2.2.2...v2.2.3)

The MongoDB Go Driver Team is pleased to release version 2.2.3 of the official MongoDB Go Driver.

#### Release Notes

This release updates the `DefaultClient` to use a non-default global `DefaultTransport`. This way, the program will not panic if the user changes the global `http.DefaultTransport` variable. The client is created as needed.

***

For a full list of tickets included in this release, please see the [list of fixed issues](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20fixVersion%3D2.2.3).

**Full Changelog**: [v2.2.2...v2.2.3](mongodb/mongo-go-driver@v2.2.2...v2.2.3)

Documentation for the Go Driver can be found on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo?tab=doc) and the [MongoDB documentation site](https://docs.mongodb.com/ecosystem/drivers/go/). BSON library documentation is also available on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson?tab=doc). Questions and inquiries can be asked on the [MongoDB Developer Community](https://www.mongodb.com/community/forums/tag/golang). Bugs can be reported in the [Go Driver project in the MongoDB JIRA](https://jira.mongodb.org/secure/CreateIssue!default.jspa?pid=14289) where a list of [current issues](https://jira.mongodb.org/browse/GODRIVER) can be found. Your feedback on the Go Driver is greatly appreciated!

### [`v2.2.2`](https://github.com/mongodb/mongo-go-driver/releases/tag/v2.2.2): MongoDB Go Driver 2.2.2

[Compare Source](mongodb/mongo-go-driver@v2.2.1...v2.2.2)

The MongoDB Go Driver Team is pleased to release version 2.2.2 of the official MongoDB Go Driver.

#### Release Notes

This release resolves three bugs in the Go Driver: it removes a buggy and unnecessary connection liveness check that could run unexpectedly or fail intermittently when maxIdleTimeMS was set, and it fixes an issue in decoding to overwrite prepopulated slice. Also, a unmarshaler for gridfs.File is added.

***

For a full list of tickets included in this release, please see the [list of fixed issues](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20fixVersion%3D2.2.2).

**Full Changelog**: [v2.2.1...v2.2.2](mongodb/mongo-go-driver@v2.2.1...v2.2.2)

Documentation for the Go Driver can be found on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo?tab=doc) and the [MongoDB documentation site](https://docs.mongodb.com/ecosystem/drivers/go/). BSON library documentation is also available on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson?tab=doc). Questions and inquiries can be asked on the [MongoDB Developer Community](https://www.mongodb.com/community/forums/tag/golang). Bugs can be reported in the [Go Driver project in the MongoDB JIRA](https://jira.mongodb.org/secure/CreateIssue!default.jspa?pid=14289) where a list of [current issues](https://jira.mongodb.org/browse/GODRIVER) can be found. Your feedback on the Go Driver is greatly appreciated!

#### What's Changed

- Ignore unmaintained branches when merging up by [@&#8203;alcaeus](https://github.com/alcaeus) in [#&#8203;2062](mongodb/mongo-go-driver#2062)
- GODRIVER-3549 Fix timeouts in CSE custom endpoint test ([#&#8203;2028](mongodb/mongo-go-driver#2028)) ([#&#8203;2031](mongodb/mongo-go-driver#2031)) by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2061](mongodb/mongo-go-driver#2061)
- GODRIVER-3516 Remove isAlive by [@&#8203;linfeip](https://github.com/linfeip) in [#&#8203;2060](mongodb/mongo-go-driver#2060)
- GODRIVER-3560 Assume ec2 role explicitly in CI by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2080](mongodb/mongo-go-driver#2080)
- GODRIVER-3524 Sync updates to reflect showExpandedEvents omissions by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2084](mongodb/mongo-go-driver#2084)
- GODRIVER-3565 Add UnmarshalBSON to GridFSFile by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2077](mongodb/mongo-go-driver#2077)
- GODRIVER-3574 Align BSON interface slice decoding with json package. by [@&#8203;qingyang-hu](https://github.com/qingyang-hu) in [#&#8203;2075](mongodb/mongo-go-driver#2075)

#### New Contributors

- [@&#8203;linfeip](https://github.com/linfeip) made their first contribution in [#&#8203;2060](mongodb/mongo-go-driver#2060)

**Full Changelog**: <mongodb/mongo-go-driver@v2.2.1...v2.2.2>

### [`v2.2.1`](https://github.com/mongodb/mongo-go-driver/releases/tag/v2.2.1): MongoDB Go Driver 2.2.1

[Compare Source](mongodb/mongo-go-driver@v2.2.0...v2.2.1)

The MongoDB Go Driver Team is pleased to release version 2.2.1 of the official MongoDB Go Driver.

#### Release Notes

This release enhances BSON encoding performance by using `sync.Pool` for value writers and readers during encoding and decoding, leading to better memory allocation and improved efficiency. Note that further regressions from version 1 may be addressed in GODRIVER-3450, with this update focusing on reinstating optimizations removed in the version 2 implementation. Performance may not be  1-1 with v1 since v2 suggests using the `bufio` package for byte management rather than a raw byte slice.

#### What's Changed

- GODRIVER-3546 Fix timeouts in CSE custom endpoint test ([#&#8203;2028](mongodb/mongo-go-driver#2028)) by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2031](mongodb/mongo-go-driver#2031)
- GODRIVER-3533 Optimize value reader and writer ([#&#8203;2022](mongodb/mongo-go-driver#2022)) by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2030](mongodb/mongo-go-driver#2030)
- DEVPROD-17319 Update perf.send command to new results end point by [@&#8203;prestonvasquez](https://github.com/prestonvasquez) in [#&#8203;2032](mongodb/mongo-go-driver#2032)

**Full Changelog**: <mongodb/mongo-go-driver@v2.2.0...v2.2.1>
**JIRA Release Notes**: <https://jira.mongodb.org/projects/GODRIVER/versions/43096>

Documentation for the Go Driver can be found on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo?tab=doc) and the [MongoDB documentation site](https://docs.mongodb.com/ecosystem/drivers/go/). BSON library documentation is also available on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson?tab=doc). Questions and inquiries can be asked on the [MongoDB Developer Community](https://www.mongodb.com/community/forums/tag/golang). Bugs can be reported in the [Go Driver project in the MongoDB JIRA](https://jira.mongodb.org/secure/CreateIssue!default.jspa?pid=14289) where a list of [current issues](https://jira.mongodb.org/browse/GODRIVER) can be found. Your feedback on the Go Driver is greatly appreciated!

### [`v2.2.0`](https://github.com/mongodb/mongo-go-driver/releases/tag/v2.2.0): MongoDB Go Driver 2.2.0

[Compare Source](mongodb/mongo-go-driver@v2.1.0...v2.2.0)

The MongoDB Go Driver team is pleased to release version 2.2.0 of the official MongoDB Go Driver.

#### Release Notes

This release includes support for a global `omitempty` setting to omit empty values when encoding BSON, instead of requiring tagging on individual struct fields. We have implemented support for [`errors.Is`](https://pkg.go.dev/errors#Is) and [`errors.As`](https://pkg.go.dev/errors#As) in all stable public APIs for improved error management. Also included is support to configure the lifetime of the [Data Encryption Key (DEK)](https://www.mongodb.com/docs/manual/core/csfle/fundamentals/manage-keys/) cache as well as [Kubernetes Support for OIDC](https://www.mongodb.com/docs/drivers/go/current/fundamentals/enterprise-auth/#kubernetes).

Additionally **MongoDB Server Version 3.6** has been marked as end-of-life (EOL) and is no longer supported by the driver. Users are advised to upgrade to a supported version.

***

For a full list of tickets included in this release, please see the links below:

- [New Features](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20type%3D%22new%20feature%22%20and%20status%20%3D%20Closed%20and%20fixVersion%3D2.2.0)
- [Improvements](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20type%3Dimprovement%20and%20status%20%3D%20Closed%20and%20fixVersion%3D2.2.0)
- [Bugs](https://jira.mongodb.org/issues/?jql=project%3DGODRIVER%20and%20type%3DBug%20and%20status%3Dclosed%20and%20fixVersion%3D2.2.0)
- [Tasks](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20type%3D%22task%22%20and%20status%20%3D%20Closed%20and%20fixVersion%3D2.2.0)

**Full Changelog**: [v2.1.0...v2.2.0](mongodb/mongo-go-driver@v2.1.0...v2.2.0)

**Note**: The Go Driver team has implemented a workflow action to automatically merge up PRs between v1 and master. This has resulted in an over-extended changelog for this version, including v1 commits for PRs that have already been cherry-picked to master. Please see the associated tickets for commits directly associated with this release.

Documentation for the MongoDB Go Driver can be found on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo) and the [MongoDB documentation site](https://docs.mongodb.com/ecosystem/drivers/go/). BSON library documentation is also available on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson). Questions and inquiries can be asked on the [MongoDB Developer Community](https://www.mongodb.com/community/forums/tag/golang). Bugs can be reported in the [Go Driver project in the MongoDB JIRA](https://jira.mongodb.org/secure/CreateIssue!default.jspa?pid=14289) where a list of [current issues](https://jira.mongodb.org/browse/GODRIVER) can be found. Your feedback on the MongoDB Go Driver is greatly appreciated!

### [`v2.1.0`](https://github.com/mongodb/mongo-go-driver/releases/tag/v2.1.0): MongoDB Go Driver 2.1.0

[Compare Source](mongodb/mongo-go-driver@v2.0.1...v2.1.0)

The MongoDB Go Driver Team is pleased to release version 2.1.0 of the official MongoDB Go Driver.

#### Release Notes

This release adds support for the new bulk write API added in [MongoDB 8.0](https://www.mongodb.com/docs/manual/release-notes/8.0/#new-bulk-write-command) and the new BSON vector datatype used in [Atlas Vector Search](https://www.mongodb.com/docs/atlas/atlas-vector-search/vector-search-overview/).

**Additionally, support for MongoDB 3.6 and below was deprecated in v2.0.0 and will be dropped in the next minor version release (v2.2.0).**

##### New BulkWrite API

The new [Client.BulkWrite](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo#Client.BulkWrite) method can perform many insert, update, and delete operations on multiple databases and collections in one request. In contrast, the existing [Collection.BulkWrite](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo#Collection.BulkWrite) method can only modify a single collection.

##### BSON Vector Datatype

The new [bson.Vector](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson#Vector) type makes inserting and querying vector data using [Atlas Vector Search](https://www.mongodb.com/docs/atlas/atlas-vector-search/vector-search-overview/) easier and more efficient.

***

For a full list of tickets included in this release, please see the links below:

- [New Features](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20type%3D%22new%20feature%22%20and%20status%20%3D%20Closed%20and%20fixVersion%3D2.1.0)
- [Improvements](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20type%3Dimprovement%20and%20status%20%3D%20Closed%20and%20fixVersion%3D2.1.0)
- [Bugs](https://jira.mongodb.org/issues/?jql=project%3DGODRIVER%20and%20type%3DBug%20and%20status%3Dclosed%20and%20fixVersion%3D2.1.0)
- [Tasks](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20type%3D%22task%22%20and%20status%20%3D%20Closed%20and%20fixVersion%3D2.1.0)

**Full Changelog**: [v2.0.1...v2.1.0](mongodb/mongo-go-driver@v2.0.1...v2.1.0)

Documentation for the MongoDB Go Driver can be found on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo) and the [MongoDB documentation site](https://docs.mongodb.com/ecosystem/drivers/go/). BSON library documentation is also available on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson). Questions and inquiries can be asked on the [MongoDB Developer Community](https://www.mongodb.com/community/forums/tag/golang). Bugs can be reported in the [Go Driver project in the MongoDB JIRA](https://jira.mongodb.org/secure/CreateIssue!default.jspa?pid=14289) where a list of [current issues](https://jira.mongodb.org/browse/GODRIVER) can be found. Your feedback on the MongoDB Go Driver is greatly appreciated!

### [`v2.0.1`](https://github.com/mongodb/mongo-go-driver/releases/tag/v2.0.1): MongoDB Go Driver 2.0.1

[Compare Source](mongodb/mongo-go-driver@v2.0.0...v2.0.1)

The MongoDB Go Driver team is pleased to release version 2.0.1 of the official MongoDB Go Driver.

#### Release Notes

This release includes various bug fixes and improvements:

- Allows SRV hostnames with only a domain name and TLD (e.g. "service-name.tld").
- Detects joined errors correctly in [IsNetworkError](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo#IsNetworkError) and [WithTransaction](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo#Session.WithTransaction).
- Fixes a memory buffer reuse bug in [MarshalValue](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson#MarshalValue) that can cause marshaled bytes to become corrupted.
- No longer returns nil from [MergeClientOptions](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo/options#MergeClientOptions) when only one nil argument is passed.
- Skips calling [UnmarshalBSONValue](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson#ValueUnmarshaler.UnmarshalBSONValue) only if the associated BSON field value is null and the Go value is a pointer.

***

For a full list of tickets included in this release, please see the links below:

- [Bugs](https://jira.mongodb.org/issues/?jql=project%3DGODRIVER%20and%20type%3DBug%20and%20status%3Dclosed%20and%20fixVersion%3D2.0.1)
- [Tasks](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20type%3D%22task%22%20and%20status%20%3D%20Closed%20and%20fixVersion%3D2.0.1)

**Full Changelog**: [v2.0.0...v2.0.1](mongodb/mongo-go-driver@v2.0.0...v2.0.1)

Documentation for the MongoDB Go Driver can be found on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo) and the [MongoDB documentation site](https://docs.mongodb.com/ecosystem/drivers/go/). BSON library documentation is also available on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/bson). Questions and inquiries can be asked on the [MongoDB Developer Community](https://www.mongodb.com/community/forums/tag/golang). Bugs can be reported in the [Go Driver project in the MongoDB JIRA](https://jira.mongodb.org/secure/CreateIssue!default.jspa?pid=14289) where a list of [current issues](https://jira.mongodb.org/browse/GODRIVER) can be found. Your feedback on the MongoDB Go Driver is greatly appreciated!

### [`v2.0.0`](https://github.com/mongodb/mongo-go-driver/releases/tag/v2.0.0): MongoDB Go Driver 2.0.0

[Compare Source](mongodb/mongo-go-driver@v1.17.7...v2.0.0)

The MongoDB Go Driver Team is pleased to release version 2.0.0 of the official MongoDB Go driver.

#### Release Notes

This release includes a host of new features and several breaking changes. Below, we provide an overview of the key highlights, changes, and guidance for migrating from version 1.x to 2.0. See the [MongoDB docs](https://www.mongodb.com/docs/drivers/go/upcoming/whats-new/#what-s-new-in-2.0) for a complete list of breaking changes and additional information on what's new.

This release includes several breaking changes that users must account for when upgrading, including:

- **Options Package**: The approach to managing options has been restructured to use a builder pattern, changing how options are constructed and applied. This alteration allows for more flexible and dynamic option configurations, but may require changes to existing code that directly manipulates options objects.
- **Mongo Package**: The `Client.Connect()` method has been removed, favoring `mongo.Connect()` to streamline connection handling.
- **Event Package**: References to the `description` package have been transitioned to `event.ServerDescription` and `event.TopologyDescription`, impacting how server and topology details are accessed.
- **BSON Package Consolidation**: All previously separate BSON-related packages, including `bsoncodec`, `bsonoptions`, `bsonrw`, and `mgocompat`, have been merged into the single `bson` package. Many functionalities from these packages have been reorganized or renamed. For instance, `bson.NewRegistryBuilder` has been replaced with new APIs tailored for registry configuration, and interfaces like `ValueReader` and `ValueWriter` are now part of the consolidated `bson` package. This consolidation simplifies the package structure but requires updates to import paths and related logic.

To ease the transition to 2.0, **a comprehensive [migration guide](https://github.com/mongodb/mongo-go-driver/blob/master/docs/migration-2.0.md) has been provided**. This guide includes detailed instructions to navigate the changes, including the updated options pattern, altered imports, and revised method signatures.

Additionally, this release deprecates support for MongoDB server versions below 3.6. Support for MongoDB 3.6 will be dropped in a future update.

New features will no longer be added to the 1.x versions. However, critical bug fixes and CVE resolutions will continue to be back-ported to 1.x versions for one year until January 15, 2026. After that date, support for 1.x versions will be discontinued.

We express our gratitude to our contributors and the community for all the support in developing this release.

***

For a full list of tickets included in this release, please see the links below:

- [Projects](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20type%3Depic%20and%20status%20%3D%20Closed%20and%20fixVersion%3D2.0.0)
- [New Features](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20type%3D%22new%20feature%22%20and%20status%20%3D%20Closed%20and%20fixVersion%3D2.0.0)
- [Improvements](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20type%3Dimprovement%20and%20status%20%3D%20Closed%20and%20fixVersion%3D2.0.0)
- [Bugs](https://jira.mongodb.org/issues/?jql=project%3DGODRIVER%20and%20type%3DBug%20and%20status%3Dclosed%20and%20fixVersion%3D2.0.0)
- [Tasks](https://jira.mongodb.org/issues/?jql=project%3Dgodriver%20and%20type%3D%22task%22%20and%20status%20%3D%20Closed%20and%20fixVersion%3D2.0.0)

**Full Changelog**: [v1.17.1...v2.0.0](mongodb/mongo-go-driver@v1.17.1...v2.0.0)

Documentation for the Go driver can be found on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/mongo?tab=doc) and the [MongoDB documentation site](https://docs.mongodb.com/ecosystem/drivers/go/). BSON library documentation is also available on [pkg.go.dev](https://pkg.go.dev/go.mongodb.org/mongo-driver/bson?tab=doc). Questions and inquiries can be asked on the [MongoDB Developer Community](https://community.mongodb.com/). Bugs can be reported in the [Go Driver project in the MongoDB JIRA](https://jira.mongodb.org/secure/CreateIssue!default.jspa?pid=14289) where a list of [current issues](https://jira.mongodb.org/browse/GODRIVER) can be found. Your feedback on the Go driver is greatly appreciated!

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0Mi45Mi4yIiwidXBkYXRlZEluVmVyIjoiNDIuOTIuMiIsInRhcmdldEJyYW5jaCI6Im1haW4iLCJsYWJlbHMiOlsiZGVwZW5kZW5jaWVzIl19-->

Co-authored-by: Renovate Bot <renovate@yourdomain.com>
Co-authored-by: riverajo <2325467+riverajo@users.noreply.github.com>
Reviewed-on: https://git.rivera.ninja/joe/fitness-app/pulls/29
Co-authored-by: renovate-bot <rivera.d.joseph@gmaill.com>
Co-committed-by: renovate-bot <rivera.d.joseph@gmaill.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement review-priority-normal Medium Priority PR for Review: within 1 business day

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants