🎉 SonarCloud, Parser improvements, hot discussions, and more

View this email in your browser SonarCloud We enabled SonarCloud for the most critical AsyncAPI tools that are reaching or already reached 1.0.0 release. Luckily this amazing software is available for free for open-source projects. 1.0.0 release is something serious, and we wanted to make sure that we have an automated way of checking the code quality and security. Now every pull request is validated for the following projects: Generator Parser and custom schema parsers for OpenAPI schema and RAML data types The quality of those projects is visible here. We additionally validate code with ESLint plugin from SonarCloud. With the Parser we went even one step further, and we now statically check the security of the code also with the ESLint security plugin. Looking at the quality of SonarCloud we will roll it out to the rest of the project under AsyncAPI GitHub organization. Project Status Update Recent releases in the JavaScript Parser, brought many new features to the parser: Server variables validation. Parser throws an error if you forgot to specify a Variable object for a variable used in the server URL like “url: api.streetlights.smartylighting.com:{port}” Channel parameters validation. Parser throws an error if you forgot to specify a Parameter object for a parameter used in the channel name like “event/{streetlightId}/lighting/measured” We added missing validation of the payload provided with the AsyncAPI schema format. In the past, when you provided a message payload information in Components object, it was correctly validated, but not if you provided this information directly under the channel Parser throws an error if OperationId is not duplicated across the whole AsyncAPI document. This is an essential property for code generation, and specification is precise that duplicates of this information are not allowed. Parser throws an error if you provided server security information in a wrong format and has a corresponding Security Schema object. For today, except for handling circular references issue we mentioned in our last update, there are no other serious tasks we want to solve before the 1.0.0 release. Keep your fingers crossed. The Highlight of Interesting Discussions There are some interesting discussions/topics where it would be great to hear your opinion: Add view property in the specification This proposal addresses the confusion around the semantics of Publish and Subscribe channel operations. At the moment, the specification should be used to describe how users can interact with an application. In other words, if the AsyncAPI document of the application says that it has a publish channel, it means that this application is subscribed to this channel, and application users can publish an event to this application by publishing an event to this channel. The proposal behind the view property is to enable you to decide if you want the specification to tell you how you can interact with an application, or how the application behaves. You could say that publish means that the application published events to the channel and not the other way around. Please have a look at the corresponding issue and share your opinion. Allow $schema property in the specification With $schema property you can specify a location of the JSON Schema file and most of the IDEs will make your life much easier by adding auto-completion and other super useful functionalities. In the issue we discuss how we could allow maybe not only $schema but maybe any property starting with $, and also we talk about the opportunity to measure the adoption of the specification. Please have a look at the corresponding issue and share your opinion. AsyncAPI Special Interest Group (SIG) open meeting The last meeting took place on Tuesday, 7th of July, 8AM UTC. Meeting notes and recording are available here. This is the recording for the AsyncAPI Special Interest Group (SIG) meeting #27. Watch Last SIG Meeting The next meeting is scheduled for next Tuesday, 21st of July, 4PM UTC. We work on the agenda for the next meeting here. At the moment, there is nothing in the agenda so you can sneak in your topic easily. We host the meeting on Zoom. Do not forget about future meetings and always have up to date invitations in your calendar by adding your email to this mailing list. Content from the community Event-Streaming: An Additional Architectural Style to Supplement API Design by James Higginbotham Read More How to mitigate unhappy paths with an event-driven architecture at scale by Paul Taylor Read More Understanding Event Driven Architecture by Craig Godden-Payne Read More If you want to promote your content in the Newsletter. Maybe you have some interesting blog posts you want to share with others. Join this mailing list and gain access to the document where we craft the next Newsletter and suggest your changes. Follow us GitHub Twitter LinkedIn YouTube WebSite Copyright © 2020 Fran Méndez, All rights reserved. Want to change how you receive these emails? You can update your preferences or unsubscribe from this list.