Improve binapi generator

- simplified Size/Marshal/Unmarshal methods
- replace struc in unions with custom marshal/unmarshal
- fix imports in generated files
- fix mock adapter
- generate rpc service using low-level stream API (dumps generate control ping or stream msg..)
- move examples/binapi to binapi and generate all API for latest release
- add binapigen.Plugin for developing custom generator plugins
- optionally generate HTTP handlers (REST API) for RPC services
- add govpp program for browsing VPP API

Change-Id: I092e9ed2b0c17972b3476463c3d4b14dd76ed42b
Signed-off-by: Ondrej Fabry <ofabry@cisco.com>

1 files changed, 319 insertions, 0 deletions

diff --git a/binapi/udp/udp.ba.go b/binapi/udp/udp.ba.go
new file mode 100644
index 0000000..2582afb
--- /dev/null
+++ b/binapi/udp/udp.ba.go
@@ -0,0 +1,319 @@
+// Code generated by GoVPP's binapi-generator. DO NOT EDIT.
+// versions:
+//  binapi-generator: v0.4.0-dev
+//  VPP:              20.05-release
+// source: /usr/share/vpp/api/core/udp.api.json
+
+// Package udp contains generated bindings for API file udp.api.
+//
+// Contents:
+//   1 struct
+//   6 messages
+//
+package udp
+
+import (
+	api "git.fd.io/govpp.git/api"
+	ip_types "git.fd.io/govpp.git/binapi/ip_types"
+	codec "git.fd.io/govpp.git/codec"
+)
+
+// This is a compile-time assertion to ensure that this generated file
+// is compatible with the GoVPP api package it is being compiled against.
+// A compilation error at this line likely means your copy of the
+// GoVPP api package needs to be updated.
+const _ = api.GoVppAPIPackageIsVersion2
+
+const (
+	APIFile    = "udp"
+	APIVersion = "1.1.0"
+	VersionCrc = 0xb827bf4f
+)
+
+// UDPEncap defines type 'udp_encap'.
+type UDPEncap struct {
+	TableID uint32           `binapi:"u32,name=table_id" json:"table_id,omitempty"`
+	SrcPort uint16           `binapi:"u16,name=src_port" json:"src_port,omitempty"`
+	DstPort uint16           `binapi:"u16,name=dst_port" json:"dst_port,omitempty"`
+	SrcIP   ip_types.Address `binapi:"address,name=src_ip" json:"src_ip,omitempty"`
+	DstIP   ip_types.Address `binapi:"address,name=dst_ip" json:"dst_ip,omitempty"`
+	ID      uint32           `binapi:"u32,name=id" json:"id,omitempty"`
+}
+
+// UDPEncapAdd defines message 'udp_encap_add'.
+type UDPEncapAdd struct {
+	UDPEncap UDPEncap `binapi:"udp_encap,name=udp_encap" json:"udp_encap,omitempty"`
+}
+
+func (m *UDPEncapAdd) Reset()               { *m = UDPEncapAdd{} }
+func (*UDPEncapAdd) GetMessageName() string { return "udp_encap_add" }
+func (*UDPEncapAdd) GetCrcString() string   { return "61d5fc48" }
+func (*UDPEncapAdd) GetMessageType() api.MessageType {
+	return api.RequestMessage
+}
+
+func (m *UDPEncapAdd) Size() int {
+	if m == nil {
+		return 0
+	}
+	var size int
+	size += 4      // m.UDPEncap.TableID
+	size += 2      // m.UDPEncap.SrcPort
+	size += 2      // m.UDPEncap.DstPort
+	size += 1      // m.UDPEncap.SrcIP.Af
+	size += 1 * 16 // m.UDPEncap.SrcIP.Un
+	size += 1      // m.UDPEncap.DstIP.Af
+	size += 1 * 16 // m.UDPEncap.DstIP.Un
+	size += 4      // m.UDPEncap.ID
+	return size
+}
+func (m *UDPEncapAdd) Marshal(b []byte) ([]byte, error) {
+	var buf *codec.Buffer
+	if b == nil {
+		buf = codec.NewBuffer(make([]byte, m.Size()))
+	} else {
+		buf = codec.NewBuffer(b)
+	}
+	buf.EncodeUint32(uint32(m.UDPEncap.TableID))
+	buf.EncodeUint16(uint16(m.UDPEncap.SrcPort))
+	buf.EncodeUint16(uint16(m.UDPEncap.DstPort))
+	buf.EncodeUint8(uint8(m.UDPEncap.SrcIP.Af))
+	buf.EncodeBytes(m.UDPEncap.SrcIP.Un.XXX_UnionData[:], 0)
+	buf.EncodeUint8(uint8(m.UDPEncap.DstIP.Af))
+	buf.EncodeBytes(m.UDPEncap.DstIP.Un.XXX_UnionData[:], 0)
+	buf.EncodeUint32(uint32(m.UDPEncap.ID))
+	return buf.Bytes(), nil
+}
+func (m *UDPEncapAdd) Unmarshal(b []byte) error {
+	buf := codec.NewBuffer(b)
+	m.UDPEncap.TableID = buf.DecodeUint32()
+	m.UDPEncap.SrcPort = buf.DecodeUint16()
+	m.UDPEncap.DstPort = buf.DecodeUint16()
+	m.UDPEncap.SrcIP.Af = ip_types.AddressFamily(buf.DecodeUint8())
+	copy(m.UDPEncap.SrcIP.Un.XXX_UnionData[:], buf.DecodeBytes(16))
+	m.UDPEncap.DstIP.Af = ip_types.AddressFamily(buf.DecodeUint8())
+	copy(m.UDPEncap.DstIP.Un.XXX_UnionData[:], buf.DecodeBytes(16))
+	m.UDPEncap.ID = buf.DecodeUint32()
+	return nil
+}
+
+// UDPEncapAddReply defines message 'udp_encap_add_reply'.
+type UDPEncapAddReply struct {
+	Retval int32  `binapi:"i32,name=retval" json:"retval,omitempty"`
+	ID     uint32 `binapi:"u32,name=id" json:"id,omitempty"`
+}
+
+func (m *UDPEncapAddReply) Reset()               { *m = UDPEncapAddReply{} }
+func (*UDPEncapAddReply) GetMessageName() string { return "udp_encap_add_reply" }
+func (*UDPEncapAddReply) GetCrcString() string   { return "e2fc8294" }
+func (*UDPEncapAddReply) GetMessageType() api.MessageType {
+	return api.ReplyMessage
+}
+
+func (m *UDPEncapAddReply) Size() int {
+	if m == nil {
+		return 0
+	}
+	var size int
+	size += 4 // m.Retval
+	size += 4 // m.ID
+	return size
+}
+func (m *UDPEncapAddReply) Marshal(b []byte) ([]byte, error) {
+	var buf *codec.Buffer
+	if b == nil {
+		buf = codec.NewBuffer(make([]byte, m.Size()))
+	} else {
+		buf = codec.NewBuffer(b)
+	}
+	buf.EncodeUint32(uint32(m.Retval))
+	buf.EncodeUint32(uint32(m.ID))
+	return buf.Bytes(), nil
+}
+func (m *UDPEncapAddReply) Unmarshal(b []byte) error {
+	buf := codec.NewBuffer(b)
+	m.Retval = int32(buf.DecodeUint32())
+	m.ID = buf.DecodeUint32()
+	return nil
+}
+
+// UDPEncapDel defines message 'udp_encap_del'.
+type UDPEncapDel struct {
+	ID uint32 `binapi:"u32,name=id" json:"id,omitempty"`
+}
+
+func (m *UDPEncapDel) Reset()               { *m = UDPEncapDel{} }
+func (*UDPEncapDel) GetMessageName() string { return "udp_encap_del" }
+func (*UDPEncapDel) GetCrcString() string   { return "3a91bde5" }
+func (*UDPEncapDel) GetMessageType() api.MessageType {
+	return api.RequestMessage
+}
+
+func (m *UDPEncapDel) Size() int {
+	if m == nil {
+		return 0
+	}
+	var size int
+	size += 4 // m.ID
+	return size
+}
+func (m *UDPEncapDel) Marshal(b []byte) ([]byte, error) {
+	var buf *codec.Buffer
+	if b == nil {
+		buf = codec.NewBuffer(make([]byte, m.Size()))
+	} else {
+		buf = codec.NewBuffer(b)
+	}
+	buf.EncodeUint32(uint32(m.ID))
+	return buf.Bytes(), nil
+}
+func (m *UDPEncapDel) Unmarshal(b []byte) error {
+	buf := codec.NewBuffer(b)
+	m.ID = buf.DecodeUint32()
+	return nil
+}
+
+// UDPEncapDelReply defines message 'udp_encap_del_reply'.
+type UDPEncapDelReply struct {
+	Retval int32 `binapi:"i32,name=retval" json:"retval,omitempty"`
+}
+
+func (m *UDPEncapDelReply) Reset()               { *m = UDPEncapDelReply{} }
+func (*UDPEncapDelReply) GetMessageName() string { return "udp_encap_del_reply" }
+func (*UDPEncapDelReply) GetCrcString() string   { return "e8d4e804" }
+func (*UDPEncapDelReply) GetMessageType() api.MessageType {
+	return api.ReplyMessage
+}
+
+func (m *UDPEncapDelReply) Size() int {
+	if m == nil {
+		return 0
+	}
+	var size int
+	size += 4 // m.Retval
+	return size
+}
+func (m *UDPEncapDelReply) Marshal(b []byte) ([]byte, error) {
+	var buf *codec.Buffer
+	if b == nil {
+		buf = codec.NewBuffer(make([]byte, m.Size()))
+	} else {
+		buf = codec.NewBuffer(b)
+	}
+	buf.EncodeUint32(uint32(m.Retval))
+	return buf.Bytes(), nil
+}
+func (m *UDPEncapDelReply) Unmarshal(b []byte) error {
+	buf := codec.NewBuffer(b)
+	m.Retval = int32(buf.DecodeUint32())
+	return nil
+}
+
+// UDPEncapDetails defines message 'udp_encap_details'.
+type UDPEncapDetails struct {
+	UDPEncap UDPEncap `binapi:"udp_encap,name=udp_encap" json:"udp_encap,omitempty"`
+}
+
+func (m *UDPEncapDetails) Reset()               { *m = UDPEncapDetails{} }
+func (*UDPEncapDetails) GetMessageName() string { return "udp_encap_details" }
+func (*UDPEncapDetails) GetCrcString() string   { return "87c82821" }
+func (*UDPEncapDetails) GetMessageType() api.MessageType {
+	return api.ReplyMessage
+}
+
+func (m *UDPEncapDetails) Size() int {
+	if m == nil {
+		return 0
+	}
+	var size int
+	size += 4      // m.UDPEncap.TableID
+	size += 2      // m.UDPEncap.SrcPort
+	size += 2      // m.UDPEncap.DstPort
+	size += 1      // m.UDPEncap.SrcIP.Af
+	size += 1 * 16 // m.UDPEncap.SrcIP.Un
+	size += 1      // m.UDPEncap.DstIP.Af
+	size += 1 * 16 // m.UDPEncap.DstIP.Un
+	size += 4      // m.UDPEncap.ID
+	return size
+}
+func (m *UDPEncapDetails) Marshal(b []byte) ([]byte, error) {
+	var buf *codec.Buffer
+	if b == nil {
+		buf = codec.NewBuffer(make([]byte, m.Size()))
+	} else {
+		buf = codec.NewBuffer(b)
+	}
+	buf.EncodeUint32(uint32(m.UDPEncap.TableID))
+	buf.EncodeUint16(uint16(m.UDPEncap.SrcPort))
+	buf.EncodeUint16(uint16(m.UDPEncap.DstPort))
+	buf.EncodeUint8(uint8(m.UDPEncap.SrcIP.Af))
+	buf.EncodeBytes(m.UDPEncap.SrcIP.Un.XXX_UnionData[:], 0)
+	buf.EncodeUint8(uint8(m.UDPEncap.DstIP.Af))
+	buf.EncodeBytes(m.UDPEncap.DstIP.Un.XXX_UnionData[:], 0)
+	buf.EncodeUint32(uint32(m.UDPEncap.ID))
+	return buf.Bytes(), nil
+}
+func (m *UDPEncapDetails) Unmarshal(b []byte) error {
+	buf := codec.NewBuffer(b)
+	m.UDPEncap.TableID = buf.DecodeUint32()
+	m.UDPEncap.SrcPort = buf.DecodeUint16()
+	m.UDPEncap.DstPort = buf.DecodeUint16()
+	m.UDPEncap.SrcIP.Af = ip_types.AddressFamily(buf.DecodeUint8())
+	copy(m.UDPEncap.SrcIP.Un.XXX_UnionData[:], buf.DecodeBytes(16))
+	m.UDPEncap.DstIP.Af = ip_types.AddressFamily(buf.DecodeUint8())
+	copy(m.UDPEncap.DstIP.Un.XXX_UnionData[:], buf.DecodeBytes(16))
+	m.UDPEncap.ID = buf.DecodeUint32()
+	return nil
+}
+
+// UDPEncapDump defines message 'udp_encap_dump'.
+type UDPEncapDump struct{}
+
+func (m *UDPEncapDump) Reset()               { *m = UDPEncapDump{} }
+func (*UDPEncapDump) GetMessageName() string { return "udp_encap_dump" }
+func (*UDPEncapDump) GetCrcString() string   { return "51077d14" }
+func (*UDPEncapDump) GetMessageType() api.MessageType {
+	return api.RequestMessage
+}
+
+func (m *UDPEncapDump) Size() int {
+	if m == nil {
+		return 0
+	}
+	var size int
+	return size
+}
+func (m *UDPEncapDump) Marshal(b []byte) ([]byte, error) {
+	var buf *codec.Buffer
+	if b == nil {
+		buf = codec.NewBuffer(make([]byte, m.Size()))
+	} else {
+		buf = codec.NewBuffer(b)
+	}
+	return buf.Bytes(), nil
+}
+func (m *UDPEncapDump) Unmarshal(b []byte) error {
+	return nil
+}
+
+func init() { file_udp_binapi_init() }
+func file_udp_binapi_init() {
+	api.RegisterMessage((*UDPEncapAdd)(nil), "udp_encap_add_61d5fc48")
+	api.RegisterMessage((*UDPEncapAddReply)(nil), "udp_encap_add_reply_e2fc8294")
+	api.RegisterMessage((*UDPEncapDel)(nil), "udp_encap_del_3a91bde5")
+	api.RegisterMessage((*UDPEncapDelReply)(nil), "udp_encap_del_reply_e8d4e804")
+	api.RegisterMessage((*UDPEncapDetails)(nil), "udp_encap_details_87c82821")
+	api.RegisterMessage((*UDPEncapDump)(nil), "udp_encap_dump_51077d14")
+}
+
+// Messages returns list of all messages in this module.
+func AllMessages() []api.Message {
+	return []api.Message{
+		(*UDPEncapAdd)(nil),
+		(*UDPEncapAddReply)(nil),
+		(*UDPEncapDel)(nil),
+		(*UDPEncapDelReply)(nil),
+		(*UDPEncapDetails)(nil),
+		(*UDPEncapDump)(nil),
+	}
+}