added factory-boy example # noqa

README.md

@@ -166,6 +166,22 @@ In a python environment with faker installed you can use it with:
     > 'bar'
 
 
+# Use with factory-boy
+
+    import factory
+    from faker import Factory as FakerFactory
+    from myapp.models import Book
+
+    faker = FakerFactory.create()
+
+
+    class Book(factory.Factory):
+        FACTORY_FOR = Book
+
+        title = factory.LazyAttribute(lambda x: faker.sentence(nb_words=4))
+        author_name = factory.LazyAttribute(lambda x: faker.name())
+
+
 # Seeding the Generator
 
 You may want to get always the same generated data - for instance when using Faker for unit testing purposes.
@@ -179,7 +195,6 @@ Calling the same script twice with the same seed produces the same results.
     print fake.name()   # Margaret Boehm
 
 
-
 # Tests
 
 Run tests:
@@ -195,7 +210,6 @@ Write documentation for providers:
     $ python -m faker > docs.txt
 
 
-
 ## License
 
 Faker is released under the MIT Licence. See the bundled LICENSE file for details.

docs/index.rst

@@ -145,6 +145,25 @@ How to create a Provider
     > 'bar'
 
 
+Use with factory-boy
+--------------------
+
+::
+
+    import factory
+    from faker import Factory as FakerFactory
+    from myapp.models import Book
+
+    faker = FakerFactory.create()
+
+
+    class Book(factory.Factory):
+        FACTORY_FOR = Book
+
+        title = factory.LazyAttribute(lambda x: faker.sentence(nb_words=4))
+        author_name = factory.LazyAttribute(lambda x: faker.name())
+
+
 Seeding the Generator
 ---------------------