mirror of
https://github.com/jazzband/django-eav2.git
synced 2026-04-04 15:40:37 +00:00
132 lines
3.4 KiB
Markdown
132 lines
3.4 KiB
Markdown
### django-eav2 - Entity-Attribute-Value storage model for Django
|
|
|
|
#### Introduction
|
|
|
|
django-eav2 is a fork of django-eav (which itself was derived from eav-django).
|
|
This project aims to:
|
|
|
|
- [ ] add Python 3 support
|
|
- [ ] add Django 1.11 and 2.0 support
|
|
- [ ] drop Django <1.11 dependencies
|
|
- [ ] remove dependency on Sites framework
|
|
- [ ] fix unresolved issues
|
|
- [ ] update documentation
|
|
- [ ] update/create tests
|
|
|
|
#### Overview
|
|
|
|
For a decent explanation of what an Entity-Attribute-Value storage model is,
|
|
check `Wikipedia
|
|
<http://en.wikipedia.org/wiki/Entity-attribute-value_model>`_.
|
|
|
|
.. note::
|
|
django-eav was inspired / derived from the excellent `eav-django
|
|
<http://pypi.python.org/pypi/eav-django/1.0.2>`_ written by Andrey
|
|
Mikhaylenko.
|
|
|
|
There are a few notable differences between this implementation and the
|
|
eav-django implementation.
|
|
|
|
* This one is called django-eav, whereas the other is called eav-django.
|
|
* This app allows you to to 'attach' EAV attributes to any existing django
|
|
model (even from third-party apps) without making any changes to the those
|
|
models' code.
|
|
* This app has slightly more robust (but still not perfect) filtering.
|
|
|
|
|
|
#### Installation
|
|
|
|
##### GitHub
|
|
|
|
You can install django-eav2 directly from github::
|
|
|
|
```
|
|
pip install -e git+git://github.com/makimo/djang-eav2.git#egg=django-eav
|
|
```
|
|
|
|
#### Prerequisites
|
|
|
|
##### Django Sites Framework
|
|
|
|
As of Django 1.7, the `Sites framework <https://docs.djangoproject.com/en/1.8/ref/contrib/sites/#enabling-the-sites-framework>`_ is not enabled by default; Django-EAV requires this framework.
|
|
To enable the sites framework, follow these steps:
|
|
|
|
Add ``django.contrib.sites`` to your INSTALLED_APPS setting. Be sure to add sites to the installed apps list BEFORE eav!
|
|
|
|
Define a ``SITE_ID`` setting::
|
|
|
|
SITE_ID = 1
|
|
|
|
Run ``migrate``
|
|
|
|
#### Usage
|
|
|
|
##### Edit settings.py
|
|
|
|
Add ``eav`` to your ``INSTALLED_APPS`` in your project's ``settings.py`` file. Be sure to add eav to the installed apps list AFTER the sites framework!
|
|
|
|
##### Register your model(s)
|
|
|
|
Before you can attach eav attributes to your model, you must register your
|
|
model with eav::
|
|
|
|
>>> import eav
|
|
>>> eav.register(MyModel)
|
|
|
|
Generally you would do this in your ``models.py`` immediate after your model
|
|
declarations. Alternatively, you can use the registration decorator provided::
|
|
|
|
from eav.decorators import register_eav
|
|
@register_eav()
|
|
class MyModel(models.Model):
|
|
...
|
|
|
|
##### Create some attributes
|
|
|
|
::
|
|
|
|
>>> from eav.models import Attribute
|
|
>>> Attribute.objects.create(name='Weight', datatype=Attribute.TYPE_FLOAT)
|
|
>>> Attribute.objects.create(name='Color', datatype=Attribute.TYPE_TEXT)
|
|
|
|
|
|
##### Assign eav values
|
|
|
|
::
|
|
|
|
>>> m = MyModel()
|
|
>>> m.eav.weight = 15.4
|
|
>>> m.eav.color = 'blue'
|
|
>>> m.save()
|
|
>>> m = MyModel.objects.get(pk=m.pk)
|
|
>>> m.eav.weight
|
|
15.4
|
|
>>> m.eav.color
|
|
blue
|
|
|
|
>>> p = MyModel.objects.create(eav__weight = 12, eav__color='red')
|
|
|
|
##### Filter on eav values
|
|
|
|
::
|
|
|
|
>>> MyModel.objects.filter(eav__weight=15.4)
|
|
|
|
>>> MyModel.objects.exclude(name='bob', eav__weight=15.4, eav__color='red')
|
|
|
|
|
|
#### Documentation and Examples
|
|
|
|
`<http://mvpdev.github.com/django-eav>`_
|
|
|
|
|
|
#### Development
|
|
|
|
##### Running tests
|
|
|
|
Run tests with the `runtests` script. To run all tests use it without
|
|
arguments or with `--all` option. To run specific tests, just type their names:
|
|
|
|
```
|
|
./runtests queries models registry
|
|
```
|