Metadata-Version: 1.1
Name: sphinx-click
Version: 2.5.0
Summary: Sphinx extension that automatically documents click applications
Home-page: https://github.com/stephenfin/sphinx-click
Author: Stephen Finucane
Author-email: stephen@that.guru
License: MIT License
Description: ============
        sphinx-click
        ============
        
        .. image:: https://travis-ci.org/click-contrib/sphinx-click.svg?branch=master
            :target: https://travis-ci.org/click-contrib/sphinx-click
            :alt: CI Status
        
        .. image:: https://readthedocs.org/projects/sphinx-click/badge/?version=latest
            :target: https://sphinx-click.readthedocs.io/en/latest/?badge=latest
            :alt: Documentation Status
        
        `sphinx-click` is a `Sphinx`__ plugin that allows you to automatically extract
        documentation from a `click-based`__ application and include it in your docs.
        
        __ http://www.sphinx-doc.org/
        __ http://click.pocoo.org/
        
        Installation
        ------------
        
        Install the plugin using `pip`:
        
        .. code-block:: shell
        
           $ pip install sphinx-click
        
        Alternatively, install from source by cloning this repo then running
        `setup.py`:
        
        .. code-block:: shell
        
           $ python setup.py install
        
        Usage
        -----
        
        .. important::
        
           To document a click-based application, both the application itself and any
           additional dependencies required by that application **must be installed**.
        
        Enable the plugin in your Sphinx `conf.py` file:
        
        .. code-block:: python
        
           extensions = ['sphinx_click']
        
        Once enabled, you can now use the plugin wherever necessary in the
        documentation.
        
        .. code-block::
        
           .. click:: module:parser
              :prog: hello-world
              :nested: full
        
        Detailed information on the various options available is provided in the
        `documentation <https://sphinx-click.readthedocs.io>`_.
        
        
Keywords: sphinx
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
