def average(values):
    """
    compute average value

    >>> print(average([20, 30, 10]))
    20.0

    >>>
    上面測試的語法>>> 後面需要空一格，否則測試縮進錯誤
    測試完如果文檔還需要寫其它註釋，則以>>>  結尾，否則這段註釋
    也會被當為上面測試的輸出結果，這樣明顯不是我們希望的輸出結果
    :param values:
    :return:
    """
    return sum
 
(values) / len(values)

# import doctest
# doctest.testmod()

"""
 直接導入上面模塊方式測試
 或者命令行測試
 python -m doctest exam.py
 exam.py為被測試的模塊
"""

python文檔測試