我在哪里可以找到像 set.symmetric_difference 這樣的內置類型方法的類型注釋？

Question

我知道 CPython 的內置函數是用 C 實現的。但我對內置類型的方法的類型提示或注釋感興趣。

例如，我想知道set.symmetric_difference_update()是如何注釋的。 但我找不到。

似乎內置函數也需要類似的類型提示才能讓 mypy 之類的程序正常工作。

Answer 1

您可以在此處找到set.symmetric_difference_update()注釋。

class set(MutableSet[_T], Generic[_T]):
    # ...
    def symmetric_difference_update(self, s: Iterable[_T]) -> None: ...

以下是typeshed存儲庫的readme.md文件的一些摘錄：

Typeshed包含 Python 標准庫和 Python 內置函數的外部類型注釋，以及由這些項目外部人員貢獻的第三方包。

該數據可用於例如靜態分析、類型檢查或類型推斷。 [...]

如果您只是使用 mypy（或 pytype 或 PyCharm），而不是開發它，則根本不需要與 typeshed 存儲庫交互：typeshed 的標准庫部分的副本與 mypy 捆綁在一起。