X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=govpp.go;h=0ca020a3a91c62e5c0aadb0c197ed28fdfc54dae;hb=a4112fac7b86fe09650d2bb57969fe46404edd7d;hp=5d3ed7f10ccf2c3a77f2d2a2fbd2d4886b738ab5;hpb=87a66a4484dda9cb1b3552f133dc3d6e93539735;p=govpp.git

diff --git a/govpp.go b/govpp.go
index 5d3ed7f..0ca020a 100644
--- a/govpp.go
+++ b/govpp.go
@@ -15,23 +15,38 @@
 package govpp
 
 import (
+	"time"
+
 	"git.fd.io/govpp.git/adapter"
-	"git.fd.io/govpp.git/adapter/vppapiclient"
+	"git.fd.io/govpp.git/adapter/socketclient"
 	"git.fd.io/govpp.git/core"
+	"git.fd.io/govpp.git/internal/version"
 )
 
-var vppAdapter adapter.VppAdapter // VPP Adapter that will be used in the subsequent Connect calls
+// Connect connects to the VPP API using a new adapter instance created with NewVppAPIAdapter.
+//
+// This call blocks until VPP is connected, or an error occurs.
+// Only one connection attempt will be performed.
+func Connect(target string) (*core.Connection, error) {
+	return core.Connect(NewVppAdapter(target))
+}
+
+// AsyncConnect asynchronously connects to the VPP API using a new adapter instance
+// created with NewVppAPIAdapter.
+//
+// This call does not block until connection is established, it returns immediately.
+// The caller is supposed to watch the returned ConnectionState channel for connection events.
+// In case of disconnect, the library will asynchronously try to reconnect.
+func AsyncConnect(target string, attempts int, interval time.Duration) (*core.Connection, chan core.ConnectionEvent, error) {
+	return core.AsyncConnect(NewVppAdapter(target), attempts, interval)
+}
 
-// Connect connects the govpp core to VPP either using the default VPP Adapter, or using the adapter previously
-// set by SetAdapter (useful mostly just for unit/integration tests with mocked VPP adapter).
-func Connect() (*core.Connection, error) {
-	if vppAdapter == nil {
-		vppAdapter = vppapiclient.NewVppAdapter()
-	}
-	return core.Connect(vppAdapter)
+// NewVppAdapter returns new instance of VPP adapter for connecting to VPP API.
+var NewVppAdapter = func(target string) adapter.VppAPI {
+	return socketclient.NewVppClient(target)
 }
 
-// SetAdapter sets the adapter that will be used for connections to VPP in the subsequent `Connect` calls.
-func SetAdapter(ad adapter.VppAdapter) {
-	vppAdapter = ad
+// Version returns version of GoVPP.
+func Version() string {
+	return version.String()
 }