python-2.7 - 如何记录参数可以是任何类型

Question

我有一个向字典添加一组值的函数。这些值实际上可以是 JSON 可序列化的任何类型。我无法为该功能编写有效的文档。在整个程序中，我列出了所有参数以及类型、名称和描述，但是如果类型无关紧要，我应该写什么？我认为说类型是any或完全省略它会很奇怪。

我正在使用的当前文档看起来像这样，如果它有帮助的话

"""
Adds an entry into payload["updated_values"]

@param dict payload: Payload to be recorded
@param str name: Name of the field we are adding to the payload
@param ### old: # <-- Looking for what to add here  
@param ### new:
@return:
"""

标签： python-2.7documentation

Answer 1

您可以在以下位置使用它python 3：

from typing import Any

def foo(bar: Any):
    pass