Что такое аннотация типов Union в Python?

Union в Python (из модуля typing) указывает, что переменная или возвращаемое значение может иметь один из нескольких типов.

Например:

python

С версии Python 3.10 можно использовать оператор | для синтаксического сахара:

python

Union полезен для повышения читаемости кода, его поддержки статическими анализаторами типов (такими как MyPy) и информирования разработчиков о возможных типах данных. Он не предоставляет проверок типов во время выполнения, это задача статических анализаторов или явных проверок isinstance.