Generating openAPI spec

Generating an openAPI spec is the only majour feature missing from this project for me. It would enable integration with many 3rd party tools, not least the ability to have swagger documentation generated