Ticket #5419: fuzz-docs.diff

docs/testing.txt

@@ -844 +844 @@
 
     The name is a string such as ``'admin/index.html'``.
 
+``assertModelUnicodePassesFuzzTest(model, repeat=10):``
+    Asserts that after having assigned random unicode data into each of the
+    fields of an instance of the specified model that calling the 
+    ``__unicode__`` method of the instance doesn't raise a ``UnicodeError``.
+    Random data is assigned and the ``__unicode__`` method called ``repeat``
+    times.
+
+``assertFunctionPassesFuzzTest(func, arg_types=(), permitted_return_types=(), permitted_exceptions=(), repeat=10):``
+    Asserts that the function when called with random values of the types
+    specified by ``arg_types`` that the return value has a type from
+    ``permitted_return_types`` and that if an exception is raised it is one
+    that is in ``permitted_exceptions``. The function is called ``repeat``
+    times with random data. For example:
+
+                  def test_func(a, b, c):
+              if a is None or b is None:
+                  return None
+                      if a < b:
+                          raise ValueError("fisrt argument is less than the second.")
+                      if c:
+                  return a + b
+              else:
+                  return a - b
+
+          assertFunctionPassesFuzzTest(test_func,
+              arg_types=(int, int, bool),
+              permitted_return_types=(None, int),
+              permitted_exceptions=(ValueError),
+              repeat=100)
+
+        The ``arg_types`` can be a sequence of sequences to indicate that an
+        argument can have more than one type:
+
+          assertFunctionPassesFuzzTest(test_func,
+              arg_types=((int, None), (int, None), bool),
+              permitted_return_types=(None, int),
+              permitted_exceptions=(ValueError),
+              repeat=100)
+        
+        Note that you can use either ``None`` or ``types.NoneType``.
+
 E-mail services
 ---------------