Metadata-Version: 2.0
Name: django-nested-formset
Version: 0.1.2
Summary: Nest Django formsets for multi-level hierarchical editing
Home-page: https://github.com/nyergler/nested-formset
Author: Nathan Yergler
Author-email: nathan@yergler.net
License: BSD
Platform: UNKNOWN
Classifier: License :: OSI Approved :: BSD License
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Django
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: Django (>=1.5)

======================
Django Nested Formsets
======================

.. image:: https://travis-ci.org/nyergler/nested-formset.png?branch=master
   :target: https://travis-ci.org/nyergler/nested-formset

Formsets_ are a Django abstraction that make it easier to manage
multiple instances of a single Form_ on a page. In 2009 I wrote a
`blog post`_ about using nesting formsets using Django 1.1. This is a
generic implementation of the technique described there, targeting
Django 1.5 and later. A `follow-up blog post`_ provides additional
context.

Installing
==========

You can install Django Nested Formsets using your favorite package
management tool. For example::

  $ pip install django-nested-formset

You can also install the `latest development version`_\ ::

  $ pip install django-nested-formset==dev

After installing the package, you can use the
``nestedformset_factory`` function to create your formset class.

Developing
==========

If you'd like to work on the source, I suggest cloning the repository
and creating a virtualenv.

::

   $ cd nested-formset
   $ virtualenv .
   $ source bin/activate
   $ python setup.py develop

The last line will install the installation and test dependencies.

To run the unit test suite, run the following::

   $ python setup.py test

See Also
========

* `Django Formset documentation`_
* `jquery.django-formset`_ Dynamic creation of formsets from the empty
  formset.

License
=======

This package is released under a BSD style license. See LICENSE for details.

.. _`latest development version`: https://github.com/nyergler/nested-formset/tarball/master#egg=django_nested_formset-dev
.. _Formsets: https://docs.djangoproject.com/en/1.5/topics/forms/formsets/
.. _`Django Formset documentation`: Formsets_
.. _Form: https://docs.djangoproject.com/en/1.5/topics/forms/
.. _`blog post`: http://yergler.net/blog/2009/09/27/nested-formsets-with-django/
.. _`follow-up blog post`: http://yergler.net/blog/2013/09/03/nested-formsets-redux/
.. _`jquery.django-formset`: https://github.com/mbertheau/jquery.django-formset


News
====

0.1.2
-----

*Release date: 20 May 2014*

* Support for passing files to bound nested formsets
* The media property now rolls up all nested media
* Compatibility with Django 1.7.

0.1.1
-----

*Release date: 6 March 2014*

* Bump minor version number to get PyPI to index the development
  version link.

0.1
---

*Release date: 6 March 2014*

* Initial release on PyPI


