Generator improvements and cleanup

- generator now supports include-comments flag (as opt-in)
- minor code cleanup in binapi-generator
- remove obsolete unit tests
- flatten examples from examples/cmd folder
- introduce constant for checking compatibility in future versions

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

1 files changed, 3 insertions, 260 deletions

diff --git a/examples/bin_api/tap/tap.ba.go b/examples/bin_api/tap/tap.ba.go
index d363146..aafd206 100644
--- a/examples/bin_api/tap/tap.ba.go
+++ b/examples/bin_api/tap/tap.ba.go
@@ -10,9 +10,9 @@
 */
 package tap
 
-import "git.fd.io/govpp.git/api"
-import "github.com/lunixbochs/struc"
-import "bytes"
+import api "git.fd.io/govpp.git/api"
+import struc "github.com/lunixbochs/struc"
+import bytes "bytes"
 
 // Reference imports to suppress errors if they are not otherwise used.
 var _ = api.RegisterMessage
@@ -20,23 +20,6 @@ var _ = struc.Pack
 var _ = bytes.NewBuffer
 
 // Services represents VPP binary API services:
-//
-//	"services": {
-//	    "tap_delete": {
-//	        "reply": "tap_delete_reply"
-//	    },
-//	    "sw_interface_tap_dump": {
-//	        "reply": "sw_interface_tap_details",
-//	        "stream": true
-//	    },
-//	    "tap_modify": {
-//	        "reply": "tap_modify_reply"
-//	    },
-//	    "tap_connect": {
-//	        "reply": "tap_connect_reply"
-//	    }
-//	},
-//
 type Services interface {
 	DumpSwInterfaceTap(*SwInterfaceTapDump) ([]*SwInterfaceTapDetails, error)
 	TapConnect(*TapConnect) (*TapConnectReply, error)
@@ -47,29 +30,6 @@ type Services interface {
 /* Messages */
 
 // SwInterfaceTapDetails represents VPP binary API message 'sw_interface_tap_details':
-//
-//	"sw_interface_tap_details",
-//	[
-//	    "u16",
-//	    "_vl_msg_id"
-//	],
-//	[
-//	    "u32",
-//	    "context"
-//	],
-//	[
-//	    "u32",
-//	    "sw_if_index"
-//	],
-//	[
-//	    "u8",
-//	    "dev_name",
-//	    64
-//	],
-//	{
-//	    "crc": "0x76229a57"
-//	}
-//
 type SwInterfaceTapDetails struct {
 	SwIfIndex uint32
 	DevName   []byte `struc:"[64]byte"`
@@ -86,24 +46,6 @@ func (*SwInterfaceTapDetails) GetMessageType() api.MessageType {
 }
 
 // SwInterfaceTapDump represents VPP binary API message 'sw_interface_tap_dump':
-//
-//	"sw_interface_tap_dump",
-//	[
-//	    "u16",
-//	    "_vl_msg_id"
-//	],
-//	[
-//	    "u32",
-//	    "client_index"
-//	],
-//	[
-//	    "u32",
-//	    "context"
-//	],
-//	{
-//	    "crc": "0x51077d14"
-//	}
-//
 type SwInterfaceTapDump struct{}
 
 func (*SwInterfaceTapDump) GetMessageName() string {
@@ -117,77 +59,6 @@ func (*SwInterfaceTapDump) GetMessageType() api.MessageType {
 }
 
 // TapConnect represents VPP binary API message 'tap_connect':
-//
-//	"tap_connect",
-//	[
-//	    "u16",
-//	    "_vl_msg_id"
-//	],
-//	[
-//	    "u32",
-//	    "client_index"
-//	],
-//	[
-//	    "u32",
-//	    "context"
-//	],
-//	[
-//	    "u8",
-//	    "use_random_mac"
-//	],
-//	[
-//	    "u8",
-//	    "tap_name",
-//	    64
-//	],
-//	[
-//	    "u8",
-//	    "mac_address",
-//	    6
-//	],
-//	[
-//	    "u8",
-//	    "renumber"
-//	],
-//	[
-//	    "u32",
-//	    "custom_dev_instance"
-//	],
-//	[
-//	    "u8",
-//	    "ip4_address_set"
-//	],
-//	[
-//	    "u8",
-//	    "ip4_address",
-//	    4
-//	],
-//	[
-//	    "u8",
-//	    "ip4_mask_width"
-//	],
-//	[
-//	    "u8",
-//	    "ip6_address_set"
-//	],
-//	[
-//	    "u8",
-//	    "ip6_address",
-//	    16
-//	],
-//	[
-//	    "u8",
-//	    "ip6_mask_width"
-//	],
-//	[
-//	    "u8",
-//	    "tag",
-//	    64
-//	],
-//	{
-//	    "crc": "0x9b9c396f"
-//	}
-//
 type TapConnect struct {
 	UseRandomMac      uint8
 	TapName           []byte `struc:"[64]byte"`
@@ -214,28 +85,6 @@ func (*TapConnect) GetMessageType() api.MessageType {
 }
 
 // TapConnectReply represents VPP binary API message 'tap_connect_reply':
-//
-//	"tap_connect_reply",
-//	[
-//	    "u16",
-//	    "_vl_msg_id"
-//	],
-//	[
-//	    "u32",
-//	    "context"
-//	],
-//	[
-//	    "i32",
-//	    "retval"
-//	],
-//	[
-//	    "u32",
-//	    "sw_if_index"
-//	],
-//	{
-//	    "crc": "0xfda5941f"
-//	}
-//
 type TapConnectReply struct {
 	Retval    int32
 	SwIfIndex uint32
@@ -252,28 +101,6 @@ func (*TapConnectReply) GetMessageType() api.MessageType {
 }
 
 // TapDelete represents VPP binary API message 'tap_delete':
-//
-//	"tap_delete",
-//	[
-//	    "u16",
-//	    "_vl_msg_id"
-//	],
-//	[
-//	    "u32",
-//	    "client_index"
-//	],
-//	[
-//	    "u32",
-//	    "context"
-//	],
-//	[
-//	    "u32",
-//	    "sw_if_index"
-//	],
-//	{
-//	    "crc": "0x529cb13f"
-//	}
-//
 type TapDelete struct {
 	SwIfIndex uint32
 }
@@ -289,24 +116,6 @@ func (*TapDelete) GetMessageType() api.MessageType {
 }
 
 // TapDeleteReply represents VPP binary API message 'tap_delete_reply':
-//
-//	"tap_delete_reply",
-//	[
-//	    "u16",
-//	    "_vl_msg_id"
-//	],
-//	[
-//	    "u32",
-//	    "context"
-//	],
-//	[
-//	    "i32",
-//	    "retval"
-//	],
-//	{
-//	    "crc": "0xe8d4e804"
-//	}
-//
 type TapDeleteReply struct {
 	Retval int32
 }
@@ -322,50 +131,6 @@ func (*TapDeleteReply) GetMessageType() api.MessageType {
 }
 
 // TapModify represents VPP binary API message 'tap_modify':
-//
-//	"tap_modify",
-//	[
-//	    "u16",
-//	    "_vl_msg_id"
-//	],
-//	[
-//	    "u32",
-//	    "client_index"
-//	],
-//	[
-//	    "u32",
-//	    "context"
-//	],
-//	[
-//	    "u32",
-//	    "sw_if_index"
-//	],
-//	[
-//	    "u8",
-//	    "use_random_mac"
-//	],
-//	[
-//	    "u8",
-//	    "tap_name",
-//	    64
-//	],
-//	[
-//	    "u8",
-//	    "mac_address",
-//	    6
-//	],
-//	[
-//	    "u8",
-//	    "renumber"
-//	],
-//	[
-//	    "u32",
-//	    "custom_dev_instance"
-//	],
-//	{
-//	    "crc": "0x8047ae5c"
-//	}
-//
 type TapModify struct {
 	SwIfIndex         uint32
 	UseRandomMac      uint8
@@ -386,28 +151,6 @@ func (*TapModify) GetMessageType() api.MessageType {
 }
 
 // TapModifyReply represents VPP binary API message 'tap_modify_reply':
-//
-//	"tap_modify_reply",
-//	[
-//	    "u16",
-//	    "_vl_msg_id"
-//	],
-//	[
-//	    "u32",
-//	    "context"
-//	],
-//	[
-//	    "i32",
-//	    "retval"
-//	],
-//	[
-//	    "u32",
-//	    "sw_if_index"
-//	],
-//	{
-//	    "crc": "0xfda5941f"
-//	}
-//
 type TapModifyReply struct {
 	Retval    int32
 	SwIfIndex uint32