OAS 3 support? about swagger-merger HOT 5 CLOSED

This is a tool for merging swagger files and can be packaged into a local file.

Is it "unofficial support", but $ref tag follows official standards.
Should be noted that$ref#* is a non-standard tag, you can use it for yourself. 😄

The official features will become more and more powerful, this tool can be used as an extension.

from swagger-merger.

Thanks for the tool! BTW, is it possible to get an explanation of what #ref#* does? I looked at the examples but I still don't understand it.

from swagger-merger.

I added some usage explanations, welcome feedback.

from swagger-merger.

Does multi level support work to solve this issue? OAI/OpenAPI-Specification#417 (I'm also having some trouble understanding it)

So it allows us to do:

paths:
    $ref#pets: "/operations/pets.yaml"       # Multiple paths
    $ref#stores: "/operations/stores.yaml"     # Multiple paths
    $ref#users: "/operations/users.yaml"      # Multiple paths

instead of:

paths:
  /pets:
    $ref: "/operations/pets.yaml"       # Multiple paths
  /stores:
    $ref: "/operations/stores.yaml"     # Multiple paths
  /users:
    $ref: "/operations/users.yaml"      # Multiple paths

Is that correct?

from swagger-merger.

You can use swagger-merger to do this, but $ref#* is a non-standard tag, you should use it for yourself.

from swagger-merger.