Как узнать тип возвращаемого значения функции и типы аргументов? ⇐ Python

[Anonymous]

Хотя я знаком с концепцией утиной типизации в Python, иногда у меня возникают проблемы с типом аргументов функций или типом возвращаемого значения функции.

Теперь, если я написал функцию сам, я ДЕЙСТВИТЕЛЬНО знаю ее типы. Но что, если кто-то захочет использовать и вызывать мои функции, как он/она должен знать их типы?
Обычно я помещаю информацию о типе в строку документации функции (например: «...аргумент id должен быть целым числом...» и «...функция вернет (строку, [целое число) ]) кортеж.")

Но ищет ли информация в строке документации (и помещает ее туда, как программист) действительно так, как предполагалось? нужно сделать?

Изменить: Хотя большинство ответов, похоже, направлены на «да, документировать!» Я считаю, что это не всегда легко для «сложных» типов.
Например: как кратко описать в строке документации, что функция возвращает список кортежей, каждый из которых имеет форму (идентификатор_узла, имя_узла, время работы_минуты) и что эти элементы представляют собой строку, строку и целое число соответственно?

Документация по строке документации PEP не дает никаких указаний на этот счет.

Думаю, контраргументом будет то, что в этом случае следует использовать классы, но я считаю Python очень гибким, поскольку он позволяет передавать эти вещи с помощью списков и кортежей, то есть без классов.

Подробнее здесь: https://stackoverflow.com/questions/533 ... ment-types