mirror of
https://github.com/jazzband/django-eav2.git
synced 2026-03-16 22:40:26 +00:00
93 lines
2.3 KiB
ReStructuredText
93 lines
2.3 KiB
ReStructuredText
django-eav
|
|
==========
|
|
|
|
|
|
Introduction
|
|
------------
|
|
|
|
django-eav provides an Entity-Attribute-Value storage model for django apps.
|
|
|
|
For a decent explanation of what an Entity-Attribute-Value storage model is,
|
|
check `Wikipedia
|
|
<http://http://en.wikipedia.org/wiki/Entity-attribute-value_model>`_.
|
|
|
|
.. note::
|
|
This software was inspired / derrived 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 implimentation 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
|
|
------------
|
|
|
|
From Github
|
|
~~~~~~~~~~~
|
|
You can install django-eav directly from guthub::
|
|
|
|
pip install -e git+git://github.com/mvpdev/django-eav.git#egg=django-eav
|
|
|
|
Usage
|
|
-----
|
|
|
|
Edit settings.py
|
|
~~~~~~~~~~~~~~~~
|
|
Add ``eav`` to your INSTALLED_APPS in your settings.py file.
|
|
|
|
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.
|
|
|
|
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>`_
|