feat: cli client with spec schema validation

internal/spec/gateway/init.go

@@ -0,0 +1,17 @@
+package gateway
+
+import (
+	_ "embed"
+
+	"forge.cadoles.com/Cadoles/emissary/internal/spec"
+	"github.com/pkg/errors"
+)
+
+//go:embed schema.json
+var schema []byte
+
+func init() {
+	if err := spec.Register(NameGateway, schema); err != nil {
+		panic(errors.WithStack(err))
+	}
+}

internal/spec/gateway/schema.json

@@ -0,0 +1,29 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://gateway.emissary.cadoles.com/spec.json",
+    "title": "GatewaySpec",
+    "description": "Emissary 'Gateway' specification",
+    "type": "object",
+    "properties": {
+        "gateways": {
+            "type": "object",
+            "patternProperties": {
+                ".*": {
+                    "type": "object",
+                    "properties": {
+                        "address": {
+                            "type": "string"
+                        },
+                        "target": {
+                            "type": "string"
+                        }
+                    },
+                    "required": ["address", "target"],
+                    "additionalProperties": false
+                }
+            }
+        }
+    },
+    "required": ["gateways"],
+    "additionalProperties": false
+}

internal/spec/gateway/spec.go

@@ -0,0 +1,37 @@
+package gateway
+
+import "forge.cadoles.com/Cadoles/emissary/internal/spec"
+
+const NameGateway spec.Name = "gateway.emissary.cadoles.com"
+
+type ID string
+
+type Spec struct {
+	Revision int                 `json:"revision"`
+	Gateways map[ID]GatewayEntry `json:"gateways"`
+}
+
+type GatewayEntry struct {
+	Address string `json:"address"`
+	Target  string `json:"target"`
+}
+
+func (s *Spec) SpecName() spec.Name {
+	return NameGateway
+}
+
+func (s *Spec) SpecRevision() int {
+	return s.Revision
+}
+
+func (s *Spec) SpecData() any {
+	return struct {
+		Gateways map[ID]GatewayEntry
+	}{Gateways: s.Gateways}
+}
+
+func NewSpec() *Spec {
+	return &Spec{
+		Gateways: make(map[ID]GatewayEntry),
+	}
+}

internal/spec/gateway/testdata/spec-additional-prop.json

@@ -0,0 +1,13 @@
+{
+    "name": "gateway.emissary.cadoles.com",
+    "data": {
+      "gateways": {
+        "cadoles.com": {
+          "address": ":3003",
+          "target": "https://www.cadoles.com",
+          "foo": "bar"
+        }
+      }
+    },
+    "revision": 0
+}

internal/spec/gateway/testdata/spec-missing-prop.json

@@ -0,0 +1,11 @@
+{
+    "name": "gateway.emissary.cadoles.com",
+    "data": {
+      "gateways": {
+        "cadoles.com": {
+          "address": ":3003"
+        }
+      }
+    },
+    "revision": 0
+}

internal/spec/gateway/testdata/spec-ok.json

@@ -0,0 +1,12 @@
+{
+    "name": "gateway.emissary.cadoles.com",
+    "data": {
+      "gateways": {
+        "cadoles.com": {
+          "address": ":3003",
+          "target": "https://www.cadoles.com"
+        }
+      }
+    },
+    "revision": 0
+}

internal/spec/gateway/validator_test.go

@@ -0,0 +1,75 @@
+package gateway
+
+import (
+	"context"
+	"encoding/json"
+	"io/ioutil"
+	"testing"
+
+	"forge.cadoles.com/Cadoles/emissary/internal/spec"
+	"github.com/pkg/errors"
+)
+
+type validatorTestCase struct {
+	Name           string
+	Source         string
+	ExpectedResult bool
+}
+
+var validatorTestCases = []validatorTestCase{
+	{
+		Name:           "SpecOK",
+		Source:         "testdata/spec-ok.json",
+		ExpectedResult: true,
+	},
+	{
+		Name:           "SpecMissingProp",
+		Source:         "testdata/spec-missing-prop.json",
+		ExpectedResult: false,
+	},
+	{
+		Name:           "SpecAdditionalProp",
+		Source:         "testdata/spec-additional-prop.json",
+		ExpectedResult: false,
+	},
+}
+
+func TestValidator(t *testing.T) {
+	t.Parallel()
+
+	validator := spec.NewValidator()
+	if err := validator.Register(NameGateway, schema); err != nil {
+		t.Fatalf("+%v", errors.WithStack(err))
+	}
+
+	for _, tc := range validatorTestCases {
+		func(tc *validatorTestCase) {
+			t.Run(tc.Name, func(t *testing.T) {
+				t.Parallel()
+
+				rawSpec, err := ioutil.ReadFile(tc.Source)
+				if err != nil {
+					t.Fatalf("+%v", errors.WithStack(err))
+				}
+
+				var spec spec.RawSpec
+
+				if err := json.Unmarshal(rawSpec, &spec); err != nil {
+					t.Fatalf("+%v", errors.WithStack(err))
+				}
+
+				ctx := context.Background()
+
+				result, err := validator.Validate(ctx, &spec)
+
+				if e, g := tc.ExpectedResult, result; e != g {
+					t.Errorf("result: expected '%v', got '%v'", e, g)
+				}
+
+				if tc.ExpectedResult && err != nil {
+					t.Errorf("+%v", errors.WithStack(err))
+				}
+			})
+		}(&tc)
+	}
+}