Zen of Python
Явное лучше неявного. Когда у нас явно и конкретно указан тип данных — это хорошо и это соответствует дзену. Когда же нам приходится неявно домысливать, что тут, наверное, (наверное!) строка или int
— это плохо и это не соответствует дзену.
Простое лучше сложного. Подсказки типов это просто, во всяком случае точно проще, чем попытки описать тип данных в докстринге функции в том или ином формате.
Удобочитаемость важна. Опять же, обсудили выше в примере с юзером, в котором непонятно какая структура без явной типизации.
Должен быть один — и желательно всего один — способ это сделать. Это как раз механизм type hinting. Не надо описывать типы в докстрингах или в формате какого-то внешнего инструмента с птичьим языком. Есть родной механизм в языке программирования, который решает задачу описания типов данных.