Merge branch 'feature/openapi' into develop

Author: codejsha

openapi/asyncapi-generator/README.md

@@ -0,0 +1,6 @@
+######################################################################
+
+### install
+
+### homebrew
+brew install asyncapi

openapi/asyncapi-generator/asyncapi-generator-commands.sh

@@ -0,0 +1,9 @@
+######################################################################
+
+oasdiff diff openapi-v0.yaml openapi-v1.yaml --strip-prefix-base /api --prefix-base /api/v1 --exclude-elements summary,description,endpoints --match-path notices/{id} -c
+oasdiff diff openapi-v0.yaml openapi-v1.yaml --strip-prefix-base /api --prefix-base /api/v1 --exclude-elements summary,description,endpoints --match-path notices/{id} -c
+
+oasdiff diff https://swagger.example.com/api/openapi.json https://swagger.example.com/api/openapi.json --strip-prefix-base /api --prefix-base /api/v1 --exclude-elements summary,description,endpoints,examples --composed --match-path notices
+
+openapi-generator-cli generate -i https://swagger.example.com/api/openapi.json -g openapi -o ./output --skip-validate-spec
+oasdiff diff output/openapi.json https://swagger.example.com/api/openapi.yaml --exclude-elements summary,description,endpoints,examples --strip-prefix-base /api --prefix-base /api/v1 --match-path notices | yq .paths

openapi/asyncapi/README.md

@@ -1,5 +1,15 @@
 ######################################################################
 
+### install
+
+### install openapi generator cli
+brew install openapi-generator
+
+### install swagger codegen
+brew install swagger-codegen
+
+######################################################################
+
 openapi-generator generate -i petstore.yaml -o petstore -g go-echo-server
 
 openapi-generator generate -i openapi.yaml -o sample -g typescript-fetch

openapi/oasdiff/oasdiff-commands.sh

@@ -1,5 +1,15 @@
 ######################################################################
 
+### install
+
+### homebrew
+brew install --cask postman
+
+### chocolatey
+choco install -y postman
+
+######################################################################
+
 ### Converting Postman collections from v1 to v2
 
 ### Install the Postman Collection Transformer

openapi/openapi-generator/README.md

@@ -1,9 +1,3 @@
 # Stoplight Prism
 
 Prism is a API mocking and contract testing tool. It supports mock servers and validation proxy from OpenAPI specification.
-
-## Install Prism
-
-```sh
-npm install -g @stoplight/prism-cli
-```

openapi/openapi-generator/openapi-generator-commands.sh

@@ -1,3 +1,8 @@
 ######################################################################
 
+### install
+npm install -g @stoplight/prism-cli
+
+######################################################################
+
 npx prism mock -d petstore3.json