Solution 3.0.0

An amazing form solution

===============================
Solution
===============================

.. image:: https://badge.fury.io/py/Solution.png
:target: http://badge.fury.io/py/Solution

.. image:: https://travis-ci.org/lucuma/solution.png?branch=master
:target: https://travis-ci.org/lucuma/solution

.. image:: https://pypip.in/d/Solution/badge.png
:target: https://crate.io/packages/Solution?version=latest


An amazing form solution

* BSD License. See ``LICENSE`` for more details.
* Documentation: http://solution.rtfd.org.

Features
====================================

* Return validated data as dictionaries or create/update a linked model and child models.
* Sub-forms and form sets
* Extremely flexible in the field representation (defaulting to an HTML representation that might be good enough).
* Easy individual field or form-wide validators.
* Customizable cleanup functions.


.. :changelog:

=============
History
=============

2.x
+++++++++++++++++++++++++++++++++++++

* Selects (and MultiSelects) can take groups of items and render them as ``<optgroup>`` or ``<fieldset>``.

* The ``clean`` and `vprepare`` methods of a field can now be defined as a form method with the signature ``clean_fieldname(py_value, **kwargs)`` and ``prepare_fieldname(obj_value, **kwargs)``.

* Added ``prepare`` and ``clean`` methods to the form so a user can overwrite them to store there the logic of pre and post-processing the data, keeping that logic in the form itself instead of in a view.

* Several bugfixes