Skip to main content

A model factory for Django that leverages Model Mommy features in FactoryBoy.

Project description

There are two excellent options for createing fixtures for your Django tests: Model Mommy <> and Factory Boy <>, (which were inspired in their Ruby counterparts Object Daddy <> and Factory Girl <>).

While Model Mommy feels lighter and requires absolutely no boilerplate for the simple cases, Factory Boy is more flexible and have more advanced features that might be necessary complex use cases. Which one is better for your project? Why not both? ;-)

Enters Mommy’s Boy

Mommy’s Boy uses both Model Mommy and Factory Boy under the hood so you can benefit from both libraries and choose the interface that is more suitable to each sittuation.

For really simple needs, we can use the make() and prepare() functions of Model Mommy’s API:

>>> from mommys_boy import mommy
>>> from django.contrib.auth.models import User
>>> user = mommy.make(User, first_name='John')

Mommy’s boy leverages both Fake Factory and Model Mommy to automatically fill up your model’s fields. It tries to use meaningful values by matching a field’s name to the corresponding Fake Factory <> function. You can also pass explicit values such as first_name='John' in our example.

>>> user.first_name
>>> user.last_name  # Chosen randomly from the fake.last_name() function

Model Mommy fills any required field that does not match a function in Fake Factory with random data.

FactoryBoy Integration

We can also use Fake Factory introspection and Model Mommy’s abilities within a Factory Boy factory:

from mommys_boy import DjangoMommyFactory
from django.contrib.auth.models import User

class UserFactory(DjangoMommyFactory):
    class Meta:
        model = User

    last_name = 'Smith'

Now we can use the .create() and .build() functions to create instances of the User class.

>>> user = UserFactory.create(email='')
>>> user.first_name  # this field were automatically filled by Fake Factory
>>> user.last_name

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mommys-boy-0.1.1.tar.gz (10.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page