OLD | NEW |
| (Empty) |
1 # mock.py | |
2 # Test tools for mocking and patching. | |
3 # Copyright (C) 2007-2009 Michael Foord | |
4 # E-mail: fuzzyman AT voidspace DOT org DOT uk | |
5 | |
6 # mock 0.6.0 | |
7 # http://www.voidspace.org.uk/python/mock/ | |
8 | |
9 # Released subject to the BSD License | |
10 # Please see http://www.voidspace.org.uk/python/license.shtml | |
11 | |
12 # 2009-11-25: Licence downloaded from above URL. | |
13 # BEGIN DOWNLOADED LICENSE | |
14 # | |
15 # Copyright (c) 2003-2009, Michael Foord | |
16 # All rights reserved. | |
17 # E-mail : fuzzyman AT voidspace DOT org DOT uk | |
18 # | |
19 # Redistribution and use in source and binary forms, with or without | |
20 # modification, are permitted provided that the following conditions are | |
21 # met: | |
22 # | |
23 # | |
24 # * Redistributions of source code must retain the above copyright | |
25 # notice, this list of conditions and the following disclaimer. | |
26 # | |
27 # * Redistributions in binary form must reproduce the above | |
28 # copyright notice, this list of conditions and the following | |
29 # disclaimer in the documentation and/or other materials provided | |
30 # with the distribution. | |
31 # | |
32 # * Neither the name of Michael Foord nor the name of Voidspace | |
33 # may be used to endorse or promote products derived from this | |
34 # software without specific prior written permission. | |
35 # | |
36 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | |
37 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | |
38 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | |
39 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | |
40 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | |
41 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | |
42 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | |
43 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | |
44 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
45 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | |
46 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
47 # | |
48 # END DOWNLOADED LICENSE | |
49 | |
50 # Scripts maintained at http://www.voidspace.org.uk/python/index.shtml | |
51 # Comments, suggestions and bug reports welcome. | |
52 | |
53 | |
54 __all__ = ( | |
55 'Mock', | |
56 'patch', | |
57 'patch_object', | |
58 'sentinel', | |
59 'DEFAULT' | |
60 ) | |
61 | |
62 __version__ = '0.6.0' | |
63 | |
64 class SentinelObject(object): | |
65 def __init__(self, name): | |
66 self.name = name | |
67 | |
68 def __repr__(self): | |
69 return '<SentinelObject "%s">' % self.name | |
70 | |
71 | |
72 class Sentinel(object): | |
73 def __init__(self): | |
74 self._sentinels = {} | |
75 | |
76 def __getattr__(self, name): | |
77 return self._sentinels.setdefault(name, SentinelObject(name)) | |
78 | |
79 | |
80 sentinel = Sentinel() | |
81 | |
82 DEFAULT = sentinel.DEFAULT | |
83 | |
84 class OldStyleClass: | |
85 pass | |
86 ClassType = type(OldStyleClass) | |
87 | |
88 def _is_magic(name): | |
89 return '__%s__' % name[2:-2] == name | |
90 | |
91 def _copy(value): | |
92 if type(value) in (dict, list, tuple, set): | |
93 return type(value)(value) | |
94 return value | |
95 | |
96 | |
97 class Mock(object): | |
98 | |
99 def __init__(self, spec=None, side_effect=None, return_value=DEFAULT, | |
100 name=None, parent=None, wraps=None): | |
101 self._parent = parent | |
102 self._name = name | |
103 if spec is not None and not isinstance(spec, list): | |
104 spec = [member for member in dir(spec) if not _is_magic(member)] | |
105 | |
106 self._methods = spec | |
107 self._children = {} | |
108 self._return_value = return_value | |
109 self.side_effect = side_effect | |
110 self._wraps = wraps | |
111 | |
112 self.reset_mock() | |
113 | |
114 | |
115 def reset_mock(self): | |
116 self.called = False | |
117 self.call_args = None | |
118 self.call_count = 0 | |
119 self.call_args_list = [] | |
120 self.method_calls = [] | |
121 for child in self._children.itervalues(): | |
122 child.reset_mock() | |
123 if isinstance(self._return_value, Mock): | |
124 self._return_value.reset_mock() | |
125 | |
126 | |
127 def __get_return_value(self): | |
128 if self._return_value is DEFAULT: | |
129 self._return_value = Mock() | |
130 return self._return_value | |
131 | |
132 def __set_return_value(self, value): | |
133 self._return_value = value | |
134 | |
135 return_value = property(__get_return_value, __set_return_value) | |
136 | |
137 | |
138 def __call__(self, *args, **kwargs): | |
139 self.called = True | |
140 self.call_count += 1 | |
141 self.call_args = (args, kwargs) | |
142 self.call_args_list.append((args, kwargs)) | |
143 | |
144 parent = self._parent | |
145 name = self._name | |
146 while parent is not None: | |
147 parent.method_calls.append((name, args, kwargs)) | |
148 if parent._parent is None: | |
149 break | |
150 name = parent._name + '.' + name | |
151 parent = parent._parent | |
152 | |
153 ret_val = DEFAULT | |
154 if self.side_effect is not None: | |
155 if (isinstance(self.side_effect, Exception) or | |
156 isinstance(self.side_effect, (type, ClassType)) and | |
157 issubclass(self.side_effect, Exception)): | |
158 raise self.side_effect | |
159 | |
160 ret_val = self.side_effect(*args, **kwargs) | |
161 if ret_val is DEFAULT: | |
162 ret_val = self.return_value | |
163 | |
164 if self._wraps is not None and self._return_value is DEFAULT: | |
165 return self._wraps(*args, **kwargs) | |
166 if ret_val is DEFAULT: | |
167 ret_val = self.return_value | |
168 return ret_val | |
169 | |
170 | |
171 def __getattr__(self, name): | |
172 if self._methods is not None: | |
173 if name not in self._methods: | |
174 raise AttributeError("Mock object has no attribute '%s'" % name) | |
175 elif _is_magic(name): | |
176 raise AttributeError(name) | |
177 | |
178 if name not in self._children: | |
179 wraps = None | |
180 if self._wraps is not None: | |
181 wraps = getattr(self._wraps, name) | |
182 self._children[name] = Mock(parent=self, name=name, wraps=wraps) | |
183 | |
184 return self._children[name] | |
185 | |
186 | |
187 def assert_called_with(self, *args, **kwargs): | |
188 assert self.call_args == (args, kwargs), 'Expected: %s\nCalled with: %s'
% ((args, kwargs), self.call_args) | |
189 | |
190 | |
191 def _dot_lookup(thing, comp, import_path): | |
192 try: | |
193 return getattr(thing, comp) | |
194 except AttributeError: | |
195 __import__(import_path) | |
196 return getattr(thing, comp) | |
197 | |
198 | |
199 def _importer(target): | |
200 components = target.split('.') | |
201 import_path = components.pop(0) | |
202 thing = __import__(import_path) | |
203 | |
204 for comp in components: | |
205 import_path += ".%s" % comp | |
206 thing = _dot_lookup(thing, comp, import_path) | |
207 return thing | |
208 | |
209 | |
210 class _patch(object): | |
211 def __init__(self, target, attribute, new, spec, create): | |
212 self.target = target | |
213 self.attribute = attribute | |
214 self.new = new | |
215 self.spec = spec | |
216 self.create = create | |
217 self.has_local = False | |
218 | |
219 | |
220 def __call__(self, func): | |
221 if hasattr(func, 'patchings'): | |
222 func.patchings.append(self) | |
223 return func | |
224 | |
225 def patched(*args, **keywargs): | |
226 # don't use a with here (backwards compatability with 2.5) | |
227 extra_args = [] | |
228 for patching in patched.patchings: | |
229 arg = patching.__enter__() | |
230 if patching.new is DEFAULT: | |
231 extra_args.append(arg) | |
232 args += tuple(extra_args) | |
233 try: | |
234 return func(*args, **keywargs) | |
235 finally: | |
236 for patching in getattr(patched, 'patchings', []): | |
237 patching.__exit__() | |
238 | |
239 patched.patchings = [self] | |
240 patched.__name__ = func.__name__ | |
241 patched.compat_co_firstlineno = getattr(func, "compat_co_firstlineno", | |
242 func.func_code.co_firstlineno) | |
243 return patched | |
244 | |
245 | |
246 def get_original(self): | |
247 target = self.target | |
248 name = self.attribute | |
249 create = self.create | |
250 | |
251 original = DEFAULT | |
252 if _has_local_attr(target, name): | |
253 try: | |
254 original = target.__dict__[name] | |
255 except AttributeError: | |
256 # for instances of classes with slots, they have no __dict__ | |
257 original = getattr(target, name) | |
258 elif not create and not hasattr(target, name): | |
259 raise AttributeError("%s does not have the attribute %r" % (target,
name)) | |
260 return original | |
261 | |
262 | |
263 def __enter__(self): | |
264 new, spec, = self.new, self.spec | |
265 original = self.get_original() | |
266 if new is DEFAULT: | |
267 # XXXX what if original is DEFAULT - shouldn't use it as a spec | |
268 inherit = False | |
269 if spec == True: | |
270 # set spec to the object we are replacing | |
271 spec = original | |
272 if isinstance(spec, (type, ClassType)): | |
273 inherit = True | |
274 new = Mock(spec=spec) | |
275 if inherit: | |
276 new.return_value = Mock(spec=spec) | |
277 self.temp_original = original | |
278 setattr(self.target, self.attribute, new) | |
279 return new | |
280 | |
281 | |
282 def __exit__(self, *_): | |
283 if self.temp_original is not DEFAULT: | |
284 setattr(self.target, self.attribute, self.temp_original) | |
285 else: | |
286 delattr(self.target, self.attribute) | |
287 del self.temp_original | |
288 | |
289 | |
290 def patch_object(target, attribute, new=DEFAULT, spec=None, create=False): | |
291 return _patch(target, attribute, new, spec, create) | |
292 | |
293 | |
294 def patch(target, new=DEFAULT, spec=None, create=False): | |
295 try: | |
296 target, attribute = target.rsplit('.', 1) | |
297 except (TypeError, ValueError): | |
298 raise TypeError("Need a valid target to patch. You supplied: %r" % (targ
et,)) | |
299 target = _importer(target) | |
300 return _patch(target, attribute, new, spec, create) | |
301 | |
302 | |
303 | |
304 def _has_local_attr(obj, name): | |
305 try: | |
306 return name in vars(obj) | |
307 except TypeError: | |
308 # objects without a __dict__ | |
309 return hasattr(obj, name) | |
OLD | NEW |