From c4522fe10317b1729a0820dc880afc78c663f64d Mon Sep 17 00:00:00 2001
From: Ondrej Fabry <ofabry@cisco.com>
Date: Thu, 6 Jun 2019 14:08:48 +0200
Subject: Add various generator improvements

- generate service implementation for modules
- generate conversion maps and String() method for enums
- generate module name and version as constants
- rename Union_data field to XXX_UnionData for consistency
- generate constant GoVppAPIPackageIsVersionN for checking compatibility with API
- add example for using service clients
- add some documentation to socketclient adapter
- cleanup gen.go file used for generating binapi
- regenerate binapi with latest VPP release (19.04.1)
- change global variables Messages into a function AllMessages

Change-Id: Id1ef97764570759eaa3e5a4dc14ecda7a168ee39
Signed-off-by: Ondrej Fabry <ofabry@cisco.com>
---
 examples/service-client/service_client.go | 77 +++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 examples/service-client/service_client.go

(limited to 'examples/service-client/service_client.go')

diff --git a/examples/service-client/service_client.go b/examples/service-client/service_client.go
new file mode 100644
index 0000000..9aa07db
--- /dev/null
+++ b/examples/service-client/service_client.go
@@ -0,0 +1,77 @@
+// Copyright (c) 2017 Cisco and/or its affiliates.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at:
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// service-client is an example VPP management application that exercises the
+// govpp API using generated service client.
+package main
+
+import (
+	"bytes"
+	"context"
+	"fmt"
+	"log"
+
+	"git.fd.io/govpp.git"
+	"git.fd.io/govpp.git/api"
+	"git.fd.io/govpp.git/examples/binapi/interfaces"
+	"git.fd.io/govpp.git/examples/binapi/vpe"
+)
+
+func main() {
+	fmt.Println("Starting VPP service client...")
+
+	// connect to VPP
+	conn, err := govpp.Connect("")
+	if err != nil {
+		log.Fatalln("failed to connect:", err)
+	}
+	defer conn.Disconnect()
+
+	// create an API channel
+	ch, err := conn.NewAPIChannel()
+	if err != nil {
+		log.Fatalln("failed to create channel:", err)
+	}
+	defer ch.Close()
+
+	showVersion(ch)
+	interfaceDump(ch)
+}
+
+// showVersion shows an example of simple request with services.
+func showVersion(ch api.Channel) {
+	c := vpe.NewService(ch)
+
+	version, err := c.ShowVersion(context.Background(), &vpe.ShowVersion{})
+	if err != nil {
+		log.Fatalln("ShowVersion failed:", err)
+	}
+
+	fmt.Printf("Version: %v\n", version.Version)
+}
+
+// interfaceDump shows an example of multi request with services.
+func interfaceDump(ch api.Channel) {
+	c := interfaces.NewService(ch)
+
+	ifaces, err := c.DumpSwInterface(context.Background(), &interfaces.SwInterfaceDump{})
+	if err != nil {
+		log.Fatalln("DumpSwInterface failed:", err)
+	}
+
+	fmt.Printf("Listing %d interfaces:\n", len(ifaces))
+	for _, d := range ifaces {
+		fmt.Printf("- interface: %s\n", bytes.Trim(d.InterfaceName, "\x00"))
+	}
+}
-- 
cgit 1.2.3-korg