Metadata-Version: 1.1
Name: sphinxcontrib-openapi
Version: 0.3.2
Summary: OpenAPI (fka Swagger) spec renderer for Sphinx
Home-page: https://github.com/ikalnytskyi/sphinxcontrib-openapi
Author: Ihor Kalnytskyi
Author-email: ihor@kalnytskyi.com
License: BSD
Description-Content-Type: UNKNOWN
Description: =====================
        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
        
           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
        =====
        
        * Documentation: https://sphinxcontrib-openapi.readthedocs.org/
        * Source: https://github.com/ikalnytskyi/sphinxcontrib-openapi
        * Bugs: https://github.com/ikalnytskyi/sphinxcontrib-openapi/issues
        
        
        .. _Sphinx: https://sphinx.pocoo.org/
        .. _OpenAPI: https://openapis.org/specification
        .. _sphinxcontrib-httpdomain: https://pythonhosted.org/sphinxcontrib-httpdomain/
        
Keywords: sphinx openapi swagger rest api renderer docs
Platform: UNKNOWN
Classifier: Topic :: Documentation
Classifier: License :: OSI Approved :: BSD License
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
