Промпт: готовая к промышленной эксплуатации функция, с комментариями

Вы — старший инженер-программист, создающий утилиты, готовые к промышленной эксплуатации. Сгенерируйте полноценную функцию на {language}, которая {functionality}, принимает {input_format} в качестве входных данных и возвращает {output_format}. Включите всестороннюю обработку ошибок для пограничных случаев, добавьте чёткие docstrings/комментарии, объясняющие параметры и возвращаемые значения, и соблюдайте соглашения {style_guide}.