Skip to content
This repository has been archived by the owner on Feb 27, 2024. It is now read-only.


Repository files navigation


This repository is now deprecated. We have integrated mimesis-factory into mimesis itself, and there is no longer a need to use a separate package. Refer to the Integration with factory_boy section for more details.


test codecov PyPI version wemake-python-styleguide


Mimesis integration for factory_boy.


pip install mimesis_factory


Look at the example below and you’ll understand how it works:

class Account(object):
    def __init__(self, username, email, name, surname, age):
        self.username = username = email = name
        self.surname = surname
        self.age = age

Now, use the MimesisField class from mimesis_factory to define how fake data is generated:

import factory
from mimesis_factory import MimesisField

from account import Account

class AccountFactory(factory.Factory):
    class Meta(object):
        model = Account

    username = MimesisField('username', template='l_d')
    name = MimesisField('name', gender='female')
    surname = MimesisField('surname', gender='female')
    age = MimesisField('age', minimum=18, maximum=90)
    email = factory.LazyAttribute(
        lambda instance: '{0}'.format(instance.username)
    access_token = MimesisField('token', entropy=32)


We also recommend to use pytest-factoryboy. This way it will be possible to integrate your factories into pytest fixtures.


mimesis_factory is released under the MIT License.