Stores a model as a dictionary
Retired: this project is no longer maintained. I (Adam Johnson) no longer have time to continue maintaining this. I was doing so to support gargoyle-yplan, a fork for my ex-employer YPlan. If you’d like to sponsor ongoing maintenance or take it over yourself, please contact firstname.lastname@example.org.
ModelDict is a very efficient way to store things like settings in your database. The entire model is transformed into a dictionary (lazily) as well as stored in your cache. It’s invalidated only when it needs to be (both in process and based on CACHE_BACKEND).
It was originally created by Disqus, but due to the inactivity we at YPlan have taken over maintenance on this fork.
Tested with all combinations of:
- Python: 3.6
- Django: 1.11, 2.0, 2.1, 2.2
Python 3.4+ supported.
Install it with pip:
pip install django-modeldict-yplan
Make sure you pip uninstall django-modeldict first if you’re upgrading from the original to this fork - the packages clash.
# You'll need a model with fields to use as key and value in the dict class Setting(models.Model): key = models.CharField(max_length=32) value = models.CharField(max_length=200) # Create the ModelDict... settings = ModelDict(Setting, key='key', value='value', instances=False) # And you can treat it like a normal dict: # Missing values = KeyError settings['foo'] >>> KeyError # Sets supported settings['foo'] = 'hello' # Fetch the current value using normal dictionary access settings['foo'] >>> 'hello' # ...or by normal model queries Setting.objects.get(key='foo').value >>> 'hello'
- Tested with Django 2.2. No changes were needed for compatibility.
- No functional changes. This is a re-release of version 2.0.0 to fix immutable metadata on PyPI so that Pip on Python 2 doesn’t pick up the Python 3 only 2.X series. Version 2.0.0 will be pulled from PyPI on 2019-03-01.
This version is due to be pulled from PyPI, please use version 2.0.1 as per its above release note.
- Drop Python 2 support, only Python 3.4+ is supported now.
- Drop Django 1.8, 1.9, and 1.10 support. Only Django 1.11+ is supported now.
- Remove iteritems(), iterkeys(), and itervalues() methods from ModelDict, and move items(), keys(), and values() to Python 3 semantics, returning iterators rather than lists.
- Include LICENSE file in wheel.
- Tested with Django 2.1. No changes were needed for compatibility.
- Fixed a race condition in threaded code. See https://github.com/adamchainz/django-modeldict/pull/40 for a detailed explanation. Thanks @Jaidan.
- Stop rounding time.time() down to the nearest integer, so we are more fine grained around expiration. It might also fix a subtle timing bug around re-fetching the remote cache unnecessarily.
- Fixed update missing when _local_last_updated could be set even when it wasn’t updated
- Fixed update missing from integer rounding in time comparison
- Fixed CachedDict.__repr__ so it works for other subclasses of CachedDict than ModelDict (don’t assume self.model exists)
- Fixed local cache never expiring if value was checked too often.
- Use Django’s cache.set_many for more efficient storage.
- Forked by YPlan
- Fixed concurrency TOCTTOU bug for threaded Django servers.
- Stopped including the ‘tests’ directory in package
- Django 1.8 and 1.9 supported.
- Python 3 support added.
- Fixed setdefault() to return the value that was set/found, as per normal dict semantics. Thanks @olevinsky.
- Last release by Disqus
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size django_modeldict_yplan-2.0.3-py3-none-any.whl (15.6 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size django-modeldict-yplan-2.0.3.tar.gz (14.0 kB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for django_modeldict_yplan-2.0.3-py3-none-any.whl
Hashes for django-modeldict-yplan-2.0.3.tar.gz