Metadata-Version: 1.1
Name: mommys-boy
Version: 0.1.0
Summary: A model factory for Django that leverages Model Mommy features in FactoryBoy.
Home-page: UNKNOWN
Author: Fábio Macêdo Mendes
Author-email: fabiomacedomendes@gmail.com
License: UNKNOWN
Description: If you want to create test fixtures for your Django project there are two
        excellent options: `Model Mommy <http://model-mommy.readthedocs.io/>` and
        `Factory Boy <http://model-mommy.readthedocs.io/>`, which were inspired in their
        Ruby counterparts `Object Daddy <https://github.com/flogic/object_daddy>` and
        `Factory Girl <https://github.com/thoughtbot/factory_girl>`.
        
        While Model Mommy feels lighter and requires absolutely no boilerplate for the
        simple cases, Factory Boy is more flexible and have more advanced features that
        might be necessary for some complex model. Which one is better for your
        project? Why not both?
        
        Enters Mommy's Boy
        ==================
        
        Mommy's Boy uses both Model Mommy and Factory Boy under the hood so you can
        benefit from both libraries and choose either interface when it is more
        suitable.
        
        For really simple cases, we can use the `make()` and `prepare()` functions of
        Model Mommy's API:
        
        >>> from mommys_boy import mommy
        >>> from django.contrib.auth.models import User
        >>> user = mommy.make(User, first_name='John')
        
        Mommy's boy leverages both Fake Factory and Model Mommy to automatically fill
        up your model's fields. It tries to use meaningful values by matching a field's
        name to the corresponding `Fake Factory <http://faker.readthedocs.io/>` function.
        You can also pass explicit values such as ``first_name='John'`` in our example.
        
        >>> user.first_name
        'John'
        >>> user.last_name  # Chosen randomly from the fake.last_name() function
        'McLovin'
        
        If your model defines a required field that does not match any function in
        Fake Factory,
        
        
        FactoryBoy Integration
        ----------------------
        
        We can also use Fake Factory introspection and Model Mommy's ability of filling
        up a field with random data in a Factory Boy factory::
        
            from mommys_boy import DjangoMommyFactory
            from django.contrib.auth.models import User
        
        
            class UserFactory(DjangoMommyFactory):
                class Meta:
                    model = User
        
        
        Now we can use the `.create()` and `.build()` functions to create instances of
        the User class.
        
        >>> user = UserFactory.create(email='foo@bar.com')
        >>> user.email
        'foo@bar.com'
        >>> user.first_name
        'Paul'
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries
