如何在 Python 运行时从存根文件（.pyi）中获取类型注释？

Question

我想获取函数或类方法的注解。如果源代码中写了类型提示，那么我可以通过获取属性__annotations__来获取类型。

def hoge(n: int): ...
print(hoge.__annotations__)  # {'n': <class 'int'>}

但我不知道如何获取写入存根文件 (.pyi) 中的类型。

# .pyi
def fuga(n: int): ...

# .py
def fuga(n): ...
print(fuga.__annotations__)  # {}

有什么很酷的方法吗？

Answer 1

来自PEP-484：

存根文件是包含类型提示的文件，仅供类型检查器使用，而不是在运行时使用。存根文件有几个用例：

• 扩展模块
• 作者尚未添加类型提示的第三方模块
• 尚未为其编写类型提示的标准库模块
• 必须与 Python 2 和 3 兼容的模块
• 将注释用于其他目的的模块

不幸的是，没有办法获取注释，它们的解释方式由类型检查器自行决定。这样做的副作用是没有权威资源来验证您的类型提示是否正确。

最接近的是mypy。