django-eav2/docs/source/index.rst
2018-07-23 16:27:12 +00:00

72 lines
1.2 KiB
ReStructuredText

.. .. image:: _static/logo.png
.. :align: center
.. rst-class:: doc-title
Django EAV 2
============
Django EAV 2 is an entity-attribute-value storage for modern Django.
Getting started is very easy.
**Step 1.** Register a model:
.. code-block:: python
import eav
eav.register(Supplier)
or with decorators:
.. code-block:: python
from eav.decorators import register_eav
@register_eav
class Supplier(models.Model):
...
**Step 2.** Create an attribute:
.. code-block:: python
Attribute.objects.create(name='City', datatype=Attribute.TYPE_TEXT)
**Step 3.** That's it! You're ready to go:
.. code-block:: python
supplier.eav.city = 'London'
supplier.save()
Supplier.objects.filter(eav__city='London')
# = <EavQuerySet [<Supplier: Supplier object (1)>]>
Documentation
-------------
.. toctree::
:maxdepth: 2
getting_started
usage
API Reference
-------------
If you are looking for information on a specific function, class, or
method, this part of the documentation is for you.
.. toctree::
:maxdepth: 2
api
Indices and tables
------------------
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`