[GODRIVER-2663] Deprecate "bson.Raw" APIs to support merge with "bsoncore.Document" API Created: 22/Nov/22  Updated: 31/May/23  Resolved: 31/May/23

Status: Closed
Project: Go Driver
Component/s: BSON
Affects Version/s: None
Fix Version/s: None

Type: Improvement Priority: Unknown
Reporter: Matt Dale Assignee: Matt Dale
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Depends
is depended on by GODRIVER-2617 Remove or un-export all currently dep... Closed
Related
related to GODRIVER-1639 Add a "bson.RawArray" type to improve... Backlog
related to GODRIVER-2863 Improve BSON RawValue type conversion... Backlog
Epic Link: Go Driver 2.0 Prep
Quarter: FY24Q1
Documentation Changes Summary:

1. What would you like to communicate to the user about this feature?
2. Would you like the user to see examples of the syntax and/or executable code and its output?
3. Which versions of the driver/connector does this apply to?


 Description   

The bsoncore.Document API is the basis for the bson.Raw and bson.RawValue APIs, but they are disjoint in some cases, with bsoncore.Document being a more powerful and complete API. Eventually we want to expose more important functionality from the bsoncore.Document API via the bson.Raw and bson.RawValue APIs, but there are cases where bson.Raw/bson.RawValue aren't perfect subsets of the bsoncore.Document API, making merging them more difficult.

Update the bson.Raw/bson.RawValue APIs to make it possible to incrementally merge the APIs after the Go Driver 2.0 release.

Definition of done:

  • List API changes required to make this possible.
  • Deprecate existing APIs in the v1.x driver that need to be removed in the v2.0 driver to make this possible. Note that deprecated APIs will be removed with GODRIVER-2617
  • Create tickets to track migration of the bsoncore.Document API to bson.Raw/bson.RawValue


 Comments   
Comment by Matt Dale [ 31/May/23 ]

Split to GODRIVER-1639 and GODRIVER-2863. There's nothing else to do before we can make breaking API changes for Go Driver 2.0.

Generated at Thu Feb 08 08:39:06 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.