Generate the SDK, implement v0.2.0

Add the generator tool which generates a large part of the SDK
surface from the JSON schemas defined in the spec repo.

Define a new test-only event which is used to run SDK unit tests
independent from the actual events defined in the spec.

Add a new, mostly generated, examples test. This test verifies
that the SDK can be used to generate the examples defined in the
spec repository, and excercises the code automatically generated
from the schemas.

Signed-off-by: Andrea Frittoli <andrea.frittoli@gmail.com>

.github/workflows/ci.yml

@@ -29,6 +29,8 @@ jobs:
       uses: golangci/golangci-lint-action@v3
       with:
         version: v1.52
+    - name: Check generated code
+      run: make generate
 
   test:
     runs-on: ubuntu-latest

Makefile

@@ -61,7 +61,10 @@ get-fmt-deps: ## Install test dependencies
 lint: ## Lint the code
 	./hack/gofmt.sh
 	./hack/linter.sh
+
+.PHONY: generate # Regenerate code
+generate:
 	./hack/generate.sh
 
 .PHONY: all
-all: fmt test lint
+all: fmt test lint generate

hack/generate.sh

@@ -13,7 +13,18 @@ fi
 
 echo "Running validation scripts..."
 
+function cleanupAndGenerate() {
+    find . -name 'zz_*' -exec rm {} +
+    go run tools/generator.go
+    GIT_STATUS=$(git status -s)
+    if [[ ! -z $GIT_STATUS ]]; then
+        echo -e "Changes detected:\n$GIT_STATUS"
+        return 1
+    fi
+}
+
 scripts=(
+    cleanupAndGenerate
 )
 fail=0
 for s in "${scripts[@]}"; do

pkg/api/bindings.go

@@ -105,12 +105,21 @@ func AsCloudEvent(event CDEventReader) (*cloudevents.Event, error) {
 	return &ce, err
 }
 
-// AsJsonString renders a CDEvent as a JSON string
-func AsJsonString(event CDEventReader) (string, error) {
+// AsJsonBytes renders a CDEvent as a JSON string
+func AsJsonBytes(event CDEventReader) ([]byte, error) {
 	if event == nil {
-		return "", nil
+		return nil, nil
 	}
 	jsonBytes, err := json.Marshal(event)
+	if err != nil {
+		return nil, err
+	}
+	return jsonBytes, nil
+}
+
+// AsJsonString renders a CDEvent as a JSON string
+func AsJsonString(event CDEventReader) (string, error) {
+	jsonBytes, err := AsJsonBytes(event)
 	if err != nil {
 		return "", err
 	}