Welcome to milkman’s documentation

milkman is an open source fixture replacement for Django testing.

Instead of maintaining scores of fixtures, whether they be generated, dumped, or managed semi-dynamically, it can still generate a lot of code that is not even test code. Furthermore, this tends to be brittle and hard to maintain.

The genius of milkman is that it randomly generates data for all the fields on a particular object, while at the same time allowing the test writer to override any particular field with their own data when determinate fields are needed for a test.

Example:

from django.contrib.auth.models import User
from django.core.urlresolvers import reverse
from django.test import TestCase, Client

from milkman.dairy import milkman

from app.models import Library, Book, Author


class LibraryTest(TestCase):

    def setUp(self):
        self.user = milkman.deliver(User)
        self.user.set_password("letmein")
        self.user.save()

        self.user2 = milkman.deliver('auth.user')
        self.user2.set_password("letmein")
        self.user2.save()

        self.book = milkman.deliver(Book, library__name="Library of Congress")
        self.author = milkman.deliver(Author, lastname="Lewis")

        self.client = Client()
        self.client.login(username=self.user.username, password="letmein")

        self.url = reverse("book", args=[self.book.library.id, self.book.id])

    def tearDown(self):
        self.user.delete()
        self.user2.delete()
        self.book.delete()
        self.author.delete()