model-bakery-async 1.23.6

Async-enabled fork of model-bakery: smart object creation facility for Django, with baker.amake/aprepare.

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.

About this fork

model-bakery-async is a fork of model-bakery that adds async-native fixture creation — baker.amake() / baker.aprepare() and their Baker counterparts — for use from async def tests on Django's async ORM.

It packages the work from upstream PR #599, which the upstream maintainers declined to merge citing the maintenance burden of a parallel async implementation (the code quality was not in question). We maintain it here so projects that need async fixtures can depend on a published package.

It is a drop-in replacement: the distribution is model-bakery-async but it imports as model_bakery, and all sync APIs from upstream are preserved. Because it shares the model_bakery import namespace, install either this package or upstream model-bakery — not both.

Installation

pip install model-bakery-async

Then import it exactly like upstream model-bakery:

from model_bakery import baker

Supported Versions

Model Bakery follows the Python and Django release and support cycles. We drop support for Python and Django versions when they reach end-of-life.

Basic usage

# models.py
from django.db import models

class Customer(models.Model):
    name = models.CharField(max_length=30)
    email = models.EmailField()
    age = models.IntegerField()
    is_jards_macale_fan = models.BooleanField()
    bio = models.TextField()
    birthday = models.DateField()
    last_shopping = models.DateTimeField()

# test_models.py
from django.test import TestCase
from model_bakery import baker

class TestCustomerModel(TestCase):
    def setUp(self):
        self.customer = baker.make('shop.Customer')
        print(self.customer.__dict__)

"""
{'_state': <django.db.models.base.ModelState object at 0x1129a3240>,
 'age': 3841,
 'bio': 'vUFzMUMyKzlnTyiCxfgODIhrnkjzgQwHtzIbtnVDKflqevczfnaOACkDNqvCHwvtWdLwoiKrCqfppAlogSLECtMmfleeveyqefkGyTGnpbkVQTtviQVDESpXascHAluGHYEotSypSiHvHzFteKIcUebrzUVigiOacfnGdvijEPrZdSCIIBjuXZMaWLrMXyrsUCdKPLRBRYklRdtZhgtxuASXdhNGhDsrnPHrYRClhrSJSVFojMkUHBvSZhoXoCrTfHsAjenCEHvcLeCecsXwXgWJcnJPSFdOmOpiHRnhSgRF',
 'birthday': datetime.date(2019, 12, 3),
 'email': '[e-mail]',
 'is_jards_macale_fan': True,
 'id': 1,
 'last_shopping': datetime.datetime(2019, 12, 3, 21, 42, 34, 77019),
 'name': 'qiayYnESvqcYLLBzxpFOcGBIfnQEPx'}
"""

Documentation

For more detailed information, check out the full documentation.

Contributing

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

• Code patches
• Documentation improvements
• Bug reports

Take a look at our contribution guidelines for instructions on how to set up your local environment.

Maintainers

• Bernardo Fontes
• Rustem Saiargaliev
• Tim Klein

Creator

• Vanderson Mota

Sponsors

License

Model Bakery is licensed under Apache License 2.0. See the LICENSE file for more information.