add diffs wrt dev and deployed versions

Author: pcrespov

.gitignore

@@ -89,3 +89,8 @@ tmp*
 *ignore*
 !.dockerignore
 !.gitignore
+
+
+# api diffs
+api/openapi-*-diff.json
+api/openapi-dev.json

api/Makefile

@@ -0,0 +1,20 @@
+include ../scripts/common.Makefile
+
+
+.PHONY: openapi-diff-dev.json
+openapi-dev-diff.json: ## Diffs against newer openapi-dev.json and checks backwards compatibility
+	$(SCRIPTS_DIR)/openapi-diff.bash \
+	/specs/openapi.json \
+	/specs/openapi-dev.json \
+	--fail-on-incompatible \
+	--json=/specs/$@
+
+
+
+.PHONY: openapi-diff-dev.json
+openapi-deploy-diff.json: ## Diffs against newer openapi-dev.json and checks backwards compatibility
+	$(SCRIPTS_DIR)/openapi-diff.bash \
+	https://api.osparc.io/api/v0/openapi.json \
+	/specs/openapi.json \
+	--fail-on-incompatible \
+	--json=/specs/$@

scripts/openapi-diff.bash

@@ -0,0 +1,16 @@
+#!/bin/bash
+#
+#
+# - https://github.com/OpenAPITools/openapi-diff
+#
+# NOTE: do not forget that the target /specs
+
+exec docker run \
+  --interactive \
+  --rm \
+  --volume="/etc/group:/etc/group:ro" \
+  --volume="/etc/passwd:/etc/passwd:ro" \
+  --user="$(id --user "$USER")":"$(id --group "$USER")" \
+  --volume "$(pwd):/specs" \
+  openapitools/openapi-diff:latest \
+  "$@"