.. _overview:
Deform
======
:mod:`deform` is a Python HTML form generation library. It runs under Python
2.x, 3.x and PyPy.
Deform is a Python form library for generating HTML forms on the server side.
`Date and time picking widgets `_,
`rich text editors `_, `forms with
dynamically added and removed items
`_ and a few other `complex
use cases `_ are supported out of the box.
Deform integrates with the `Pyramid web framework `_
and several other web frameworks. Deform comes with `Chameleon templates
`_ and `Bootstrap 3
`_ styling. Under the hood, `Colander schemas
`_ are used for serialization and
validation. The `Peppercorn `_ library
maps HTTP form submissions to nested structure.
Although Deform uses Chameleon templates internally, you can embed rendered
Deform forms into any template language.
Topics
======
.. toctree::
:maxdepth: 1
basics
retail
common_needs
components
serialization
templates
widget
validation
app
ajax
i18n
api
interfaces
glossary
changes
Demonstration Site
==================
Visit `deformdemo.pylonsproject.org `_ to view an
application which demonstrates most of Deform's features. The source code
for this application is also available in the `deformdemo package on GitHub
`_.
Community and links
===================
* `Deform on PyPI `_
* `Deform issue tracker `_
* `Support `_
Thanks
======
The design of :mod:`deform` is heavily influenced by the `formish
`_ form generation library. Some
might even say it's a shameless rip-off; this would not be completely
inaccurate. It differs from formish mostly in ways that make the
implementation (arguably) simpler and smaller.
Without these people, this software would not exist:
- The Formish guys
- Tres Seaver
- `Fear Factory `_
- `Midlake `_
Index and Glossary
==================
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`