**kwargs 中具有多种类型的类型注释

Question

我正在尝试将 Python 的 type annotations 与抽象类一起使用。 我的__init__ 函数如下所示：

from abc import ABCMeta

class SomeClass(object, metaclass=ABCMeta):
    def __init__(self, *args, **kwargs):
        print("Initiating %s object.", self.__class__.__name__)

        self.username = kwargs['data']
        assert isinstance(self.username, str)

        is_premioum = kwargs.get('premioum', False)

        self.money_investmant = kwargs.get('investmant')
        if isinstance(self.money_investmant, str):
            self.money_investmant = float(self.money_investmant)

如您所见，kwargs 可以包含来自多种类型的参数 - float、bool 和 str。

现在，我正在尝试为函数编写类型注释，如下所示：

def __init__(self, *args, **kwargs: Union[bool, str, float]) -> None:

但是我的PyCharm IDE 提醒我：

除了类型 'Integral'，改为使用 'str'

还有：

在 bool | 中找不到引用“get”字符串 |浮动'

我做错了吗？

如果kwargs包含多种类型的参数，我应该如何编写类型注释？

Answer 1

请参阅 PyCharm 问题跟踪器上的 this bug 和 this bug。这显然是 PyCharm 检查器的问题； mypy（Python 的另一个类型检查器）在我执行类似代码时不会抱怨。

已经有一个解决方案，它显然是可用的in build 171.2014.23。在那之前，我认为Any 足以作为临时解决方法让检查员停止抱怨。

Answer 2

如果想要描述 kwargs 中预期的特定命名参数，可以改为传入定义必需和可选参数的 TypedDict。可选参数是 kwargs：

这允许一个人有未设置的（不是默认的）可选参数并且有类型提示。

如果它们的键具有无效的 python 变量名，这也很有用，因为除了非常一般的 **kwargs 值类型提示之外，TypedDict 是定义这些值的类型的唯一方法。

import typing
from abc import ABCMeta


class RequiredProps(typing.TypedDict):
    # all of these must be present
    data: str

class OptionalProps(typing.TypedDict, total=False):
    # these can be included or they can be omitted
    premium: bool
    investment: typing.Union[str, float]

class ReqAndOptional(RequiredProps, OptionalProps):
    pass

class SomeClass(object, metaclass=ABCMeta):
    def __init__(self, *args, kwargs: ReqAndOptional):
        print("Initiating %s object.", self.__class__.__name__)

        self.username = kwargs['data']
        assert isinstance(self.username, str)

        is_premium = kwargs.get('premium', False)
        assert isinstance(is_premium, bool)

        self.money_investment = kwargs.get('investment')
        assert isinstance(elf.money_investment, (str, float))
        if isinstance(self.money_investment, str):
            self.money_investment = float(self.money_investment)