Python单元测试框架-nose

lsekfe

Nose是一个Python单元测试的扩展，能自动发现并运行测试，使得测试更容易。

　　框架介绍
　　nose是一个第三方单元测试框架，它完全兼容unittest，并且号称是一个更好用的测试框架。
　　1、用例的编写方式除了编写继承于unittest.TestCase的测试类外，还可以编写成没有继承的测试类。同时nose也支持定义函数来作为测试。
　　2、unittest所支持的用例发现和执行能力，nose均支持，nose支持用例自动（递归）发现。
　　3、使用nosetests命令，默认发现当前目录下所有包含test的测试用例，不包括以 _ 开头的用例。
　　4、通过-w参数指定要自动发现的目录，-m参数指定用例文件、目录、函数、类的名称模式（正则匹配），例如：nosetests -w project_directory "test_.+"。
　　5、nose也支持执行指定用例：
　　指定测试模块：nosetests test.module
　　指定测试类：nosetests a.test:TestCase
　　指定测试方法：nosetests another.test:TestCase.test_method
　　指定测试文件路径：nosetests /path/to/test/file.py
　　指定测试文件路径+测试类或测试函数（这是 unittest 所不支持的）：
　　nosetests /path/to/test/file.py:TestCase
　　nosetests /path/to/test/file.py:TestCase.test_method
　　nosetests /path/to/test/file.py:test_function
　　6、测试装置（Fixtures）：nose支持unittest所支持的定义测试前置和清理方式。
　　7、子测试/测试生成器：nose除了支持unittest中的 TestCase.subTest，还支持测试生成器（Test generators），通过yield实现。
　　8、测试前置和清理：nose支持setup和teardown函数，在测试用例的前后执行。

　　四种作用域：

　　package
　　可以在__init__.py中定义，setup方法名可以是setup, setup_package, setUp, or setUpPackage，而teardown方法名可以是teardown, teardown_package, tearDown or tearDownPackage。比如定义数据库的连接和释放。

　　module
　　在模块内定义setup,setup_module, setUp or setUpModule，和/或teardown,teardown_module, or tearDownModule。

　　class

　　function
　　任何符合正则的函数都会被包装成FunctionTestCase。
　　除此之外，nose相较于unittest自带了很多有用的插件，也有丰富的第三方插件。
　　比如MultiProcess插件，支持多进程并发测试的用例、支持assert断言、超时机制（from nose.tools import timedimport time@timed(1)def test_lean_5():time.sleep(2)pass）、可结合ddt对用例进行参数化设置、还可以进行失败案例重跑（nosetests -v --failed）、支持跳过指定用例、可利用pip install nose-htmloutput--with-html --html-file=生成测试报告、可以生成xml测试报告（--with-xunit）。

　　工具获取及安装
　　Nose属于python的第三方单元测试框架，需要单独安装。
　　第一种方法：直接pip install nose
　　第二种方法：从官网上直接下载安装包，解压后安装
　　网址：https://pypi.org/project/nose/1.3.7/#files

tar -zvxf nose-1.3.7.tar.gz cd nose-1.3.7 python setup.py install

　　Nose与nose2区别
　　nose2是nose的继任者。目的是让编写和运行测试用例变得更容易。
　　nose2的主要目的是扩展Python的标准单元测试库unittest，提供丰富的插件，例如测试用例加载器、覆盖度报告生成器、并行测试等内置插件和第三方插件，让单元测试变得更加完善。
　　它们有很多相同点，比如都兼容unittest，支持使用函数作为测试用例，支持子测试，拥有插件体系。
　　但也有很多不同点：

　　发现和载入测试
　　nose自行实现了模块加载功能，使用惰性方式加载测试模块，加载一个执行一个。nose2则借助内建的import()导入模块，并且是先全部载入，再执行用例。nose2不支持nose所支持的所有测试用例项目结构。

　　测试前置和清理函数级别
　　nose支持方法、类、模块和包级别的测试前置和清理函数，nose2则不支持包级别的测试前置和清理函数。

　　子测试
　　nose2除了支持使用测试生成器来实现子测试外，还支持使用参数化测试（Parameterized tests）来实现子测试；nose2除了像nose一样支持在测试函数和测试类（不继承于unittest.TestCase）中支持参数化测试和测试生成器外，还支持在继承于 unittest.TestCase 的测试类中使用。
　　nose目前已经进入维护模式，继承nose的是nose2，但nose2并不支持nose的全部功能，它们的区别可以参见：https://nose2.readthedocs.io/en/latest/differences.html

　　实际使用案例

　　1、nose支持unittest定义的setUp和tearDown。

import logging log = logging.getLogger(__name__) def test_learn_3():     print("test_lean_3")     pass def test_lean_4():     print("test_learn_2") def test_lean_5():     print("test_learn_5") def setUp():     print("0002 test setUp") def tearDown():     print("0002 test teardown") test_learn_3.teardown = test_lean_5.teardown = tearDown

　　命令行窗口执行nosetests -v -s test1可以查看结果。

　　也可以以类的形式:

class TestClass():     def setUp(self):         print("MyTestClass setup")     def tearDown(self):         print("MyTestClass teardown")     def Testfunc1(self):         print("this is Testfunc1")         pass     def test_func1(self):         print("this is test_func1")         pass     def Testfunc2(self):         print("this is Testfunc2")         pass     def test_func2(self):         print("this is test_func2")         pass

　　命令行窗口执行nosetests -v -s test2查看结果。

　　也可以在每个用例前使用with_setup修饰器。

def setup_func():     "set up test fixtures" def teardown_func():     "tear down test fixtures" @with_setup(setup_func, teardown_func) def test():     "test ..."

　　2、nose可以运行某一个脚本，还可以运行某一个模块、某一个用例以及不同模块下的不同用例。

　　3、插件使用
　　可以使用SkipTest将某些用例跳过不执行。运行上次运行失败的案例：第一次运行，加入--failed参数：

　　第二次运行时，还是--failed参数，但只运行错误的用例了：

　　4、测试报告生成
　　如果没安装相应插件，需要先安装插件：
　　pip install nose-html-reporting；pip install nosehtmloutput-2或者从官网下载安装包进行安装。
　　命令执行：

nosetests --with-html-output --html-out-file=result1.html

　　生成执行结果报告，如图所示：

　　nose完全兼容unittest，自带代码覆盖率统计的插件，可以在执行用例时加入--with-coverage、--cover-branches、--cover-html、--cover-html-dir=DIR、--cover-xml-file=FILE、--cover-xml等。
　　也可以使用coverage插件进行统计覆盖率，在命令行中执行coverage run --branch test1.py 或（coverage run *.py），跑完后，会自动生成一个覆盖率统计结果文件（data file）：.coverage。coverage report 运行report函数 就可以在命令里看到统计的结果。

　　coverage html（或指定目录 -d testhtml）会在.py文件夹路径下生成一个htmlcov文件夹，打开htmlcov文件夹，用默认浏览器打开index.html，查看html的测试报告。
　　生成的报告直接关联代码，高亮显示覆盖和未覆盖的代码，支持排序。执行后生成的执行结果和代码覆盖率结果（index.html）如图所示：