generator VS github-action

The "most official" AsyncAPI generator linked from the AsyncAPI site will follow the references in the "allOf" structure to generate the subclasses of the Pet class. But it will ignore the "discriminator" logic and actually fail because it does know what to do with the "petType" attribute repeated in the derived types (e.g. StickInsect).

For that, the project provides a Javascript tool to generate source code from specification in numerous languages: Python, Java, Markdown, PHP, … and even Go! All you have to do is install the corresponding NPM packages and launch the right command tool.

AsyncAPI Generator

With the file created, we can now generate more friendly documentation. For this, we need to install generator or use it in its Docker version.

This can be improved and extended overtime, especially because of the way the generator is designed, enabling extensibility so we can have templates for many other languages that support more protocols, etc. For example, there is only a NATS generator for .NET Core... but perhaps in the future there could be more protocols supported for .NET Core and examples built for Azure 😃.

Continue improvements and add new features to core tools such as our spec parser/validator and code generator.

Let’s walk through the process of implementing an event-driven API using AsyncAPI, a specification for defining asynchronous APIs. We’ll also introduce Bump.sh, a tool for documenting and tracking event-driven APIs lifecycle/changes, and demonstrate how you can use it in conjunction with AsyncAPI files.

Bump.sh is a tool that's swiftly gaining popularity as it combines many of the best features from the previous five entries in this roundup.

With Bump, you can easily track changes within your API documentation, between different versions. We wanted to give a glimpse of the magic behind Bump, with a tool that could compare two versions of an API: API Diff.

Bump.sh 💙

👋 Fernando, We are providing an API documentation generation tool at Bump, based on the OpenAPI specification. Feel free to give it a look and reach out to me if you need, I'd be happy to help :).

If you use Github Actions to launch your automation workflows, we have some more good news for you: we now offer a stable bump-sh/github-action@v1 action. And this release includes automatic API contract changelog pushed as a comment for each pull request.