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/fields.py widgets.py: fixed small
bugs in DateField, DateTimeField, DateWidget, DateTimeWidget.
* 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/fields.py widgets.py: fixed small
bugs in DateField, DateTimeField, DateWidget, DateTimeWidget.
* 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 Distributions
Close
Hashes for softwarefabrica.django.forms-0.9dev-BZR-r10-panta-elasticworld.org-20081216152624-sz5xilgbk42aqw1n.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0feb0c2d9056790d56bc47223889c96822f56d38b69213a009d4cd11618bbe7c |
|
MD5 | a5f39dc1c600b0083f22db270d2b3294 |
|
BLAKE2b-256 | b264d5f20e20e75f8b8060990e21f6316a93f9c0a361fbf76e8d8f17cbdca55b |
Close
Hashes for softwarefabrica.django.forms-0.9dev_BZR_r10_panta_elasticworld.org_20081216152624_sz5xilgbk42aqw1n-py2.6.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | 240e294c2ed6a5d7c3d6da85017564407faa7ab37e645f1137de026fb24c1e6f |
|
MD5 | cb157342b953720205a0bfa124b45d94 |
|
BLAKE2b-256 | 3dd4c5820c10d19189905e4baaae0490b5770345bffcda2976c9ecde5d99d3f4 |
Close
Hashes for softwarefabrica.django.forms-0.9dev_BZR_r10_panta_elasticworld.org_20081216152624_sz5xilgbk42aqw1n-py2.5.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | a196518aa08f779f584aab10acd39bc1c4b56a93399084427d873700e1a802d2 |
|
MD5 | 1cdf5668d257e3c9905fd62c64ab29ae |
|
BLAKE2b-256 | f9201433036baac67bc061700636432cfeb4968bc19361886d9debbc71cffeab |
Close
Hashes for softwarefabrica.django.forms-0.9dev_BZR_r10_panta_elasticworld.org_20081216152624_sz5xilgbk42aqw1n-py2.4.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5deb0204297c63972b49a5fca292cdd50a07f67c22b714169aada507793ed978 |
|
MD5 | d56f72ead587dcb872fcadcff0fc2e3d |
|
BLAKE2b-256 | 2c4f3d49b4bf2687716efd61a370f63ad3e4ff86f83e50ebaa68c0be696af292 |