cli icon indicating copy to clipboard operation
cli copied to clipboard

CLI cannot generate fromTemplate when specification contains file path $refs

Open Laupetin opened this issue 2 years ago • 2 comments

Describe the bug

When trying to generate with the html-template the process will fail when the specification file uses a $ref element that points to another file.

It will just show the following message and exit (The error message itself unfortunately is not really helpful):

Generator Error: Input is not a correct AsyncAPI document so it cannot be processed.

After adding a bit of logging it seems to me that it fails to resolve the path and cannot load the referenced file.

How to Reproduce

Running the following command will fail:

asyncapi generate fromTemplate ./index.yaml @asyncapi/html-template

when used with the following specification files:

# index.yaml
asyncapi: 2.5.0
info:
  title: Example
  version: 0.1.0
channels:
  user/signedup:
    $ref: subfolder/user-signedup.yaml
# subfolder/user-signedup.yaml
subscribe:
  message:
    description: An event describing that a user just signed up.
    payload:
      type: object
      additionalProperties: false
      properties:
        fullName:
          type: string
        email:
          type: string
          format: email
        age:
          type: integer
          minimum: 18

Expected behavior

The cli manages to generate output using the html-template and the given specification.

Running the generator directly instead of the cli does in fact produce the expected result:

ag index.yaml @asyncapi/html-template

Laupetin avatar Dec 01 '23 09:12 Laupetin

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 Dec 01 '23 09:12 github-actions[bot]

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 Mar 31 '24 00:03 github-actions[bot]