Metadata-Version: 1.1
Name: click-shell
Version: 0.3
Summary: An extension to click that easily turns your click app into a shell utility
Home-page: https://github.com/clarkperkins/click-shell
Author: Clark Perkins
Author-email: r.clark.perkins@gmail.com
License: BSD
Description: click-shell
        ===========
        
        |TravisCI| |DocsStatus|
        
        click-shell is an extension to `click`_ that easily turns your click app into a shell utility.
        It is built on top of the built in python `cmd`_ module, with modifications to make it work
        with click.
        
        Usage
        -----
        
        Simply replace ``@click.group`` with ``@click_shell.shell`` on the root level command:
        
        
        .. code-block:: python
        
            from click_shell import shell
        
            # @click.group()  # no longer
            @shell(prompt='my-app > ', intro='Starting my app...')
            def my_app():
                pass
        
            @my_app.command()
            def the_command():
                print 'the_command is running'
        
            ...
        
        
        When run, you should expect an output like so:
        
        .. code-block:: bash
        
            $ python my_app.py
            Starting my app...
            my-app >
        
        
        .. note::
        
            It should be noted that this decorator **only** alters functionality if no arguments are
            passed on the command line.  If you try to run a command directly
            (like ``python my_app.py the_command`` in the above example), your app will function
            identically to how it did before.
        
        
        For more advanced usage, check out our docs at http://click-shell.readthedocs.org/
        
        .. _click: http://click.pocoo.org/
        .. _cmd: https://docs.python.org/2/library/cmd.html
        
        .. |TravisCI| image:: https://travis-ci.org/clarkperkins/click-shell.svg?branch=master
           :target: https://travis-ci.org/clarkperkins/click-shell
           :alt: Build status
        
        .. |DocsStatus| image:: https://readthedocs.org/projects/click-shell/badge/?version=latest
           :target: http://click-shell.readthedocs.org/en/latest/?badge=latest
           :alt: Documentation Status
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
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
