go-oas3
drf-yasg
go-oas3 | drf-yasg | |
---|---|---|
1 | 8 | |
20 | 3,327 | |
- | - | |
4.8 | 1.5 | |
about 1 month ago | about 1 month ago | |
Go | Python | |
MIT License | GNU General Public License v3.0 or later |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
go-oas3
-
Open API v3 Server Generator
Hello, I have worked on an open API v3 server code generator, so please take a look at https://github.com/mikekonan/go-oas3. The idea is to force the developer to write spec first disallowing him to write code differently from the specification. I've been done that on several weekends so any help or participation is welcomed. Feel free to ask questions or made a PR.
drf-yasg
-
Swagger for Django api
I believe drf-yasg what you need. You can create a schema manually and define request and response types for your small API.
-
How can one enable the html for apis that are not apiviewsets using django rest framework?
Check this out: https://drf-yasg.readthedocs.io/en/stable/
-
Separate project vs multiple apps on a single project
There's also the caveat of having different API documentation for both the frontend solution and the API-only solution, since I don't want to expose the frontend-specific endpoints to the API-only endpoints, but I think that might just take some time playing around with swagger: https://drf-yasg.readthedocs.io/en/stable/
-
Deploying Django Rest Framework with Postgres on fly.io
Swagger and OpenAPI capabilities using drf-yasg, where you can only see endpoints and Swagger docs if you have a valid Token
- does anyone find a way to use swagger ui
-
Beautiful Hackernews UI: Working with Hackernews API in Python (Django)
The major apps are news and accounts. While the former handles almost all the physical functionalities of the system, the latter only does user stuff. The api app exposes the data for consumption. It is documented using drf-yasg, a Swagger generation tool implemented without using the schema generation provided by Django Rest Framework. The api has a token-based authentication which requires that all POST requests must provide a token to be accepted, otherwise a not too interesting response:
-
Keeping Documentation Debt At Bay & Clients Happy
Our RESTful API was actually the easiest to document, because we were able to rely on third-party libraries from the start. It was a Python Django and Django REST Framework project that leveraged the drf-yasg OpenAPI generator library to create OpenAPI and Swagger compatible documentation.
-
Documenting Django Rest Framework API
This post will go through how to document your DRF APIs using https://github.com/axnsan12/drf-yasg/ package.
What are some alternatives?
oapi-codegen - Generate Go client and server boilerplate from OpenAPI 3 specifications
drf-spectacular - Sane and flexible OpenAPI 3 schema generation for Django REST framework.
openapi-generator-go - An opinionated OpenAPI v3 code generator for Go. Use this to generate API models and router scaffolding.
Django REST Swagger - Swagger Documentation Generator for Django REST Framework: deprecated
swagger-ui - Swagger UI is a collection of HTML, JavaScript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API.
sideko - Generate SDKs and docs for your API
redoc - 📘 OpenAPI/Swagger-generated API Reference Documentation
swagger-petstore - swagger-codegen contains a template-driven engine to generate documentation, API clients and server stubs in different languages by parsing your OpenAPI / Swagger definition.
dj-rest-auth - Authentication for Django Rest Framework
apibrew - APIBrew is Low code software to automate building CRUDs from yaml files [Moved to: https://github.com/apibrew/apibrew]
drf-nested-routers - Nested Routers for Django Rest Framework