標籤:包含 ror imp blog 輸出 support obj 互動式 自動
Python內建的“文檔測試”(doctest)模組可以直接提取注釋中的代碼並執行測試。
doctest嚴格按照Python互動式命令列的輸入和輸出來判斷測試結果是否正確。只有測試異常的時候,可以用‘‘‘表示中間一大段煩人的輸出.
class Dict(dict): ‘‘‘ Simple dict but also support access as x.y style. >>> d1 = Dict() >>> d1[‘x‘] = 100 >>> d1.x 100 >>> d1.y = 200 >>> d1[‘y‘] 200 >>> d2 = Dict(a=1, b=2, c=‘3‘) >>> d2.c ‘3‘ >>> d2[‘empty‘] Traceback (most recent call last): ... KeyError: ‘empty‘ >>> d2.empty Traceback (most recent call last): ... AttributeError: ‘Dict‘ object has no attribute ‘empty‘ ‘‘‘ def __init__(self, **kw): super(Dict, self).__init__(**kw) def __getattr__(self, key): try: return self[key] except KeyError: raise AttributeError(r"‘Dict‘ object has no attribute ‘%s‘" % key) def __setattr__(self, key, value): self[key] = valueif __name__==‘__main__‘: import doctest doctest.testmod()
模組正常匯入時,doctest不會被執行。只有在命令列運行時,才執行doctest。
doctest非常有用,不但可以用來測試,還可以直接作為範例程式碼。通過某些文檔產生工具,就可以自動把包含doctest的注釋提取出來。使用者看文檔的時候,同時也看到了doctest。
Python 文檔測試