Doctest：将 Python 函数调用的文档字符串拆分为多行

Question

我想知道是否有一种方法可以将函数调用拆分为多行以进行 doctest。例如，对于类似的东西

>>> result = some_func(some_param=1, another_param=4, a_third_param='super_long_string')

我试过了

>>> result = some_func(some_param=1, another_param=4, 
    ...     a_third_param='super_long_string')

>>> result = some_func(some_param=1, another_param=4, \
                       a_third_param='super_long_string')

或者

>>> result = some_func(#doctest: +NORMALIZE_WHITESPACE
             some_param=1, 
             another_param=4, 
             a_third_param='super_long_string')

但两者都行不通。有什么想法或提示吗？

编辑： 我正在通过nosetests -sv --with-doctest 运行文档测试

Answer 1

您的第二个示例非常接近对我有用的示例。在我放置一组省略号后，我添加了五个空格。

之所以我加五个空格，是因为第一个空格匹配提示符，其他四个匹配缩进级别。

这是一个使用 python 2.7 和您提供的函数对我有用的示例。

def some_func(some_param, another_param, a_third_param):
    """
    Does something at least some of the time.

    Examples
    --------

    >>> some_func(
    ...     some_param=1,
    ...     another_param=4,
    ...     a_third_param='super_long_string')
    'Worked'
    """
    return 'Worked'

if __name__ == "__main__":
    import doctest
    doctest.testmod()