akari-bot/modules/ask/tools/random.py

import secrets
import uuid

from .utils import AkariTool, parse_input


async def random_number(max: int, min: int):
    random = secrets.randbelow(max - min + 1) + min
    return random


async def random_choice(input: list[str]):
    parsed = parse_input(input)
    return secrets.choice(parsed)


async def random_uuid():
    return uuid.uuid4()


random_number_tool = AkariTool.from_function(
    func=random_number,
    description='Generates a random number based on a max value and a min value.'
)

random_choice_tool = AkariTool.from_function(
    func=random_choice,
    description='Randomly chooses a input item.'
)

random_uuid_tool = AkariTool.from_function(
    func=random_uuid,
    description='Generates a random UUID.'
)