# Cliparse (CLI with ArgumentParser)
 [](https://badge.fury.io/py/cliparse)
__Cliparse__ is a framework to make CLI with ['Argparse'](https://docs.python.org/3/howto/argparse.html) and ['Cmd'](https://docs.python.org/3/library/cmd.html)
[](https://asciinema.org/a/J83RPQHIb1mAUG3TGSaplqhy4)
## Concept
There are times when it is necessary that to provide a command line client like _MySQL Command Line Client_.
```bash
$ mysql -uroot -p
Type 'help;', or '\h' for help. Type '\C' to clean current input statement.
mysql> use test_db;
```
Some of legacy CLI framework we could have chosen are not easy to extend or written in low productivity languages. __Cliparse__ is written with some of the most used modules in Python.
`Cmd` is a very common module of python for making CLI application. It provides a prompt to gets command input from user, tab auto completion, help message or usage. Actually, It's already super easy enough to make CLI applications with `Cmd`.
`Argparse` is an argument parser in command line interface. It parses options and arguments. With some short options, we can check validations which several types of arguments such as string or integer and boolean.
```python
parser = ArgumentParser(
prog='',
description='description',
epilog='end of description', )
sub_parser = parser.add_subparsers(dest='sub_parser')
# Setting
# ==========================================================================
setting_parser = sub_parser.add_parser('setting', help='Setting Command')
# Setting - DB Initializing
# ==========================================================================
setting_init_db_parser = setting_parser.add_subparsers(
dest='init', help='Initialize the database')
init_db_parser = setting_init_db_parser.add_parser(
name='initialize-db', help='Initialize database')
init_db_parser.add_argument('-d', '--init-db', action='store_true',
help='initialize database.')
init_db_parser.add_argument('-m', '--dummy-members', action='store_true',
help='insert dummy members.')
init_db_parser.add_argument('-b', '--dummy-books', action='store_true',
help='insert dummy books.')
init_db_parser.add_argument('-r', '--dummy-rental', action='store_true',
help='insert dummy rental.')
init_db_parser.set_defaults(func=initialize_db)
```
These awesome modules are already used for a long time and easy to find its usage on web sites.
What __Cliparse__ does is to read user's argument parsers, to print the parser groups and parameters for running its function, and to make completing command line when tab. And print a result data of the function defined at the parser with some simple table viewer.
__Cliparse__ is very simple. That's all it does.
## Features
* All command line input validation checking by `Argparse`
* Easy command line input with tab auto completion
## Installation
```bash
$ pip install cliparse
```
or
```bash
$ python setup.py install
```
### Running
```bash
$ python -m cliparse ./sample_cli/cli.py
```
### Running with docker
If you use docker, you can try it like below.
#### Build
```bash
$ docker build -t cliparse:latest .
```
or
```bash
$ docker-compose build
```
#### Running
**the volume option for mounting host directory where the sample cli is.**
```bash
$ docker run -it -v $(pwd):/root --rm cliparse sample_cli/cli.py
```
or
```bash
$ docker-compose run -v $(pwd):/root --rm cliparse sample_cli/cli.py
```
### sample_cli/cli.py
This sample cli file is also able to run without __Cliparse__.
```bash
python sample_cli/cli.py -h
```
---
## Sample
There is a simple sample cli which is able to try basic CRUD. It is in the directory named `sample_cli/cli.py`. Please run command below and try to edit as you want.
### Things you can do
#### Help
Use help command to learn more about a command's usage.
```bash
# Help
(Cmd) help
Documented commands (type help <topic>):
========================================
help manager setting
```
```bash
(Cmd) manager -h
usage: manager [-h] {book} ...
positional arguments:
{book} Initialize the database
book setting command
optional arguments:
-h, --help show this help message and exit
```
```bash
(Cmd) manager book -h
usage: manager book [-h] [-r | -t] {insert,update,delete} ...
positional arguments:
{insert,update,delete}
optional arguments:
-h, --help show this help message and exit
-r, --raw-data show the data as raw
-t, --simple-table show the data with simple table
```
#### Tapping tab key
Use Tab key to autocomplete commands in the command line. It also shows a list of commands you can use.
#### Choosing presentation style
````bash
# show --raw-data
(Cmd) manager book --raw-data
[
{
"author": "John Doe",
"title": "How to learn speaking English",
"publisher": "Magic House"
},
{
"author": "George Orwell",
"title": "1984",
"publisher": "Motihari"
}
]
# show data with simple table
(Cmd) manager book --simple-table
| | author | title | publisher |
|----+---------------+-------------------------------+-------------|
| 0 | John Doe | How to learn speaking English | Magic House |
| 1 | George Orwell | 1984 | Motihari |
````
## Contributes
### Running as development mode
You don't need to build the docker image every time whenever source code changes.
```bash
docker-compose -f docker-compose.dev.yml run --rm cliparse
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ravenkyu/cliparse",
"name": "cliparse",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "cli,terminal,interpreter",
"author": "Duk Kyu Lim",
"author_email": "hong18s@gmail.com",
"download_url": "",
"platform": null,
"description": "# Cliparse (CLI with ArgumentParser)\n\n [](https://badge.fury.io/py/cliparse)\n\n__Cliparse__ is a framework to make CLI with ['Argparse'](https://docs.python.org/3/howto/argparse.html) and ['Cmd'](https://docs.python.org/3/library/cmd.html) \n\n[](https://asciinema.org/a/J83RPQHIb1mAUG3TGSaplqhy4)\n\n## Concept\nThere are times when it is necessary that to provide a command line client like _MySQL Command Line Client_.\n```bash\n$ mysql -uroot -p\n\nType 'help;', or '\\h' for help. Type '\\C' to clean current input statement.\n\nmysql> use test_db;\n```\nSome of legacy CLI framework we could have chosen are not easy to extend or written in low productivity languages. __Cliparse__ is written with some of the most used modules in Python. \n\n`Cmd` is a very common module of python for making CLI application. It provides a prompt to gets command input from user, tab auto completion, help message or usage. Actually, It's already super easy enough to make CLI applications with `Cmd`.\n\n`Argparse` is an argument parser in command line interface. It parses options and arguments. With some short options, we can check validations which several types of arguments such as string or integer and boolean.\n```python\nparser = ArgumentParser(\n prog='',\n description='description',\n epilog='end of description', )\n sub_parser = parser.add_subparsers(dest='sub_parser')\n\n # Setting\n # ==========================================================================\n setting_parser = sub_parser.add_parser('setting', help='Setting Command')\n\n # Setting - DB Initializing\n # ==========================================================================\n setting_init_db_parser = setting_parser.add_subparsers(\n dest='init', help='Initialize the database')\n\n init_db_parser = setting_init_db_parser.add_parser(\n name='initialize-db', help='Initialize database')\n init_db_parser.add_argument('-d', '--init-db', action='store_true',\n help='initialize database.')\n init_db_parser.add_argument('-m', '--dummy-members', action='store_true',\n help='insert dummy members.')\n init_db_parser.add_argument('-b', '--dummy-books', action='store_true',\n help='insert dummy books.')\n init_db_parser.add_argument('-r', '--dummy-rental', action='store_true',\n help='insert dummy rental.')\n init_db_parser.set_defaults(func=initialize_db)\n```\nThese awesome modules are already used for a long time and easy to find its usage on web sites.\n\nWhat __Cliparse__ does is to read user's argument parsers, to print the parser groups and parameters for running its function, and to make completing command line when tab. And print a result data of the function defined at the parser with some simple table viewer.\n\n__Cliparse__ is very simple. That's all it does.\n\n## Features\n* All command line input validation checking by `Argparse`\n* Easy command line input with tab auto completion\n\n## Installation \n```bash\n$ pip install cliparse\n```\nor\n```bash\n$ python setup.py install\n```\n\n### Running \n```bash\n$ python -m cliparse ./sample_cli/cli.py \n```\n\n### Running with docker\nIf you use docker, you can try it like below. \n#### Build\n```bash\n$ docker build -t cliparse:latest .\n``` \nor\n```bash\n$ docker-compose build\n```\n#### Running\n**the volume option for mounting host directory where the sample cli is.** \n```bash\n$ docker run -it -v $(pwd):/root --rm cliparse sample_cli/cli.py \n```\nor\n```bash\n$ docker-compose run -v $(pwd):/root --rm cliparse sample_cli/cli.py\n```\n\n### sample_cli/cli.py\nThis sample cli file is also able to run without __Cliparse__. \n```bash\npython sample_cli/cli.py -h\n```\n---\n## Sample\nThere is a simple sample cli which is able to try basic CRUD. It is in the directory named `sample_cli/cli.py`. Please run command below and try to edit as you want.\n### Things you can do\n#### Help\nUse help command to learn more about a command's usage. \n```bash\n# Help\n(Cmd) help\n\nDocumented commands (type help <topic>):\n========================================\nhelp manager setting\n```\n```bash\n(Cmd) manager -h\nusage: manager [-h] {book} ...\n\npositional arguments:\n {book} Initialize the database\n book setting command\n\noptional arguments:\n -h, --help show this help message and exit\n```\n```bash\n(Cmd) manager book -h\nusage: manager book [-h] [-r | -t] {insert,update,delete} ...\n\npositional arguments:\n {insert,update,delete}\n\noptional arguments:\n -h, --help show this help message and exit\n -r, --raw-data show the data as raw\n -t, --simple-table show the data with simple table\n```\n\n#### Tapping tab key \nUse Tab key to autocomplete commands in the command line. It also shows a list of commands you can use. \n#### Choosing presentation style \n````bash\n# show --raw-data\n(Cmd) manager book --raw-data\n[\n {\n \"author\": \"John Doe\",\n \"title\": \"How to learn speaking English\",\n \"publisher\": \"Magic House\"\n },\n {\n \"author\": \"George Orwell\",\n \"title\": \"1984\",\n \"publisher\": \"Motihari\"\n }\n]\n\n# show data with simple table\n(Cmd) manager book --simple-table\n| | author | title | publisher |\n|----+---------------+-------------------------------+-------------|\n| 0 | John Doe | How to learn speaking English | Magic House |\n| 1 | George Orwell | 1984 | Motihari |\n````\n\n## Contributes\n### Running as development mode\nYou don't need to build the docker image every time whenever source code changes. \n```bash\ndocker-compose -f docker-compose.dev.yml run --rm cliparse\n```\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "CLI Framework with Argparse",
"version": "1.1.0",
"split_keywords": [
"cli",
"terminal",
"interpreter"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "264fe638afd1eabb6103e2d8a54268c9d13a584dca3b1abf00f73f52280f2846",
"md5": "fc9050c820a359c4952588e9308a661c",
"sha256": "5c1cdc3c7b2d150d387f23b36ab94915d8fb1bf9c12a3587bec0b7819fc799ae"
},
"downloads": -1,
"filename": "cliparse-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fc9050c820a359c4952588e9308a661c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 7574,
"upload_time": "2023-04-28T06:40:59",
"upload_time_iso_8601": "2023-04-28T06:40:59.200503Z",
"url": "https://files.pythonhosted.org/packages/26/4f/e638afd1eabb6103e2d8a54268c9d13a584dca3b1abf00f73f52280f2846/cliparse-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-28 06:40:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "ravenkyu",
"github_project": "cliparse",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cliparse"
}
JSON
