集合類型提示的函數註釋

在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 開發人員提供的設施。