# 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.

Documentation: [https://model-bakery.readthedocs.io](https://model-bakery.readthedocs.io)

Source code: [https://github.com/model-bakers/model_bakery/](https://github.com/model-bakers/model_bakery/)

## Key Features

- Automatically generates test data for Django models
- Provides sensible defaults for all field types
- Supports custom field overrides and "recipes" for reusable patterns
- Handles related models and complex relationships
- Works with currently maintained versions of Python and Django

## Installation

```console
$ pip install model-bakery
```

## Supported Versions

Model Bakery follows the [Python](https://devguide.python.org/versions/) and [Django](https://docs.djangoproject.com/en/stable/internals/release-process/#supported-versions) release and support cycles. We drop support for Python and Django versions when they reach end-of-life.

## Contributing to Model Bakery

As an open-source project, Model Bakery welcomes contributions of many forms:

- Code patches
- Documentation improvements
- Bug reports

Take a look at our [GitHub repo](https://github.com/model-bakers/model_bakery/blob/main/CONTRIBUTING.md) for instructions
on how to set up your local environment.

## Support

Feel free to [open an issue](https://github.com/model-bakers/model_bakery/issues/new) for support, development ideas, or questions!

## License

Model Bakery is licensed under Apache License 2.0.
See the [LICENSE](https://github.com/model-bakers/model_bakery/blob/main/LICENSE) file for more information.

## Contents

```{toctree}
:maxdepth: 4

basic_usage
recipes
how_bakery_behaves
test_runners
migrating_from_mommy
```