pbutils

Documentation

Overview

Package pbutils provides helper utilities for working with protobuf objects. These utilities are mostly aimed at testing.

Index

• func FuzzFuncs() []interface{}
• func FuzzUnmarshaler(unmarshaler proto.Unmarshaler)
• func RoundTrip(marshaler proto.Marshaler, unmarshaler proto.Unmarshaler) error

Functions

func FuzzFuncs

func FuzzFuncs() []interface{}

FuzzFuncs returns custom fuzzing functions set.

func FuzzUnmarshaler

func FuzzUnmarshaler(unmarshaler proto.Unmarshaler)

FuzzUnmarshaler tests given unmarshaler with random bytes.

func RoundTrip

func RoundTrip(
	marshaler proto.Marshaler,
	unmarshaler proto.Unmarshaler,
) error

RoundTrip takes a marshaler and unmarshaler, marshals the marshaler, and then unmarshals the result into the unmarshaler. If either procedure errors out, it returns an error; otherwise it returns nil and the unmarshaler is left with the results of the round-trip.

This is a utility meant to facilitate tests that verify round-trip marshaling of objects with custom protobuf marshaling.