Status update (week 17, 2019)

Fran Méndez

Fran Méndez

·3 min read

Alas güenas tardis! This week we've made significant progress on the documentation and the parser. The goal is to make AsyncAPI 2.0.0 easy and quick to learn at the same time we provide you the necessary tools to start playing with it. Check out the progress so far:

The parser

  1. Compile for all platforms: One of the hardest things to solve, before we continue moving forward, was the compilation process. We had to make sure we can compile the Go parser to C shared objects for Linux, Mac, and Windows. To make thing easier, we moved the compilation process to Travis CI, so now we don't have to configure our computers for cross-compilation.
  2. JSON Schema dereferencing: When we decided to choose Go as our main language for the parser development we knew there were less libraries than in the Node.js universe. One of the missing pieces was a JSON Schema dereferencer, i.e., a library that takes a JSON Schema document and replaces all the appearances of $ref with the value they point to. Rubén came up with an initial solution and he's now working on polishing it, extracting the code to a separate library so the Go community can benefit from it, and adding support for circular references.

The documentation

  1. New Getting Started guide: This week we just launched our new getting started guide for AsyncAPI 2.0.0. The guide targets new users of AsyncAPI and event-driven architectures. Also, if you're coming from OpenAPI (Swagger), don't miss the comparative chart.
  2. New blog: Enough with Medium. There's no point on hosting the blog on a service that puts very low limits on how much you can read for free. We'll keep posting there as a distribution channel but the full articles will live in our self-hosted blog, powered by Hugo.

Talks

Join us tomorrow for API days Madrid if you're in the city. I'll be talking all things AsyncAPI, past, present, and future. And also having some beers and tapas 🍻. Let's connect!

And last but not least, we’re running a sponsorship campaign. We’ve got different tiers so that everybody can show their love! ❤️

Donate here. Help Open Source projects.


“Victorious warriors win first and then go to war, while defeated warriors go to war first and then seek to win.” — Sun Tzu

See you next week, folks! 👋