使用 Python Mock 类进行单元测试

谁践踏了优雅 2022-08-07 03:45 206阅读 0赞

<table style="margin:0px; padding:0px; font-family:'Microsoft YaHei',Verdana,sans-serif,SimSun; table-layout:fixed; color:rgb(0,0,0); font-size:13px; background-color:rgb(237,237,237)"> 
 <tbody style="margin:0px; padding:0px"> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> Data type, model, or node -- these are just some of the roles a mock object might assume. But how does a mock fit inside a unit test setup? Sometimes, you need "other" code resources for your test setup. But those resources may be unavailable, unstable, or just too unwieldy to use. You could try and find a replacement for the missing resource; or you could simulate it by creating what is known as a mock. Mocks let us simulate resources that are either unavailable or too unwieldy for unit testing. Creating a mock in Python is done through the Mock module. You can build a mock one-attribute-at-a-time or wholesale with a dictionary object or a class interface. You can also define how a mock behaves and check its usage during a test. Let's explore. Sample code presented here is written in Python 2.4, unless noted otherwise. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> 数据类型、模型或节点——这些都只是mock对象可承担的角色。但mock在单元测试中扮演一个什么角色呢？ 有时，你需要为单元测试的初始设置准备一些“其他”的代码资源。但这些资源兴许会不可用，不稳定，或者是使用起来太笨重。你可以试着找一些其他的资源替代；或者你可以通过创建一个被称为mock的东西来模拟它。Mocks能够让我们模拟那些在单元测试中不可用或太笨重的资源。 在Python中创建mock是通过Mock模块完成的。你可以通过每次一个属性（one-attribute-at-a-time）或一个健全的字典对象或是一个类接口来创建mock。你还可以定义mock的行为并且在测试过程中检查它的使用。让我们继续探讨。 除非单独说明，下面的示例代码都是用Python2.4写的。 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> <h3 style="margin:0px; padding:0px">The Test Setup</h3> The typical test setup has at least two parts. First, there is the test subject (red), the focus of the test. It can be a method, module, or class. It may or may not return a result, but it can raise an error or exception depending on input data or internal state &nbsp;(Figure 1). <img src="http://static.oschina.net/uploads/img/201405/27065220_C73n.gif" alt="Python" title="Python" width="550" style="margin:0px; padding:0px; border:0px"> Figure 1. Second is the test case (grey), which runs alone or as part of a suite. It prepares the test subject, as well as any data or resources needed by the subject. It runs one or more test routines and checks how the test subject behaves in each test. And it collects the test results and presents them in a concise, readable format. Now, some test subjects need one or more resources (green) in order to function. These resources may be another class or module, or even an independent process. Whatever their nature, test resources are functional code. Their role is to support the test subject, but they are not the focus of the test. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> <h3 style="margin:0px; padding:0px">测试准备</h3> 典型的测试准备最少有两个部分。首先是测试对象（红色），这是测试的关注点。它可以是一个方法、模块或者类。它可以返回一个结果，也可以不返回结果，但是它可以根据数据数据或者内部状态产生错误或者异常（图1）。 <img src="http://static.oschina.net/uploads/img/201405/27065220_C73n.gif" alt="Python" style="margin:0px; padding:0px; border:0px"> 图1 第二测试用例（灰色），它可以单独运行也可以作为套件的一部分。它是为测试对象准备的，也可以是测试对象需要的任意数据或资源。运行一个或多个测试事务，在每个测试中检查测试对象的行为。收集测试结果并用一个简洁、易读的格式呈现测试结果。 现在，为了发挥作用，一些测试对象需要一个或多个资源（绿色）。这些资源可以是其他的类或者模块，甚至是一个非独立的进程。不论其性质，测试资源是功能性的代码。他们的角色是支持测试对象，但是他们不是测试的关注点。 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> <h3 style="margin:0px; padding:0px">Reasons to Mock</h3> But there are times when a test resource is either unavailable or unsuitable. Perhaps the resource is being developed in parallel with the test subject. It may then be incomplete or too unstable to be reliable. The resource may be too costly. If the resource is a third-party product, its high price tag can disqualify its use for testing. Setting up the resource might be complex, taking up hardware and time that could be used elsewhere. If the resource is a data source, setting up its data set, one that mimics real-world content, can get tedious. The resource may simply be unpredictable. A good unit test has to be repeatable, allowing you to isolate and identify a fault. But the test resource might give out stochastic results, or it might have widely varying response times. And as a result, you end up glossing over a potential showstopper. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> <h3 style="margin:0px; padding:0px">使用Mock的理由</h3> 但是有些时候，测试资源不可用，或者不适合。也许这个资源正在和测试对象并行开发中，或者并不完整或者是太不稳定以至于不可靠。 测试资源太昂贵，如果测试资源是第三方的产品，其高昂的价格不适用于测试。测试资源的建立过于复杂，占用的硬件和时间可以用于别的地方。如果测试资源是一个数据源，建立它的数据集模仿真实世界是乏味的。 测试资源是不可预知的。一个好的单元测试是可重复的，允许你分离和识别故障。但是测试资源可能给出随机的结果，或者它会有不同的响应时间。而作为这样的结果，测试资源最终可能成为一个潜在的搅局者。 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> These are some of the reasons why you might want to use a mock in place of a test resource. A mock can present the same set of method interfaces as the resource to the test subject. But a mock is easier to setup, easier to manage. It can present the test subject the same method interfaces as the actual test resource. It can deliver deterministic results, and it can be customize to suit a particular test. And it can be easily updated to reflect changes in the actual resource. Of course, mocks are not without issues. Designing an accurate mock is difficult, especially if you have no reliable information on the test resource. You can try and find an open-source match, or you can make a guesstimate on the resource's method interface. Whichever you choose, you can update the mock easily later on, should you get more detailed information on the preferred resource. Too many mocks can complicate a test, making it harder for you to track down a failure. Best practice is to limit a test case to one or two mocks, or use separate test cases for each mock/subject pairing. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> &nbsp;这些都是你可能想要用mock代替测试资源的原因。mock向测试对象提供一套和测试资源相同的方法接口。但是mock是更容易创建和管理。它能向测试对象提供和真实的测试资源相同的方法接口。它能提供确定的结果，并可以自定义以适用于特定的测试。能够容易的更新，以反映实际资源的变化。 当然，mocks不是没有问题的。设计一个精确的mock是困难的,特别是如果你没有测试资源的可靠信息。你可以尝试找到一个开源的接口，或者你能对测试资源的方法接口进行猜测。无论你如何选择，你都可以在以后轻松的更新mock,你可以在首选资源中得到更详细的信息。 太多的mock会使测试过于复杂，让你跟踪错误变得更困难。最好的实践是每个测试用例限制使用一到两个mock，或者为每个mock/对象对使用独立的测试用例。 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> <h3 style="margin:0px; padding:0px">Mocks versus Stubs versus Fakes</h3> A mock is not the only way to mimic a test resource. Solutions like a stub or a fake are just as capable of the same service. So, how does a mock compare against these two? Why choose a mock over a stub or a fake? Consider the stub: A stub presents a set of method interfaces to the test subject, the same set the subject would see in an actual test resource. When the test subject calls a stub method, the stub may respond with a predetermined set of results. It may raise an error or exception, also predetermined. A stub may track its interactions with the test subject, but it performs no tasks outside the narrow scope of its programming. A fake also presents a set of method interfaces and tracks its interactions with the test subject. But unlike a stub, a fake actually processes input data from the test subject and produces results based on that data. In short, a fake is a functional, but non-production version of the actual test resource. It lacks the checks and balances found in resource, it uses simpler algorithms, and it seldom, if ever, stores or transports data. With fakes and stubs, you can test if the test subject called the right method with the right input. You can test how the subject handles the result and how it reacts to an error or exception. These tests are known as state verification. But what if you want to know if the test subject called the same method twice? What if you want to know if it called several methods in the proper order? Such tests are known as behavior verification, and to do them, you need mocks. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> <h3 style="margin:0px; padding:0px">Mocks对Stubs对Fakes</h3> Mock不是模仿测试资源的唯一方式。其他的解决方案如stub和fake也能提供相同的服务。因此，mock和其他两种解决方案怎样比较？为什么选择mock而不是选择stub或者fake? 认识stub:stub为测试对象提供了一套方法接口，和真实的测试资源提供给测试对象的接口是相同的。当测试对象调用stub方法时，stub响应预定的结果。也可以产生一个预定的错误或者异常。stub可以跟踪和测试对象的交互，但是它不处理输入的数据。 fake也提供了一套方法接口并且也可以跟踪和测试对象的交互。但是和stub不同，fake真正的处理了从测试对象输入的数据产生的结果是基于这些数据的。简而言之，fake是功能性的，它是真实测试资源的非生产版。它缺乏资源的相互制衡，使用了更简单的算法，而且它很少存储和传输数据。 使用fake和stub,你可以输入正确的数据调用了正确的方法对测试对象进行测试。你能测试对象是如何处理数据并产生结果，当出现错误或者异常时是怎样反应的。这些测试被称为状态验证。但是你是否想知道测试对象调用了两次相同的方法？你是否想知道测试对象是否按照正确的顺序调用了几个方法？这种测试被称为行为验证，而要做到这些，你需要mocks。 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> <h3 style="margin:0px; padding:0px">To Mock with Python</h3> The Mock module is what you use to create and manage a mock object on Python. This module is the brainchild of Michael Foord, and it is a standard module on Python 3.0. For Python 2.4 to 2.7, however, you have to install the module yourself. You can get the latest version of the Mock module (1.0.1) from the&nbsp;<a href="https://pypi.python.org/pypi/mock#downloads" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Python Package Index website</a>. The Mock module provides a handful classes on which to base your mock object. There is even a patch mechanism for altering the mock on the fly. But for now, our focus is on one class: the&nbsp;<code style="margin:0px; padding:0px">Mock</code>&nbsp;class. Figure 2 shows the basic structure of the&nbsp;<code style="margin:0px; padding:0px">Mock</code>&nbsp;class (green). It derives from two parent classes:&nbsp;<code style="margin:0px; padding:0px">NonCallableMock</code>&nbsp;and&nbsp;<code style="margin:0px; padding:0px">CallableMixin</code>&nbsp;(grey).<code style="margin:0px; padding:0px">NonCallableMock</code>&nbsp;defines the routines needed by the mock object. It overrides several magic methods, giving them default behaviors. And it supplies the assert routines for tracking the mock's behavior. As for<code style="margin:0px; padding:0px">CallableMixin</code>, it updates those magic methods that make a mock object callable. In turn, both parents derive from the&nbsp;<code style="margin:0px; padding:0px">Base</code>&nbsp;class (red), which declares the properties needed by the mock object. <img src="http://static.oschina.net/uploads/img/201405/27065222_9MSv.gif" alt="Python" title="Python" width="350" style="margin:0px; padding:0px; border:0px"> Figure 2. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> <h3 style="margin:0px; padding:0px">使用Python Mock</h3> 在Python中Mock模块是用来创建和管理mock对象的。该模块是Michael Foord的心血结晶，它是Python3.0的标准模块。因此在Python2.4~2.7中，你不得不自己安装这个模块。你可以&nbsp;<a href="https://pypi.python.org/pypi/mock#downloads" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Python Package Index website</a>从获得Mock模块最新的版本。 基于你的mock对象，Mock模块提供了少量的类。为了改变运行中的mock甚至提供了补丁机制。但是现在，我们关注一个类：Mock类。 图2中显示了Mock类（绿色）的基本结构。它继承于两个父类：NonCallableMock和CallableMixin（灰色）。NonCallableMock定义了mock对象所需的例程。它重载了几个魔法方法，给他们定义了缺省的行为。为了跟踪mock的行为，它提供了断言例程。CallableMixin更新了mock对象回调的魔法方法。反过来，两个父类继承于Base类（红色），声明了mock对象所需的属性。 <img src="http://static.oschina.net/uploads/img/201405/27065222_9MSv.gif" alt="Python" style="margin:0px; padding:0px; border:0px"> 图2 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> <h3 style="margin:0px; padding:0px">Preparing to Mock </h3> The&nbsp;<code style="margin:0px; padding:0px">Mock</code>&nbsp;class has four sets of methods (Figure 3). In the first set is the class constructor, which takes up to six optional and labeled arguments. The diagram shows the four arguments you will use most often. <img src="http://static.oschina.net/uploads/img/201405/27065223_DqsX.gif" alt="Python" title="Python" width="350" style="margin:0px; padding:0px; border:0px"> Figure 3. The first constructor argument is the&nbsp;<code style="margin:0px; padding:0px">name</code>&nbsp;argument, which gives a mock object &nbsp;a unique name. Listing One shows how I create a mock object (<code style="margin:0px; padding:0px">mockFoo</code>) with the name&nbsp;<code style="margin:0px; padding:0px">Foo</code>. Notice the name appears next to the mock's unique ID when I print the mock object (lines 6-9). Listing One <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(name&nbsp;=&nbsp;"Foo")

print&nbsp;mockFoo
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='Foo'&nbsp;id='494864'&gt;
print&nbsp;repr(mockFoo)
#&nbsp;still&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='Foo'&nbsp;id='494864'&gt;</code></pre> The next constructor argument is the&nbsp;<code style="margin:0px; padding:0px">spec</code>&nbsp;argument. It sets the mock object's attributes — which may be a property or a method. The attributes can be a list of strings or &nbsp;can come from another Python class. To demonstrate, in Listing Two, I have a list object (<code style="margin:0px; padding:0px">fooSpec</code>) with three items (line 4): the property attribute<code style="margin:0px; padding:0px">&nbsp;_fooValue</code>, and the method attributes&nbsp;<code style="margin:0px; padding:0px">callFoo</code>and&nbsp;<code style="margin:0px; padding:0px">doFoo</code>. When I pass&nbsp;<code style="margin:0px; padding:0px">fooSpec</code>&nbsp;to the class constructor (line 7),&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>gains three attributes, which I can access with the dot operator (lines 10-15). But if I access an undeclared attribute,&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>&nbsp;raises an&nbsp;<code style="margin:0px; padding:0px">AttributeError</code>and names the "faulty" attribute (lines 21-24). Listing Two <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;prepare&nbsp;the&nbsp;spec&nbsp;list
fooSpec&nbsp;=&nbsp;["_fooValue",&nbsp;"callFoo",&nbsp;"doFoo"]

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;fooSpec)

#&nbsp;accessing&nbsp;the&nbsp;mocked&nbsp;attributes
print&nbsp;mockFoo
#&nbsp;&lt;Mock&nbsp;id='427280'&gt;
print&nbsp;mockFoo._fooValue
#&nbsp;returns&nbsp;&lt;Mock&nbsp;name='mock._fooValue'&nbsp;id='2788112'&gt;
print&nbsp;mockFoo.callFoo()
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.callFoo()'&nbsp;id='2815376'&gt;

mockFoo.callFoo()
#&nbsp;nothing&nbsp;happens,&nbsp;which&nbsp;is&nbsp;fine

#&nbsp;accessing&nbsp;the&nbsp;missing&nbsp;attributes
print&nbsp;mockFoo._fooBar
#&nbsp;raises:&nbsp;AttributeError:&nbsp;Mock&nbsp;object&nbsp;has&nbsp;no&nbsp;attribute&nbsp;'_fooBar'
mockFoo.callFoobar()
#&nbsp;raises:&nbsp;AttributeError:&nbsp;Mock&nbsp;object&nbsp;has&nbsp;no&nbsp;attribute&nbsp;'callFoobar'</code></pre> </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> <h3 style="margin:0px; padding:0px">准备Mock</h3> Mock类有四套方法（图3）。第一套方法是类的构造器，它有六个可选和已标记的参数。图中显示了4个经常用到的参数。 <img src="http://static.oschina.net/uploads/img/201405/27065223_DqsX.gif" alt="Python" style="margin:0px; padding:0px; border:0px"> 图3 构造器的第一个参数是name，它定义了mock对象的唯一标示符。Listing one显示了怎么创建一个标示符为Foo的mock对象mockFoo。请注意当我打印mock对象（6-9行）时，标示符后紧跟的是mock对象的唯一ID。 Listing One <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(name&nbsp;=&nbsp;"Foo")

print&nbsp;mockFoo
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='Foo'&nbsp;id='494864'&gt;
print&nbsp;repr(mockFoo)
#&nbsp;still&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='Foo'&nbsp;id='494864'&gt;</code></pre> 构造器的第二个参数是spec。它设置mock对象的属性，可以是property或者方法。属性可以是一个列表字符串或者是其他的Python类。 为了演示，在Listing Two中，我有一个带三个项目的列表对象fooSpec(第4行)：property属性_fooValue,方法属性callFoo和doFoo。当我把fooSpec带入类构造器时（第7行），mockFoo获得了三个属性，我能用点操作符访问它们（10~15行）。当我访问了一个未声明的属性时，mockFoo引发AttributeError和"faulty"属性（21~14行）。 Listing Two <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;prepare&nbsp;the&nbsp;spec&nbsp;list
fooSpec&nbsp;=&nbsp;["_fooValue",&nbsp;"callFoo",&nbsp;"doFoo"]

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;fooSpec)

mockFoo.callFoo()
#&nbsp;nothing&nbsp;happens,&nbsp;which&nbsp;is&nbsp;fine

#&nbsp;accessing&nbsp;the&nbsp;missing&nbsp;attributes
print&nbsp;mockFoo._fooBar
#&nbsp;raises:&nbsp;AttributeError:&nbsp;Mock&nbsp;object&nbsp;has&nbsp;no&nbsp;attribute&nbsp;'_fooBar'
mockFoo.callFoobar()
#&nbsp;raises:&nbsp;AttributeError:&nbsp;Mock&nbsp;object&nbsp;has&nbsp;no&nbsp;attribute&nbsp;'callFoobar'</code></pre> </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> Listing Three shows another use of the&nbsp;<code style="margin:0px; padding:0px">spec</code>&nbsp;argument. This time, I have class<code style="margin:0px; padding:0px">Foo</code>&nbsp;with the same three attributes (lines 4-12). I pass the class name to the constructor (line 15), which then produces a mock object with the same attributes as&nbsp;<code style="margin:0px; padding:0px">Foo</code>&nbsp;(lines 18-23). Again, accessing an undeclared attribute raises an&nbsp;<code style="margin:0px; padding:0px">AttributeError</code>&nbsp;(lines 29-32). Also, in both examples, the method attributes are non-functional. Calling a mocked method does nothing, even if said method has functional code (lines 25-26). Listing Three <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;The&nbsp;class&nbsp;interfaces
class&nbsp;Foo(object):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;instance&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_fooValue&nbsp;=&nbsp;123
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;callFoo(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Foo:callFoo_"
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;doFoo(self,&nbsp;argValue):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Foo:doFoo:input&nbsp;=&nbsp;",&nbsp;argValue&nbsp;&nbsp;&nbsp;&nbsp;

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)

#&nbsp;accessing&nbsp;the&nbsp;mocked&nbsp;attributes
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;
print&nbsp;mockFoo._fooValue
#&nbsp;returns&nbsp;&lt;Mock&nbsp;name='mock._fooValue'&nbsp;id='2788112'&gt;
print&nbsp;mockFoo.callFoo()
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.callFoo()'&nbsp;id='2815376'&gt;

mockFoo.callFoo()
#&nbsp;nothing&nbsp;happens,&nbsp;which&nbsp;is&nbsp;fine

#&nbsp;accessing&nbsp;the&nbsp;missing&nbsp;attributes
print&nbsp;mockFoo._fooBar
#&nbsp;raises:&nbsp;AttributeError:&nbsp;Mock&nbsp;object&nbsp;has&nbsp;no&nbsp;attribute&nbsp;'_fooBar'
mockFoo.callFoobar()
#&nbsp;raises:&nbsp;AttributeError:&nbsp;Mock&nbsp;object&nbsp;has&nbsp;no&nbsp;attribute&nbsp;'callFoobar'</code></pre> The next constructor argument is&nbsp;<code style="margin:0px; padding:0px">return_value</code>. This one sets a mock object's response when it gets a direct call. I use this argument for simulating a factory call. To demonstrate, in Listing Four, I have&nbsp;<code style="margin:0px; padding:0px">return_value</code>&nbsp;set to&nbsp;<code style="margin:0px; padding:0px">456</code>&nbsp;(line 4). When I call&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>, I get&nbsp;<code style="margin:0px; padding:0px">456</code>&nbsp;for a result (line 9-11). In Listing Five, I pass an instance of class&nbsp;<code style="margin:0px; padding:0px">Foo</code>&nbsp;(<code style="margin:0px; padding:0px">fooObj</code>) for&nbsp;<code style="margin:0px; padding:0px">return_value</code>&nbsp;(lines 15-19). Now, when I call&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>, I get&nbsp;<code style="margin:0px; padding:0px">fooObj</code>&nbsp;instead (shown here as&nbsp;<code style="margin:0px; padding:0px">mockObj</code>) (line 24). And unlike in Listings Two and Three, the methods in&nbsp;<code style="margin:0px; padding:0px">mockObj</code>&nbsp;are functional. Listing Four <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(return_value&nbsp;=&nbsp;456)

print&nbsp;mockFoo
#&nbsp;&lt;Mock&nbsp;id='2787568'&gt;

#&nbsp;The&nbsp;mock&nbsp;object
class&nbsp;Foo(object):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;instance&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_fooValue&nbsp;=&nbsp;123
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;callFoo(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Foo:callFoo_"
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;doFoo(self,&nbsp;argValue):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Foo:doFoo:input&nbsp;=&nbsp;",&nbsp;argValue

#&nbsp;creating&nbsp;the&nbsp;mock&nbsp;object
fooObj&nbsp;=&nbsp;Foo()
print&nbsp;fooObj
#&nbsp;returns:&nbsp;&lt;__main__.Foo&nbsp;object&nbsp;at&nbsp;0x68550&gt;

mockFoo&nbsp;=&nbsp;Mock(return_value&nbsp;=&nbsp;fooObj)
print&nbsp;mockFoo
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;id='2788144'&gt;

#&nbsp;creating&nbsp;an&nbsp;"instance"
mockObj&nbsp;=&nbsp;mockFoo()
print&nbsp;mockObj
#&nbsp;returns:&nbsp;&lt;__main__.Foo&nbsp;object&nbsp;at&nbsp;0x68550&gt;

#&nbsp;working&nbsp;with&nbsp;the&nbsp;mocked&nbsp;instance
print&nbsp;mockObj._fooValue
#&nbsp;returns:&nbsp;123
mockObj.callFoo()
#&nbsp;returns:&nbsp;Foo:callFoo_
mockObj.doFoo("narf")
#&nbsp;returns:&nbsp;Foo:doFoo:input&nbsp;=&nbsp;&nbsp;narf
&lt;Mock&nbsp;id='428560'&gt;</code></pre> Counter to&nbsp;<code style="margin:0px; padding:0px">return_value</code>&nbsp;is the&nbsp;<code style="margin:0px; padding:0px">side_effect</code>&nbsp;argument. This one assigns the mock with an alternative result, one that overrides&nbsp;<code style="margin:0px; padding:0px">return_value</code>. In short, a simulated factory call returns the&nbsp;<code style="margin:0px; padding:0px">side_effect</code>&nbsp;value, not the&nbsp;<code style="margin:0px; padding:0px">return_value</code>. Listing Six demonstrates the effects of the<code style="margin:0px; padding:0px">&nbsp;side_effect</code>&nbsp;argument. First, I create an instance of class&nbsp;<code style="margin:0px; padding:0px">Foo</code>&nbsp;(<code style="margin:0px; padding:0px">fooObj</code>) and pass it as a&nbsp;<code style="margin:0px; padding:0px">return_value</code>argument (line 17). The result is similar to Listing Five;&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>&nbsp;returns<code style="margin:0px; padding:0px">fooObj</code>&nbsp;when called (line 22). But then I repeat the same steps, passing<code style="margin:0px; padding:0px">StandardError</code>&nbsp;for the&nbsp;<code style="margin:0px; padding:0px">side_effect</code>&nbsp;argument (line 28). Now, calling&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>raises&nbsp;<code style="margin:0px; padding:0px">StandardError</code>, instead of returning&nbsp;<code style="margin:0px; padding:0px">fooObj</code>&nbsp;(lines 29-30). </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> Listing Three显示了spec参数的另一种用法。这次，有带三个属性的类Foo(4~12行)。把类名传入构造器中，这样就产生了一个和Foo有相同属性的mock对象（18~23行）。再次，访问一个未声明的属性引发了AttributeError（29~32行）。也就是说，在两个例子中，方法属性时没有功能的。甚至在方法有功能代码时，调用mock的方法也什么都不做。 Listing Three <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)

mockFoo.callFoo()
#&nbsp;nothing&nbsp;happens,&nbsp;which&nbsp;is&nbsp;fine

#&nbsp;accessing&nbsp;the&nbsp;missing&nbsp;attributes
print&nbsp;mockFoo._fooBar
#&nbsp;raises:&nbsp;AttributeError:&nbsp;Mock&nbsp;object&nbsp;has&nbsp;no&nbsp;attribute&nbsp;'_fooBar'
mockFoo.callFoobar()
#&nbsp;raises:&nbsp;AttributeError:&nbsp;Mock&nbsp;object&nbsp;has&nbsp;no&nbsp;attribute&nbsp;'callFoobar'</code></pre> 下一个构造器参数是return_value。这将设置mock对象的响应当它被直接调用的时候。我用这个参数模拟一个工厂调用。&nbsp; 为了演示，在Listing Four中，设置return_value为456（第4行）。当调用mockFoo时，将返回456的结果（9~11行）。在Listing Five中，我给return_value传入了一个类Foo的实例fooObj（15~19行）。现在，当我调用mockFoo时，我获得了fooObj的实例（显示为mockObj）(第24行)。和Listing Two和Three不一样，mockObj的方法是带有功能的。 Listing Four <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(return_value&nbsp;=&nbsp;456)

print&nbsp;mockFoo
#&nbsp;&lt;Mock&nbsp;id='2787568'&gt;

mockObj&nbsp;=&nbsp;mockFoo()
print&nbsp;mockObj
#&nbsp;returns:&nbsp;456</code></pre> Listing Five <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;creating&nbsp;the&nbsp;mock&nbsp;object
fooObj&nbsp;=&nbsp;Foo()
print&nbsp;fooObj
#&nbsp;returns:&nbsp;&lt;__main__.Foo&nbsp;object&nbsp;at&nbsp;0x68550&gt;

mockFoo&nbsp;=&nbsp;Mock(return_value&nbsp;=&nbsp;fooObj)
print&nbsp;mockFoo
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;id='2788144'&gt;

#&nbsp;creating&nbsp;an&nbsp;"instance"
mockObj&nbsp;=&nbsp;mockFoo()
print&nbsp;mockObj
#&nbsp;returns:&nbsp;&lt;__main__.Foo&nbsp;object&nbsp;at&nbsp;0x68550&gt;

#&nbsp;creating&nbsp;the&nbsp;mock&nbsp;object&nbsp;(without&nbsp;a&nbsp;side&nbsp;effect)
fooObj&nbsp;=&nbsp;Foo()

mockFoo&nbsp;=&nbsp;Mock(return_value&nbsp;=&nbsp;fooObj)
print&nbsp;mockFoo
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;id='2788144'&gt;

#&nbsp;creating&nbsp;an&nbsp;"instance"
mockObj&nbsp;=&nbsp;mockFoo()
print&nbsp;mockObj
#&nbsp;returns:&nbsp;&lt;__main__.Foo&nbsp;object&nbsp;at&nbsp;0x2a88f0&gt;

#&nbsp;creating&nbsp;a&nbsp;mock&nbsp;object&nbsp;(with&nbsp;a&nbsp;side&nbsp;effect)

mockFoo&nbsp;=&nbsp;Mock(return_value&nbsp;=&nbsp;fooObj,&nbsp;side_effect&nbsp;=&nbsp;StandardError)
mockObj&nbsp;=&nbsp;mockFoo()
#&nbsp;raises:&nbsp;StandardError</code></pre> Listing Seven shows another effect. In this one, I pass a list object (<code style="margin:0px; padding:0px">fooList</code>) to the class constructor (lines 17-18). Then, each time I call&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>, it returns a list item in succession (lines 20-30). Once&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>&nbsp;reaches the end of the list, another call will raise a&nbsp;<code style="margin:0px; padding:0px">StopIteration</code>&nbsp;error (lines 32-34). Listing Seven <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;creating&nbsp;the&nbsp;mock&nbsp;object&nbsp;(with&nbsp;a&nbsp;side&nbsp;effect)
fooObj&nbsp;=&nbsp;FooSpec()

fooList&nbsp;=&nbsp;[665,&nbsp;666,&nbsp;667]
mockFoo&nbsp;=&nbsp;Mock(return_value&nbsp;=&nbsp;fooObj,&nbsp;side_effect&nbsp;=&nbsp;fooList)

fooTest&nbsp;=&nbsp;mockFoo()
print&nbsp;fooTest
#&nbsp;returns&nbsp;665

fooTest&nbsp;=&nbsp;mockFoo()
print&nbsp;fooTest
#&nbsp;returns&nbsp;666

fooTest&nbsp;=&nbsp;mockFoo()
print&nbsp;fooTest
#&nbsp;returns&nbsp;667

fooTest&nbsp;=&nbsp;mockFoo()
print&nbsp;fooTest
#&nbsp;raises:&nbsp;StopIteration</code></pre> You could pass other iterable objects (<code style="margin:0px; padding:0px">set, tuple</code>) to the&nbsp;<code style="margin:0px; padding:0px">side_effect</code>argument. What you&nbsp;cannot&nbsp;pass is a primitive (integer, string, and so on) because these are not iterable. To make a primitive iterable, add it to a single-item list. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> Listing Six <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;creating&nbsp;the&nbsp;mock&nbsp;object&nbsp;(without&nbsp;a&nbsp;side&nbsp;effect)
fooObj&nbsp;=&nbsp;Foo()

mockFoo&nbsp;=&nbsp;Mock(return_value&nbsp;=&nbsp;fooObj)
print&nbsp;mockFoo
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;id='2788144'&gt;

#&nbsp;creating&nbsp;an&nbsp;"instance"
mockObj&nbsp;=&nbsp;mockFoo()
print&nbsp;mockObj
#&nbsp;returns:&nbsp;&lt;__main__.Foo&nbsp;object&nbsp;at&nbsp;0x2a88f0&gt;

#&nbsp;creating&nbsp;a&nbsp;mock&nbsp;object&nbsp;(with&nbsp;a&nbsp;side&nbsp;effect)

mockFoo&nbsp;=&nbsp;Mock(return_value&nbsp;=&nbsp;fooObj,&nbsp;side_effect&nbsp;=&nbsp;StandardError)
mockObj&nbsp;=&nbsp;mockFoo()
#&nbsp;raises:&nbsp;StandardError</code></pre> Listing Seven显示了另一个影响。在这个例子中，传入一个列表对象fooList到类构造器中（17~18行）。然后，每次我调用mockFoo时，它连续的返回列表中的项（20~30行）。一旦mockFoo到达了列表的末尾，调用将引发StopIteration&nbsp;错误（32~34行） Listing Seven <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;creating&nbsp;the&nbsp;mock&nbsp;object&nbsp;(with&nbsp;a&nbsp;side&nbsp;effect)
fooObj&nbsp;=&nbsp;FooSpec()

fooList&nbsp;=&nbsp;[665,&nbsp;666,&nbsp;667]
mockFoo&nbsp;=&nbsp;Mock(return_value&nbsp;=&nbsp;fooObj,&nbsp;side_effect&nbsp;=&nbsp;fooList)

fooTest&nbsp;=&nbsp;mockFoo()
print&nbsp;fooTest
#&nbsp;returns&nbsp;665

fooTest&nbsp;=&nbsp;mockFoo()
print&nbsp;fooTest
#&nbsp;returns&nbsp;666

fooTest&nbsp;=&nbsp;mockFoo()
print&nbsp;fooTest
#&nbsp;returns&nbsp;667

fooTest&nbsp;=&nbsp;mockFoo()
print&nbsp;fooTest
#&nbsp;raises:&nbsp;StopIteration</code></pre> 你可以传入其他的可迭代对象（集合，元组）到side_effct对象中。你不能传入一个简单对象（如整数、字符串等），因为这些对象是不能迭代的，为了让简单对象可迭代，需要将他们加入单一项的列表中。 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> <h3 style="margin:0px; padding:0px">Asserting with a Mock</h3> The next set of methods from the&nbsp;<code style="margin:0px; padding:0px">Mock</code>&nbsp;class are the asserts. These help track the method calls made to the mock by the test subject. They can work in conjunction with the asserts from the unittest module. They can be attached to the mock or to one of its method attributes. All but one take the same two optional arguments: a variable sequence, and a key/value sequence. The first assert,&nbsp;<code style="margin:0px; padding:0px">assert_called_with()</code>, checks if a mocked method gets the right arguments. It fires when at least one argument has the wrong value or type, when there is a wrong number of arguments, when the arguments are in the wrong order, or when the mocked method is not expecting any arguments at all. Listing Eight shows how you might use this assert. Here, I prepared a mock object with class&nbsp;<code style="margin:0px; padding:0px">Foo</code>&nbsp;as its spec. I call the mocked method<code style="margin:0px; padding:0px">doFoo()</code>, passing a string for input. With&nbsp;<code style="margin:0px; padding:0px">assert_called_with()</code>, I check if the method gets the right input. The assert in line 20 passes because<code style="margin:0px; padding:0px">doFoo()</code>&nbsp;got&nbsp;<code style="margin:0px; padding:0px">"narf"</code>&nbsp;for input. But the assert in line 24 fails because&nbsp;<code style="margin:0px; padding:0px">doFoo()</code>got&nbsp;<code style="margin:0px; padding:0px">"zort"</code>, which is wrong. Listing Eight <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;The&nbsp;mock&nbsp;object
class&nbsp;Foo(object):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;instance&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_fooValue&nbsp;=&nbsp;123
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;callFoo(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;doFoo(self,&nbsp;argValue):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

mockFoo.doFoo("narf")
mockFoo.doFoo.assert_called_with("narf")
#&nbsp;assertion&nbsp;passes

mockFoo.doFoo("zort")
mockFoo.doFoo.assert_called_with("narf")
#&nbsp;AssertionError:&nbsp;Expected&nbsp;call:&nbsp;doFoo('narf')
#&nbsp;Actual&nbsp;call:&nbsp;doFoo('zort')</code></pre> </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> <h3 style="margin:0px; padding:0px">Mock断言</h3> Mock类的下一套方法是断言。它将帮助跟踪测试对象对mock方法的调用。他们能和unittest模块的断言一起工作。能连接到mock或者其方法属性之一。 有两个相同的可选参数：一个变量序列，一个键/值序列。 第一个断言assert_called_with()，检查mock方法是否获得了正确的参数。当至少一个参数有错误的值或者类型时，当参数的数量错误时，当参数的顺序错误时，或者当mock的方法根本不存在任何参数时，这个断言将引发错误。Listing Eight显示了可以怎样使用这个断言。那儿，我准备了一个mock对象，用类Foo作为它的spec参数。我调用了类的方法doFoo()，传入了一个字符串作为输入。使用assert_called_with()，我检查方法是否获得了正确的输入。第20行的断言通过了，因为doFoo()获得了"narf"的输入。但是在第24行的断言失败了因为doFoo()获得了"zort"，这是错误的输入。 Listing Eight <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;The&nbsp;mock&nbsp;object
class&nbsp;Foo(object):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;instance&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_fooValue&nbsp;=&nbsp;123
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;callFoo(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;doFoo(self,&nbsp;argValue):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

mockFoo.doFoo("narf")
mockFoo.doFoo.assert_called_with("narf")
#&nbsp;assertion&nbsp;passes

#&nbsp;The&nbsp;mock&nbsp;object
class&nbsp;Foo(object):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;instance&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_fooValue&nbsp;=&nbsp;123
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;callFoo(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;doFoo(self,&nbsp;argValue):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

mockFoo.callFoo()
mockFoo.callFoo.assert_called_with()
#&nbsp;assertion&nbsp;passes

mockFoo.callFoo("zort")
mockFoo.callFoo.assert_called_with()
#&nbsp;AssertionError:&nbsp;Expected&nbsp;call:&nbsp;callFoo()
#&nbsp;Actual&nbsp;call:&nbsp;callFoo('zort')</code></pre> The next assert is<code style="margin:0px; padding:0px">&nbsp;assert_called_once_with()</code>. Like&nbsp;<code style="margin:0px; padding:0px">assert_called_with()</code>, this assert checks if the test subject called a mocked method correctly. But<code style="margin:0px; padding:0px">assert_called_once_with()</code>&nbsp;will fire when the same method call happens more than once, whereas<code style="margin:0px; padding:0px">&nbsp;assert_called_with()</code>&nbsp;will ignore multiple calls. Listing Ten shows how one might use the assert. Here, I make two calls to the mocked method&nbsp;<code style="margin:0px; padding:0px">callFoo()</code>. On the first call (lines 19-20), the assert passes. But on the second call (lines 23-24), the assert fires, sending its error message to&nbsp;<code style="margin:0px; padding:0px">stdout</code>. Listing Ten <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;The&nbsp;mock&nbsp;object
class&nbsp;Foo(object):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;instance&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_fooValue&nbsp;=&nbsp;123
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;callFoo(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;doFoo(self,&nbsp;argValue):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

mockFoo.callFoo()
mockFoo.callFoo.assert_called_once_with()
#&nbsp;assertion&nbsp;passes

mockFoo.callFoo()
mockFoo.callFoo.assert_called_once_with()
#&nbsp;AssertionError:&nbsp;Expected&nbsp;to&nbsp;be&nbsp;called&nbsp;once.&nbsp;Called&nbsp;2&nbsp;times.</code></pre> The assert&nbsp;<code style="margin:0px; padding:0px">assert_any_call()</code>&nbsp;checks if the test subject called a mocked method at any point of the test routine. This is regardless of how many other calls were made between the mocked method and the assert. Compare this with the previous two asserts, both of which check only the most recent call. Listing Eleven shows the&nbsp;<code style="margin:0px; padding:0px">assert_any_call()</code>&nbsp;assert at work: still the same mock object, with class&nbsp;<code style="margin:0px; padding:0px">Foo</code>&nbsp;as its spec. The first call is to the method<code style="margin:0px; padding:0px">callFoo()</code>&nbsp;(line 18), the next two to&nbsp;<code style="margin:0px; padding:0px">doFoo()</code>&nbsp;(lines 19-20). Notice that<code style="margin:0px; padding:0px">doFoo()</code>&nbsp;gets two different inputs. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> Listing Nine显示了稍微不同的用法。在这个例子中，我调用了mock方法callFoo()，首先没有任何输入，然后输入了字符串“zort”。第一个断言通过了（第20行），因为callFoo()不支持获得任何输入。而第二个断言失败了（第24行）因为显而易见的原因。 Listing Nine <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;The&nbsp;mock&nbsp;object
class&nbsp;Foo(object):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;instance&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_fooValue&nbsp;=&nbsp;123
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;callFoo(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;doFoo(self,&nbsp;argValue):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

mockFoo.callFoo()
mockFoo.callFoo.assert_called_with()
#&nbsp;assertion&nbsp;passes

mockFoo.callFoo("zort")
mockFoo.callFoo.assert_called_with()
#&nbsp;AssertionError:&nbsp;Expected&nbsp;call:&nbsp;callFoo()
#&nbsp;Actual&nbsp;call:&nbsp;callFoo('zort')</code></pre> 先一个断言是assert_called_once_with()。像assert_called_with()一样，这个断言检查测试对象是否正确的调用了mock方法。但是当同样的方法调用超过一次时， assert_called_once_with（）将引发错误，然而assert_called_with()会忽略多次调用。Listing Ten显示了怎样使用这个断言。那儿，我调用了mock方法callFoo()两次。第一次调用时（行19~20），断言通过。但是在第二次调用的时（行23~24），断言失败，发送了错误消息到stdout。 Listing Ten <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;The&nbsp;mock&nbsp;object
class&nbsp;Foo(object):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;instance&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_fooValue&nbsp;=&nbsp;123
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;callFoo(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;doFoo(self,&nbsp;argValue):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

mockFoo.callFoo()
mockFoo.callFoo.assert_called_once_with()
#&nbsp;assertion&nbsp;passes

#&nbsp;The&nbsp;mock&nbsp;specification
class&nbsp;Foo(object):
&nbsp;&nbsp;&nbsp;&nbsp;_fooValue&nbsp;=&nbsp;123
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;callFoo(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;doFoo(self,&nbsp;argValue):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

mockFoo.callFoo()
mockFoo.doFoo("narf")
mockFoo.doFoo("zort")

mockFoo.callFoo.assert_any_call()
#&nbsp;assert&nbsp;passes

mockFoo.callFoo()
mockFoo.doFoo("troz")

mockFoo.doFoo.assert_any_call("zort")
#&nbsp;assert&nbsp;passes

mockFoo.doFoo.assert_any_call("egad")
#&nbsp;raises:&nbsp;AssertionError:&nbsp;doFoo('egad')&nbsp;call&nbsp;not&nbsp;found</code></pre> The first&nbsp;<code style="margin:0px; padding:0px">assert_any_call()</code>&nbsp;(line 22) passes even though two&nbsp;<code style="margin:0px; padding:0px">doFoo()</code>&nbsp;calls separate the assert and&nbsp;<code style="margin:0px; padding:0px">callFoo()</code>. The second assert (line 28) also passes even though a<code style="margin:0px; padding:0px">&nbsp;callFoo()</code>&nbsp;separates it from the&nbsp;<code style="margin:0px; padding:0px">doFoo()</code>&nbsp;in question (line 20). On the other hand, the third assert (line 31) fires, because none of the<code style="margin:0px; padding:0px">doFoo()</code>&nbsp;calls used the string&nbsp;<code style="margin:0px; padding:0px">"egad"</code>&nbsp;for input. Finally, there is&nbsp;<code style="margin:0px; padding:0px">assert_has_calls()</code>. This one looks at a sequence of method calls, checks if they are in the right order and with the right arguments. It takes two arguments: a list of expected method calls and an optional argument&nbsp;<code style="margin:0px; padding:0px">any_order</code>. It fires when the test subject calls the wrong method, calls one method out of order, or gives a method the wrong input. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> Listing Eleven <pre><code>&lt;from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

mockFoo.callFoo()
mockFoo.doFoo("narf")
mockFoo.doFoo("zort")

mockFoo.callFoo.assert_any_call()
#&nbsp;assert&nbsp;passes

mockFoo.callFoo()
mockFoo.doFoo("troz")

mockFoo.doFoo.assert_any_call("zort")
#&nbsp;assert&nbsp;passes

mockFoo.doFoo.assert_any_call("egad")
#&nbsp;raises:&nbsp;AssertionError:&nbsp;doFoo('egad')&nbsp;call&nbsp;not&nbsp;found</code></pre> 第一个assert_any_call()（第22行）通过，虽然两次doFoo()调用隔开了断言和callFoo()。第二个断言（第28行）也通过了，虽然一个callFoo()隔开了我们提到的doFoo()(第20行)。另一方面，第三个断言（第31行）失败了，因为没有任何doFoo()的调用使用了"egad"的输入。 最后，还有assert_has_calls（）。它查看方法调用的顺序，检查他们是否按正确的次序调用并带有正确的参数。它带有两个参数：期望调用方法的列表和一个可选悬殊any_order。当测试对象调用了错误的方法，调用了不在次序中的方法，或者方法获得了一个错误的输入，将生产断言错误。 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> Listing Twelve demonstrates the&nbsp;<code style="margin:0px; padding:0px">assert_has_calls()</code>&nbsp;assert. In lines 18-20, I make three method calls, providing input to two. Then, I prepare a list of expected calls (<code style="margin:0px; padding:0px">fooCalls</code>) and pass this list to&nbsp;<code style="margin:0px; padding:0px">assert_has_calls()</code>&nbsp;(lines 22-23). Since the list matches the method calls, the assert passes. Listing Twelve <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock,&nbsp;call

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

mockFoo.callFoo()
mockFoo.doFoo("narf")
mockFoo.doFoo("zort")

fooCalls&nbsp;=&nbsp;[call.callFoo(),&nbsp;call.doFoo("narf"),&nbsp;call.doFoo("zort")]
mockFoo.assert_has_calls(fooCalls)
#&nbsp;assert&nbsp;passes

fooCalls&nbsp;=&nbsp;[call.callFoo(),&nbsp;call.doFoo("zort"),&nbsp;call.doFoo("narf")]
mockFoo.assert_has_calls(fooCalls)
#&nbsp;AssertionError:&nbsp;Calls&nbsp;not&nbsp;found.
#&nbsp;Expected:&nbsp;[call.callFoo(),&nbsp;call.doFoo('zort'),&nbsp;call.doFoo('narf')]
#&nbsp;Actual:&nbsp;[call.callFoo(),&nbsp;call.doFoo('narf'),&nbsp;call.doFoo('zort')]

fooCalls&nbsp;=&nbsp;[call.callFoo(),&nbsp;call.doFoo("zort"),&nbsp;call.doFoo("narf")]
mockFoo.assert_has_calls(fooCalls,&nbsp;any_order&nbsp;=&nbsp;True)
#&nbsp;assert&nbsp;passes</code></pre> In line 26, I swapped the two&nbsp;<code style="margin:0px; padding:0px">doFoo()</code>&nbsp;calls around. The first&nbsp;<code style="margin:0px; padding:0px">doFoo()</code>&nbsp;gets &nbsp;<code style="margin:0px; padding:0px">"zort"</code>&nbsp;for input, the second gets&nbsp;<code style="margin:0px; padding:0px">"narf"</code>. If I pass this&nbsp;<code style="margin:0px; padding:0px">fooCalls</code>&nbsp;to<code style="margin:0px; padding:0px">assert_has_calls()</code>&nbsp;(line 27), the assert fires. But if I pass a&nbsp;<code style="margin:0px; padding:0px">True</code>&nbsp;to the<code style="margin:0px; padding:0px">any_order</code>&nbsp;argument, the assert passes. This is because the assert now ignores the order in which the method calls were made. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> Listing Twelve演示了assert_has_calls()断言。在18~20行，我调用了三个方法，提供了两个输入。然后，我准备了一个期望调用的列表（fooCalls）并把这个列表传入assert_has_calls()（22~23行）。由于列表匹配了方法的调用，断言通过。 Listing Twelve <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock,&nbsp;call

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

mockFoo.callFoo()
mockFoo.doFoo("narf")
mockFoo.doFoo("zort")

fooCalls&nbsp;=&nbsp;[call.callFoo(),&nbsp;call.doFoo("narf"),&nbsp;call.doFoo("zort")]
mockFoo.assert_has_calls(fooCalls)
#&nbsp;assert&nbsp;passes

fooCalls&nbsp;=&nbsp;[call.callFoo(),&nbsp;call.doFoo("zort"),&nbsp;call.doFoo("narf")]
mockFoo.assert_has_calls(fooCalls,&nbsp;any_order&nbsp;=&nbsp;True)
#&nbsp;assert&nbsp;passes</code></pre> 在第26行，我交换了两个doFoo()调用的顺序。第一个doFoo()获得"zort"的输入，第二个获得了"narf"。如果我传入这个fooCalls到assert_has_calls()（第27行）中，断言失败。但是如果我给参数any_order传入参数True，断言通过。这是因为断言将忽略方法调用的顺序。 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> Listing Thirteen demonstrates another use. To the list&nbsp;<code style="margin:0px; padding:0px">fooCalls</code>, I added a nonexistent method&nbsp;<code style="margin:0px; padding:0px">dooFoo()</code>&nbsp;(line 22). Then I passed&nbsp;<code style="margin:0px; padding:0px">fooCalls</code>&nbsp;to<code style="margin:0px; padding:0px">assert_has_calls(</code>) (line 24). The assert fires, informing me that the expected call sequence did not match what actually happened. If I pass a<code style="margin:0px; padding:0px">True</code>&nbsp;to the&nbsp;<code style="margin:0px; padding:0px">any_order</code>&nbsp;argument (line 30), the assert names&nbsp;<code style="margin:0px; padding:0px">dooFoo()</code>&nbsp;as the offending method call. Listing Thirteen <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock,&nbsp;call

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

mockFoo.callFoo()
mockFoo.doFoo("narf")
mockFoo.doFoo("zort")

fooCalls&nbsp;=&nbsp;[call.callFoo(),&nbsp;call.dooFoo("narf"),&nbsp;call.doFoo("zort")]

mockFoo.assert_has_calls(fooCalls)
#&nbsp;AssertionError:&nbsp;Calls&nbsp;not&nbsp;found.
#&nbsp;Expected:&nbsp;[call.callFoo(),&nbsp;call.dooFoo('narf'),&nbsp;call.doFoo('zort')]
#&nbsp;Actual:&nbsp;[call.callFoo(),&nbsp;call.doFoo('narf'),&nbsp;call.doFoo('zort')]

fooCalls&nbsp;=&nbsp;[call.callFoo(),&nbsp;call.dooFoo("narf"),&nbsp;call.doFoo("zort")]
mockFoo.assert_has_calls(fooCalls,&nbsp;any_order&nbsp;=&nbsp;True)
#&nbsp;AssertionError:&nbsp;(call.dooFoo('narf'),)&nbsp;not&nbsp;all&nbsp;found&nbsp;in&nbsp;call&nbsp;list</code></pre> In both examples for&nbsp;<code style="margin:0px; padding:0px">assert_has_calls()</code>, note the&nbsp;<code style="margin:0px; padding:0px">call</code>&nbsp;keyword that appears before each method name. This keyword is for a helper object, one that marks out a method attribute in the mock object. To use the&nbsp;<code style="margin:0px; padding:0px">call</code>keyword, make sure to import the helper from the mock module as follows: <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock,&nbsp;call</code></pre> </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> Listing Thirteen演示了其他的用法。在fooCalls列表中，我添加了不存在的方法dooFoo()（第22行）。然后我传入fooCalls到assert_has_calls()中（第24行）。断言失败，通知我期望调用的顺序和真实发生的顺序不匹配。如果我给any_order赋值为True（第30行），断言名称dooFoo()作为违规的方法调用。 Listing Thirteen <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock,&nbsp;call

#&nbsp;create&nbsp;the&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

mockFoo.callFoo()
mockFoo.doFoo("narf")
mockFoo.doFoo("zort")

fooCalls&nbsp;=&nbsp;[call.callFoo(),&nbsp;call.dooFoo("narf"),&nbsp;call.doFoo("zort")]

fooCalls&nbsp;=&nbsp;[call.callFoo(),&nbsp;call.dooFoo("narf"),&nbsp;call.doFoo("zort")]
mockFoo.assert_has_calls(fooCalls,&nbsp;any_order&nbsp;=&nbsp;True)
#&nbsp;AssertionError:&nbsp;(call.dooFoo('narf'),)&nbsp;not&nbsp;all&nbsp;found&nbsp;in&nbsp;call&nbsp;list</code></pre> 在assert_has_calls()的两个例子中，注意到关键字call是出现在每个方法的前面。这个关键字是一个helper对象，标记出mock对象的方法属性。为了使用call关键字，请确保使用如下的方法从mocke模块导入helper：&nbsp; <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock,&nbsp;call</code></pre> </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> <h3 style="margin:0px; padding:0px">Managing a Mock </h3> A third set of methods from the&nbsp;<code style="margin:0px; padding:0px">Mock</code>&nbsp;class allow you to control and manage your mock object. You can change how the mock behaves, alter some of its attributes, or restore the mock to its pre-test state. You can even change the response values for each mocked method or for the mock itself. The method&nbsp;<code style="margin:0px; padding:0px">attach_mock()</code>&nbsp;lets you add a second mock object to your mock. This method takes two arguments: the second mock object (<code style="margin:0px; padding:0px">aMock</code>) and an attribute name (<code style="margin:0px; padding:0px">aName</code>). Listing Fourteen demonstrates how this is done. Here, I create two mock objects,&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>&nbsp;and&nbsp;<code style="margin:0px; padding:0px">mockBar</code>, each one with a different spec (lines 25, 30). To&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>, I add&nbsp;<code style="margin:0px; padding:0px">mockBar</code>&nbsp;using &nbsp;<code style="margin:0px; padding:0px">attach_mock()</code>&nbsp;and &nbsp;the name "f<code style="margin:0px; padding:0px">ooBar</code>" (line 35). Once that is done, I can access the second mock and its attributes via the property&nbsp;<code style="margin:0px; padding:0px">fooBar</code>&nbsp;(lines 46-53). And I can still access the attributes for the first mock,&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>&nbsp;(lines 40-43). Listing Fourteen <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

class&nbsp;Bar(object):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;instance&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_barValue&nbsp;=&nbsp;456
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;callBar(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;doBar(self,&nbsp;argValue):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass

#&nbsp;create&nbsp;the&nbsp;first&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

#&nbsp;create&nbsp;the&nbsp;second&nbsp;mock&nbsp;object
mockBar&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Bar)
print&nbsp;mockBar
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;spec='Bar'&nbsp;id='2784400'&gt;

#&nbsp;attach&nbsp;the&nbsp;second&nbsp;mock&nbsp;to&nbsp;the&nbsp;first
mockFoo.attach_mock(mockBar,&nbsp;'fooBar')

#&nbsp;access&nbsp;the&nbsp;first&nbsp;mock's&nbsp;attributes
print&nbsp;mockFoo
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='495312'&gt;
print&nbsp;mockFoo._fooValue
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock._fooValue'&nbsp;id='428976'&gt;
print&nbsp;mockFoo.callFoo()
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.callFoo()'&nbsp;id='448144'&gt;

#&nbsp;access&nbsp;the&nbsp;second&nbsp;mock&nbsp;and&nbsp;its&nbsp;attributes
print&nbsp;mockFoo.fooBar
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.fooBar'&nbsp;spec='Bar'&nbsp;id='2788592'&gt;
print&nbsp;mockFoo.fooBar._barValue
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.fooBar._barValue'&nbsp;id='2788016'&gt;
print&nbsp;mockFoo.fooBar.callBar()
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.fooBar.callBar()'&nbsp;id='2819344'&gt;
print&nbsp;mockFoo.fooBar.doBar("narf")
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.fooBar.doBar()'&nbsp;id='4544528'&gt;</code></pre> The method&nbsp;<code style="margin:0px; padding:0px">configure_mock()</code>&nbsp;lets you make wholesale changes to the mock object. Its sole argument is a sequence of key/value pairs, each key being the attribute you want changed. If the mock does not have the specified attribute,&nbsp;<code style="margin:0px; padding:0px">configure_mock()</code>&nbsp;will add the attribute to the mock. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> <h3 style="margin:0px; padding:0px">管理Mock</h3> Mock类的第三套方法允许你控制和管理mock对象。你可以更改mock的行为，改变它的属性或者将mock恢复到测试前的状态。你甚至可以更改每个mock方法或者mock本身的响应值。attach_mock()方法让你在mock中添加第二个mock对象。这个方法带有两个参数：第二个mock对象(aMock)和一个属性名称(aName)。 Listing Fourteen 样式了attach_mock（）方法的使用。那儿，我创建了两个mock对象mockFoo和mockBar,他们有不同spec参数（第25行和第30行）。我用attach_mock()方法将mockBar添加到mockFoo中，命名为fooBar(第35行)。一旦添加成功，我就能通过property fooBar访问第二mock对象和它的属性（46~53行）。并且我仍然可以访问第一个mock对象mockFoo的属性。 Listing Fourteen <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;first&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

#&nbsp;create&nbsp;the&nbsp;second&nbsp;mock&nbsp;object
mockBar&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Bar)
print&nbsp;mockBar
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;spec='Bar'&nbsp;id='2784400'&gt;

#&nbsp;attach&nbsp;the&nbsp;second&nbsp;mock&nbsp;to&nbsp;the&nbsp;first
mockFoo.attach_mock(mockBar,&nbsp;'fooBar')

#&nbsp;access&nbsp;the&nbsp;second&nbsp;mock&nbsp;and&nbsp;its&nbsp;attributes
print&nbsp;mockFoo.fooBar
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.fooBar'&nbsp;spec='Bar'&nbsp;id='2788592'&gt;
print&nbsp;mockFoo.fooBar._barValue
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.fooBar._barValue'&nbsp;id='2788016'&gt;
print&nbsp;mockFoo.fooBar.callBar()
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.fooBar.callBar()'&nbsp;id='2819344'&gt;
print&nbsp;mockFoo.fooBar.doBar("narf")
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.fooBar.doBar()'&nbsp;id='4544528'&gt;</code></pre> configure_mock()方法让你批量的更改mock对象。它唯一的参数是一个键值对序列，每个键就是你想要修改的属性。如果你的对象没有指定的属性，configure_mock()将在mock中添加属性。&nbsp; </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> Listing Fifteen shows the&nbsp;<code style="margin:0px; padding:0px">configure_mock()</code>&nbsp;method in action. Once again, I have a mock object (<code style="margin:0px; padding:0px">mockFoo</code>) with class&nbsp;<code style="margin:0px; padding:0px">Foo</code>&nbsp;for a spec and&nbsp;<code style="margin:0px; padding:0px">555</code>&nbsp;for a<code style="margin:0px; padding:0px">return_value</code>&nbsp;(line 13). Then with&nbsp;<code style="margin:0px; padding:0px">configure_mock()</code>, I changed the<code style="margin:0px; padding:0px">return_value</code>&nbsp;property to&nbsp;<code style="margin:0px; padding:0px">999</code>&nbsp;(line 17). When I call&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>&nbsp;directly, I get&nbsp;<code style="margin:0px; padding:0px">999</code>for a result, instead of the original&nbsp;<code style="margin:0px; padding:0px">555</code>. Listing Fifteen <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

class&nbsp;Foo(object):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;instance&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_fooValue&nbsp;=&nbsp;123
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;callFoo(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Foo:callFoo_"
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;doFoo(self,&nbsp;argValue):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Foo:doFoo:input&nbsp;=&nbsp;",&nbsp;argValue

mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo,&nbsp;return_value&nbsp;=&nbsp;555)
print&nbsp;mockFoo()
#&nbsp;returns:&nbsp;555

mockFoo.configure_mock(return_value&nbsp;=&nbsp;999)
print&nbsp;mockFoo()
#&nbsp;returns:&nbsp;999

fooSpec&nbsp;=&nbsp;{'callFoo.return_value':"narf",&nbsp;'doFoo.return_value':"zort",&nbsp;'doFoo.side_effect':StandardError}
mockFoo.configure_mock(**fooSpec)

print&nbsp;mockFoo.callFoo()
#&nbsp;returns:&nbsp;narf
print&nbsp;mockFoo.doFoo("narf")
#&nbsp;raises:&nbsp;StandardError

fooSpec&nbsp;=&nbsp;{'doFoo.side_effect':None}
mockFoo.configure_mock(**fooSpec)
print&nbsp;mockFoo.doFoo("narf")
#&nbsp;returns:&nbsp;zort</code></pre> Next, I prepare a dictionary object (<code style="margin:0px; padding:0px">fooSpec</code>) into which I set the return values for two mocked methods and the side effect for&nbsp;<code style="margin:0px; padding:0px">doFoo()</code>&nbsp;(line 21). I pass&nbsp;<code style="margin:0px; padding:0px">fooSpec</code>&nbsp;into&nbsp;<code style="margin:0px; padding:0px">configure_mock()</code>, taking care to prefix&nbsp;<code style="margin:0px; padding:0px">fooSpec</code>&nbsp;with&nbsp;<code style="margin:0px; padding:0px">'**'</code>(line 22). Invoking&nbsp;<code style="margin:0px; padding:0px">callFoo()</code>&nbsp;now returns&nbsp;<code style="margin:0px; padding:0px">"narf"</code>&nbsp;as a result; and invoking<code style="margin:0px; padding:0px">doFoo()</code>, regardless of input, raises a&nbsp;<code style="margin:0px; padding:0px">StandardError</code>&nbsp;signal (lines 24-27). If I alter&nbsp;<code style="margin:0px; padding:0px">fooSpec</code>, setting the side-effect value for&nbsp;<code style="margin:0px; padding:0px">doFoo()</code>&nbsp;to&nbsp;<code style="margin:0px; padding:0px">None</code>, I get a result of&nbsp;<code style="margin:0px; padding:0px">"zort"</code>&nbsp;when invoking&nbsp;<code style="margin:0px; padding:0px">doFoo()</code>&nbsp;(lines 29-32). </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> Listing fifteen显示了configure_mock()方法的运用。再次，我定义了一个spec为类Foo和return_value为555的mock对象mockFoo（第13行）。然后使用configure_mock()方法更改return_value为999（第17行）。当我直接调用mockFoo时，获得的结果为999，替换了原来的555。 Listing Fifteen <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo,&nbsp;return_value&nbsp;=&nbsp;555)
print&nbsp;mockFoo()
#&nbsp;returns:&nbsp;555

mockFoo.configure_mock(return_value&nbsp;=&nbsp;999)
print&nbsp;mockFoo()
#&nbsp;returns:&nbsp;999

fooSpec&nbsp;=&nbsp;{'callFoo.return_value':"narf",&nbsp;'doFoo.return_value':"zort",&nbsp;'doFoo.side_effect':StandardError}
mockFoo.configure_mock(**fooSpec)

print&nbsp;mockFoo.callFoo()
#&nbsp;returns:&nbsp;narf
print&nbsp;mockFoo.doFoo("narf")
#&nbsp;raises:&nbsp;StandardError

fooSpec&nbsp;=&nbsp;{'doFoo.side_effect':None}
mockFoo.configure_mock(**fooSpec)
print&nbsp;mockFoo.doFoo("narf")
#&nbsp;returns:&nbsp;zort</code></pre> 接着，我准备了一个字段对象(fooSpec)，对两个mock方法设置了返回值，为doFoo()设置了side_effect（第21行）。我将fooSpec传入configure_mock()，注意fooSpec带有前缀'**'（第22行）。现在调用callFoo()结果返回“narf”。调用doFoo()，无论输入什么，引发StandardError&nbsp;信号（行24~27）。如果我修改了fooSpec，设置doFoo(）的side_effect的值为None,当我调用doFoo()时，将得到结果“zort”（29~32行）。 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> The next method,&nbsp;<code style="margin:0px; padding:0px">mock_add_spec()</code>, lets you add new attributes to the mock object. Its function is similar to the constructor argument spec, except<code style="margin:0px; padding:0px">mock_add_spec()</code>&nbsp;works on an existing object, and it "erases" those attributes set by the constructor. The method takes two arguments: the attribute spec (<code style="margin:0px; padding:0px">aSpec</code>) and a&nbsp;<code style="margin:0px; padding:0px">spec_set</code>&nbsp;flag (<code style="margin:0px; padding:0px">aFlag</code>). Again, the spec may be a list of strings or it may be a class. The added attributes are read-only by default, but passing a&nbsp;<code style="margin:0px; padding:0px">True</code>&nbsp;to the&nbsp;<code style="margin:0px; padding:0px">spec_set</code>&nbsp;flag make those same attributes writable. Listing Sixteen demonstrates&nbsp;<code style="margin:0px; padding:0px">mock_add_spec()</code>&nbsp;in action. The mock object (<code style="margin:0px; padding:0px">mockFoo</code>) starts with attributes coming from class&nbsp;<code style="margin:0px; padding:0px">Foo</code>&nbsp;(line 25). When I access two of the attributes (<code style="margin:0px; padding:0px">_fooValue</code>&nbsp;and&nbsp;<code style="margin:0px; padding:0px">callFoo()</code>), I get a result confirming their presence (lines 29-32) Listing Sixteen <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;
print&nbsp;mockFoo._fooValue
#&nbsp;returns&nbsp;&lt;Mock&nbsp;name='mock._fooValue'&nbsp;id='2788112'&gt;
print&nbsp;mockFoo.callFoo()
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.callFoo()'&nbsp;id='2815376'&gt;

#&nbsp;add&nbsp;a&nbsp;new&nbsp;spec&nbsp;attributes
mockFoo.mock_add_spec(Bar)

print&nbsp;mockFoo
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;spec='Bar'&nbsp;id='491088'&gt;
print&nbsp;mockFoo._barValue
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock._barValue'&nbsp;id='2815120'&gt;
print&nbsp;mockFoo.callBar()
#&nbsp;returns:&nbsp;&lt;Mock&nbsp;name='mock.callBar()'&nbsp;id='4544368'&gt;

#&nbsp;add&nbsp;a&nbsp;new&nbsp;spec&nbsp;attributes
mockFoo.mock_add_spec(Bar)

print&nbsp;mockFoo._fooValue
#&nbsp;raises:&nbsp;AttributeError:&nbsp;Mock&nbsp;object&nbsp;has&nbsp;no&nbsp;attribute&nbsp;'_fooValue'
print&nbsp;mockFoo.callFoo()
#&nbsp;raises:&nbsp;AttributeError:&nbsp;Mock&nbsp;object&nbsp;has&nbsp;no&nbsp;attribute&nbsp;'callFoo'</code></pre> 然后，我使用mock_add_spec()方法添加类Bar到mockFoo(第35行)。mock对象现在的属性已声明在类Bar中（39~42行）。如果我访问任何Foo属性，mock对象将引发AttributeError&nbsp;信号，表示他们不存在（44~47行）。 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> The last method,&nbsp;<code style="margin:0px; padding:0px">resetMock()</code>, puts the mock object back to its pre-test state. It clears the mock's call statistics and asserts. It does not clear the<code style="margin:0px; padding:0px">return_value</code>&nbsp;and&nbsp;<code style="margin:0px; padding:0px">side_effect</code>&nbsp;properties for both mock and its method attributes. Do this to reuse the mock and avoid the overhead of creating another mock. Finally, you can assign a return value or side-effect to each method attribute. This you do through the accessors&nbsp;<code style="margin:0px; padding:0px">return_value</code>&nbsp;and&nbsp;<code style="margin:0px; padding:0px">side_effect</code>. For example, to make the method&nbsp;<code style="margin:0px; padding:0px">callFoo()</code>&nbsp;return a value of "<code style="margin:0px; padding:0px">narf</code>", use the<code style="margin:0px; padding:0px">return_value</code>&nbsp;accessor as follows: <pre><code>mockFoo.callFoo.return_value&nbsp;=&nbsp;"narf"</code></pre> To give&nbsp;<code style="margin:0px; padding:0px">callFoo(</code>) the side-effect of&nbsp;<code style="margin:0px; padding:0px">TypeError</code>, use the&nbsp;<code style="margin:0px; padding:0px">side_effect</code>accessor as follows: <pre><code>mockFoo.callFoo.side_effect&nbsp;=&nbsp;TypeError</code></pre> To clear the side-effect, pass&nbsp;<code style="margin:0px; padding:0px">None</code>&nbsp;to the accessor: <pre><code>mockFoo.callFoo.side_effect&nbsp;=&nbsp;None</code></pre> You can also use the same two accessors to change how the mock object responds to a factory call. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> 最后一个方法resetMock()，恢复mock对象到测试前的状态。它清除了mock对象的调用统计和断言。它不会清除mock对象的return_value和side_effect属性和它的方法属性。这样做是为了重新使用mock对象避免重新创建mock的开销。 最后，你能给每个方法属性分配返回值或者side-effect。你能通过return_value和side_effect访问器做到这些。例如，按如下的语句通过return_value访问器设置方法callFoo()的返回值为"narf"： <pre><code>mockFoo.callFoo.return_value&nbsp;=&nbsp;"narf"</code></pre> 按如下的语句通过side_effect访问器 设置方法callFoo()的side-ffect为TypeError <pre><code>mockFoo.callFoo.side_effect&nbsp;=&nbsp;TypeError</code></pre> 传入None清除side-effect <pre><code>mockFoo.callFoo.side_effect&nbsp;=&nbsp;None</code></pre> 你也可以用这个两个相同的访问器改变mock对象对工厂调用的响应值。&nbsp; </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> <h3 style="margin:0px; padding:0px">Statistics with a Mock </h3> The last set of methods consists of accessors that track any calls made to a mock object. The accessor called returns a&nbsp;<code style="margin:0px; padding:0px">True</code>&nbsp;when the mock gets a factory call,&nbsp;<code style="margin:0px; padding:0px">False</code>&nbsp;&nbsp;otherwise. Consider the code in Listing Seventeen. After I create&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>, the called accessor returns a&nbsp;<code style="margin:0px; padding:0px">False</code>&nbsp;result (lines 19-20). If I do a factory call, it returns a&nbsp;<code style="margin:0px; padding:0px">True</code>&nbsp;result (lines 22-23). But what if I create a second mock object, then invoke a mocked method (<code style="margin:0px; padding:0px">callFoo()</code>, line 30)? In that case, the called accessor will only give a&nbsp;<code style="margin:0px; padding:0px">False</code>&nbsp;result (lines 31-32). Listing Seventeen <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;first&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

print&nbsp;mockFoo.called
#&nbsp;returns:&nbsp;False

mockFoo()
print&nbsp;mockFoo.called
#&nbsp;returns:&nbsp;True

mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo.called
#&nbsp;returns:&nbsp;False

mockFoo.callFoo()
print&nbsp;mockFoo.called
#&nbsp;returns:&nbsp;False</code></pre> The accessor&nbsp;<code style="margin:0px; padding:0px">call_count</code>&nbsp;gives the number of times a mock object gets a factory call. Consider the code in Listing Eighteen. After I create&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>,<code style="margin:0px; padding:0px">call_count</code>&nbsp;gives the expected result of&nbsp;<code style="margin:0px; padding:0px">0</code>&nbsp;(lines 19-20). When I make a factory call to&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>,&nbsp;<code style="margin:0px; padding:0px">call_count</code>&nbsp;increases by 1 (lines 22-24). When I invoke the mocked method&nbsp;<code style="margin:0px; padding:0px">callFoo()</code>,&nbsp;<code style="margin:0px; padding:0px">call_count</code>&nbsp;remains unchanged (lines 26-28). If I do a second factory call,&nbsp;<code style="margin:0px; padding:0px">call_count</code>&nbsp;should increase by 1 more. Listing Eighteen <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;first&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

print&nbsp;mockFoo.call_count
#&nbsp;returns:&nbsp;0

mockFoo()
print&nbsp;mockFoo.call_count
#&nbsp;returns:&nbsp;1

mockFoo.callFoo()
print&nbsp;mockFoo.call_count
#&nbsp;returns:&nbsp;1</code></pre> </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> <h3 style="margin:0px; padding:0px">Mock统计</h3> 最后一套方法包含跟踪mock对象所做的任意调用的访问器。当mock对象获得工厂调用时，访问器called返回True，否则返回False。查看Listing Seventeen中的代码，我创建了mockFoo之后，called访问器返回了结果False(19~20行)。如果我做了一个工厂调用，它将返回结果True(22~23行)。但是如果我创建了第二个mock对象，然后调用了mock方法callFoo()（第30行）?在这个例子中，called访问器仅仅放回了False结果（31~32行）。 Listing Seventeen <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;first&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

print&nbsp;mockFoo.called
#&nbsp;returns:&nbsp;False

mockFoo()
print&nbsp;mockFoo.called
#&nbsp;returns:&nbsp;True

mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo.called
#&nbsp;returns:&nbsp;False

mockFoo.callFoo()
print&nbsp;mockFoo.called
#&nbsp;returns:&nbsp;False</code></pre> 访问器call_count给出了mock对象被工厂调用的次数。查看Listing Eighteen中的代码。我创建mockFoo之后，call_count给出的期望结果为0(19~20行)。当我对mockFoo做了一个工厂调用时，call_count增加1（22~24行）。当我调用mock方法callFoo()时，call_count没有改变（26~28行）。如果我做了第二次工厂调用call_count将再增加1。 Listing Eighteen <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;first&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo)
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;

print&nbsp;mockFoo.call_count
#&nbsp;returns:&nbsp;0

mockFoo()
print&nbsp;mockFoo.call_count
#&nbsp;returns:&nbsp;1

mockFoo.callFoo()
print&nbsp;mockFoo.call_count
#&nbsp;returns:&nbsp;1</code></pre> </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> The accessor&nbsp;<code style="margin:0px; padding:0px">call_args</code>&nbsp;returns the arguments used in a factory call. Listing Nineteen demonstrates its action. For a newly created mock object (<code style="margin:0px; padding:0px">mockFoo</code>), the&nbsp;<code style="margin:0px; padding:0px">call_args</code>&nbsp;accessor gives a result of&nbsp;<code style="margin:0px; padding:0px">None</code>&nbsp;(lines 17-21). If I make a factory call, passing&nbsp;<code style="margin:0px; padding:0px">"zort"</code>&nbsp;for input,&nbsp;<code style="margin:0px; padding:0px">call_args</code>&nbsp;reports it as<code style="margin:0px; padding:0px">"call('zort')"</code>&nbsp;(line 23-25). Note the&nbsp;<code style="margin:0px; padding:0px">call</code>&nbsp;keyword in the result. For a second factory call, without input,&nbsp;<code style="margin:0px; padding:0px">call_args</code>&nbsp;returns&nbsp;<code style="margin:0px; padding:0px">"call()"</code>&nbsp;(lines 27-29). A third factory call, with&nbsp;<code style="margin:0px; padding:0px">"troz"</code>&nbsp;for input, gives the result&nbsp;<code style="margin:0px; padding:0px">"call('troz')"</code>from&nbsp;<code style="margin:0px; padding:0px">call_args</code>&nbsp;(lines 31-33). But when I invoke the mocked method<code style="margin:0px; padding:0px">callFoo()</code>, the&nbsp;<code style="margin:0px; padding:0px">call_args</code>&nbsp;accessor still returns&nbsp;<code style="margin:0px; padding:0px">"call('troz')"</code>&nbsp;(lines 35-37). Listing Nineteen <pre><code>#!/usr/bin/python

from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;first&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo,&nbsp;return_value&nbsp;=&nbsp;"narf")
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;
print&nbsp;mockFoo.call_args
#&nbsp;returns:&nbsp;None

mockFoo("zort")
print&nbsp;mockFoo.call_args
#&nbsp;returns:&nbsp;call('zort')

mockFoo()
print&nbsp;mockFoo.call_args
#&nbsp;returns:&nbsp;call()

mockFoo("troz")
print&nbsp;mockFoo.call_args
#&nbsp;returns:&nbsp;call('troz')

mockFoo.callFoo()
print&nbsp;mockFoo.call_args
#&nbsp;returns:&nbsp;call('troz')</code></pre> The accessor&nbsp;<code style="margin:0px; padding:0px">call_args_list</code>&nbsp;also reports the arguments used in a factory call. But while&nbsp;<code style="margin:0px; padding:0px">call_args</code>&nbsp;returns the most recent arguments,<code style="margin:0px; padding:0px">call_args_list</code>&nbsp;returns a list, with the first item being the earliest argument. Listing Twenty shows the accessor in action, using the same code in Listing Nineteen. </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> 访问器call_args返回工厂调用已用的参数。Listing Nineteen演示了它的运用。对于新创建的mock对象(mockFoo)，call_args访问器返回结果为None(17~21行)。如果我做了一个工厂调用，在输入中传入"zort"，call_args报告的结果为call('zort')（23~25行）。注意结果中的call关键字。对于第二个没有输入的工厂调用，call_args返回call()（27~29行）。第三个工厂调用，输入“troz”，call_args给出结果为call('troz')（31~33行）。但是当我调用mock方法callFoo()时，call_args访问器仍然返回call('troz')（35~37行）。 Listing Nineteen <pre><code>#!/usr/bin/python

from&nbsp;mock&nbsp;import&nbsp;Mock

mockFoo("zort")
print&nbsp;mockFoo.call_args
#&nbsp;returns:&nbsp;call('zort')

mockFoo()
print&nbsp;mockFoo.call_args
#&nbsp;returns:&nbsp;call()

mockFoo("troz")
print&nbsp;mockFoo.call_args
#&nbsp;returns:&nbsp;call('troz')

mockFoo.callFoo()
print&nbsp;mockFoo.call_args
#&nbsp;returns:&nbsp;call('troz')</code></pre> 访问器call_args_list 也报告了工厂调用中已使用的参数。但是call_args返回最近使用的参数，而call_args_list返回一个列表，第一项为最早的参数。Listing Twenty显示了这个访问的的运用，使用了和Listing Nineteen相同的代码。 </td> 
 </tr> 
 </tbody> 
</table>

mockFoo("zort")
print&nbsp;mockFoo.call_args_list
#&nbsp;returns:&nbsp;[call('zort')]

mockFoo()
print&nbsp;mockFoo.call_args_list
#&nbsp;returns:&nbsp;[call('zort'),&nbsp;call()]

mockFoo("troz")
print&nbsp;mockFoo.call_args_list
#&nbsp;returns:&nbsp;[call('zort'),&nbsp;call(),&nbsp;call('troz')]

mockFoo.callFoo()
print&nbsp;mockFoo.call_args_list
#&nbsp;returns:&nbsp;[call('zort'),&nbsp;call(),&nbsp;call('troz')]</code></pre> The accessor&nbsp;<code style="margin:0px; padding:0px">method_calls</code>&nbsp;reports the mocked method calls made by the test subject. Its result is a list object, each item showing the method name and its arguments. Listing Twenty-one demonstrates&nbsp;<code style="margin:0px; padding:0px">method_calls</code>&nbsp;in action. With a newly created&nbsp;<code style="margin:0px; padding:0px">mockFoo</code>,&nbsp;<code style="margin:0px; padding:0px">method_calls</code>&nbsp;returns an empty list (lines 15-19). The same also happens when I do a factory call (lines 21-23). When I invoke the mocked method&nbsp;<code style="margin:0px; padding:0px">callFoo()</code>,&nbsp;<code style="margin:0px; padding:0px">method_calls</code>&nbsp;returns a list object with one entry (lines 25-27). When I invoke&nbsp;<code style="margin:0px; padding:0px">doFoo()</code>, passing&nbsp;<code style="margin:0px; padding:0px">"narf"</code>&nbsp;for input,&nbsp;<code style="margin:0px; padding:0px">method_calls</code>returns a list with two items (lines 29-31). Notice how each method name appears in the order of its invocation. Listing Twenty-one <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

#&nbsp;create&nbsp;the&nbsp;first&nbsp;mock&nbsp;object
mockFoo&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Foo,&nbsp;return_value&nbsp;=&nbsp;"poink")
print&nbsp;mockFoo
#&nbsp;returns&nbsp;&lt;Mock&nbsp;spec='Foo'&nbsp;id='507120'&gt;
print&nbsp;mockFoo.method_calls
#&nbsp;returns&nbsp;[]

mockFoo()
print&nbsp;mockFoo.method_calls
#&nbsp;returns&nbsp;[]

mockFoo.callFoo()
print&nbsp;mockFoo.method_calls
#&nbsp;returns:&nbsp;[call.callFoo()]

mockFoo.doFoo("narf")
print&nbsp;mockFoo.method_calls
#&nbsp;returns:&nbsp;[call.callFoo(),&nbsp;call.doFoo('narf')]

mockFoo()
print&nbsp;mockFoo.method_calls
#&nbsp;returns:&nbsp;[call.callFoo(),&nbsp;call.doFoo('narf')]</code></pre> The last accessor&nbsp;<code style="margin:0px; padding:0px">mock_calls</code>&nbsp;reports all calls made by the test subject to the mock object. The result is again a list, but now showing both factory and method calls. Listing Twenty-two demonstrates the accessor in action, using the same code in Listing Twenty-one. Listing Twenty-two <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

print&nbsp;mockFoo.mock_calls
#&nbsp;returns&nbsp;[]

mockFoo()
print&nbsp;mockFoo.mock_calls
#&nbsp;returns&nbsp;[call()]

mockFoo.callFoo()&gt;
print&nbsp;mockFoo.mock_calls
#&nbsp;returns:&nbsp;[call(),&nbsp;call.callFoo()]

mockFoo.doFoo("narf")
print&nbsp;mockFoo.mock_calls
#&nbsp;returns:&nbsp;[call(),&nbsp;call.callFoo(),&nbsp;call.doFoo('narf')]

mockFoo()
print&nbsp;mockFoo.mock_calls
#&nbsp;returns:&nbsp;[call(),&nbsp;call.callFoo(),&nbsp;call.doFoo('narf'),&nbsp;call()]</code></pre> </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> Listing Twenty <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

mockFoo("zort")
print&nbsp;mockFoo.call_args_list
#&nbsp;returns:&nbsp;[call('zort')]

mockFoo()
print&nbsp;mockFoo.call_args_list
#&nbsp;returns:&nbsp;[call('zort'),&nbsp;call()]

mockFoo("troz")
print&nbsp;mockFoo.call_args_list
#&nbsp;returns:&nbsp;[call('zort'),&nbsp;call(),&nbsp;call('troz')]

mockFoo.callFoo()
print&nbsp;mockFoo.call_args_list
#&nbsp;returns:&nbsp;[call('zort'),&nbsp;call(),&nbsp;call('troz')]</code></pre> 访问器mothod_calls报告了测试对象所做的mock方法的调用。它的结果是一个列表对象，每一项显示了方法的名称和它的参数。 Listing Twenty-one演示了method_calls的运用。对新创建的mockFoo，method_calls返回了空列表（15~19行）。当做了工厂调用时，同样返回空列表（21~23行）。当我调用了mock方法callFoo()时，method_calls返回一个带一项数据的列表对象（25~27行）。当我调用doFoo()，并传入"narf"参数时，method_calls返回带有两项数据的列表（29~31行）。注意每个方法名称是按照它调用的顺序显示的。 Listing Twenty-one <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

mockFoo()
print&nbsp;mockFoo.method_calls
#&nbsp;returns&nbsp;[]

mockFoo.callFoo()
print&nbsp;mockFoo.method_calls
#&nbsp;returns:&nbsp;[call.callFoo()]

mockFoo.doFoo("narf")
print&nbsp;mockFoo.method_calls
#&nbsp;returns:&nbsp;[call.callFoo(),&nbsp;call.doFoo('narf')]

mockFoo()
print&nbsp;mockFoo.method_calls
#&nbsp;returns:&nbsp;[call.callFoo(),&nbsp;call.doFoo('narf')]</code></pre> 最后一个访问器mock_calls报告了测试对象对mock对象所有的调用。结果是一个列表，但是工厂调用和方法调用都显示了。Listing Twenty-two演示这个访问器的运用，使用了和Listing Twenty-one相同的代码 Listing Twenty-two <pre><code>from&nbsp;mock&nbsp;import&nbsp;Mock

print&nbsp;mockFoo.mock_calls
#&nbsp;returns&nbsp;[]

mockFoo()
print&nbsp;mockFoo.mock_calls
#&nbsp;returns&nbsp;[call()]

mockFoo.callFoo()&gt;
print&nbsp;mockFoo.mock_calls
#&nbsp;returns:&nbsp;[call(),&nbsp;call.callFoo()]

mockFoo.doFoo("narf")
print&nbsp;mockFoo.mock_calls
#&nbsp;returns:&nbsp;[call(),&nbsp;call.callFoo(),&nbsp;call.doFoo('narf')]

mockFoo()
print&nbsp;mockFoo.mock_calls
#&nbsp;returns:&nbsp;[call(),&nbsp;call.callFoo(),&nbsp;call.doFoo('narf'),&nbsp;call()]</code></pre> </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> <h3 style="margin:0px; padding:0px">Testing with a Mock </h3> Data type, model, or node &amp;#151; these are just some of the roles a mock object might assume. But how does a mock fit inside a unit test setup? Let us take a look, using a simplified setup taken from the Martin Fowler article<a href="http://martinfowler.com/articles/mocksArentStubs.html" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Mocks Aren't Stubs</a>. In the test setup are three classes (Figure 4). The&nbsp;<code style="margin:0px; padding:0px">Order</code>&nbsp;class is the test subject. It models a single item purchase order, which it fills from a data source. The&nbsp;<code style="margin:0px; padding:0px">Warehouse</code>&nbsp;class is the test resource. It contains a sequence of key/value pairs, the key being the item name, the value being the available quantity. And the&nbsp;<code style="margin:0px; padding:0px">OrderTest</code>&nbsp;class is the test case itself. <img src="http://static.oschina.net/uploads/img/201405/27065227_RYxv.gif" alt="Python" title="Python" width="450" style="margin:0px; padding:0px; border:0px"> Figure 4. Listing Twenty-three describes the&nbsp;<code style="margin:0px; padding:0px">Order</code>&nbsp;class. The class declares three properties: the item name (<code style="margin:0px; padding:0px">_orderItem</code>), the requested quantity (<code style="margin:0px; padding:0px">_orderAmount</code>) and the filled quantity (<code style="margin:0px; padding:0px">_orderFilled</code>). Its constructor takes two arguments (lines 8-18), which it uses to populate the properties<code style="margin:0px; padding:0px">_orderItem</code>&nbsp;and&nbsp;<code style="margin:0px; padding:0px">_orderAmount</code>. Its&nbsp;<code style="margin:0px; padding:0px">__repr__()</code>&nbsp;method returns a summary of the purchase order (lines 21-24). Listing Twenty-three <pre><code>class&nbsp;Order(object):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;instance&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_orderItem&nbsp;=&nbsp;"None"
&nbsp;&nbsp;&nbsp;&nbsp;_orderAmount&nbsp;=&nbsp;0
&nbsp;&nbsp;&nbsp;&nbsp;_orderFilled&nbsp;=&nbsp;-1
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Constructor
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;__init__(self,&nbsp;argItem,&nbsp;argAmount):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Order:__init__"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;set&nbsp;the&nbsp;order&nbsp;item
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(isinstance(argItem,&nbsp;str)):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(len(argItem)&nbsp;&gt;&nbsp;0):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self._orderItem&nbsp;=&nbsp;argItem
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;set&nbsp;the&nbsp;order&nbsp;amount
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(argAmount&nbsp;&gt;&nbsp;0):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self._orderAmount&nbsp;=&nbsp;argAmount
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Magic&nbsp;methods
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;__repr__(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;assemble&nbsp;the&nbsp;dictionary
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;locOrder&nbsp;=&nbsp;{'item':self._orderItem,&nbsp;'amount':self._orderAmount}
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;repr(locOrder)
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Instance&nbsp;methods
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;attempt&nbsp;to&nbsp;fill&nbsp;the&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;fill(self,&nbsp;argSrc):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Order:fill_"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;try:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;does&nbsp;the&nbsp;warehouse&nbsp;has&nbsp;the&nbsp;item&nbsp;in&nbsp;stock?
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(argSrc&nbsp;is&nbsp;not&nbsp;None):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(argSrc.hasInventory(self._orderItem)):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;get&nbsp;the&nbsp;item
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;locCount&nbsp;=&nbsp;&nbsp;&nbsp;&nbsp;argSrc.getInventory(self._orderItem,&nbsp;self._orderAmount)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;update&nbsp;the&nbsp;following&nbsp;property
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self._orderFilled&nbsp;=&nbsp;locCount
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Inventory&nbsp;item&nbsp;not&nbsp;available"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Warehouse&nbsp;not&nbsp;available"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;except&nbsp;TypeError:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Invalid&nbsp;warehouse"
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;check&nbsp;if&nbsp;the&nbsp;order&nbsp;has&nbsp;been&nbsp;filled
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;isFilled(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Order:isFilled_"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;(self._orderAmount&nbsp;==&nbsp;self._orderFilled)</code></pre> The&nbsp;<code style="margin:0px; padding:0px">Order</code>&nbsp;class defines two instance methods. The&nbsp;<code style="margin:0px; padding:0px">fill(</code>) method gets a data source (<code style="margin:0px; padding:0px">argSrc</code>) for an argument. It checks if the source is valid and if it has the item in question (line 33-34). It submits a withdrawal request and updates&nbsp;<code style="margin:0px; padding:0px">_orderFilled</code>&nbsp;with the actual quantity withdrawn (lines 36-39). The<code style="margin:0px; padding:0px">isFilled()</code>&nbsp;method returns a&nbsp;<code style="margin:0px; padding:0px">True</code>&nbsp;when both&nbsp;<code style="margin:0px; padding:0px">_orderAmount</code>&nbsp;and<code style="margin:0px; padding:0px">_orderFilled</code>&nbsp;have the same values (lines 48-50). </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> <h3 style="margin:0px; padding:0px">在测试中使用MOCK</h3> 数据类型，模型或者节点，这些是mock对象可能被假定的一些角色。但是mock对象怎样适合单元测试呢？让我们一起来看看，来自Martin Fowler的文章<a href="http://martinfowler.com/articles/mocksArentStubs.html" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Mocks Aren't Stubs</a>采取了简化的设置。 在这个测试中，设置了三个类（图4）。Order类是测试对象。它模拟了单一项目的采购订单，订单来源于一个数据源。Warehouse类是测试资源。它包含了键值对的序列，键是项目的名称，值是可用的数量。OrderTest类是测试用例本身。 <img src="http://static.oschina.net/uploads/img/201405/27065227_RYxv.gif" alt="Python" style="margin:0px; padding:0px; border:0px"> 图4 Listing Twenty-three描述了Order。Order类声明了三个属性:项目名称（_orderItem），要求的数量（_orderAmount）和已填写的数量(_orderFilled)。它的构造器带有两个参数（8~18行），填入的属性是_orderItem和_orderAmount。它的__repr__()方法返回了购买清单的摘要(21~24行)。 Listing Twenty-three <pre><code>class&nbsp;Order(object):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;instance&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_orderItem&nbsp;=&nbsp;"None"
&nbsp;&nbsp;&nbsp;&nbsp;_orderAmount&nbsp;=&nbsp;0
&nbsp;&nbsp;&nbsp;&nbsp;_orderFilled&nbsp;=&nbsp;-1
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Constructor
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;__init__(self,&nbsp;argItem,&nbsp;argAmount):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Order:__init__"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;set&nbsp;the&nbsp;order&nbsp;item
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(isinstance(argItem,&nbsp;str)):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(len(argItem)&nbsp;&gt;&nbsp;0):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self._orderItem&nbsp;=&nbsp;argItem
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;set&nbsp;the&nbsp;order&nbsp;amount
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(argAmount&nbsp;&gt;&nbsp;0):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self._orderAmount&nbsp;=&nbsp;argAmount
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Magic&nbsp;methods
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;__repr__(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;assemble&nbsp;the&nbsp;dictionary
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;locOrder&nbsp;=&nbsp;{'item':self._orderItem,&nbsp;'amount':self._orderAmount}
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;repr(locOrder)
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Instance&nbsp;methods
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;attempt&nbsp;to&nbsp;fill&nbsp;the&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;fill(self,&nbsp;argSrc):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Order:fill_"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;try:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;does&nbsp;the&nbsp;warehouse&nbsp;has&nbsp;the&nbsp;item&nbsp;in&nbsp;stock?
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(argSrc&nbsp;is&nbsp;not&nbsp;None):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(argSrc.hasInventory(self._orderItem)):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;get&nbsp;the&nbsp;item
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;locCount&nbsp;=&nbsp;&nbsp;&nbsp;&nbsp;argSrc.getInventory(self._orderItem,&nbsp;self._orderAmount)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;update&nbsp;the&nbsp;following&nbsp;property
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self._orderFilled&nbsp;=&nbsp;locCount
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Inventory&nbsp;item&nbsp;not&nbsp;available"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Warehouse&nbsp;not&nbsp;available"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;except&nbsp;TypeError:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Invalid&nbsp;warehouse"
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;check&nbsp;if&nbsp;the&nbsp;order&nbsp;has&nbsp;been&nbsp;filled
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;isFilled(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Order:isFilled_"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;(self._orderAmount&nbsp;==&nbsp;self._orderFilled)</code></pre> Order类定义了两个实例方法。fill()方法从参数(argSrc)中获取数据源。它检查数据源是否可用，数据源的项目是否存在问题（33~34行）。它提交了一个申请并用实际返回的数量更新_orderFilled（36~39行）。当_orderAmount和_orderFilled有相同的值时，isFilled()方法返回True(48~50行)。 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> Listing Twenty-four describes the&nbsp;<code style="margin:0px; padding:0px">Warehouse</code>&nbsp;class. It is an abstract class, declaring properties and method interfaces, but not defining the methods themselves. The property&nbsp;<code style="margin:0px; padding:0px">_houseName</code>&nbsp;holds the warehouse's name, while<code style="margin:0px; padding:0px">_houseList</code>&nbsp;holds its inventory. Accessors exists for these two properties. Listing Twenty-four <pre><code>class&nbsp;Warehouse(object):&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;private&nbsp;properties
&nbsp;&nbsp;&nbsp;&nbsp;_houseName&nbsp;=&nbsp;None
&nbsp;&nbsp;&nbsp;&nbsp;_houseList&nbsp;=&nbsp;None
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;accessors
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;warehouseName(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;(self._houseName)
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;inventory(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;(self._houseList)
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;--&nbsp;INVENTORY&nbsp;ACTIONS
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;set&nbsp;up&nbsp;the&nbsp;warehouse
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;setup(self,&nbsp;argName,&nbsp;argList):
&nbsp;&nbsp;&nbsp;&nbsp;&amp;#9;pass
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;check&nbsp;for&nbsp;an&nbsp;inventory&nbsp;item
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;hasInventory(self,&nbsp;argItem):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;retrieve&nbsp;an&nbsp;inventory&nbsp;item
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;getInventory(self,&nbsp;argItem,&nbsp;argCount):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;add&nbsp;an&nbsp;inventory&nbsp;item
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;addInventory(self,&nbsp;argItem,&nbsp;argCount):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass</code></pre> The class declares four method interfaces. The method&nbsp;<code style="margin:0px; padding:0px">setup()</code>&nbsp;takes two arguments, which are meant to update the two properties. The method<code style="margin:0px; padding:0px">hasInventory()</code>&nbsp;gets an item name and returns a&nbsp;<code style="margin:0px; padding:0px">True</code>&nbsp;if said item is in the inventory. The method&nbsp;<code style="margin:0px; padding:0px">getInventory()</code>&nbsp;gets an item name and quantity. It tries to deduct that quantity from the inventory, and returns what was deducted successfully. The method&nbsp;<code style="margin:0px; padding:0px">addInventory()</code>&nbsp;also gets an item name and quantity. It is suppose to update&nbsp;<code style="margin:0px; padding:0px">_houseList</code>&nbsp;with those two arguments. In Listing Twenty-five is the test case itself,&nbsp;<code style="margin:0px; padding:0px">OrderTest</code>. Its one property,<code style="margin:0px; padding:0px">fooSource</code>, holds the mock object needed by the&nbsp;<code style="margin:0px; padding:0px">Order</code>&nbsp;class. The&nbsp;<code style="margin:0px; padding:0px">setUp()</code>method identifies the test routine to be executed (lines 14-16), then creates and configures the mock object (lines 21-34). And the&nbsp;<code style="margin:0px; padding:0px">tearDown()</code>&nbsp;method prints an empty line to&nbsp;<code style="margin:0px; padding:0px">stdout</code>. Listing Twenty-five <pre><code>import&nbsp;unittest
from&nbsp;mock&nbsp;import&nbsp;Mock,&nbsp;call

class&nbsp;OrderTest(unittest.TestCase):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;declare&nbsp;the&nbsp;test&nbsp;resource
&nbsp;&nbsp;&nbsp;&nbsp;fooSource&nbsp;=&nbsp;None
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;preparing&nbsp;to&nbsp;test
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;setUp(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"""&nbsp;Setting&nbsp;up&nbsp;for&nbsp;the&nbsp;test&nbsp;"""
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"OrderTest:setUp_:begin"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;identify&nbsp;the&nbsp;test&nbsp;routine
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testName&nbsp;=&nbsp;self.id().split(".")
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testName&nbsp;=&nbsp;testName[2]
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;testName
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;prepare&nbsp;and&nbsp;configure&nbsp;the&nbsp;test&nbsp;resource
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(testName&nbsp;==&nbsp;"testA_newOrder"):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"OrderTest:setup_:testA_newOrder:RESERVED"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;elif&nbsp;(testName&nbsp;==&nbsp;"testB_nilInventory"):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Warehouse,&nbsp;return_value&nbsp;=&nbsp;None)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;elif&nbsp;(testName&nbsp;==&nbsp;"testC_orderCheck"):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Warehouse)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.return_value&nbsp;=&nbsp;True
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.getInventory.return_value&nbsp;=&nbsp;0
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;elif&nbsp;(testName&nbsp;==&nbsp;"testD_orderFilled"):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Warehouse)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.return_value&nbsp;=&nbsp;True
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.getInventory.return_value&nbsp;=&nbsp;10
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;elif&nbsp;(testName&nbsp;==&nbsp;"testE_orderIncomplete"):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource&nbsp;=&nbsp;Mock(spec&nbsp;=&nbsp;Warehouse)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.return_value&nbsp;=&nbsp;True
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.getInventory.return_value&nbsp;=&nbsp;5
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"UNSUPPORTED&nbsp;TEST&nbsp;ROUTINE"
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;ending&nbsp;the&nbsp;test
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;tearDown(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"""Cleaning&nbsp;up&nbsp;after&nbsp;the&nbsp;test"""
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"OrderTest:tearDown_:begin"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;""
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;test:&nbsp;new&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;objective:&nbsp;creating&nbsp;an&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;testA_newOrder(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;creating&nbsp;a&nbsp;new&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder&nbsp;=&nbsp;Order("mushrooms",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;repr(testOrder)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;test&nbsp;for&nbsp;a&nbsp;nil&nbsp;object
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertIsNotNone(testOrder,&nbsp;"Order&nbsp;object&nbsp;is&nbsp;a&nbsp;nil.")
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;test&nbsp;for&nbsp;a&nbsp;valid&nbsp;item&nbsp;name
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testName&nbsp;=&nbsp;testOrder._orderItem
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertEqual(testName,&nbsp;"mushrooms",&nbsp;"Invalid&nbsp;item&nbsp;name")
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;test&nbsp;for&nbsp;a&nbsp;valid&nbsp;item&nbsp;amount
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testAmount&nbsp;=&nbsp;testOrder._orderAmount
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertGreater(testAmount,&nbsp;0,&nbsp;"Invalid&nbsp;item&nbsp;amount")
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;test:&nbsp;nil&nbsp;inventory
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;objective:&nbsp;how&nbsp;the&nbsp;order&nbsp;object&nbsp;handles&nbsp;a&nbsp;nil&nbsp;inventory
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;testB_nilInventory(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"""Test&nbsp;routine&nbsp;B"""
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;creating&nbsp;a&nbsp;new&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder&nbsp;=&nbsp;Order("mushrooms",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;repr(testOrder)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;fill&nbsp;the&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testSource&nbsp;=&nbsp;self.fooSource()
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder.fill(testSource)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;print&nbsp;the&nbsp;mocked&nbsp;calls
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;self.fooSource.mock_calls
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;check&nbsp;the&nbsp;call&nbsp;history
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testCalls&nbsp;=&nbsp;[call()]
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.assert_has_calls(testCalls)
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;...&nbsp;continued&nbsp;in&nbsp;the&nbsp;next&nbsp;listing</code></pre> OrderTest类有五个测试例程。所有五个测试例程在开始的时候都创建了一个Order类的实例。例程testA_newOrder()测试Order对象是否可用是否有正确的数据（46~60行）。例程testB_nilWarehouse()创建了一个空的mock并传入Order对象的fill()方法（64~79行）。它检查了mock的调用历史，确保仅仅发生了工厂调用。 </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> The routine&nbsp;<code style="margin:0px; padding:0px">testC_orderCheck()</code>&nbsp;(Listing Twenty-six) tests how the&nbsp;<code style="margin:0px; padding:0px">Order</code>object reacts to a missing inventory item. Initially,&nbsp;<code style="margin:0px; padding:0px">fooSource</code>&nbsp;responds with a<code style="margin:0px; padding:0px">True</code>&nbsp;with its&nbsp;<code style="margin:0px; padding:0px">hasInventory()</code>&nbsp;method and a&nbsp;<code style="margin:0px; padding:0px">0</code>&nbsp;with&nbsp;<code style="margin:0px; padding:0px">getinventory()</code>. The test routine checks if the order is not fulfilled and if the right mocked method is called (lines 16-19). Then the routine creates a new&nbsp;<code style="margin:0px; padding:0px">Order</code>&nbsp;object, this time for a different item. The mock&nbsp;<code style="margin:0px; padding:0px">fooSource</code>&nbsp;is set to respond with a&nbsp;<code style="margin:0px; padding:0px">False</code>&nbsp;with its&nbsp;<code style="margin:0px; padding:0px">hasInventory()</code>&nbsp;method (line 27). Again, the routine checks if the order is not filled and if the right mocked method is called (lines 34-37). Note the use of the&nbsp;<code style="margin:0px; padding:0px">reset_mock()</code>&nbsp;method to restore&nbsp;<code style="margin:0px; padding:0px">fooSource</code>&nbsp;to its pre-test state (line 28). Listing Twenty-six <pre><code>class&nbsp;OrderTest(unittest.TestCase):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;...&nbsp;see&nbsp;previous&nbsp;listing
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;test:&nbsp;checking&nbsp;the&nbsp;inventory
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;objective:&nbsp;does&nbsp;the&nbsp;order&nbsp;object&nbsp;check&nbsp;for&nbsp;inventory?
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;testC_orderCheck(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"""Test&nbsp;routine&nbsp;C"""
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;creating&nbsp;a&nbsp;test&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder&nbsp;=&nbsp;Order("mushrooms",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;repr(testOrder)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;test
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder.fill(self.fooSource)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;checks
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertFalse(testOrder.isFilled())
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertEqual(testOrder._orderFilled,&nbsp;0)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.assert_called_once_with("mushrooms")
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;self.fooSource.mock_calls
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;creating&nbsp;another&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder&nbsp;=&nbsp;Order("cabbage",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;repr(testOrder)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;reconfigure&nbsp;the&nbsp;test&nbsp;resource
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.return_value&nbsp;=&nbsp;False
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.reset_mock()
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;test
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder.fill(self.fooSource)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;checks
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertFalse(testOrder.isFilled())
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertEqual(testOrder._orderFilled,&nbsp;-1)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.assert_called_once_with("cabbage")
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;self.fooSource.mock_calls
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;...&nbsp;continued&nbsp;in&nbsp;the&nbsp;next&nbsp;listing</code></pre> Test routine&nbsp;<code style="margin:0px; padding:0px">testD_orderFilled()</code>&nbsp;(Listing Twenty-seven) simulates a successful order transaction. Here,&nbsp;<code style="margin:0px; padding:0px">fooSource</code>&nbsp;responds with a&nbsp;<code style="margin:0px; padding:0px">True</code>&nbsp;with its<code style="margin:0px; padding:0px">hasInventory()</code>&nbsp;method and returns&nbsp;<code style="margin:0px; padding:0px">10</code>&nbsp;with&nbsp;<code style="margin:0px; padding:0px">getinventory()</code>. The routine passes the mock to the&nbsp;<code style="margin:0px; padding:0px">fill()</code>&nbsp;method, then checks if the order has been filled (lines 17-18). It also checks whether the right mocked methods were called in the right order and with the right arguments (lines 20-24). Listing Twenty-seven <pre><code>class&nbsp;OrderTest(unittest.TestCase):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;...&nbsp;see&nbsp;previous&nbsp;listing
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;test:&nbsp;fulfilling&nbsp;an&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;objective:&nbsp;how&nbsp;does&nbsp;the&nbsp;order&nbsp;object&nbsp;behave&nbsp;with&nbsp;a&nbsp;successful&nbsp;transaction
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;testD_orderFilled(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"""Test&nbsp;routine&nbsp;D"""
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;creating&nbsp;a&nbsp;test&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder&nbsp;=&nbsp;Order("mushrooms",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;repr(testOrder)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;test
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder.fill(self.fooSource)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;testOrder.isFilled()
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;checks
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertTrue(testOrder.isFilled())
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertNotEqual(testOrder._orderFilled,&nbsp;-1)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.assert_called_once_with("mushrooms")
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.getInventory.assert_called_with("mushrooms",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testCalls&nbsp;=&nbsp;[call.hasInventory("mushrooms"),&nbsp;call.getInventory("mushrooms",&nbsp;10)]
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.assert_has_calls(testCalls)
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;...&nbsp;continued&nbsp;in&nbsp;the&nbsp;next&nbsp;listing</code></pre> Test routine&nbsp;<code style="margin:0px; padding:0px">testE_orderIncomplete()</code>&nbsp;(Listing Twenty-eight) simulates an incomplete transaction. In this one,&nbsp;<code style="margin:0px; padding:0px">fooSource</code>&nbsp;responds with a&nbsp;<code style="margin:0px; padding:0px">True</code>&nbsp;with its<code style="margin:0px; padding:0px">hasInventory()</code>, but with a&nbsp;<code style="margin:0px; padding:0px">5</code>&nbsp;with&nbsp;<code style="margin:0px; padding:0px">getinventory()</code>. The routine passes the mock to the&nbsp;<code style="margin:0px; padding:0px">fill()</code>&nbsp;method, then checks for an incomplete order (lines 17-18). And it also checks if the right mocked methods were called in the right order and with the right arguments (lines 20-25). Listing Twenty-eight <pre><code>class&nbsp;OrderTest(unittest.TestCase):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;...&nbsp;see&nbsp;previous&nbsp;listing
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;test:&nbsp;fulfilling&nbsp;an&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;objective:&nbsp;how&nbsp;does&nbsp;the&nbsp;order&nbsp;object&nbsp;behave&nbsp;with&nbsp;an&nbsp;incomplete&nbsp;transaction
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;testE_orderIncomplete(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"""Test&nbsp;routine&nbsp;E"""
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;creating&nbsp;a&nbsp;test&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder&nbsp;=&nbsp;Order("mushrooms",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;repr(testOrder)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;test
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder.fill(self.fooSource)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;testOrder.isFilled()
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;checks
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertFalse(testOrder.isFilled())
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertNotEqual(testOrder._orderFilled,&nbsp;testOrder._orderAmount)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.assert_called_once_with("mushrooms")
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.getInventory.assert_called_with("mushrooms",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;self.fooSource.mock_calls
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testCalls&nbsp;=&nbsp;[call.hasInventory("mushrooms"),&nbsp;call.getInventory("mushrooms",&nbsp;10)]
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.assert_has_calls(testCalls)</code></pre> </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> 例程testC_orderCheck()（Listing Twenty-six）测试了Order对象在库存不足时的反应。最初，fooSource的hasInventory()方法响应True，getinventory()方法返回0。测试例程检查是否订单未达成，是否正确的mock方法被带调用(16~19行)。然后测试例程创建了一个新的Order对象，这次是一个不同的项目。mock(fooSource)的方法hasInventory()的响应设置为False（第27行）。再次，例程检查是否订单未达成，是否调用了正确的mock方法（34~37行）。注意使用reset_mock()方法将fooSource恢复到测试前的状态（第28行）。 Listing Twenty-six <pre><code>class&nbsp;OrderTest(unittest.TestCase):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;...&nbsp;see&nbsp;previous&nbsp;listing
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;test:&nbsp;checking&nbsp;the&nbsp;inventory
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;objective:&nbsp;does&nbsp;the&nbsp;order&nbsp;object&nbsp;check&nbsp;for&nbsp;inventory?
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;testC_orderCheck(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"""Test&nbsp;routine&nbsp;C"""
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;creating&nbsp;a&nbsp;test&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder&nbsp;=&nbsp;Order("mushrooms",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;repr(testOrder)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;test
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder.fill(self.fooSource)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;checks
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertFalse(testOrder.isFilled())
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertEqual(testOrder._orderFilled,&nbsp;0)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.assert_called_once_with("mushrooms")
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;self.fooSource.mock_calls
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;creating&nbsp;another&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder&nbsp;=&nbsp;Order("cabbage",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;repr(testOrder)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;reconfigure&nbsp;the&nbsp;test&nbsp;resource
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.return_value&nbsp;=&nbsp;False
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.reset_mock()
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;test
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder.fill(self.fooSource)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;checks
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertFalse(testOrder.isFilled())
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertEqual(testOrder._orderFilled,&nbsp;-1)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.assert_called_once_with("cabbage")
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;self.fooSource.mock_calls
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;...&nbsp;continued&nbsp;in&nbsp;the&nbsp;next&nbsp;listing</code></pre> 测试例程testD_orderFilled()（Listing Twenty-seven）模拟了一个成功的订单事务。fooSource的hasInventory()方法响应True，getinventory()方法返回10。例程调用fill()方法传入mock对象，然后检查订单是否已完成（17~18行）。它也检查了是否采用正确的顺序和正确的参数调用了 正确的mock方法（20~24行）。 Listing Twenty-seven <pre><code>class&nbsp;OrderTest(unittest.TestCase):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;...&nbsp;see&nbsp;previous&nbsp;listing
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;test:&nbsp;fulfilling&nbsp;an&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;objective:&nbsp;how&nbsp;does&nbsp;the&nbsp;order&nbsp;object&nbsp;behave&nbsp;with&nbsp;a&nbsp;successful&nbsp;transaction
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;testD_orderFilled(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"""Test&nbsp;routine&nbsp;D"""
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;creating&nbsp;a&nbsp;test&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder&nbsp;=&nbsp;Order("mushrooms",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;repr(testOrder)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;test
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder.fill(self.fooSource)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;testOrder.isFilled()
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;checks
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertTrue(testOrder.isFilled())
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertNotEqual(testOrder._orderFilled,&nbsp;-1)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.assert_called_once_with("mushrooms")
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.getInventory.assert_called_with("mushrooms",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testCalls&nbsp;=&nbsp;[call.hasInventory("mushrooms"),&nbsp;call.getInventory("mushrooms",&nbsp;10)]
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.assert_has_calls(testCalls)
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;...&nbsp;continued&nbsp;in&nbsp;the&nbsp;next&nbsp;listing</code></pre> 测试例程testE_orderIncomplete()（Listing Twenty-eight）模拟了一个未完成的事务。在这个测试中，fooSource的方法hasInventory()响应True,但是getinventory()返回5。例程调用fill()方法传入mock对象，然后检查未完成的订单（17~18行）。 它也检查了是否采用正确的顺序和正确的参数调用了正确的mock方法（20~25行）。 Listing Twenty-eight <pre><code>class&nbsp;OrderTest(unittest.TestCase):
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;...&nbsp;see&nbsp;previous&nbsp;listing
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;test:&nbsp;fulfilling&nbsp;an&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;objective:&nbsp;how&nbsp;does&nbsp;the&nbsp;order&nbsp;object&nbsp;behave&nbsp;with&nbsp;an&nbsp;incomplete&nbsp;transaction
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;testE_orderIncomplete(self):
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"""Test&nbsp;routine&nbsp;E"""
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;creating&nbsp;a&nbsp;test&nbsp;order
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder&nbsp;=&nbsp;Order("mushrooms",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;repr(testOrder)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;test
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testOrder.fill(self.fooSource)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;testOrder.isFilled()
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;perform&nbsp;the&nbsp;checks
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertFalse(testOrder.isFilled())
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.assertNotEqual(testOrder._orderFilled,&nbsp;testOrder._orderAmount)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.hasInventory.assert_called_once_with("mushrooms")
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.getInventory.assert_called_with("mushrooms",&nbsp;10)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;self.fooSource.mock_calls
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;testCalls&nbsp;=&nbsp;[call.hasInventory("mushrooms"),&nbsp;call.getInventory("mushrooms",&nbsp;10)]
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;self.fooSource.assert_has_calls(testCalls)</code></pre> </td> 
 </tr> 
 <tr style="margin:0px; padding:0px"> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10pt; line-height:1.5; background-color:rgb(255,255,255)"> <h3 style="margin:0px; padding:0px">Conclusion </h3> Mocks let us simulate resources that are either unavailable or too unwieldy for unit testing. We can configure a mock on the fly, change how it behaves or responds in a particular test, or get it to throw errors and exceptions on cue. In this article, we looked at how a unit test setup benefits from a mock. We learned how a mock differs from a fake or a stub. We learned how to create a mock on Python, how to manage it and how to track its behavior with asserts. And we examined a simple mock at work in a basic test case.Feel free to try out this test setup and observe its results. Feel free to tweak the test routines presented here, and experiment with how those tweaks affect the test. <h3 style="margin:0px; padding:0px">References</h3> Alex Marandon.&nbsp;<a href="http://alexmarandon.com/articles/python_mock_gotchas/" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Python Mock Gotchas</a>. Grig Gheorghiu. (2009).&nbsp;<a href="http://agiletesting.blogspot.ca/2009/07/python-mock-testing-techniques-and.html" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Python Mock Testing Techniques and Tools</a>.&nbsp;Python Magazine Insomihack.&nbsp;<a href="http://www.insomnihack.com/?p=194" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Python Unit Testing with Mock</a>. Matt Cottingham.&nbsp;<a href="http://blueprintforge.com/blog/2012/01/08/python-injecting-mock-objects-for-powerful-testing/" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Python: Injecting Mock Objects for Powerful Testing</a>. Michael Foord. (2012).&nbsp;<a href="http://www.voidspace.org.uk/downloads/mock-1.0.1.pdf" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Mock Documentation, Release 1.0.1</a>. [PDF] Martin Fowler.&nbsp;<a href="http://martinfowler.com/articles/mocksArentStubs.html" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Mocks Aren't Stubs</a>. Naftuli Tzvi Kay.&nbsp;<a href="http://www.toptal.com/python/an-introduction-to-mocking-in-python" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">An Introduction to Mocking in Python</a>. Steve Freeman, Tim Mackinnon, et al. (2004).&nbsp;<a href="http://jmock.org/oopsla2004.pdf" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Mock Roles, Not Objects</a>&nbsp;[PDF].OOPLSA 2004 </td> 
 <td style="margin:0px; padding:5px; overflow:hidden; font-size:10.5pt; line-height:1.5; background-color:rgb(255,255,255)"> 译者信息<img src="http://www.oschina.net/img/down.gif" alt="" style="margin:0px 0px 0px 5px; padding:2px 0px 0px; border:0px; vertical-align:middle"> <h3 style="margin:0px; padding:0px">结束语</h3> Mocks让我们为单元测试模拟了那些不可用或者是太庞大的资源。我们可以在运行中配置mock，在特定的测试中改变它的行为或响应，或者让它在恰当的时候抛出错误和异常。 在这篇文章中，我们看到了在单元测试中设置mock的好处。我们了解了mock和fake或者stub的区别。我们了解了怎样在Python中创建mock，怎样管理它和用断言跟踪它的行为。我们研究了简单的mock在基础测试用例中的工作。随意尝试了这个测试设置并观察它的结构。随意的调整已提供的测试例程并观察这些调整对测试的影响。 引用 Alex Marandon.&nbsp;<a href="http://alexmarandon.com/articles/python_mock_gotchas/" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Python Mock Gotchas</a>. Grig Gheorghiu. (2009).&nbsp;<a href="http://agiletesting.blogspot.ca/2009/07/python-mock-testing-techniques-and.html" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Python Mock Testing Techniques and Tools</a>.&nbsp;Python Magazine Insomihack.&nbsp;<a href="http://www.insomnihack.com/?p=194" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Python Unit Testing with Mock</a>. Matt Cottingham.&nbsp;<a href="http://blueprintforge.com/blog/2012/01/08/python-injecting-mock-objects-for-powerful-testing/" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Python: Injecting Mock Objects for Powerful Testing</a>. Michael Foord. (2012).&nbsp;<a href="http://www.voidspace.org.uk/downloads/mock-1.0.1.pdf" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Mock Documentation, Release 1.0.1</a>. [PDF] Martin Fowler.&nbsp;<a href="http://martinfowler.com/articles/mocksArentStubs.html" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Mocks Aren't Stubs</a>. Naftuli Tzvi Kay.&nbsp;<a href="http://www.toptal.com/python/an-introduction-to-mocking-in-python" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">An Introduction to Mocking in Python</a>. Steve Freeman, Tim Mackinnon, et al. (2004).&nbsp;<a href="http://jmock.org/oopsla2004.pdf" style="margin:0px; padding:0px; color:rgb(62,98,166); outline:0px" rel="nofollow">Mock Roles, Not Objects</a>&nbsp;[PDF].&nbsp;OOPLSA 2004 </td> 
 </tr> 
 </tbody> 
</table>

http://www.oschina.net/translate/unit-testing-with-the-python-mock-class?cmp&p=3\#

http://www.drdobbs.com/testing/unit-testing-with-the-python-mock-class/240168251