Metadata-Version: 1.0
Name: taskr
Version: 0.0.4
Summary: Python Command Line Utility
Home-page: https://github.com/sodastsai/taskr
Author: sodastsai
Author-email: sodas2002@gmail.com
License: Apache License Version 2.0
Description: # Taskr
        
        ## Installation
        
        via pip:
        
        ```
        pip install taskr
        ```
        
        
        
        ## Usage - Task
        
        
        ### ```@task``` decorator
        
        Setup a task function like (Let's call it as "utils.py")
        
        ```
        from taskr import task
        
        @task
        def run(source, destination, speed=42):
            print('Run from {0} to {1} by speed={2}'.format(source, destination, speed))
           
        if __name__ == '__main__':
            task.dispatch()
        ```
        
        Then execute by
        
        ```
        $ python utils.py run Tokyo Yokohama
        ```
        
        And you'll get
        
        ```
        Run from Tokyo to Yokohama by speed=42
        ```
        
        To get help of utils.py
        
        ```
        $ python utils.py run -h
        usage: utils.py run [-h] [--speed SPEED] source destination
        
        positional arguments:
          source
          destination
        
        optional arguments:
          -h, --help     show this help message and exit
          --speed SPEED
        ```
        
        
        ### ```@task.set_name``` decorator
        
        By default, we make the name of the function as its action/task name.
        If you want to change the action name, you can use ```@task.set_name``` decorator like this
        
        ```
        @task
        @task.set_name('run_to')
        def run(source, destination, speed=42):
            print('Run from {0} to {1} by speed={2}'.format(source, destination, speed))
        ```
        
        And now execute by
        
        ```
        $ python utils.py run_to Tokyo Yokohama
        ```
        
        
        ### ```@task.set_argument``` decorator
        
        taskr uses ```argparse``` module of Python to parse argument passed in.
        By default, we map positional argument of task function into required positonal argument of argparser and
        optional argument of task function into optional argument of argparser.
        
        If you want to change this behavior or add help text, choice limitation, and etc when setup argparse,
        you can use ```@task.set_argument``` decorator and pass the same arguments you pass when using argparse.
        
        ```
        @task
        @task.set_argument('source', help='The source where you come from', choice=('Tokyo', 'Osaka'))
        @task.set_argument('--speed', '-s', help='The speed you wanna run', type=int)
        def run(source, destination, speed=42):
            print('Run from {0} to {1} by speed={2}'.format(source, destination, speed))
        ```
        
        And now you can only run from Tokyo or Osaka but cannot run from Kyoto
        Also you must run in an int value speed.
        
        Please note that the first argument of ```@task.set_argument``` must be the same as the argument name of function.
        For example, 'source' for source, '--speed' for speed, and '--buffer-length' for buffer_length if exists.
        Or taskr may register duplicate argument.
        
        
        
        ## Usage - Console
        
        The ```console``` helps you to print color message on console.
        
        ```
        console.color_str('Hello World', foreground=console.RED, background=console.WHITE, light=True)
        ```
        
        It gives you a str 'Hello World' with loght red color and white background.
        Also you can use ```console.info```, ```console.error```, ```console.success```, ```console.highlight```,
        and ```console.prompt``` to print messages
        
Platform: UNKNOWN
