cornsnake.util_pick

 1"""
 2Functions for randomly selecting text. The `pick_one_random` function chooses a random text from a list. The `pick_one_by_prompt` function prompts the user to pick a text from a list.
 3
 4[Documentation](http://docs.mrseanryan.cornsnake.s3-website-eu-west-1.amazonaws.com/cornsnake/util_pick.html)
 5"""
 6
 7import random
 8
 9
10def pick_one_random(texts: list[str]) -> str:
11    """
12    Function to pick a random text from a list.
13
14    Args:
15    texts (list): A list of texts to choose from.
16
17    Returns:
18    str: A randomly selected text from the list.
19    """
20    if not texts:
21        raise RuntimeError("Arg texts is empty")
22
23    return random.choice(texts)
24
25
26def pick_one_by_prompt(texts: list[str]) -> str:
27    """
28    Function to prompt the user to pick a text from a list.
29
30    Args:
31    texts (list): A list of texts to choose from.
32
33    Returns:
34    str: The text selected by the user.
35    """
36    if not texts:
37        raise RuntimeError("Arg texts is empty")
38
39    valid_selection = None
40    while not valid_selection:
41        print(texts)
42        selected = input("Please pick one >>")
43        if selected in texts:
44            valid_selection = selected
45    return valid_selection