validate_user_mstr#

pybear.base.validate_user_mstr(user_prompt, options, max_len=2)#

String validation for multiple alpha character user entry that screens by length of entry and allowed options. Not case sensitive.

Parameters:
user_promptstr

Text string displayed to the user at prompt.

optionsstr

A single text string containing the allowed characters.

max_lenint, default = 2

Maximum number of allowed selections.

Returns:
user_inputstr

Validated user selection(s).

Examples

>>> from pybear.input_validation import validate_user_mstr
>>> out = validate_user_mstr('Put something: ', 'pqrstuv', max_len=3)
Put something: rstu
>>> # prompts again because of invalid selection (too many selections)
Put something: rst
>>> out
RST