集合类型提示的函数注释

在 Python 3 中，函数注释是指定类型的常用方法，特别是对于同类集合（例如，列出）。然而，用户寻求一种将集合类型合并到这些注释中的方法。

基于文档字符串的类型提示

最初，Python 开发人员依赖格式化文档字符串，例如 reStructuredText 或Sphinx，提供集合类型信息。这些方法得到了 IDE 的支持，但它们不像注释那样简洁或集成。

登场*

PEP 484（类型提示）和Python 3.5 引入了 typing 模块。此增强功能允许开发人员使用类型注释指定集合中的类型。

例如，字符串列表可以注释为：

from typing import List

def do_something(l: List[str]):
    for s in l:
        s  # str

此注释表示函数需要一个字符串列表，类型信息反映在 IDE 代码补全中。

Constraints

最初，不支持使用注释指定集合内的类型。然而，这个限制在 Python 3.5 中得到了解决。

结论

类型注释现在提供了一种全面且方便的方法来指定集合类型，增强类型检查和 IDE 代码完成为 Python 开发人员提供的设施。