aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRaphaël Barrois <raphael.barrois@polytechnique.org>2016-01-06 23:10:26 +0100
committerRaphaël Barrois <raphael.barrois@polytechnique.org>2016-01-07 01:38:05 +0100
commit28ce31db61a46fbd73126630c758d32a7245da42 (patch)
treec61aff92c4de7d7cc59fa5ce3f871f1a6cd1153d
parentbe85908f5205810083c524a25c7da565788f2c03 (diff)
downloadfactory-boy-28ce31db61a46fbd73126630c758d32a7245da42.tar
factory-boy-28ce31db61a46fbd73126630c758d32a7245da42.tar.gz
Clarify the (dis)advantages of randomized tests.
As noted in #259, fully random tests have some issues, notably possibly flaky builds: it is quite helpful to be able to choose the random seeds used by factory_boy and friends.
-rw-r--r--README.rst6
1 files changed, 5 insertions, 1 deletions
diff --git a/README.rst b/README.rst
index 9b82406..8914c62 100644
--- a/README.rst
+++ b/README.rst
@@ -181,7 +181,7 @@ It is also possible to create a bunch of objects in a single call:
Realistic, random values
""""""""""""""""""""""""
-Tests look better with random yet realistic values.
+Demos look better with random yet realistic values; and those realistic values can also help discover bugs.
For this, factory_boy relies on the excellent `fake-factory <https://pypi.python.org/pypi/fake-factory>`_ library:
.. code-block:: python
@@ -199,6 +199,10 @@ For this, factory_boy relies on the excellent `fake-factory <https://pypi.python
<User: Lucy Murray>
+.. note:: Use of fully randomized data in tests is quickly a problem for reproducing broken builds.
+ To that purpose, factory_boy provides helpers to handle the random seeds it uses.
+
+
Lazy Attributes
"""""""""""""""