Question: Should oas-resolver resolve internal $refs?

Resolver issue

• core functionality
• CLI options
• Docs updated
• New test cases (minimal for now)

I have a .yaml file that contains several internal $ref (and 0 external $ref). I expected that the output from oas-resolver would replace the $ref elements with the content that is targeted by the $ref. However, it seems to skip internal $ref and leave the original element unchanged. Example:

Original file:

....
paths:
  /v1/orders/:
    post:
      ....
      responses:
        '200':
          $ref: '#/components/schemas/Order'
....

Output from speccy resolve myfile.yaml

....
paths:
  /v1/orders/:
    post:
      ....
      responses:
        '200':
          $ref: '#/components/schemas/Order'
....

The Order schema does exist in the same file, and is valid. Is this correct behavior?

[MikeRalphson]

OK thanks, now I understand your use case. I don’t know when it would be implemented, but I’m not averse to the idea of having an option to do this.

[MikeRalphson]

Successfully published:

• oas-resolver@2.1.0
• oas-validator@3.1.0
• reftools@1.0.6
• swagger2openapi@5.1.0