from django.db import models class Author(models.Model): name = models.CharField(max_length=100) def __unicode__(self): return self.name class Book(models.Model): author = models.ForeignKey(Author) title = models.CharField(max_length=100) def __unicode__(self): return self.title __test__ = {'API_TESTS': """ >>> from django.newforms.models import formset_for_queryset, formset_for_model >>> qs = Author.objects.all() >>> AuthorFormSet = formset_for_model(Author, extra=3) >>> formset = AuthorFormSet() >>> for form in formset.forms: ... print form.as_p()

>>> data = { ... 'form-COUNT': '3', ... 'form-0-name': 'Charles Baudelaire', ... 'form-1-name': 'Arthur Rimbaud', ... 'form-2-name': '', ... } >>> formset = AuthorFormSet(data=data) >>> formset.is_valid() True >>> formset.save() [, ] >>> for author in Author.objects.order_by('name'): ... print author.name Arthur Rimbaud Charles Baudelaire Gah! We forgot Paul Verlaine. Let's create a formset to edit the existing authors with an extra form to add him. This time we'll use formset_for_queryset. We *could* use formset_for_queryset to restrict the Author objects we edit, but in that case we'll use it to display them in alphabetical order by name. >>> qs = Author.objects.order_by('name') >>> AuthorFormSet = formset_for_queryset(qs, extra=1, deletable=False) >>> formset = AuthorFormSet() >>> for form in formset.forms: ... print form.as_p()

>>> data = { ... 'form-COUNT': '3', ... 'form-0-id': '2', ... 'form-0-name': 'Arthur Rimbaud', ... 'form-1-id': '1', ... 'form-1-name': 'Charles Baudelaire', ... 'form-2-name': 'Paul Verlaine', ... } >>> formset = AuthorFormSet(data=data) >>> formset.is_valid() True >>> formset.save() [, , ] >>> for author in Author.objects.order_by('name'): ... print author.name Arthur Rimbaud Charles Baudelaire Paul Verlaine This probably shouldn't happen, but it will. If an add form was marked for deltetion, make sure we don't save that form. >>> qs = Author.objects.order_by('name') >>> AuthorFormSet = formset_for_queryset(qs, extra=1, deletable=True) >>> formset = AuthorFormSet() >>> for form in formset.forms: ... print form.as_p()

>>> data = { ... 'form-COUNT': '4', ... 'form-0-id': '2', ... 'form-0-name': 'Arthur Rimbaud', ... 'form-1-id': '1', ... 'form-1-name': 'Charles Baudelaire', ... 'form-2-id': '3', ... 'form-2-name': 'Paul Verlaine', ... 'form-3-name': 'Walt Whitman', ... 'form-3-DELETE': 'on', ... } >>> formset = AuthorFormSet(data=data) >>> formset.is_valid() True >>> formset.save() [, , ] >>> for author in Author.objects.order_by('name'): ... print author.name Arthur Rimbaud Charles Baudelaire Paul Verlaine We can also create a formset that is tied to a parent model. This is how the admin system's edit inline functionality works. >>> from django.newforms.models import inline_formset >>> AuthorBooksFormSet = inline_formset(Author, Book, deletable=False, extra=3) >>> author = Author.objects.get(name='Charles Baudelaire') >>> formset = AuthorBooksFormSet(author) >>> for form in formset.forms: ... print form.as_p()

>>> data = { ... 'book_set-COUNT': '3', ... 'book_set-0-title': 'Les Fleurs du Mal', ... 'book_set-1-title': '', ... 'book_set-2-title': '', ... } >>> formset = AuthorBooksFormSet(author, data=data) >>> formset.is_valid() True >>> formset.save() [] >>> for book in author.book_set.all(): ... print book.title Les Fleurs du Mal Now that we've added a book to Charles Baudelaire, let's try adding another one. This time though, an edit form will be available for every existing book. >>> AuthorBooksFormSet = inline_formset(Author, Book, deletable=False, extra=2) >>> author = Author.objects.get(name='Charles Baudelaire') >>> formset = AuthorBooksFormSet(author) >>> for form in formset.forms: ... print form.as_p()

>>> data = { ... 'book_set-COUNT': '3', ... 'book_set-0-id': '1', ... 'book_set-0-title': 'Les Fleurs du Mal', ... 'book_set-1-title': 'Le Spleen de Paris', ... 'book_set-2-title': '', ... } >>> formset = AuthorBooksFormSet(author, data=data) >>> formset.is_valid() True >>> formset.save() [, ] As you can see, 'Le Spleen de Paris' is now a book belonging to Charles Baudelaire. >>> for book in author.book_set.order_by('title'): ... print book.title Le Spleen de Paris Les Fleurs du Mal """}