Swagger client generators with multiple yaml files containing references

[steffes]

Swagger client generators like NSwag and NSwagStudio expect one yaml or json file. What is the best way to create one yaml or json file from the existing yaml files in docs/swagger that have references to separate yaml files like common.yaml?

Is there functionality in a different swagger client generator that NSwag might be missing that can take all the references found in a yaml file and create a combined swagger file with no references?

Would trying to create a single client file be a bad idea because of how the separate HumHub swagger files are organized?

[steffes]

Is there functionality in a different swagger client generator that NSwag might be missing that can take all the references found in a yaml file and create a combined swagger file with no references?

npm install swagger-cli -g

swagger-cli bundle --dereference activity.yaml --outfile activity.json