I plan to write periodic updates about the AsyncAPI Spec and parsers every ~2 weeks (I hope you are ok with it).
Note This is not an official AsyncAPI update but a personal summary I volunteer to do.
What do I mean by AsyncAPI Spec ecosystem? As most of the work around the AsyncAPI Spec is not only related with https://github.com/asyncapi/spec, each update will include the most significant recent activity from the following repositories, which I consider them to be part of the same ecosystem:
This time, as an exception (it is the first one I do), I wanted to include updates from the whole month (30 Nov - 31 Dec 2021).
Feel free to ask me to include any other repository if you consider it makes sense. Also, in case you want to help me with these updates :)
Spec v2.3.0 work is progressing!
- Dale Lane and Lukasz Gornicki are leading this release. The overall progress is tracked here. They created the following PRs that represent the scaffolding of the release branches:
- Sergio Moya is championing Allow servers and channels to be defined inside components. The RFC is in
Stage 2 Draft(even though it mentions
Stage 0 Strawman), and most probably going to advance its stage to
Stage 3 Acceptedand be included in
2.3.0release. For this reason, PR’s are opened and targeting
- Michael Davis is championing Add Solace bindings to the list of supported bindings in the spec. The RFC is in
Stage 2 Draftand will probably advance its stage to
Stage 3 Acceptedand be included in the
2.3.0release, especially considering that the PR that had Solace binding got merged almost two months ago. The following PR got opened and targeting
- https://github.com/asyncapi/spec-json-schemas/pull/143 Once the previous is merged, ci scripts will generate a new release of @asyncapi/specs package. Then there will be one more PR coming on parser-js which will update that package to point to that new version.
Spec v3.0.0 work is slowly progressing!
As always, You can find some of the most critical progress on the AsyncAPI spec v3.0.0 release journal
- The Proposal to solve publish/subscribe confusion RFC is slowly being moved forward. Sergio Moya has taken the initiative to split this issue into smaller ones so they can be treated as independent RFCs. An example is the one already mentioned in the previous section: Allow servers and channels to be defined inside components. Some issues have been created so anyone else can also pick them anc champion them:
- Make channels field optional within an AsyncAPI file.
- Let channels be identified by an ID rather than their address.
However, we need more thoughts on how to handle the
kindproperty. Shall we drop that idea? Help is needed here.
- The Pros/Cons of implementing an Intent-driven API (as described in Parser-API) for the future Parser-JS version (the one that will adopt spec
v3.0.0changes) has been annotated in https://github.com/asyncapi/parser-js/issues/401. And your feedback is needed!
- Also, regarding the Parser-API repo, some new important issues have been opened by Jonas Lagoni:
You can find a list (grooming pending) of candidates to be included in
v3.0.0 at https://github.com/asyncapi/spec/milestone/18.
Spec also had some more activity
Jonas Lagoni baked a new example of spec use-case to be used as AsyncAPI doc reference from now on. Here the PR, which is already merged.
Khuda Dad fixed the
streetlights-kafka.ymlexample with change clientId type on kafka operation to schema.
Lukasz Gornicki also worked on
streetlights-kafka.ymlexample with extend example for kafka with x509 security, which is already reviewed and waiting for a last review and approval from the code owner Fran Méndez.
The list of contributors shown in the spec repository is now showing only spec contributors thanks to this PR by Lukasz Gornicki
The work on redefine the trait inheritance behavior has been retaken by Simon Heimler.
Should we have freeze period on release process?. Maciej Urbańczyk is opening that debate and looking for more opinions on it.
add security at the operation level by sekharbans is moving most probably to RFC
Stage 2 Draft.
docs(spec): fix the type and docs of Operation.message field by Vladimir Gorej is waiting for the last review so it can be merged.
Add Support for
messageIDdid a baby step.
- Sergio Moya has opened a few issues to guide people on the work that has to be done in :
We need a champion for this feature, so please consider passing by and dropping questions. I (Sergio Moya) am more than happy to help you :)
spec-json-schemas had some important activity
- To ease maintainability of AsyncAPI JSON Schemas, Jonas Lagoni has been doing a rework on them, mainly splitting all definitions into different files they can be bundled later to provide a unique file to use. The PR is available here, and it has been going through several iterations. Some people have already reviewed it. As always, eyes are welcome and needed, so I encourage you to go and take a look!
- On the other hand, Lukasz Gornicki opened the issue remove js and go package and probably move JSON schemas should stay alone in the repo.
The TL;DR is that it has been proposed to create separate repositories for each different language implementation (Node and Go at this time) of that package instead of using monorepo. All those repositories will have an up-to-date copy of the JSON Schema definitions (via GH Actions). Work would start after
v2.3.0release. A discussion about it can be found on the issue.
v1.13.1 is out + some important issues and updates!
- Two versions got released!
- feat: add stringify function by Maciej Urbańczyk. More info why need that can be found here.
- Dimitrios Dedoussis discovered that there are Misleading validation errors for Security Scheme Objects. It needs further investigation so help is wanted!
- Work on Improve error handling in parser by Maciej Urbańczyk has been retaken after few questions and suggestions dropped by David.
avro-schema-parser got a PR to fix a bug
fix: avro parser now handles record reuse in definitions by Jonathan is waiting for your review!
Commits by repo:
|# Commits||# Authors||# Repositories|
|Repository||Commits||Authors||Added Lines||Removed Lines||Avg. LInes/Commit||Avg. Files/Commit|
|# Issues||# Submitters||# Assignees||Median Time Open (Days)|
|Summary||URL||Open Date||Days Open|
|Let channels be identified by an ID rather than their address.||https://github.com/asyncapi/spec/issues/663||Dec 1, 2021 @ 12:39:41.000||29.04|
|Support of allOf, oneOf or anyOf at payload level||https://github.com/asyncapi/avro-schema-parser/issues/106||Dec 1, 2021 @ 17:16:54.000||28.77|
|Define how ||https://github.com/asyncapi/parser-api/issues/31||Dec 6, 2021 @ 15:58:21.000||23.86|
|Define how to handle derferencing||https://github.com/asyncapi/parser-api/issues/30||Dec 6, 2021 @ 15:51:33.000||23.86|
|Define how to handle schemaFormats||https://github.com/asyncapi/parser-api/issues/29||Dec 6, 2021 @ 15:49:57.000||23.86|
|Should we have freeze period on release process?||https://github.com/asyncapi/spec/issues/667||Dec 7, 2021 @ 13:57:33.000||22.98|
|Maybe make ||https://github.com/asyncapi/parser-js/issues/421||Dec 9, 2021 @ 15:25:01.000||20.88|
|Clarification on URL and it’s resolution rules||https://github.com/asyncapi/spec/issues/674||Dec 14, 2021 @ 10:05:37.000||16.14|
|Define how to handle unknown schema and message id’s||https://github.com/asyncapi/parser-api/issues/34||Dec 14, 2021 @ 09:28:38.000||16.13|
|Work on 2.3 release||https://github.com/asyncapi/spec/issues/675||Dec 14, 2021 @ 14:48:17.000||15.95|
|[New Doc 📑]: specify which version of npm is required to run ||https://github.com/asyncapi/parser-js/issues/427||Dec 15, 2021 @ 14:20:04.000||14.93|
|Misleading validation errors for Security Scheme Objects||https://github.com/asyncapi/parser-js/issues/428||Dec 15, 2021 @ 21:47:49.000||14.62|
|Clearly define how traits should be applied||https://github.com/asyncapi/parser-api/issues/36||Dec 17, 2021 @ 15:31:28.000||12.88|
|Clarify the intention of server URL||https://github.com/asyncapi/parser-api/issues/37||Dec 17, 2021 @ 15:40:26.000||12.87|
|Missing visualization of Avro schema with reference||https://github.com/asyncapi/avro-schema-parser/issues/113||Dec 22, 2021 @ 23:06:35.000||7.53|
|Avro parser does not store sub definitions||https://github.com/asyncapi/avro-schema-parser/issues/111||Dec 23, 2021 @ 22:56:07.000||6.53|
Pull Requests opened:
Pull Requests closed:
|# Pull Requests||# Submitters||# Repositories|
|Repository||Pull Requests||Submitters||Avg. Days Open|
Pull Requests Backlog
|Summary||URL||Open Date||Days Open|
|feat: allow servers and channels to be defined as components||https://github.com/asyncapi/spec/pull/665||Dec 2, 2021 @ 16:56:51.000||27.86|
|feat: allow servers and channels to be defined as components||https://github.com/asyncapi/spec-json-schemas/pull/133||Dec 2, 2021 @ 16:06:01.000||27.85|
|feat: add Solace bindings to the list of supported bindings in the spec.||https://github.com/asyncapi/spec/pull/666||Dec 6, 2021 @ 17:36:34.000||23.83|
|docs: extend example for kafka with x509 security||https://github.com/asyncapi/spec/pull/670||Dec 8, 2021 @ 11:48:58.000||22.07|
|fix: upgrade @asyncapi/specs||https://github.com/asyncapi/parser-js/pull/423||Dec 9, 2021 @ 16:37:56.000||20.83|
|feat: allow servers and channels to be fetched from components||https://github.com/asyncapi/parser-js/pull/430||Dec 16, 2021 @ 17:58:39.000||13.78|
|fix: avro parser now handles record reuse in definitions||https://github.com/asyncapi/avro-schema-parser/pull/112||Dec 24, 2021 @ 17:59:27.000||5.78|
|feat: release version 2.3.0||https://github.com/asyncapi/spec/pull/681||Dec 27, 2021 @ 11:12:35.000||3.1|
|feat: release for version 2.3.0 of the spec||https://github.com/asyncapi/spec-json-schemas/pull/142||Dec 27, 2021 @ 11:14:07.000||3.06|
|feat: release for version 2.3.0 of the spec||https://github.com/asyncapi/parser-js/pull/433||Dec 27, 2021 @ 12:04:32.000||3.02|
|feat: add Solace to the list of bindings.||https://github.com/asyncapi/spec-json-schemas/pull/143||Dec 28, 2021 @ 19:07:06.000||1.73|