sphinx-contrib / openapi

OpenAPI (fka Swagger) spec renderer for Sphinx.
https://sphinxcontrib-openapi.readthedocs.io
BSD 2-Clause "Simplified" License
111 stars 80 forks source link
extension hacktoberfest oas openapi openapi2 openapi3 python sphinx sphinx-extension swagger

===================== sphinxcontrib-openapi

sphinxcontrib-openapi is a Sphinx extension to generate APIs docs from OpenAPI (fka Swagger) spec. It depends on sphinxcontrib-httpdomain_ that provides an HTTP domain for describing RESTful HTTP APIs, so we don't need to reinvent the wheel.

.. code:: bash

$ python3 -m pip install sphinxcontrib-openapi

Usage

Pass sphinxcontrib-openapi to extensions list in Sphinx's conf.py

.. code:: python

extensions = [ ... 'sphinxcontrib.openapi', ]

and feel free to use the openapi directive to render OpenAPI specs

.. code:: restructuredtext

.. openapi:: path/to/openapi.yml

Links

.. _Sphinx: https://www.sphinx-doc.org/en/master/ .. _OpenAPI: https://github.com/OAI/OpenAPI-Specification .. _sphinxcontrib-httpdomain: https://sphinxcontrib-httpdomain.readthedocs.io/