python - 在实际代码中编写 python 单元测试

Question

有时我会编写一些小的实用程序函数并将它们打包为 python 包。
多么小？ 30 - 60 行 python。
我的问题是你认为在实际代码中编写测试不好吗？虐待？

我可以看到很大的好处，例如代码本身内部的使用示例，而无需在文件之间跳转(同样来自非常小的项目)。示例:

#!/usr/bin/env python
# Actual code
def increment(number, by=1):
    return number += by

# Tests
def test_increment_positive():
    assert increment(1) == 2

def test_increment_negative():
    assert increment(-5) == -4

def test_increment_zero():
    assert increment(0) == 1

总体思路取 self 使用的监控框架 riemann，在 riemann 中，您可以将测试文件与代码一起编写 link

Answer 1

你可以写doctests在您的文档中指明应如何使用您的函数:

def increment(number, by=1):
    """ Increments the given number by some other number
    >>> increment(3)
    4
    >>> increment(5,3)
    8
    """
    return number += by

来自文档:

• To check that a module’s docstrings are up-to-date by verifying that all interactive examples still work as documented.
• To perform regression testing by verifying that interactive examples from a test file or a test object work as expected.
• To write tutorial documentation for a package, liberally illustrated with input-output examples. Depending on whether the examples or the expository text are emphasized, this has the flavor of “literate testing” or “executable documentation”