Merged in feature/service-accounts-1 (pull request #227)

Support for service accounts with static credentials

* feature complete

* tests and docs

* lint fix

scripts/openapi-scripts.yml

@@ -5,6 +5,7 @@ version: "3"
 
 tasks:
   lint:
+    desc: "Lint every OpenAPI spec under serviceAPIs/ with vacuum"
     cmds:
       - |
         for file in serviceAPIs/*.yml serviceAPIs/*.yaml; do
@@ -14,31 +15,33 @@ tasks:
           fi
         done
   generate:
-    - |
-      generateGo() {
-        mkdir -p $2
-        oapi-codegen \
-          -generate $4 \
-          -config .openapi.yml \
-          -package $1 \
-          -o $2/api.gen.go \
-          $3
-      }
+    desc: "Generate Go server (./api) and client (./pkg) code from OpenAPI specs"
+    cmds:
+      - |
+        generateGo() {
+          mkdir -p $2
+          oapi-codegen \
+            -generate $4 \
+            -config .openapi.yml \
+            -package $1 \
+            -o $2/api.gen.go \
+            $3
+        }
 
-      # Below3 the gererateGo for ./pkg is the public client package
-      # and ./api is the internal server package
-      for file in serviceAPIs/*.yml serviceAPIs/*.yaml; do
-        if [[ -f "$file" ]]; then
-          service=$(basename "$file")
-          service=${service%.*}
-          service_lower=${service,,}
+        # Below3 the gererateGo for ./pkg is the public client package
+        # and ./api is the internal server package
+        for file in serviceAPIs/*.yml serviceAPIs/*.yaml; do
+          if [[ -f "$file" ]]; then
+            service=$(basename "$file")
+            service=${service%.*}
+            service_lower=${service,,}
 
-          # Client Code
-          generateGo $service_lower ./pkg/$service $file \
-            "models,client"
+            # Client Code
+            generateGo $service_lower ./pkg/$service $file \
+              "models,client"
 
-          # Server Code
-          generateGo $service_lower ./api/$service $file \
-            "models,embedded-spec,echo-server"
-        fi
-      done
+            # Server Code
+            generateGo $service_lower ./api/$service $file \
+              "models,embedded-spec,echo-server"
+          fi
+        done