Extended forms library for django
Project description
softwarefabrica.django.forms library
====================================
A forms library for `Django`_ projects, which aims at providing increased
functionality and flexibility to the standard `forms library`_.
Please see the documentation for more information and examples.
Don't forget to check also our other `Django`_ applications,
``softwarefabrica.django.utils``, and ``softwarefabrica.django.forms``.
Happy coding!
.. _`Django`: http://www.djangoproject.com
.. _`forms library`: http://docs.djangoproject.com/en/dev/topics/forms/
*Marco Pantaleoni*
.. contents::
PRE-REQUISITES
--------------
This library depends on `softwarefabrica.django.utils` from the same
author.
If you use the EasyInstall_ outlined below, dependencies will be satisfied
automatically (the ``easy_install`` will take care of everything).
There are no dependencies right now, except for Django itself.
INSTALLATION
------------
You can download and install the most up-to-date version in one step
using EasyInstall_. For example, on a unix-like system:
::
$ su
# easy_install softwarefabrica.django.forms
If you are using Ubuntu, to install system-wide:
::
$ sudo easy_install softwarefabrica.django.forms
Otherwise you can just download the source package (eg. from PyPI_),
extract it and run the usual ``setup.py`` commands:
::
$ su
# python setup.py install
Then you can use the library in any django project by simple including it in the
``INSTALLED_APPS`` settings variable, as outlined below.
.. _EasyInstall: http://peak.telecommunity.com/DevCenter/EasyInstall
.. _PyPI: http://pypi.python.org/pypi
DOWNLOAD
--------
If you don't want or cannot install using EasyInstall_, download the
package from Cheese Shop:
http://cheeseshop.python.org/pypi/softwarefabrica.django.forms/
In a future, it will be possible to download also from:
http://www.softwarefabrica.org/projects/softwarefabrica.django.forms//
Using the forms library in your applications
--------------------------------------------
Once you've installed the library and want to use it in your Django
applications, simply put ``'softwarefabrica.django.forms'`` in your
``INSTALLED_APPS`` setting.
Since there are no associated models, a ``manage.py syncdb`` command is not
necessary.
That's it!
DOCUMENTATION
-------------
Documentation is included in the form of *docstrings*, inside the library source
code.
For some advanced examples, please see also the included automatic tests.
TESTING
-------
The library includes automatic tests.
To run the tests, do:
::
$ export DJANGO_SETTINGS_MODULE=softwarefabrica.django.forms.tests.settings
$ django-admin.py test
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.
CHANGES
-------
2008-12-16 Marco Pantaleoni <panta@elasticworld.org>
* softwarefabrica/django/forms/extended.py
(extended_formfield_cb): 'required' is forced into fields kwargs,
because in some cases it's not honoured.
2008-12-01 Marco Pantaleoni <panta@elasticworld.org>
* bug fixes.
2008-11-27 Marco Pantaleoni <panta@elasticworld.org>
* Added RelatedItemField, SelectPopupField,
SelectMultiplePopupField fields and corresponding widgets
(RelatedItemWidget, SelectPopupWidget, SelectMultiplePopupWidget
widgets).
2008-11-25 Marco Pantaleoni <panta@elasticworld.org>
* Added extended fields and widgets. Modified form classes to use
new widgets.
* Fixes, added regression tests.
* Created.
====================================
A forms library for `Django`_ projects, which aims at providing increased
functionality and flexibility to the standard `forms library`_.
Please see the documentation for more information and examples.
Don't forget to check also our other `Django`_ applications,
``softwarefabrica.django.utils``, and ``softwarefabrica.django.forms``.
Happy coding!
.. _`Django`: http://www.djangoproject.com
.. _`forms library`: http://docs.djangoproject.com/en/dev/topics/forms/
*Marco Pantaleoni*
.. contents::
PRE-REQUISITES
--------------
This library depends on `softwarefabrica.django.utils` from the same
author.
If you use the EasyInstall_ outlined below, dependencies will be satisfied
automatically (the ``easy_install`` will take care of everything).
There are no dependencies right now, except for Django itself.
INSTALLATION
------------
You can download and install the most up-to-date version in one step
using EasyInstall_. For example, on a unix-like system:
::
$ su
# easy_install softwarefabrica.django.forms
If you are using Ubuntu, to install system-wide:
::
$ sudo easy_install softwarefabrica.django.forms
Otherwise you can just download the source package (eg. from PyPI_),
extract it and run the usual ``setup.py`` commands:
::
$ su
# python setup.py install
Then you can use the library in any django project by simple including it in the
``INSTALLED_APPS`` settings variable, as outlined below.
.. _EasyInstall: http://peak.telecommunity.com/DevCenter/EasyInstall
.. _PyPI: http://pypi.python.org/pypi
DOWNLOAD
--------
If you don't want or cannot install using EasyInstall_, download the
package from Cheese Shop:
http://cheeseshop.python.org/pypi/softwarefabrica.django.forms/
In a future, it will be possible to download also from:
http://www.softwarefabrica.org/projects/softwarefabrica.django.forms//
Using the forms library in your applications
--------------------------------------------
Once you've installed the library and want to use it in your Django
applications, simply put ``'softwarefabrica.django.forms'`` in your
``INSTALLED_APPS`` setting.
Since there are no associated models, a ``manage.py syncdb`` command is not
necessary.
That's it!
DOCUMENTATION
-------------
Documentation is included in the form of *docstrings*, inside the library source
code.
For some advanced examples, please see also the included automatic tests.
TESTING
-------
The library includes automatic tests.
To run the tests, do:
::
$ export DJANGO_SETTINGS_MODULE=softwarefabrica.django.forms.tests.settings
$ django-admin.py test
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.
CHANGES
-------
2008-12-16 Marco Pantaleoni <panta@elasticworld.org>
* softwarefabrica/django/forms/extended.py
(extended_formfield_cb): 'required' is forced into fields kwargs,
because in some cases it's not honoured.
2008-12-01 Marco Pantaleoni <panta@elasticworld.org>
* bug fixes.
2008-11-27 Marco Pantaleoni <panta@elasticworld.org>
* Added RelatedItemField, SelectPopupField,
SelectMultiplePopupField fields and corresponding widgets
(RelatedItemWidget, SelectPopupWidget, SelectMultiplePopupWidget
widgets).
2008-11-25 Marco Pantaleoni <panta@elasticworld.org>
* Added extended fields and widgets. Modified form classes to use
new widgets.
* Fixes, added regression tests.
* Created.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for softwarefabrica.django.forms-0.9dev-BZR-r9-panta-elasticworld.org-20081216120255-bfxtvm59se53cu9k.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 79144499dc823725f31c6168f84b385920f813920835c50b0014f37194de8721 |
|
MD5 | b29978b98b782eaee7bf15d9f2152de2 |
|
BLAKE2b-256 | 2ca29f7c8847db94385c966863bba7f7f8d42714bb3b300f5358f601522abb64 |
Close
Hashes for softwarefabrica.django.forms-0.9dev_BZR_r9_panta_elasticworld.org_20081216120255_bfxtvm59se53cu9k-py2.5.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7d4844272cb124159e6624ce3abb65fc4763f6ca4934dcf563abb4dc5b132cc9 |
|
MD5 | acbd3c143697e8cdd5da8136a7d1cff5 |
|
BLAKE2b-256 | 09d91573c182faa4659b743031f0fcb8f25168523666505ee98cee46fb8c4c9d |