markdown-template icon indicating copy to clipboard operation
markdown-template copied to clipboard

[BUG] <description> Not compatible with the latest Async/generator's latest version

Open Ervishalpathak7 opened this issue 10 months ago • 6 comments

Describe the bug.

Title : The Latest version of markdown-template is not compatible with the asyn/generator's latest version

Description : We need to upgrade the package to support the latest version of the asyncapi/generator so that we can upgrade our package , because the html-template latest is not compatible with the older version

Expected behavior

New version should be comaptible with latest generator versions

Screenshots

Image

How to Reproduce

  1. I update the async-cli with the latest async/generator
  2. and then i try to generate a markdown template
  3. and then i got the error with the message Generator Error: This template is not compatible with the current version of the generator (2.6.0). This template is compatible with the following version range: >=1.15.0 <2.0.0.

🥦 Browser

None

👀 Have you checked for similar open issues?

  • [x] I checked and didn't find similar issue

🏢 Have you read the Contributing Guidelines?

Are you willing to work on this issue ?

None

Ervishalpathak7 avatar Mar 08 '25 07:03 Ervishalpathak7

Welcome to AsyncAPI. Thanks a lot for reporting your first issue. Please check out our contributors guide and the instructions about a basic recommended setup useful for opening a pull request.
Keep in mind there are also other channels you can use to interact with AsyncAPI community. For more details check out this issue.

github-actions[bot] avatar Mar 08 '25 07:03 github-actions[bot]

3.0 not support:

zzq@MacBook-Pro-2 Project_A1 % asyncapi generate fromTemplate docs/ws-api.yaml @asyncapi/[email protected] --use-new-generator --force-write -o docs/src/content/docs/wsa
Skipping submitting anonymous metrics due to the following error: AbortError: This operation was aborted
┌  AsyncAPI Generator
Generation in progress. Keep calm and wait a bit
Diagnostic err: Version "3.0.0" is not supported. Please use "2.6.0" (latest) version of the specification. in path [] starting L1 C0, ending L206 C25
Diagnostic err: Unknown schema format: "application/vnd.aai.asyncapi;version=3.0.0" in path ["components","messages","lightMeasured"] starting L118 C18, ending L128 C57
Diagnostic err: Unknown schema format: "application/vnd.aai.asyncapi;version=3.0.0" in path ["components","messages","turnOnOff"] starting L129 C14, ending L136 C53
Diagnostic err: Unknown schema format: "application/vnd.aai.asyncapi;version=3.0.0" in path ["components","messages","dimLight"] starting L137 C13, ending L144 C52
Diagnostic err: Cannot validate and parse given schema due to unknown schema format: "application/vnd.aai.asyncapi;version=3.0.0" in path ["components","schemas","lightMeasuredPayload"] starting L146 C25, ending L154 C45
Diagnostic err: Cannot validate and parse given schema due to unknown schema format: "application/vnd.aai.asyncapi;version=3.0.0" in path ["components","schemas","turnOnOffPayload"] starting L155 C21, ending L165 C45
Diagnostic err: Cannot validate and parse given schema due to unknown schema format: "application/vnd.aai.asyncapi;version=3.0.0" in path ["components","schemas","dimLightPayload"] starting L166 C20, ending L175 C45
Generation failed
Generator Error: Input is not a correct AsyncAPI document so it cannot be processed.

ziqiangai avatar Mar 10 '25 07:03 ziqiangai

@ziqiangai i think you have updated the generator , thats why this error is coming right ?

Ervishalpathak7 avatar Mar 10 '25 08:03 Ervishalpathak7

@Ervishalpathak7 I believe that's what he's eluding to. When you run the generator with the --use-new-generator flag it will not work with the markdown template. It probably should however because sooner or later the 'new generator' will simply become 'the generator' and this template will cease to work.

ctataryn avatar May 16 '25 20:05 ctataryn

This issue has been automatically marked as stale because it has not had recent activity :sleeping:

It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.

There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.

Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.

Thank you for your patience :heart:

github-actions[bot] avatar Sep 15 '25 00:09 github-actions[bot]

Running into the same issues as @ziqiangai. This also happened earlier with @asyncapi/[email protected], but using the --use-new-generator flag fixed that. However, for the markdown-template, the flag doesn't work. Is it possible to remediate this issue somehow else?

P.S. I didn't notice that the example from README.md contained the hardcoded version 1.2.1, which apparently doesn't support 3.0.0. I removed the version, and everything has worked: asyncapi generate fromTemplate <asyncapi.yaml> @asyncapi/markdown-template. Solved ✅

vimkin avatar Sep 29 '25 21:09 vimkin