codecs

README

mongo-go-driver-protobuf

This is extension for officional MongoDB Go driver adds support for Google protocol buffers types.

• Description
• Links
• Requirements
• Installation
• Usage example

Description

It contains set of BSON marshal/unmarshal codecs for Google protocol buffers type wrappers, Timestamp and MongoDB ObjectID:

• BoolValue
• BytesValue
• DoubleValue
• FloatValue
• Int32Value
• Int64Value
• StringValue
• Uint32Value
• Uint64Value
• Timestamp
• ObjectID
• Struct

Links

• Official MongoDB Go Driver: https://go.mongodb.org/mongo-driver
• Google protocol buffers types (wrappers): https://github.com/golang/protobuf/blob/master/ptypes/wrappers/wrappers.proto
• Google protocol buffers Timestamp type: https://github.com/golang/protobuf/blob/master/ptypes/timestamp/timestamp.proto
• MongoDB ObjectID type: https://github.com/mongodb/mongo-go-driver/blob/master/bson/primitive/objectid.go
• MongoDB ObjectID my proto wrapper: https://github.com/amsokol/mongo-go-driver-protobuf/blob/master/proto/mongodb/objectid.proto

Requirements

• Google protocol buffers version proto3
• Official MongoDB Go Driver RC1 or higher

Installation

Installing using go get:

go get -u github.com/Hunrik/mongo-go-driver-protobuf

or you don't need to do anything manually if you are using Go modules. Go modules installs necessary packages automatically.

Usage example

First install protoc-gen-gotag to make available Go language tags for proto messages

go get -u github.com/Hunrik/protoc-gen-gotag

Next

1. Create free Altas mini MongoDB instance
2. Create experiments database
3. Create proto collection into experiments database
4. Run this example

Documentation

Index

• func Register(rb *bsoncodec.RegistryBuilder) *bsoncodec.RegistryBuilder
• func ToStruct(v map[string]interface{}) *st.Struct
• func ToValue(v interface{}) *st.Value

Functions

func Register

func Register(rb *bsoncodec.RegistryBuilder) *bsoncodec.RegistryBuilder

Register registers Google protocol buffers types codecs

func ToStruct

func ToStruct(v map[string]interface{}) *st.Struct

ToStruct converts a map[string]interface{} to a ptypes.Struct

func ToValue

func ToValue(v interface{}) *st.Value

ToValue converts an interface{} to a ptypes.Value