openapi-generator

Does Django Rest Framework have third party apps to auto generate swagger.yaml file?

只谈情不闲聊 提交于 2019-12-11 01:23:35
问题 I have large amount of API endpoints written in django-rest-framework and it keeps increasing and updating. How can I create & maintain API documentation that should be up-to-date? My current version is Create swagger.yaml file and somehow auto generate everytime any endpoint changes. Then use this file as an input to readme.io, ReDoc or other alternatives to provide visualization to external folks. If you have an experience on this or any similar solution, please share I really appreciate it

Swagger Codegen (with maven plugin) for OpenAPI 3.0

最后都变了- 提交于 2019-12-04 02:53:08
问题 I want to use Swagger Codegen for OpenAPI 3.0 YAML file. And I see Swagger Codegen 3.0.0-rc0 is available. But when I try to use that I run into issues. Following are the details: My pom.xml file with swagger-codegen plugin: <plugin> <groupId>io.swagger</groupId> <artifactId>swagger-codegen-maven-plugin</artifactId> <version>3.0.0-rc0</version> <executions> <execution> <goals> <goal>generate</goal> </goals> <configuration> <inputSpec>${basedir}/src/main/resources/mySpec.yaml</inputSpec>

Swagger Codegen (with maven plugin) for OpenAPI 3.0

你说的曾经没有我的故事 提交于 2019-12-01 16:06:11
I want to use Swagger Codegen for OpenAPI 3.0 YAML file. And I see Swagger Codegen 3.0.0-rc0 is available. But when I try to use that I run into issues. Following are the details: My pom.xml file with swagger-codegen plugin: <plugin> <groupId>io.swagger</groupId> <artifactId>swagger-codegen-maven-plugin</artifactId> <version>3.0.0-rc0</version> <executions> <execution> <goals> <goal>generate</goal> </goals> <configuration> <inputSpec>${basedir}/src/main/resources/mySpec.yaml</inputSpec> <output>target/generated-sources</output> <language>spring</language> <generateApis>false</generateApis>