package typeurl

import "github.com/containerd/typeurl"

Index ¶

• Variables
• func Is(any *types.Any, v interface{}) bool
• func MarshalAny(v interface{}) (*types.Any, error)
• func Register(v interface{}, args ...string)
• func TypeURL(v interface{}) (string, error)
• func UnmarshalAny(any *types.Any) (interface{}, error)
• func UnmarshalByTypeURL(typeURL string, value []byte) (interface{}, error)
• func UnmarshalTo(any *types.Any, out interface{}) error
• func UnmarshalToByTypeURL(typeURL string, value []byte, out interface{}) error

Variables ¶

var (
	ErrNotFound = errors.New("not found")
)

Definitions of common error types used throughout typeurl.

These error types are used with errors.Wrap and errors.Wrapf to add context to an error.

To detect an error class, use errors.Is() functions to tell whether an error is of this type.

Functions ¶

func Is ¶

func Is(any *types.Any, v interface{}) bool

Is returns true if the type of the Any is the same as v.

func MarshalAny ¶

func MarshalAny(v interface{}) (*types.Any, error)

MarshalAny marshals the value v into an any with the correct TypeUrl. If the provided object is already a proto.Any message, then it will be returned verbatim. If it is of type proto.Message, it will be marshaled as a protocol buffer. Otherwise, the object will be marshaled to json.

func Register ¶

func Register(v interface{}, args ...string)

Register a type with a base URL for JSON marshaling. When the MarshalAny and UnmarshalAny functions are called they will treat the Any type value as JSON. To use protocol buffers for handling the Any value the proto.Register function should be used instead of this function.

func TypeURL ¶

func TypeURL(v interface{}) (string, error)

TypeURL returns the type url for a registered type.

func UnmarshalAny ¶

func UnmarshalAny(any *types.Any) (interface{}, error)

UnmarshalAny unmarshals the any type into a concrete type.

func UnmarshalByTypeURL ¶

func UnmarshalByTypeURL(typeURL string, value []byte) (interface{}, error)

UnmarshalByTypeURL unmarshals the given type and value to into a concrete type.

func UnmarshalTo ¶

func UnmarshalTo(any *types.Any, out interface{}) error

UnmarshalTo unmarshals the any type into a concrete type passed in the out argument. It is identical to UnmarshalAny, but lets clients provide a destination type through the out argument.

func UnmarshalToByTypeURL ¶

func UnmarshalToByTypeURL(typeURL string, value []byte, out interface{}) error

UnmarshalTo unmarshals the given type and value into a concrete type passed in the out argument. It is identical to UnmarshalByTypeURL, but lets clients provide a destination type through the out argument.

Source Files ¶

doc.go types.go