1. 在代碼中直接寫doctest測(cè)試用例。

測(cè)試用例使用“>>>”，應(yīng)輸出結(jié)果就直接換行，不使用“>>>”。如果測(cè)試結(jié)果和應(yīng)輸出結(jié)果相同，則通過測(cè)試。用例的位置一是模塊的開頭，或者是函數(shù)聲明語句的下一行（本文給的例子就這種情況）。其中注意下應(yīng)輸出的結(jié)果一定要嚴(yán)格匹配，比如“hello”和'hello'就是不同的輸出。

# doctest_practice.py
def add_two_positive_number(a,b):
    """
    >>> add_two_positive_number(2,3)
    5
    >>> add_two_positive_number(100,200)
    300
    """
    assert a > 0 and b> 0, "both needs to be positive"
    return a+b

add_two_positive_number(1,3)
#add_two_positive_number(-1,4) # AssertionError
# using python -o assert-and-testing.py will ignore all the assertion code!!

def double(values):
    """ double the values in a list

    >>> double([1,2,3,4])
    [2, 4, 6, 8]

    >>> double([])
    []

    >>> double(['a', 'b', 'c'])
    ['aa', 'bb', 'cc']

    >>> double([True, None])
    Traceback (most recent call last):
        ...
    TypeError: unsupported operand type(s) for *: 'int' and 'NoneType'
    """
    return [2 * element for element in values]

# doctest expect all str to have single str not double str
def say_hi():
    """
    >>> say_hi()
    'hi'
    """
    return "hi"


# Watch out for whitespace!
# (There's a trailing space on line 42)
def true_that():
    """
    >>> true_that()
    True
    """
    return True

# Order of keys in dicts matters in doctests
def make_dict(keys):
    """
    >>> make_dict(['a','b'])
    {'a': True, 'b': True}
    """
    return {key: True for key in keys}

測(cè)試時(shí)候直接用以下命令：

python3 -m doctest -v doctest_practice.py

測(cè)試結(jié)果由于是verbose所以會(huì)比較詳細(xì)：

Trying:
    add_two_positive_number(2,3)
Expecting:
    5
ok
Trying:
    add_two_positive_number(100,200)
Expecting:
    300
ok
Trying:
    double([1,2,3,4])
Expecting:
    [2, 4, 6, 8]
ok
Trying:
    double([])
Expecting:
    []
ok
Trying:
    double(['a', 'b', 'c'])
Expecting:
    ['aa', 'bb', 'cc']
ok
Trying:
    double([True, None])
Expecting:
    Traceback (most recent call last):
            ...
    TypeError: unsupported operand type(s) for *: 'int' and 'NoneType'
ok
Trying:
    make_dict(['a','b'])
Expecting:
    {'a': True, 'b': True}
ok
Trying:
    say_hi()
Expecting:
    'hi'
ok
Trying:
    true_that()
Expecting:
    True
ok
1 items had no tests:
    doctest_practice
5 items passed all tests:
   2 tests in doctest_practice.add_two_positive_number
   4 tests in doctest_practice.double
   1 tests in doctest_practice.make_dict
   1 tests in doctest_practice.say_hi
   1 tests in doctest_practice.true_that
9 tests in 6 items.
9 passed and 0 failed.
Test passed.

2. doctest測(cè)試用例單獨(dú)放在一個(gè)文件里面

我這里就把其中一個(gè)用例放在了doctest_practice_testfile.txt里面：

>>> from doctest_practice import double
>>> double([1,2,3,4])
[2, 4, 6, 8]

注意一下這個(gè)里面的from ... import... 也需要用“>>>”。測(cè)試的時(shí)候就直接輸入以下命令就好了：

python3 -m doctest -v doctest_practice_testfile.txt

測(cè)試執(zhí)行結(jié)果：

Trying:
    from doctest_practice import double
Expecting nothing
ok
Trying:
    double([1,2,3,4])
Expecting:
    [2, 4, 6, 8]
ok
1 items passed all tests:
   2 tests in doctest_practice_testfile.txt
2 tests in 1 items.
2 passed and 0 failed.
Test passed.