Softwarefabrica Django Forms

About this document

This document provides an overview of what Softwarefabrica Django Forms is.

Contents

See also the documentation index.

What is this?

This is a forms library for Django projects, which aims at providing increased functionality and flexibility to the standard forms library (aka newforms).

Your help and feedback is precious. Suggestions and contributions are very much appreciated. See below on how you can contribute.

If you want to actively collaborate and provide code, documentation, tests or bug fixes, please feel free to create a new Bazaar branch in Launchpad, and tell us about it! See the collaboration section for more information.

And don't forget to check also our other Django applications, softwarefabrica.django.utils, softwarefabrica.django.crud, and softwarefabrica.django.wiki.

Feature overview

  • a compatible replacement for the standard Form class, supporting templated form output

  • a compatible replacement for the standard ModelForm class, supporting extended features, like field ordering, advanced widgets, templated output

  • a compatible replacement for modelform_factory, which uses the extended ModelForm

  • a set of extended fields and widgets:
    • compatible replacements for DateField and DateTimeField and the associated widgets, using a nice popup Javascript calendar
    • a new DateRangeField
    • compatible replacements for ModelChoiceField and ModelMultipleChoiceField using a popup interface for selecting the related instance/instances

Pre-requisites and installation

See the installation guide document.

How can I contribute?

As said, your help is precious. We'll warmly appreciate any help you'll want to give. Just using this library is a reward for us, but if you want to become more actively involved, you are welcome!

The project has a development home page at LaunchPad:

https://launchpad.net/sf-django-forms

There you can file bugs, suggest enhancements, follow development or ask to become an active team member.

You can checkout the development branch using Bazaar:

bzr branch lp:sf-django-forms

We'll appreciate very much if you'll want to contribute back any changes. Just register your branch with LaunchPad and tell us!

Source code can also be browsed online.

Contacts

It's possible to contact the author by e-mail at the following addresses:

m.pantaleoni at softwarefabrica.org

panta at elasticworld.org

marco.pantaleoni at gmail.com

LICENSE

This software is covered by the GNU General Public License version 2. If you want to use this software in a closed source application, you need to buy a commercial license from the author.

This open source version is:

Copyright (C) 2007-2008 Marco Pantaleoni. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.