Metadata-Version: 2.1
Name: inputselect
Version: 0.8.7
Summary: A Python module for selecting options in the Python interactive terminal.
Author: ItchyPython3759
Description-Content-Type: text/markdown

INPUTSELECT

"inputselect" is a tool for selecting options on the Python command line.
"inputselect" works by only presenting the user with the options that the developer wants them to pick, and forces them to choose before moving on. 
It eliminates the hassle of trying to get the user to choose only from a set of specific options, and fixes the trouble with typos and repeat loops.

## API Reference

#### Allow the user to select options horizontally in the Python interactive terminal.

```http
inputselect.List(message: str = "", choices=None, separator: str = " ", spin_speed: int = 0, colors=DEF_COLORS, underline=False):
```

| Parameter  | Type          | Description                                                                                                                                  |
| :--------- | :------------ | :------------------------------------------------------------------------------------------------------------------------------------------- |
| message    | string        | **Not required**. The message that the user sees before the options are presented to them.                                                   |
| choices    | list or tuple | **Required**. The choices to be displayed on the terminal.                                                                                   |
| separator  | string        | **Not required**. The string that separates each option.                                                                                     |
| spin_speed | integer       | **Not required**. The speed at which the choices spin (spins the display forwards if x>0, backwards if x<0, and lets the user choose if x=0) |
| colors     | list or tuple | **Not required**. The respective colors of the text and bg of the option the user currently rests on (blue text and no bg by default)        |
| underline  | boolean       | **Not required**. Whether or not to underline of the option the user currently rests on (False by default)                                   |

#### Allow the user to select options in a sort of vertical slider in the Python interactive terminal.

```http
inputselect.Slider(message: str = "", choices=None, spin_speed: int = 0, colors=DEF_COLORS, wrap=True, underline=False):
```

| Parameter  | Type          | Description                                                                                                                                  |
| :--------- | :------------ | :------------------------------------------------------------------------------------------------------------------------------------------- |
| message    | string        | **Not required**. The message that the user sees before the options are presented to them.                                                   |
| choices    | list or tuple | **Required**. The choices to be displayed on the terminal.                                                                                   |
| spin_speed | integer       | **Not required**. The speed at which the choices spin (spins the display forwards if x>0, backwards if x<0, and lets the user choose if x=0) |
| colors     | list or tuple | **Not required**. The respective colors of the text and bg of the option the user currently rests on (blue text and no bg by default)        |
| wrap       | boolean       | **Not required**. Whether or not to give the slider a wrap-around feature                                                                    |
| underline  | boolean       | **Not required**. Whether or not to underline of the option the user currently rests on (False by default)                                   |

#### Allow the user to check and uncheck options in the Python interactive terminal.

```http
inputselect.Checkbox(message: str = "pick an animal: ", choices=None, separator: str = " ", min_choices=2, colors=DEF_COLORS, alt_colors=ALT_COLORS, underline=False):
```

| Parameter   | Type          | Description                                                                                                                                  |
| :---------- | :------------ | :------------------------------------------------------------------------------------------------------------------------------------------- |
| message     | string        | **Not required**. The message that the user sees before the options are presented to them.                                                   |
| choices     | list or tuple | **Required**. The choices to be displayed on the terminal.                                                                                   |
| separator   | string        | **Not required**. The string that separates each option.                                                                                     |
| min_choices | integer       | **Not required**. The minimum amount of choices for the user to pick before they can exit (by default it is set to 2)                        |
| max_choices | integer       | **Not required**. The maximum amount of choices for the user to pick before they can exit (by default it is set to 2)                        |
| colors      | list or tuple | **Not required**. The respective colors of the text and bg of the option the user currently rests on (blue text and no bg by default)        |
| alt_colors  | list or tuple | **Not required**. The respective colors of the text and bg of the option(s) the user has selected (yellow text and no bg by default)         |
| underline   | boolean       | **Not required**. Whether or not to underline of the option the user currently rests on (False by default)                                   |

## AUTHORS

- [@ItchyPython3759](https://pypi.org/user/ItchyPython3759/)
