Module pmock

英文原文文档：http://pmock.sourceforge.net/api/index.html

pmock模块

Python的mock对象框架，支持在单元测试中使用模拟对象。

其API是仿照jmock的框架。

Usage:   import pmock   import unittest   class PowerStation(object):       def start_up(self, reactor):           try:               reactor.activate('core')           except Exception, err:               reactor.shutdown()   class PowerStationTestCase(unittest.TestCase):       def test_successful_activation(self):           mock = pmock.Mock()           mock.expects(pmock.once()).activate(pmock.eq('core'))           PowerStation().start_up(mock)           mock.verify()       def test_problematic_activation(self):           mock = pmock.Mock()           mock.expects(pmock.once()).activate(pmock.eq('core')).will(               pmock.throw_exception(RuntimeError('overheating')))           mock.expects(pmock.once()).shutdown()           PowerStation().start_up(mock)           mock.verify()   if __name__ == '__main__':       unittest.main()

更相信的信息可以在项目的文档找到，项目的主页在这里 http://pmock.sourceforge.net/

Copyright (c) 2004, Graham Carlyle

本模块是自由软件，你可以在与Python一样的条款下分发/修改它，只要以同样的格式保留其版权信息及免责声明。

IN NO EVENT SHALL THE AUTHOR BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS CODE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

THE AUTHOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE CODE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

---

ClassesMock一个mock对象MockTestCase 
Function Summary at_least_once() 
该方法将会被调用至少一次。 eq(expected) 
该参数是提供的值 functor(boolean_functor) 
Supplied unary function evaluates to True when called with argument. never() 
设置不能被调用。 once() 
设置只能被调用一次。 raise_exception(exception) 
让Stub抛出提供的异常。 return_value(value) 
让Stub返回提供的值。 same(expected) 
判断参数是否与被提供的对象引用一样。 string_contains(expected) 
判断参数是否包含被提供的字符串。
Function Details

at_least_once()

函数设置至少被调用一次。

此函数方便创建 AtLeastOnceInvocationMatcher 实例。

eq(expected)

参数将会与提供的值比较是否相等。

方便创建 EqConstraint 实例.

functor(boolean_functor)

Supplied unary function evaluates to True when called with argument.

方便创建FunctorConstraint 实例。

never()

设置永远不会被调用的函数。

方便获取 NotCalledInvocationMatcher 实例。

once()

设置只会被调用一次。

方便创建OnceInvocationMatcher 实例。

raise_exception(exception)

设置Stub抛出提供的异常。

方便创建 RaiseExceptionStub 实例.

return_value(value)

让Stub返回提供的值。

方便创建 ReturnValueStub 实例。

same(expected)

判断参数是否与提供的对象引用一样。

方便创建 SameConstraint 实例。

string_contains(expected)

判断参数是否包含提供的字符串。

方便创建StringContainsConstraint 实例。