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
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
.. _Sphinx: https://www.sphinx-doc.org/en/master/ .. _OpenAPI: https://github.com/OAI/OpenAPI-Specification .. _sphinxcontrib-httpdomain: https://sphinxcontrib-httpdomain.readthedocs.io/