== description
With django-dbpreferences you can store some app/user preferences into the database.
| {{https://travis-ci.org/jedie/django-dbpreferences.svg|Build Status on travis-ci.org}} | [[https://travis-ci.org/jedie/django-dbpreferences/|travis-ci.org/jedie/django-dbpreferences]] | | {{https://coveralls.io/repos/jedie/django-dbpreferences/badge.svg|Coverage Status on coveralls.io}} | [[https://coveralls.io/r/jedie/django-dbpreferences|coveralls.io/r/jedie/django-dbpreferences]] | | {{https://landscape.io/github/jedie/django-dbpreferences/master/landscape.svg|Status on landscape.io}} | [[https://landscape.io/github/jedie/django-dbpreferences/master|landscape.io/github/jedie/django-dbpreferences/master]] |
A django app defines a form with initial values. The form cleaned data dict would be stored serialized into the database. The app can easy get the current preference dict and the user can easy edit the values in the django admin panel.
With [[https://code.google.com/p/django-dbpreferences/wiki/UserSettings|UserSettings]] you can store some settings per user.
More Information and examples can be found here:
== unittests
There exist different ways to run unittests, e.g.: {{{ .../django-dbpreferences $ ./setup.py test .../django-dbpreferences $ ./manage.py test .../django-dbpreferences $ ./runtests.sh }}} Run specific tests, e.g.: {{{ .../django-dbpreferences $ ./setup.py test tests.test_dbpreferences.TestDBPref .../django-dbpreferences $ ./manage.py test tests.test_dbpreferences.TestDBPref .../django-dbpreferences $ ./runtests.sh tests.test_dbpreferences.TestDBPref }}}
== Django compatibility
|= django-tools |= django version |= python | | v0.6.0 | 1.6 - 1.8 | 2.7, 3,4 | | v0.5.0 | <=1.6 | 2 only | | v0.4.5 | <=1.4 | 2 only |
(version combination will be tested via travis-ci)
== history
== pip upgrade
To do a pip upgrade in a virtual environment, run this:
{{{ ~$ cd /YourVirtualEnv/bin ~/YourVirtualEnv/bin$ source activate (YourVirtualEnv)~/YourVirtualEnv/bin$ pip install --upgrade --verbose --editable=git+git://github.com/jedie/django-dbpreferences.git#egg=django-dbpreferences }}} The example used git readonly clone url. If you use subversion do this:
{{{ (YourVirtualEnv)~/YourVirtualEnv/bin$ pip install --upgrade --verbose --editable=http://svn.github.com/jedie/django-dbpreferences.git#egg=django-dbpreferences }}}
If you have git write access, use this: {{{ (YourVirtualEnv)~/YourVirtualEnv/bin$ pip install --upgrade --verbose --editable=git+git@github.com:jedie/django-dbpreferences.git#egg=django-dbpreferences }}}
== donation ==
If you like it, send some [[http://www.bitcoin.org/|Bitcoins]] to [[https://blockexplorer.com/address/1HLNVtZFwdHLavRKdUebTGHVn8A7e6Dgne|1HLNVtZFwdHLavRKdUebTGHVn8A7e6Dgne]] ;)
== links
| homepage | http://github.com/jedie/django-dbpreferences | PyPi | http://pypi.python.org/pypi/django-dbpreferences/
=== contact ===
Come into the conversation, besides the github communication features:
| Forum | http://www.pylucid.org/en/forum/10/ | IRC | #pylucid on freenode.net (Yes, the PyLucid channel...) | webchat | http://webchat.freenode.net/?channels=pylucid