Metadata-Version: 2.1
Name: aiocli
Version: 1.1.0
Summary: Simple and lightweight async console runner.
Home-page: https://github.com/ticdenis/python-aiocli
License: MIT
Keywords: asyncio,async,aio,cli,console
Author: ticdenis
Author-email: denisnavarroalcaide@outlook.es
Requires-Python: >=3.6,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Project-URL: Documentation, https://github.com/ticdenis/python-aiocli/blob/master/README.md
Project-URL: Repository, https://github.com/ticdenis/python-aiocli
Description-Content-Type: text/markdown

# Async cli client/commander framework

aiocli is a Python library for simple and lightweight async console runner.

Full compatibility with argparse module and highly inspired by aiohttp module.

## Installation

Use the package manager [pip](https://pip.pypa.io/en/stable/) to install aiocli.

```bash
pip install aiocli
```

## Usage

```python
# examples/commander.py
from aiocli import commander

async def handle(args: dict) -> int:
    print('Hello ' + args.get('name'))
    return 0

app = commander.Application()
app.add_commands([commander.command('greet:to', handle, [('--name', {'default': 'World!'})])])

if __name__ == '__main__':
    commander.run_app(app)
```

## Requirements

- Python >= 3.6

## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

## License
[MIT](https://github.com/ticdenis/python-aiocli/blob/master/LICENSE)

