Metadata-Version: 2.1
Name: auto-usage
Version: 0.1.0
Summary: A python tool for agenerating or auto-updating usage of python cli tools.
Home-page: https://github.com/zhangxianbing/auto-usage
Author: zhangxianbing
License: UNKNOWN
Description: <!-- START doctoc generated TOC please keep comment here to allow auto update -->
        <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
        
        - [Auto Usage](#auto-usage)
          - [Installation](#installation)
          - [How to use](#how-to-use)
          - [Usage](#usage)
            - [subcommand: quickstart](#subcommand-quickstart)
            - [subcommand: quickstart](#subcommand-quickstart-1)
        
        <!-- END doctoc generated TOC please keep comment here to allow auto update -->
        
        # Auto Usage
        
        A python tool for auto-generating or auto-updating usage of python cli tools.
        
        > Note: This project was created with [Cookiecutter](https://github.com/cookiecutter/cookiecutter) and the [`zhangxianbing/cookiecutter-pypackage`](https://github.com/zhangxianbing/cookiecutter-pypackage) project template.
        
        ## Installation
        
        ```bash
         # install
         git clone https://github.com/zhangxianbing/auto-usage
         cd auto-usage && pip install .
        
        # usage
         cd /path/to/project
         auto-usage
        ```
        
        ## How to use
        
        Auto-usage works for python cli tools based on [argparse](https://docs.python.org/3/library/argparse.html) or other scripts that support '--help' option for showing help message like the following [usage](#Usage).
        
        For auto-usage using pattern `usage: ` to search where the usage beginning, and using the `\ <command>` to search where the subcommands beginning, you must make sure your tool's usage following the pattern.
        
        As for project structure, you can refer to this project, or just created with [Cookiecutter](https://github.com/cookiecutter/cookiecutter) and the [`zhangxianbing/cookiecutter-pypackage`](https://github.com/zhangxianbing/cookiecutter-pypackage) project template.
        
        ## Usage
        
        ```
        usage: auto-usage [-h] <command> ...
        
        A python tool for auto-generating or auto-updating usage of python cli tools.
        
        optional arguments:
          -h, --help  show this help message and exit
        
        Commands:
          <command>
            quickstart
                      quickstart for auto-usage.
        
        ```
        
        ### subcommand: quickstart
        
        ```
        usage: auto-usage quickstart [-h]
        
        optional arguments:
          -h, --help  show this help message and exit
        
        ```
        
        ### subcommand: quickstart
        
        ```
        usage: auto-usage quickstart [-h]
        
        optional arguments:
          -h, --help  show this help message and exit
        
        ```
        
        > Note: This usage is auto-generated by [zhangxianbing/auto-usage](https://github.com/zhangxianbing/auto-usage).
        
Platform: UNKNOWN
Requires-Python: >=3.6
Description-Content-Type: text/markdown
