FactoryMan

Factory-Man provides Django specific extensions for Factory Boy.

Usage

FactoryMan provides you with a factory function create_populated_modelfactory, which accepts the model class and automatically creates a factory class based on the model's fields. If you want to override some fields, you can pass them as keyword arguments to the __init__ method.

from factoryman import create_populated_modelfactory
from .models import Project

ProjectFactory = create_populated_modelfactory(Project)

ExpiredProjectFactory = create_populated_modelfactory(Project, deadline='1999-04-04')

To override the factory's _create method, use create_override keyword argument.

Check out this article for a more detailed user guide.

Low-level Features

ModelFieldSequence extends factory.Sequence to provide a little more DRY syntax. It takes in a string parameter and uses it to create a unique value for each object by adding -n to the string, where n is the count of objects created.

When working with Django, ModelFieldSequence can also accept a model parameter instead of string. The model should be a Django model. The name of the model and the field to which ModelFieldSequence is signed to are used to automatically create the string. model can also be used as a positional argument.

Example:

from factory.django import DjangoModelFactory as ModelFactory
from factoryman import ModelFieldSequence


class CharityFactory(ModelFactory):
    class Meta:
        model = Charity

    name = ModelFieldSequence(Charity)  # Will be `Charity__name-n`, where n is the object count
    email = ModelFieldSequence(string='hello@charity.ee')  # Will be `hello@charity.ee-n`, where n is the object count