{"categories":[{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation"},{"label":"Sphinx","url":"https://skillfed.io/packages/category/documentation-sphinx"}],"enrichment":{"capability":"A Sphinx plugin that embeds interactive Swagger UI pages into documentation to render OpenAPI specifications with customizable configuration and optional local resource mirroring.","skillfed_tags":["api-documentation","openapi","sphinx-extension"],"use_cases":["Embed live API documentation in Sphinx-generated project docs alongside narrative guides","Render multiple OpenAPI specs on a single page with separate Swagger UI containers","Self-host API documentation by mirroring Swagger UI assets into your build output","Generate full-page Swagger UI views as part of your documentation site","Pass custom Swagger configuration options to control UI behavior and appearance"],"what_it_does":"This is a Sphinx extension that brings OpenAPI specification rendering into your documentation build. It acts as a bridge between Sphinx's documentation generation and Swagger UI, letting you embed interactive API explorers directly into your HTML docs. The plugin uses a simple directive to include OpenAPI YAML or JSON files, automatically copying them into your build output and rendering them with Swagger UI's interactive interface.\n\nThe plugin depends on Sphinx, Jinja2, docutils, PyYAML, and typing_extensions to handle template rendering, specification parsing, and documentation generation. It supports multiple specifications per page with unique IDs, optional full-page rendering modes, and custom Swagger configuration options. You can point to CDN-hosted Swagger assets or mirror them locally into your documentation tree for offline or self-hosted deployments.","worth_installing":"Yes. The plugin is actively maintained, has no known vulnerabilities, carries a permissive license, and installs with low friction. It directly solves the problem of embedding interactive API docs into Sphinx projects. Install it if you use Sphinx and need to include OpenAPI specifications in your documentation."},"id":"swagger-plugin-for-sphinx","links":{"html":"https://skillfed.io/packages/swagger-plugin-for-sphinx","md":"https://skillfed.io/packages/swagger-plugin-for-sphinx.md","pypi":"https://pypi.org/project/swagger-plugin-for-sphinx/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-06-01","license_spdx":"Apache-2.0","license_treatment":"permissive","name":"swagger-plugin-for-sphinx","python_support":"supports_current","summary":"Sphinx plugin which renders a OpenAPI specification with Swagger"},"popularity":{"monthly_downloads":3840196,"position":2483,"tier":"top_5000"},"security":{"n_vulnerabilities":0},"version":"7.2.1"}
