* args和** kwargs的类型注释

Question

我正在尝试使用具有抽象基类的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？

Answer 1

对于可变位置参数（*args）和可变关键字参数（**kw），您只需为 一个 这样的参数指定期望值。

在“ 类型提示” PEP的“ 任意参数列表”和“默认参数值”
部分
中： __

任意参数列表也可以类型注释，以便定义：

def foo(*args: str, **kwds: int): ...

是可以接受的，这意味着，例如，以下所有内容均代表具有有效参数类型的函数调用：

foo('a', 'b', 'c')
foo(x=1, y=2)
foo('', z=0)

因此，您需要像这样指定您的方法：

def foo(*args: int):

但是，如果您的函数只能接受一个或两个整数值，则完全不应使用*args，请使用一个显式的位置参数和第二个关键字参数：

def foo(first: int, second: Optional[int] = None):

现在，您的函数实际上仅限于一个或两个参数，并且如果指定，则两个参数都必须为整数。*args 始终
表示0或更大，并且不能由类型提示限制为更特定的范围。