Initial commit of minimocktest to repo.

Author: pykler

.gitignore

@@ -0,0 +1 @@
+*.pyc

LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Hatem Nassrat
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.rst

@@ -0,0 +1,43 @@
+MiniMockTest
+============
+
+Documentation
+-------------
+
+This module provides a class which extends unittest.TestCase which can
+be used to easily mock objects in a test case. This module can be used
+in conjunction with other test case classes by means of multiple
+inheritance http://docs.python.org/tutorial/classes.html#multiple-inheritance
+
+An example of using Django's test case with this module's test case is
+simply as follows::
+
+    from minimocktest import MockTestCase
+    from django.test import TestCase
+    from django.test.client import Client
+
+    class DjangoTestCase(TestCase, MockTestCase):
+        '''
+        A TestCase class that combines minimocktest and django.test.TestCase
+        '''
+
+        def setUp(self):
+            TestCase.setUp(self)
+            MockTestCase.setUp(self)
+            # optional: shortcut client handle for quick testing
+            self.client = Client()
+
+        def tearDown(self):
+            MockTestCase.tearDown(self)
+            TestCase.tearDown(self)
+
+COPYING
+-------
+
+This module is provided under the terms of the MIT Licence. The code in
+this module relies on the "minimock" library which is included as part of
+the package. The copyright notice for "minimock" is included at the
+beginning of its source code file.
+
+For more information, see the file LICENCSE or
+http://www.opensource.org/licenses/mit-license.php

minimocktest/__init__.py

@@ -0,0 +1,50 @@
+# (c) 2011 Hatem Nassrat 
+# Licensed under the MIT license: http://www.opensource.org/licenses/mit-license.php
+'''
+MiniMockTest module, holds MockTestCase class for easy to use mocking in testcases
+'''
+
+import __builtin__
+import inspect
+from unittest import TestCase
+import minimock
+
+class MockTestCase(TestCase):
+    '''
+    A TestCase class that integrates minimock functionailty
+    `self.tt` minimock tracker object
+    `self.mock` calls minimock.mock using tracker=`self.tt`
+    `self.assertSameTrace` calls minimock.assert_same_trace with `self.tt`
+    '''
+
+    Mock = minimock.Mock
+
+    def setUp(self):
+        TestCase.setUp(self)
+        self.tt = minimock.TraceTracker()
+
+    def tearDown(self):
+        self.mockRestore()
+        TestCase.tearDown(self)
+
+    def mock(self, *args, **kwargs):
+        if len(args) <= 1 and 'nsdicts' not in kwargs:
+            # custom nsdicts not used, inspect caller's stack
+            stack = inspect.stack()
+            try:
+                # stack[1][0] is the frame object of the caller to this function
+                globals_ = stack[1][0].f_globals
+                locals_ = stack[1][0].f_locals
+                nsdicts = (locals_, globals_, __builtin__.__dict__)
+            finally:
+                del(stack)
+            kwargs['nsdicts'] = nsdicts
+        if 'tracker' not in kwargs:
+            kwargs['tracker'] = self.tt
+        return minimock.mock(*args, **kwargs)
+
+    def mockRestore(self):
+        minimock.restore()
+
+    def assertSameTrace(self, want):
+        minimock.assert_same_trace(self.tt, want)