作者：廖飛

全文約 7778 字，讀完可能需要 15 分鐘。

原文鏈接：http://www.cnblogs.com/liaofeifight/

一、為什么使用 nose ?

1. 編寫(xiě)測(cè)試更容易。

   nose 可以自動(dòng)識(shí)別繼承于 unittest.TestCase 的測(cè)試單元，并執(zhí)行測(cè)試，而且， nose 也可以測(cè)試非繼承于 unittest.TestCase 的測(cè)試單元。 nose 提供了豐富的 API 便于編寫(xiě)測(cè)試代碼。

   
   

2. 執(zhí)行測(cè)試更容易。

   只要遵循一些簡(jiǎn)單的規(guī)則去組織你的類(lèi)庫(kù)和測(cè)試代碼， nose 是可以自動(dòng)識(shí)別單元測(cè)試的。執(zhí)行測(cè)試是非常耗資源的，但是，一段第一個(gè)測(cè)試模塊被加載后， nose 就開(kāi)始執(zhí)行測(cè)試。

   
   

3. 建立測(cè)試環(huán)境更容易。

4. 做你想做的事情更容易。

   
   

   nose 擁有很多內(nèi)置的插件幫助進(jìn)行輸出抓取、錯(cuò)誤查找、代碼覆蓋、文檔測(cè)試（ doctest ）等等。同樣，如果你不喜歡這些內(nèi)置插件提供的功能或者這些插件不能滿足你的項(xiàng)目結(jié)構(gòu)，你可以自定義開(kāi)發(fā)插件來(lái)完成你想要做的事情。

二、基本使用

安裝： pip install ?nose

腳本命令：

nosetests [options] ?[( optional) test files ?or directories]

除了使用命令行這種方式之外，還可以在根目錄下放置配置文件，配置文件的類(lèi)型為 .noserc 或 nose.cfg 文件。配置文件都是標(biāo)準(zhǔn)的 ini 內(nèi)容格式。例如：

三、擴(kuò)展使用

nose 自動(dòng)收集單元測(cè)試，收集它當(dāng)前工作目錄下的源代碼文件、目錄以及包。任何的源代碼文件、目錄或者包只要匹配正則表達(dá)式，他們就會(huì)被自動(dòng)收集。包的測(cè)試收集按照樹(shù)的層級(jí)級(jí)別一級(jí)一級(jí)進(jìn)行，因此 package.tests 、 package.sub.tests 、 package.sub.sub2.tests 將會(huì)被收集。

匹配成功的包、任何 python 的源文件都會(huì)當(dāng)做測(cè)試用例。

3.1 選擇測(cè)試用例

將需要測(cè)試的名稱傳遞給 nose 的命令行。格式如下：

nosetests only_test_this.py

測(cè)試的名稱可以是腳本文件的名稱或者模塊的名稱，也可以使用 colon 表達(dá)式表達(dá)的測(cè)試名稱。路徑可以是相對(duì)的路徑也可以是絕對(duì)的路徑。如下所示：

同樣可以使用—— w 開(kāi)關(guān)來(lái)切換當(dāng)前的工作路徑，從而改變 nose 查找測(cè)試用例的根路徑。用法如下：

nosetests -w /path/to/tests

更多關(guān)于自定義測(cè)試用例的收集與加載方式，可以使用插件的方式做到。

3.2 配置

除了3.1通過(guò)腳本命令傳遞參數(shù)的方式外，你還可以在根目錄下通過(guò)設(shè)置 setup.cfg 或者 .noserc 或者 nose.cfg 等配置文件達(dá)到同樣的目的。例如：

所有查找到的配置文件將會(huì)被加載，而且配置項(xiàng)的值會(huì)合并。如果想覆蓋標(biāo)準(zhǔn)的配置文件，使用—— c 選項(xiàng)。

3.3 使用插件

使用 pip 安裝所需要的插件，然后通過(guò) nosetests 命令行配置插件。執(zhí)行如下命令驗(yàn)證所安裝的插件:

nosetests - plugins

在命令行中添加 -v 或者 -vv 選項(xiàng)可以顯示每一個(gè)插件的更多信息。?如果通過(guò) nose.main() 或者 nose.run() 執(zhí)行測(cè)試，可以將要使用的插件關(guān)鍵字參數(shù)的列表傳遞進(jìn)去。

3.4 配置選項(xiàng)

• V ,— version

輸出 nose 的版本

• p ,— plugins

輸出可獲取的插件列表。

• v = DEFUALT ,— verbose = DEFAULT

使用更多的 verbose

— verbosity = VERBOSITY

設(shè)置 verbosity ;— verbosity =2與—— v 設(shè)置一致

• q ,— quiet = DEFAULT

使用更少的 verbose

• c = FILES ,— config = FILES

設(shè)置配置文件。可以設(shè)置很多次，然后將所有的配置文件合并。

• w = WHERE ,— where = WHERE

設(shè)置查找的根目錄。

• py 3 where = WHERE

顧名思義，針對(duì) python 3. x 以上設(shè)置查找路徑。

• m = REGEX ,— match = REGEX ,— testmatch = REGEX

設(shè)置用于自動(dòng)化收集用例的正則表達(dá)式。

— tests = NAMES

執(zhí)行這些測(cè)試。

— debug - log = FILE

設(shè)置調(diào)試的日志文件路徑。

— logging - config = FILE ,— log - config = FILE

設(shè)置日志文件的配置文件。

• I = REGEX ，— ignore - files = REGEX

設(shè)置自動(dòng)收集測(cè)試用例時(shí)忽略的正則表達(dá)式。

• e = REGEX ,— exclude = REGEX

排除要執(zhí)行的測(cè)試用例的正則表達(dá)式

• i = REGEX ,— include = REGEX

包含要執(zhí)行的測(cè)試用例的正則表達(dá)式

• x ,— stop

執(zhí)行測(cè)試發(fā)生錯(cuò)誤后，停止執(zhí)行測(cè)試。

— noexe

不查找可以執(zhí)行文件。

• a = ATTR ,— attr = ATTR

只執(zhí)行包含 ATTR 屬性的測(cè)試用例。

• A = EXPR ,— eval - attr = EXPR

只執(zhí)行屬性與 EXPR 匹配的測(cè)試用例。

• s ,— nocapture

不抓取標(biāo)準(zhǔn)輸出 \ ( stdout\ )

— nologcapture

禁止使用日志插件

— logging - format = FORMAT

打印語(yǔ)句的自定義格式

— logging - datefmt = FORMAT

日志的日期時(shí)間格式

— logging - filter = FILTER

日志語(yǔ)句的過(guò)濾器。

— logging - clear - handlers

清除日志的其他 handlers

— logging - level = DEFUALT

設(shè)置日志的等級(jí)

— with - coverage

開(kāi)啟 coverage 插件

— cover - package = PACKAGE

限定 coverage 所在包

— cover - erase

在執(zhí)行之前 清除上次 coverage 統(tǒng)計(jì)結(jié)果

— cover - testes

在 coverage 報(bào)告中包含測(cè)試模塊

— cover - html

產(chǎn)生 html 的 coverage 報(bào)告

— cover - html - dir = DIR

設(shè)置存儲(chǔ) html 的目錄

— cover - xml

產(chǎn)生 xml 的 coverage 報(bào)告

— cover - xml - file = FILE

設(shè)置存儲(chǔ) coverage 報(bào)告的 xml 文件

— cover - config - file = DEFUALT

設(shè)置 coverage 的配置文件

• pdb

當(dāng)測(cè)試失敗或產(chǎn)生錯(cuò)誤是進(jìn)入調(diào)試模式

— pdb - failures

當(dāng)測(cè)試失敗時(shí)進(jìn)入調(diào)試模式

— pdb - errors

當(dāng)測(cè)試產(chǎn)生錯(cuò)誤時(shí)進(jìn)入調(diào)試模式

— with - doctest

開(kāi)啟 doctest 插件

— doctest - tests

在測(cè)試模塊中查詢 doctests

— with - profile

開(kāi)啟 profile 插件

— profile - sort = SORT

設(shè)置 profiler 輸出排序

— profile - stats - file = FILE

設(shè)置統(tǒng)計(jì)所在的文件地址

— with - id

開(kāi)啟 TestId 插件

— processes = NUM

開(kāi)始測(cè)試處理器的個(gè)數(shù)

— processes - timeout = SECONDS

設(shè)置超時(shí)時(shí)間。

— with - xuint

開(kāi)始 Xunit 插件

— xuint - file = FILE

設(shè)置 XUnit 報(bào)告所在的 xml 文件

— all - modules

開(kāi)啟 AllModules 插件

— collect - only

開(kāi)啟只收集測(cè)試功能。只收集測(cè)試用例及輸出測(cè)試名字，而不執(zhí)行測(cè)試

四、編寫(xiě)測(cè)試用例

4.1 項(xiàng)目組織結(jié)構(gòu)

由于 nose 是自動(dòng)收集測(cè)試用例的，只有 nose 執(zhí)行的測(cè)試目錄下的源代碼文件、包名、子目錄名跟正則表達(dá)式匹配成功后，才能被收集。而且代碼是樹(shù)級(jí)層次顯示的話， nose 會(huì)逐級(jí)向下查找子目錄下的匹配的測(cè)試用例。

匹配的正則表達(dá)式默認(rèn)值為： ( (?: ^ | [\b_\. - ] ) [Tt]est. 所以最好是以 Test 開(kāi)頭，或者 test 開(kāi)頭。當(dāng)然也可以修改默認(rèn)的匹配的正則表達(dá)式。

所以，推薦的項(xiàng)目結(jié)構(gòu)為：

為項(xiàng)目單獨(dú)建一個(gè) test 包，里面按項(xiàng)目模塊分子包，最后以及為 "test_" 開(kāi)頭的測(cè)試用例源文件。

4.2 測(cè)試結(jié)果

4.3測(cè)試代碼

test_mymath.py 中的代碼如下：

# -*- coding: utf-8 -*-
__author__ = 'Administrator'
from nose.tools import assert_equal
from nose.tools import with_setup
 
import ?unittest
import mymath.math as mmath

def setUp(): ? ?
????print("============test math module setup==============")

def teardown(): ? ?
? ? print("============test math module teardown==============")

def test_math_add():
? ? result=mmath.add(4, 5) ? ?
? ? print("================test_math_add============")
 ? ?assert_equal(10, result)

class test_math3(): ? ?
? ? def setUp(self): ? ? ? ?
? ? ? ? print("============test math class setup==============")
? ??def teardown(self): ? ? ? ?
????????print("============test math class teardown==============") ? ?
????def test_math_square(self): ? ? ? ?
????????print("=============== test_math_square================ ")
 ? ? ? ?assert_equal(9, mmath.square(3)) ? ?
????def test_math_sub(self): ? ? ? ?
????????print("=============== test_math_sub================ ")
 ? ? ? ?assert_equal(1, mmath.sub(3, 2))

class test_math2(unittest.TestCase): ? ?
????def test_math_multipy(self): ? ? ? ?
????????print("=============== test_math_multipy================ ")
 ? ? ? ?assert_equal(8, mmath.multiply(2, 4))

test_logicOper.py 中的代碼如下：

4.4 測(cè)試分析

（1）測(cè)試用例的收集

由于 nose 是按照正則表達(dá)式自動(dòng)收集匹配的測(cè)試用例。我們這里收集了5個(gè)測(cè)試用例。分別了

• test_mymath.py 模塊里的 test_math_add 函數(shù)。

• test_mymath.py 模塊里的 test_math 3類(lèi)下面的 test_math_square 、 test_math_sub 兩個(gè)函數(shù)。

• test_mymath.py 模塊里的 test_math 2類(lèi)下面的 test_math_multipy 函數(shù)。

• test_logicOper.py 模塊里的 test_logicOper_isGreaterThan 函數(shù)。

（2）測(cè)試的運(yùn)行順序。

從下圖打印輸出的結(jié)果可以看出。收集的測(cè)試用例的執(zhí)行順序：

test_logicOper_isGreaterThan—>test_mymath(模塊).setup—>test_math2(類(lèi)).test_math_multipy—>test_math3(類(lèi)).setup—>test_math3(類(lèi)).test_math_square—>?test_math3(類(lèi)).teardown—>test_math3(類(lèi)).setup—>test_math3(類(lèi)).test_math_sub—>test_math3(類(lèi)).teardown—>test_mymath(模塊).test_math_add—>test_mymath(模塊).teardown.

大體可以得出如下結(jié)論：

1）測(cè)試的順序總體上按照包—>模塊—>類(lèi)的順序進(jìn)行；

2) 然后按照測(cè)試用例名稱的升序排序進(jìn)行，比如test_math_multipy比test_math_square先執(zhí)行；

3）當(dāng)測(cè)試模塊中既包含測(cè)試函數(shù)，又包含測(cè)試類(lèi)時(shí)，都一定是先執(zhí)行setup(如果定義了),模塊測(cè)試執(zhí)行完畢后執(zhí)行teardown（如果定義了)。而且模塊的setup、setdown只執(zhí)行一次。

4）測(cè)試類(lèi)中的每個(gè)測(cè)試方法執(zhí)行前先執(zhí)行setup(如果定義了),執(zhí)行完畢后執(zhí)行teardown（如果定義了)。而且每個(gè)測(cè)試方法的執(zhí)行過(guò)程都是如此，新的方法重新按setup—>執(zhí)行方法—>teardown的順序執(zhí)行

（3）關(guān)于 setup 、 teardown

package 、 module 、 class 都可以設(shè)置 setup 、 teardown 。

1） package 的 setup 、 teardown 的設(shè)置

放在 __init__.py 文件中，在整個(gè)測(cè)試的運(yùn)行期間只運(yùn)行一次。

setup 函數(shù)的取名可以是 setup , setup_package , setUp , setUpPackage 中的一個(gè)。

teardown 函數(shù)取名可以是 teardown , teardown_package , tearDown or ?tearDownPackage 中的一個(gè)。

2） module 的 setup 、 teardown 的設(shè)置

在整個(gè)測(cè)試的運(yùn)行期間只運(yùn)行一次。

setup 函數(shù)的取名可以是 setup , setup_module , setUp or ?setUpModule 中的一個(gè)。

teardown 函數(shù)取名可以是 teardown_module , or tearDownModule 中的一個(gè)。

3） class 的 setup 、 teardown 的設(shè)置

每個(gè)測(cè)試方法執(zhí)行時(shí)都會(huì)調(diào)用。

setup 函數(shù)的取名可以是 setup_class , setupClass , setUpClass , setupAll , setUpAll 中的一個(gè)。

teardown 函數(shù)取名可以是 teardown_class , teardownClass , tearDownClass , teardownAll
, tearDownAll 中的一個(gè)。

測(cè)試類(lèi)可以繼承 unittest.TestCase ，也可以不繼承， nose 都能識(shí)別。

4）測(cè)試方法的 setup 、 teardown

可以通過(guò) with_setup 裝飾器進(jìn)行設(shè)置，比如

總之， nose 的口號(hào)是： nose extends ?unittest to ?make testing ?easier (測(cè)試更簡(jiǎn)單 ?).


點(diǎn)擊閱讀原文，查看更多 Python 教程和資源