Metadata-Version: 1.0
Name: declic
Version: 1.0.1
Summary: Declic (DEcorator-oriented CLI Creator) is a tiny Python 3 package for creating command line interfaces using decorators. It was inspired by the click package and is based on argparse
Home-page: https://github.com/Septaris/declic
Author: S. Lion
Author-email: sonny.lion@laposte.net
License: MIT
Description-Content-Type: text/x-rst
Description: Declic
        ======
        
        Declic (DEcorator-oriented CLI Creator) is a tiny Python 3 package for
        creating command line interfaces using decorators. It was inspired by
        the `click`_ package and is based on `argparse`_
        
        Installation
        ------------
        
        From PyPI:
        
        ::
        
           pip install declic
        
        or from Github:
        
        ::
        
           pip install git+https://github.com/Septaris/declic.git
        
        Usage
        -----
        
        Here is an example of Declic usage:
        
        .. code:: python
        
           from declic import group, argument, command
        
        
           @group(description='my description')
           @argument('--version', action='version', version='<the version>')
           @argument('--foo', type=int, default=1)
           def bar():
               print('bar')
        
           @bar.group(invokable=True)
           @argument('--toto', type=int, default=2)
           @argument('--tata', type=str, default='aaa')
           def sub_group(toto, tata):
               print(toto)
               print(tata)
        
           @sub_group.command(chain=True)
           def mop(toto, **kwargs):
               print(kwargs)
               print(toto)
        
           @bar.command()
           @argument('-x', type=int, default=1)
           @argument('y', type=float)
           def foo(x, y):
               print(x, y)
        
        
           if __name__ == '__main__':
               import sys
        
               bar(sys.argv[1:])
               # or bar()
        
        Running the cli:
        
        ::
        
           $ python my_file.py --help
        
           usage: bar [-h] [--foo FOO] [--version] {sub_group,foo} ...
        
           my description
        
           positional arguments:
             {sub_group,foo}
        
           optional arguments:
             -h, --help       show this help message and exit
             --foo FOO
             --version        show program's version number and exit
        
        .. _click: http://click.pocoo.org/6/
        .. _argparse: https://docs.python.org/3/library/argparse.html
Platform: UNKNOWN
