Я пробую аннотации типов Python с абстрактными базовыми классами для написания некоторых интерфейсов. Есть ли способ аннотировать возможные типы *args
и **kwargs
?
Например, как можно выразить, что разумными аргументами функции являются int
или два или два int
? type(args)
дает, Tuple
поэтому я предположил, чтобы аннотировать тип как Union[Tuple[int, int], Tuple[int]]
, но это не работает.
from typing import Union, Tuple
def foo(*args: Union[Tuple[int, int], Tuple[int]]):
try:
i, j = args
return i + j
except ValueError:
assert len(args) == 1
i = args[0]
return i
# ok
print(foo((1,)))
print(foo((1, 2)))
# mypy does not like this
print(foo(1))
print(foo(1, 2))
Сообщения об ошибках от mypy:
t.py: note: In function "foo":
t.py:6: error: Unsupported operand types for + ("tuple" and "Union[Tuple[int, int], Tuple[int]]")
t.py: note: At top level:
t.py:12: error: Argument 1 to "foo" has incompatible type "int"; expected "Union[Tuple[int, int], Tuple[int]]"
t.py:14: error: Argument 1 to "foo" has incompatible type "int"; expected "Union[Tuple[int, int], Tuple[int]]"
t.py:15: error: Argument 1 to "foo" has incompatible type "int"; expected "Union[Tuple[int, int], Tuple[int]]"
t.py:15: error: Argument 2 to "foo" has incompatible type "int"; expected "Union[Tuple[int, int], Tuple[int]]"
Имеет смысл, что mypy не нравится это для вызова функции, потому что он ожидает, что tuple
в вызове будет a . Добавление после распаковки также дает ошибку при печати, которую я не понимаю.
Как аннотировать разумные типы для *args
и **kwargs
?
источник
Optional
? Что-то изменилось в Python или ты передумал? Это все еще не является строго необходимым из-заNone
дефолта?Optional
аннотация при использованииNone
в качестве значения по умолчанию усложняла некоторые варианты использования, и теперь она удаляется из PEP.Optional
в будущем потребуется явное .Callable
не поддерживает какие - либо упоминания о типа намек на*args
или**kwargs
полной остановки . Эта конкретная проблема связана с разметкой вызываемых элементов, которые принимают конкретные аргументы плюс произвольное число других , и, таким образом, используют*args: Any, **kwargs: Any
очень специфическую подсказку типа для двух универсальных элементов. Для случаев, когда вы устанавливаете*args
и / или**kwargs
что-то более конкретное, вы можете использоватьProtocol
.Правильный способ сделать это с помощью
@overload
Обратите внимание, что вы не добавляете
@overload
и не вводите аннотации к фактической реализации, которая должна быть последней.Вам понадобится новая версия обоих
typing
и mypy, чтобы получить поддержку @overload вне заглушки .Вы также можете использовать это для изменения возвращаемого результата таким образом, чтобы было ясно, какие типы аргументов соответствуют какому возвращаемому типу. например:
источник
(type1)
против(type1, type1)
вызовов функций , как мой пример. Может быть,(type1)
vs(type2, type1)
был бы лучшим примером и показывает, почему мне нравится этот ответ. Это также позволяет разные типы возврата. Однако в особом случае, когда у вас есть только один возвращаемый тип и ваш*args
и*kwargs
все они одного типа, методика ответа Мартжина имеет больше смысла, поэтому оба ответа полезны.*args
там, где есть максимальное количество аргументов (2 здесь), все еще неправильно .*args
обязательно что-то не так? Если ожидаемые вызовы были(type1)
vs(type2, type1)
, то число аргументов является переменным, и нет подходящего значения по умолчанию для конечного аргумента. Почему так важно, чтобы был максимум?*args
действительно существует для нуля или более , неограниченных, однородных аргументов или для «передачи их нетронутым» всеобъемлющим. У вас есть один обязательный аргумент и один необязательный. Это совершенно другое и обычно обрабатывается, давая второму аргументу значение по умолчанию для дозорного, чтобы определить, что было опущено.*args
, еще лучший ответ на вопрос заключается в том, что это совсем не то, что следует делать.В качестве краткого дополнения к предыдущему ответу, если вы пытаетесь использовать mypy в файлах Python 2 и вам нужно использовать комментарии для добавления типов вместо аннотаций, вам необходимо добавить префиксы типов для
args
иkwargs
с*
и**
соответственно:Это рассматривается mypy как то же самое, что и в приведенной ниже версии Python 3.5
foo
:источник