WSD file is empty

[whyynoot]

[RobertoPrevato]

Hi @whyynoot
Can you please share an example swagger.json to reproduce the issue?

[whyynoot]

https://github.com/whyynoot/bmstuInformaticsTechnology/blob/master/docs/swagger.json

[whyynoot]

Hey! @adriangb

[adriangb]

Sorry, but I have no idea why you tagged me here. Care to explain?

[whyynoot]

Sorry, but I have no idea why you tagged me here. Care to explain?

Sorry, by mistake

[RobertoPrevato]

Finally, thanks to GH Copilot, I now have the time capacity to look into old issues like this one. The problem here is that the library always only supported OpenAPI v3 for generating output (it always only had a /mk/v3/ package and not a v2 namespace to support generating Swagger. The v2.py classes were included from the beginning but only to support describing specification files.

OpenAPI 3.0 has been out since 2017 and 3.1 since 2021. Swagger 2.0 is 8+ years old and officially superseded.

The real fix here is adding a clear error when Swagger 2.0 is detected costs ~5 lines and immediately unblocks users (they know why it failed and what to do).