FDK testkit initial commit

.gitignore

@@ -0,0 +1,17 @@
+# Created by .ignore support plugin (hsz.mobi)
+### Go template
+# Binaries for programs and plugins
+*.exe
+*.dll
+*.so
+*.dylib
+
+# Test binary, build with `go test -c`
+*.test
+
+# Output of the go coverage tool, specifically when used with LiteIDE
+*.out
+
+# Project-local glide cache, RE: https://github.com/Masterminds/glide/issues/736
+.glide/
+.idea

Dockerfile

@@ -0,0 +1,12 @@
+# build stage
+FROM golang:alpine AS build-env
+RUN apk --no-cache add build-base git bzr mercurial gcc
+ENV D=/go/src/github.com/fnproject/fdk-testkit
+ADD . $D
+RUN cd $D && go test -c -i  && cp fdk-testkit.test /tmp/
+
+# final stage
+FROM fnproject/dind
+WORKDIR /app
+COPY --from=build-env /tmp/fdk-testkit.test /app/fdk-testkit
+CMD ["./fdk-testkit"]

Gopkg.toml

@@ -0,0 +1,34 @@
+
+# Gopkg.toml example
+#
+# Refer to https://github.com/golang/dep/blob/master/docs/Gopkg.toml.md
+# for detailed Gopkg.toml documentation.
+#
+# required = ["github.com/user/thing/cmd/thing"]
+# ignored = ["github.com/user/project/pkgX", "bitbucket.org/user/project/pkgA/pkgY"]
+#
+# [[constraint]]
+#   name = "github.com/user/project"
+#   version = "1.0.0"
+#
+# [[constraint]]
+#   name = "github.com/user/project2"
+#   branch = "dev"
+#   source = "github.com/myfork/project2"
+#
+# [[override]]
+#  name = "github.com/x/y"
+#  version = "2.4.0"
+
+
+[[constraint]]
+  name = "github.com/fnproject/fn_go"
+  version = "0.2.1"
+
+[[constraint]]
+  branch = "master"
+  name = "github.com/go-openapi/runtime"
+
+[[constraint]]
+  branch = "master"
+  name = "github.com/go-openapi/strfmt"

Makefile

@@ -0,0 +1,8 @@
+# Just builds
+.PHONY: build test
+
+build:
+	go test -c -i
+
+test:
+	go test -v ./...

README.md

@@ -1,2 +1,71 @@
-# fdk-testkit
-Compatibility validation tests suite for programming language-specific Fn development kits (FDK)
+Testing FDK-based functions
+===========================
+
+Function development kit (FDK) as a piece of software that helps to write hot functions by encapsulating logic of processing incoming requests with respect to defined protocol (HTTP, JSON).
+Particular testing framework help developers to identify if any programming language-specific FDK compatible with Fn hot formats.
+
+
+Prerequisites
+-------------
+
+This testing framework allows to run FDK tests against live Fn service, to let tests know of where Fn service is hosted please set following environment variable:
+```bash
+    export FN_API_URL=http://fn.io:8080
+```
+
+Test suite requires general purpose programming language-specific FDK-based function image that must be developed specifically for this test suite, following environment variable must be set:
+```bash
+    export FDK_FUNCTION_IMAGE="..."
+```
+This environment variable should contain a reference to the particular docker image.
+
+
+Test suite details
+------------------
+
+Test suite contains following tests:
+
+1. `TestFDKFormatSmallBody`
+
+`TestFDKFormatSmallBody` test
+--------------------------
+
+FDK should support following formats:
+
+ - HTTP (subtest: `test-fdk-http-small-body`)
+ - JSON (subtest: `test-fdk-json-small-body`)
+
+Request input body:
+```json
+{
+  "name": "John"
+}
+```
+
+Response output body:
+```text
+Hello John
+```
+
+How to run tests?
+-----------------
+
+There are couple options: from source code, from release binary
+
+From source code:
+```bash
+    go test -v ./...
+```
+
+How to build test binary executable?
+------------------------------------
+
+Regular `go build` does not work with tests, so following command will create a binary executable for this particular test suite:
+```bash
+    go test -c -i
+```
+
+Sample FDK-based functions
+--------------------------
+
+As an example test suite supplied with general purpose test [function written with FDK Python](./functions/python).

apps_api.go

@@ -0,0 +1,109 @@
+package test
+
+import (
+	"context"
+	"strings"
+	"testing"
+	"time"
+
+	"github.com/fnproject/fn_go/client"
+	"github.com/fnproject/fn_go/client/apps"
+	"github.com/fnproject/fn_go/models"
+)
+
+func CheckAppResponseError(t *testing.T, e error) {
+	if e != nil {
+		switch err := e.(type) {
+		case *apps.DeleteAppsAppNotFound:
+			t.Errorf("Unexpected error occurred: %v Original Location: %s", err.Payload.Error.Message, MyCaller())
+			t.FailNow()
+		case *apps.DeleteAppsAppDefault:
+			t.Errorf("Unexpected error occurred: %v. Status code: %v Orig Location: %s", err.Payload.Error.Message, err.Code(), MyCaller())
+			t.FailNow()
+		case *apps.PostAppsDefault:
+			t.Errorf("Unexpected error occurred: %v. Status code: %v Orig Location: %s", err.Payload.Error.Message, err.Code(), MyCaller())
+			t.FailNow()
+		case *apps.GetAppsAppNotFound:
+			if !strings.Contains("App not found", err.Payload.Error.Message) {
+				t.Errorf("Unexpected error occurred: %v Original Location: %s", err.Payload.Error.Message, MyCaller())
+				t.FailNow()
+			}
+		case *apps.GetAppsAppDefault:
+			t.Errorf("Unexpected error occurred: %v. Status code: %v Orig Location: %s", err.Payload.Error.Message, err.Code(), MyCaller())
+			t.FailNow()
+		case *apps.PatchAppsAppDefault:
+			t.Errorf("Unexpected error occurred: %v. Status code: %v Orig Location: %s", err.Payload.Error.Message, err.Code(), MyCaller())
+			t.FailNow()
+		case *apps.PatchAppsAppNotFound:
+			t.Errorf("Unexpected error occurred: %v. Original Location: %s", err.Payload.Error.Message, MyCaller())
+			t.FailNow()
+		case *apps.PatchAppsAppBadRequest:
+			t.Errorf("Unexpected error occurred: %v. Original Location: %s", err.Payload.Error.Message, MyCaller())
+			t.FailNow()
+		default:
+			t.Errorf("Unable to determine type of error: %s Original Location: %s", err, MyCaller())
+			t.FailNow()
+		}
+	}
+}
+
+func CreateAppNoAssert(ctx context.Context, fnclient *client.Fn, appName string, config map[string]string) (*apps.PostAppsOK, error) {
+	cfg := &apps.PostAppsParams{
+		Body: &models.AppWrapper{
+			App: &models.App{
+				Config: config,
+				Name:   appName,
+			},
+		},
+		Context: ctx,
+	}
+	ok, err := fnclient.Apps.PostApps(cfg)
+	if err == nil {
+		approutesLock.Lock()
+		_, got := appsandroutes[appName]
+		if !got {
+			appsandroutes[appName] = []string{}
+		}
+		approutesLock.Unlock()
+	}
+	return ok, err
+}
+
+func CreateApp(t *testing.T, ctx context.Context, fnclient *client.Fn, appName string, config map[string]string) {
+	appPayload, err := CreateAppNoAssert(ctx, fnclient, appName, config)
+	CheckAppResponseError(t, err)
+	if !strings.Contains(appName, appPayload.Payload.App.Name) {
+		t.Errorf("App name mismatch.\nExpected: %v\nActual: %v",
+			appName, appPayload.Payload.App.Name)
+	}
+}
+
+func DeleteApp(t *testing.T, ctx context.Context, fnclient *client.Fn, appName string) {
+	cfg := &apps.DeleteAppsAppParams{
+		App:     appName,
+		Context: ctx,
+	}
+
+	_, err := fnclient.Apps.DeleteAppsApp(cfg)
+	CheckAppResponseError(t, err)
+}
+
+func GetApp(t *testing.T, ctx context.Context, fnclient *client.Fn, appName string) *models.App {
+	cfg := &apps.GetAppsAppParams{
+		App:     appName,
+		Context: ctx,
+	}
+
+	app, err := fnclient.Apps.GetAppsApp(cfg)
+	CheckAppResponseError(t, err)
+	return app.Payload.App
+}
+
+func DeleteAppNoT(ctx context.Context, fnclient *client.Fn, appName string) {
+	cfg := &apps.DeleteAppsAppParams{
+		App:     appName,
+		Context: ctx,
+	}
+	cfg.WithTimeout(time.Second * 60)
+	fnclient.Apps.DeleteAppsApp(cfg)
+}