{"categories":[{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation"},{"label":"Code Generators","url":"https://skillfed.io/packages/category/software-development-code-generators"}],"enrichment":{"capability":"Generates Swagger/OpenAPI 2.0 specifications automatically from Django REST Framework APIs, with built-in UI viewers for swagger-ui and ReDoc.","skillfed_tags":["api-documentation","schema-generation","swagger-openapi"],"use_cases":["Auto-generate interactive API documentation for a Django REST Framework service without writing YAML or JSON by hand.","Expose Swagger UI and ReDoc viewers at standard endpoints for API consumers to explore and test endpoints.","Generate OpenAPI 2.0 specs for code generation tools to produce client libraries in other languages.","Validate generated schemas against the OpenAPI 2.0 spec to catch structural errors early in development.","Cache the schema view to avoid regenerating specs on every request in production."],"what_it_does":"drf-yasg is a code-first API documentation tool for Django REST Framework that introspects your DRF views and serializers to generate a Swagger/OpenAPI 2.0 specification. It bundles swagger-ui and ReDoc viewers, so you get interactive documentation endpoints out of the box\u2014no manual schema writing required. The generated specs can be served as JSON or YAML and are cacheable for performance.\n\nThe package handles nested serializers, response schemas, and model definitions compatible with code generation tools. It supports DRF's URLPathVersioning and NamespaceVersioning schemes. The documentation notes that OpenAPI 3.0 support is unlikely; for new projects targeting OpenAPI 3.0, the maintainers recommend drf-spectacular instead. Validation against the OpenAPI 2.0 spec is optional but can catch schema errors at generation time.","worth_installing":"Yes. drf-yasg is a mature, actively maintained tool for Django REST Framework projects that need Swagger/OpenAPI 2.0 documentation. Low install friction, no security issues, and permissive licensing make it a straightforward choice. The main caveat is that it targets OpenAPI 2.0, not 3.0; if you need OpenAPI 3.0 support, consider drf-spectacular instead. For existing DRF projects or new ones committed to OpenAPI 2.0, this is a reliable dependency."},"id":"drf-yasg","links":{"html":"https://skillfed.io/packages/drf-yasg","md":"https://skillfed.io/packages/drf-yasg.md","pypi":"https://pypi.org/project/drf-yasg/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-02-24","license_spdx":"BSD-3-Clause","license_treatment":"permissive","name":"drf-yasg","python_support":"supports_current","summary":"Automated generation of real Swagger/OpenAPI 2.0 schemas from Django Rest Framework code."},"popularity":{"monthly_downloads":3099552,"position":2755,"tier":"top_5000"},"security":{"n_vulnerabilities":0},"version":"1.21.15"}