From 2442c92c1dea12ccc4f6390d346188d5d420e5f0 Mon Sep 17 00:00:00 2001 From: Laurent Broudoux Date: Mon, 10 Aug 2020 14:48:07 +0200 Subject: [PATCH 1/3] Add Mocking and Testing section for Microcks reference --- config.yaml | 2 ++ content/docs/tooling.md | 8 ++++++++ 2 files changed, 10 insertions(+) diff --git a/config.yaml b/config.yaml index 31f9c8aa549d..b3915ee773b7 100644 --- a/config.yaml +++ b/config.yaml @@ -76,6 +76,8 @@ params: url: /docs/tooling#docgens - title: DSL url: /docs/tooling#dsl + - title: Mocking & Testing + url: /docs/tooling#mocking - title: GitHub Actions url: /docs/tooling#ghactions - title: Validators diff --git a/content/docs/tooling.md b/content/docs/tooling.md index c0a8dbc6e4a3..6e0eef0ae4cc 100644 --- a/content/docs/tooling.md +++ b/content/docs/tooling.md @@ -63,6 +63,14 @@ Writing YAML by hand is no fun, and maybe you don't want a GUI, so use a Domain | :------------- | :------------- | :------------- | | [BOATS](https://www.npmjs.com/package/boats) | Compile your single AsyncAPI file from multiple components and with the help of the template engine Nunjucks plus a few extra helpers. Once compiled BOATS calls in [AsyncAPI Parser](https://github.com/asyncapi/parser-js) to validate. | JS | +# Mocking and Testing {#mocking} + +Tools that take specification documents as input, then publish fake messages to broker destinations for simulation purpose. May also check that publisher messages are compliant with schemas. + +| Link | Description | Language/Kind | +| :------------- | :------------- | :------------- | +| [Microcks](https://microcks.io) | Mocking and testing platform for API and microservices. Turn your AsyncAPI, OpenAPI contract examples or Postman collections into ready to use mocks. Use examples to simulate and validate received messages according schema elements. | Kubernetes-native, Self-hosted / SaaS, Open Source | + # GitHub Actions {#ghactions} The following is a list of [GitHub Actions](https://github.com/features/actions) that you can use in your workflows: From 1aeccd2ff42fc7a5030c64e81461895dbabfb3f9 Mon Sep 17 00:00:00 2001 From: Laurent Broudoux Date: Tue, 11 Aug 2020 09:34:48 +0200 Subject: [PATCH 2/3] Move section to follow alphabetical order --- config.yaml | 4 ++-- content/docs/tooling.md | 16 ++++++++-------- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/config.yaml b/config.yaml index b3915ee773b7..a0ff88f1bd66 100644 --- a/config.yaml +++ b/config.yaml @@ -76,12 +76,12 @@ params: url: /docs/tooling#docgens - title: DSL url: /docs/tooling#dsl - - title: Mocking & Testing - url: /docs/tooling#mocking - title: GitHub Actions url: /docs/tooling#ghactions - title: Validators url: /docs/tooling#validators + - title: Mocking & Testing + url: /docs/tooling#mocking - title: Blog url: /blog - title: Help diff --git a/content/docs/tooling.md b/content/docs/tooling.md index 6e0eef0ae4cc..5a84de6e696b 100644 --- a/content/docs/tooling.md +++ b/content/docs/tooling.md @@ -63,14 +63,6 @@ Writing YAML by hand is no fun, and maybe you don't want a GUI, so use a Domain | :------------- | :------------- | :------------- | | [BOATS](https://www.npmjs.com/package/boats) | Compile your single AsyncAPI file from multiple components and with the help of the template engine Nunjucks plus a few extra helpers. Once compiled BOATS calls in [AsyncAPI Parser](https://github.com/asyncapi/parser-js) to validate. | JS | -# Mocking and Testing {#mocking} - -Tools that take specification documents as input, then publish fake messages to broker destinations for simulation purpose. May also check that publisher messages are compliant with schemas. - -| Link | Description | Language/Kind | -| :------------- | :------------- | :------------- | -| [Microcks](https://microcks.io) | Mocking and testing platform for API and microservices. Turn your AsyncAPI, OpenAPI contract examples or Postman collections into ready to use mocks. Use examples to simulate and validate received messages according schema elements. | Kubernetes-native, Self-hosted / SaaS, Open Source | - # GitHub Actions {#ghactions} The following is a list of [GitHub Actions](https://github.com/features/actions) that you can use in your workflows: @@ -81,6 +73,14 @@ The following is a list of [GitHub Actions](https://github.com/features/actions) | [Generator for AsyncAPI documents](https://github.com/marketplace/actions/generator-for-asyncapi-documents) | This action generates whatever you want using your AsyncAPI document. It uses [AsyncAPI Generator](https://github.com/asyncapi/generator). | [API documentation on Bump](https://github.com/marketplace/actions/api-documentation-on-bump) | With this Github Action you can automatically generate your API reference (with changelog and diff) on [Bump](https://bump.sh) from any AsyncAPI file. +# Mocking and Testing {#mocking} + +Tools that take specification documents as input, then publish fake messages to broker destinations for simulation purpose. May also check that publisher messages are compliant with schemas. + +| Link | Description | Language/Kind | +| :------------- | :------------- | :------------- | +| [Microcks](https://microcks.io) | Mocking and testing platform for API and microservices. Turn your AsyncAPI, OpenAPI contract examples or Postman collections into ready to use mocks. Use examples to simulate and validate received messages according schema elements. | Kubernetes-native, Self-hosted / SaaS, Open Source | + # Validators {#validators} The following is a list of tools that validate AsyncAPI documents. From e0a7f58557ea4c5a04b9a03e1e928c264ecd4857 Mon Sep 17 00:00:00 2001 From: Laurent Broudoux Date: Tue, 11 Aug 2020 17:25:42 +0200 Subject: [PATCH 3/3] Fix alphabetical order in menu... --- config.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/config.yaml b/config.yaml index a0ff88f1bd66..7d7d5213c9ce 100644 --- a/config.yaml +++ b/config.yaml @@ -78,10 +78,10 @@ params: url: /docs/tooling#dsl - title: GitHub Actions url: /docs/tooling#ghactions - - title: Validators - url: /docs/tooling#validators - title: Mocking & Testing url: /docs/tooling#mocking + - title: Validators + url: /docs/tooling#validators - title: Blog url: /blog - title: Help