protobuf

README

ProtoBuf

I reject the idea of having to use a compiler for ProtoBuf. I think you should be able to Marshal and Unmarshal just like JSON. And really, that should be possible. If they had only added a single extra wiretype for messages, ProtoBuf would be more or less self describing. At any rate, I want a package that can decode arbitrary ProtoBuf, and can also encode some Map or Struct into ProtoBuf as well.

• https://github.com/golang/protobuf/issues/1370
• https://stackoverflow.com/questions/41348512/protobuf-unmarshal-unknown

Why not use generic add?

If you use generic add with method interface, it would allow recurive slices. We could solve this by also adding type interface, but its probably simpler to just not use generics for this.

Why not implement a decoder?

I tried, but Unmarshal is way faster:

Benchmark_Decode-12       367295 ns/op         1481091 B/op       2588 allocs/op
Benchmark_Unmarshal-12     86033 ns/op           80245 B/op       1104 allocs/op

Documentation

Index

• type Bytes
• type Encoder
• type Fixed32
• type Fixed64
• type Message
  • func Unmarshal(buf []byte) (Message, error)
  • func (m Message) Add(num Number, value Message) error
  • func (m Message) Add_Fixed32(num Number, value uint32) error
  • func (m Message) Add_Fixed64(num Number, value uint64) error
  • func (m Message) Add_String(num Number, value string) error
  • func (m Message) Add_Varint(num Number, value uint64) error
  • func (m Message) Get(num Number) Message
  • func (m Message) Get_Bytes(num Number) ([]byte, error)
  • func (m Message) Get_Fixed64(num Number) (uint64, error)
  • func (m Message) Get_Messages(num Number) []Message
  • func (m Message) Get_String(num Number) (string, error)
  • func (m Message) Get_Varint(num Number) (uint64, error)
  • func (m Message) Marshal() []byte
• type Number
• type Raw
• type Slice
• type String
• type Varint

Types

type Bytes

type Bytes []byte

type Encoder

type Encoder interface {
	// contains filtered or unexported methods
}

type Fixed32

type Fixed32 uint32

type Fixed64

type Fixed64 uint64

type Message

type Message map[Number]Encoder

func Unmarshal

func Unmarshal(buf []byte) (Message, error)

func (Message) Add

func (m Message) Add(num Number, value Message) error

func (Message) Add_Fixed32

func (m Message) Add_Fixed32(num Number, value uint32) error

func (Message) Add_Fixed64

func (m Message) Add_Fixed64(num Number, value uint64) error

func (Message) Add_String

func (m Message) Add_String(num Number, value string) error

func (Message) Add_Varint

func (m Message) Add_Varint(num Number, value uint64) error

func (Message) Get

func (m Message) Get(num Number) Message

func (Message) Get_Bytes

func (m Message) Get_Bytes(num Number) ([]byte, error)

func (Message) Get_Fixed64

func (m Message) Get_Fixed64(num Number) (uint64, error)

func (Message) Get_Messages

func (m Message) Get_Messages(num Number) []Message

func (Message) Get_String

func (m Message) Get_String(num Number) (string, error)

func (Message) Get_Varint

func (m Message) Get_Varint(num Number) (uint64, error)

func (Message) Marshal

func (m Message) Marshal() []byte

type Number

type Number = protowire.Number

type Raw

type Raw struct {
	Bytes   []byte
	String  string
	Message map[Number]Encoder
}

type Slice

type Slice[T Encoder] []T

type String

type String string

type Varint

type Varint uint64