Uploaded image for project: 'Go Driver'
  1. Go Driver
  2. GODRIVER-2663

Deprecate "bson.Raw" APIs to support merge with "bsoncore.Document" API

XMLWordPrintableJSON

    • Type: Icon: Improvement Improvement
    • Resolution: Done
    • Priority: Icon: Unknown Unknown
    • None
    • Affects Version/s: None
    • Component/s: BSON
    • None
    • Hide

      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?

      Show
      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?

      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

            Assignee:
            matt.dale@mongodb.com Matt Dale
            Reporter:
            matt.dale@mongodb.com Matt Dale
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: