Cache manager for django models
Project description
===============================
django-cache-manager
===============================
Simple cache manager for django models that caches querysets for a model. Cache manager will cache any query that has been seen for a model. Model cache is evicted for any updates/deletes to the model. This manager is useful for models that don't change often.
[![Build Status](https://travis-ci.org/vijaykatam/django-cache-manager.svg?branch=master)](https://travis-ci.org/vijaykatam/django-cache-manager)
[![Coverage Status](https://img.shields.io/coveralls/vijaykatam/django-cache-manager.svg)](https://coveralls.io/r/vijaykatam/django-cache-manager)
## Installation
```sh
pip install django-cache-manager
```
### Caching strategy
* Cache results for a model on load.
* Evict cache for model on update.
## Usage
Add to installed apps
```
INSTALLED_APPS = (
...
'django_cache_manager',
...
)
```
Define cache backend for `django_cache_manager.cache_backend` in `settings.py`. The backend can be any cache backend
that implements django cache API.
```
CACHES = {
'django_cache_manager.cache_backend': {
'BACKEND': 'django.core.cache.backends.filebased.FileBasedCache',
'LOCATION': '/tmp/django_cache_manager',
'TIMEOUT': 0
}
}
```
```
from django_cache_manager.cache_manager import CacheManager
class MyModel(models.Model):
#set cache manager as default
objects = CacheManager()
# or declare a new manager
objects = models.Manager()
cached_objects = CacheManager()
```
## Django shell
To run django shell with sample models defined in tests.
```sh
make shell
```
Sample models
```
from tests.models import Manufacturer
from tests.models import Car
from tests.models import Driver
m = Manufacturer(name='Tesla')
m.save()
c = Car(make=m, model='Model S', year=2015)
c.save()
d = Driver(first_name ='ABC', last_name='XYZ')
d.save()
d.cars.add(c)
drivers = Driver.objects.select_related('car', 'manufacturer').all()
```
## Testing
To run tests
```sh
make test
```
##### Supported Django versions
Supported - 1.5, 1.6, 1.7
History
-------
0.1.0
---------------------
* Test coverage
* Cache invalidation for manytomany relation
0.1.0-beta.1
---------------------
* First beta release
django-cache-manager
===============================
Simple cache manager for django models that caches querysets for a model. Cache manager will cache any query that has been seen for a model. Model cache is evicted for any updates/deletes to the model. This manager is useful for models that don't change often.
[![Build Status](https://travis-ci.org/vijaykatam/django-cache-manager.svg?branch=master)](https://travis-ci.org/vijaykatam/django-cache-manager)
[![Coverage Status](https://img.shields.io/coveralls/vijaykatam/django-cache-manager.svg)](https://coveralls.io/r/vijaykatam/django-cache-manager)
## Installation
```sh
pip install django-cache-manager
```
### Caching strategy
* Cache results for a model on load.
* Evict cache for model on update.
## Usage
Add to installed apps
```
INSTALLED_APPS = (
...
'django_cache_manager',
...
)
```
Define cache backend for `django_cache_manager.cache_backend` in `settings.py`. The backend can be any cache backend
that implements django cache API.
```
CACHES = {
'django_cache_manager.cache_backend': {
'BACKEND': 'django.core.cache.backends.filebased.FileBasedCache',
'LOCATION': '/tmp/django_cache_manager',
'TIMEOUT': 0
}
}
```
```
from django_cache_manager.cache_manager import CacheManager
class MyModel(models.Model):
#set cache manager as default
objects = CacheManager()
# or declare a new manager
objects = models.Manager()
cached_objects = CacheManager()
```
## Django shell
To run django shell with sample models defined in tests.
```sh
make shell
```
Sample models
```
from tests.models import Manufacturer
from tests.models import Car
from tests.models import Driver
m = Manufacturer(name='Tesla')
m.save()
c = Car(make=m, model='Model S', year=2015)
c.save()
d = Driver(first_name ='ABC', last_name='XYZ')
d.save()
d.cars.add(c)
drivers = Driver.objects.select_related('car', 'manufacturer').all()
```
## Testing
To run tests
```sh
make test
```
##### Supported Django versions
Supported - 1.5, 1.6, 1.7
History
-------
0.1.0
---------------------
* Test coverage
* Cache invalidation for manytomany relation
0.1.0-beta.1
---------------------
* First beta release
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
django-cache-manager-0.1.0.tar.gz
(14.8 kB
view hashes)
Close
Hashes for django-cache-manager-0.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e6fd470b7afd0b42e5fb1c60b27e5dfd1651407b4634c59b326037d985f7eefa |
|
MD5 | ce8743154eb4622cb5e4139ce15c6a80 |
|
BLAKE2b-256 | 0f3d7e9809fa308773eca9b77304f7eb2fb9af489023dae4839d5ebb9aeaeec9 |