Metadata-Version: 2.3
Name: click-prompt
Version: 0.6.3
Summary: click-prompt provides more beautiful interactive options for the Python click library
License: MIT
Author: Markus Grotz
Author-email: grotz@uw.edu
Requires-Python: >=3.6.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: click (>=8.0.4)
Requires-Dist: questionary (>=1.10.0,<2.0.0)
Project-URL: documentation, https://github.com/markusgrotz/click-prompt
Project-URL: homepage, https://github.com/markusgrotz/click-prompt
Project-URL: repository, https://github.com/markusgrotz/click-prompt
Project-URL: tracker, https://github.com/markusgrotz/click-prompt/issues
Description-Content-Type: text/markdown

# click-prompt 

[![Supported Python Versions](https://img.shields.io/pypi/pyversions/click-prompt)](https://pypi.org/project/click-prompt/) 
[![PyPI version](https://img.shields.io/pypi/v/click-prompt)](https://pypi.org/project/click-prompt/) 
[![License](https://img.shields.io/pypi/l/click-prompt)](./LICENSE.md)
[![Code style](https://img.shields.io/badge/code%20style-black-black)](https://black.readthedocs.io/en/stable/)
![PyPI - Downloads](https://img.shields.io/pypi/dm/click-prompt)



**click-prompt** is a Python library that enhances the functionality of the Click library by providing interactive prompts for user inputs. It features simple prompts to easily prompt users for a single/multi input from a list. It also allows for more advanced prompting such as path completion.
This library is inspired by a post on [stackoverflow.com](https://stackoverflow.com/questions/54311067/).
Contributions are welcome! Please send me an e-mail or create a pull request.


## Installation

To install `click-prompt`, use pip:

```bash
pip install click-prompt
```


## Usage

The library can be used with decorators:

```python
import click
from click_prompt import choice_option

@click.command()
@choice_option('--fruit', type=click.Choice(['Apples', 'Bananas', 'Grapefruits', 'Mangoes']))
def select_fruit(fruit: str):
    print(fruit)
```

## Example

For more examples see the file [example.py](./example.py).

![Example](./docs/example_cli.gif)


## Available Decorators

Here is a list of available decorators that can be used with the click library
instead of a `click.Option` decorator

 - `choice_option`: Select a single item out of a list. Use the parameter
   `multiple=True` to select multiple items out of a list
 - `confirm_option`: Yes/No confirmation
 - `filepath_option`: Select a file path with auto completion
 - `auto_complete_option`: Auto completion given a list
 - `input_text_option`: Input any text

for every `click.Option` there is also a `click.Argument` implementation


## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE.md) file for more information.

