{"categories":[{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation"}],"enrichment":{"capability":"Generates OpenAPI specification documents from Python code, supporting versions 2 and 3 of the OpenAPI standard with framework-agnostic design and built-in marshmallow integration.","skillfed_tags":["api-documentation","openapi","schema-generation"],"use_cases":["Generate interactive API documentation (Swagger UI, ReDoc) from Flask or other framework route definitions without manual YAML","Maintain OpenAPI specs that stay synchronized with marshmallow schema changes during development","Export API contracts for client code generation or third-party API integration testing","Publish machine-readable API definitions for API gateways, monitoring tools, or developer portals","Validate request/response schemas at runtime by embedding OpenAPI definitions in your application"],"what_it_does":"apispec is a code-driven OpenAPI specification generator that converts Python code into machine-readable API documentation. It works by introspecting your code\u2014particularly route handlers, schemas, and security definitions\u2014and synthesizing them into valid OpenAPI 2 or 3 documents that can be exported as JSON or YAML. The package is framework-agnostic at its core but ships with built-in support for marshmallow schema serialization, and integrates with web frameworks through optional plugins.\n\nTypical usage involves instantiating an APISpec object with your target OpenAPI version, registering plugins for your framework and schema library, then feeding it your application's routes and models. It parses docstring annotations (YAML-formatted operation metadata) and automatically generates schema definitions, security schemes, and endpoint documentation. This keeps your spec in sync with your code rather than maintaining separate documentation files.","worth_installing":"Yes. apispec is production-stable (Development Status 5), actively maintained, has no known vulnerabilities, and solves a real problem\u2014keeping API documentation synchronized with code. The single dependency and low install friction make it a safe addition. Install it if you need OpenAPI specs for a Python web service and want to avoid manual YAML maintenance."},"id":"apispec","links":{"html":"https://skillfed.io/packages/apispec","md":"https://skillfed.io/packages/apispec.md","pypi":"https://pypi.org/project/apispec/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-03-06","license_spdx":null,"license_treatment":"permissive","name":"apispec","python_support":"supports_current","summary":"A pluggable API specification generator. Currently supports the OpenAPI Specification (f.k.a. the Swagger specification)."},"popularity":{"monthly_downloads":15080134,"position":1199,"tier":"top_5000"},"security":{"n_vulnerabilities":0},"version":"6.10.0"}