Model Bakery: Smart fixtures for better tests

Model Bakery offers you a smart way to create fixtures for testing in Django.

With a simple and powerful API you can create many objects with a single line of code.

Model Bakery is a rename of the legacy model_mommy’s project. This is because the project’s creator and maintainers decided to not reinforce gender stereotypes for women in technology. You can read more about this subject here.

Contributing to Model Bakery

As an open source project, Model Bakery welcomes contributions of many forms. Examples of contributions include:

• Code Patches
• Documentation improvements
• Bug reports

Compatibility

model_bakery supports Django >= 1.11

Install

Install it with pip

$ pip install model_bakery

Contributing

1. Prepare a virtual environment.

$ pip install virtualenvwrapper
$ mkvirtualenv model_bakery

2. Install the requirements.

$ pip install -r dev_requirements.txt

3. Run the tests.

$ make test

Doubts? Loved it? Hated it? Suggestions?

Feel free to open an issue for support, development or ideas!

• https://github.com/model-bakers/model_bakery

Contents:

• Basic Usage
  • Model Relationships
  • M2M Relationships
  • Explicit M2M Relationships
  • Explicit values for fields
  • Creating Files
  • Non persistent objects
  • More than one instance
• Recipes
  • Recipes with foreign keys
  • Recipes with callables
  • Recipes with iterators
  • Sequences in recipes
  • Overriding recipe definitions
  • Recipe inheritance
• How Model Bakery behaves?
  • When shouldn’t you let Baker generate things for you?
  • Currently supported fields
  • Custom fields
  • Customizing Baker
  • Save method custom parameters
• Migrating from Model Mommy