Skip to main content

Additional, dynamic fields for all Django models.

Project description

=====================
django-specifications
=====================

.. image:: https://travis-ci.org/matthiask/django-specifications.png?branch=master
:target: https://travis-ci.org/matthiask/django-specifications

Version |release|

This module offers an easy way to attach auxiliary information to Django
models. It allows configuring custom forms through the administration
interface.

Usage
=====

1. Add ``"specifications"`` to ``INSTALLED_APPS``.
2. Create a ``specification = ForeignKey("specifications.Specification")``
on the model you want to use specifications with. The foreign key can
be nullable or required, as you wish.
3. Create the place where the specification field data is actually stored::

from specifications.models import SpecificationValueFieldBase

class MyObjectField(SpecificationValueFieldBase):
parent = models.ForeignKey(
MyObject,
on_delete=models.CASCADE,
related_name="fields",
)

class Meta:
ordering = ["field__group__ordering", "ordering"]

4. Inherit from ``FormWithSpecification`` when creating your ``ModelForm``::

from specifications.forms import FormWithSpecification

class MyObjectForm(FormWithSpecification):
class Meta:
model = MyObject

5. If you want to edit models with specifications you might want to use
the following snippet::

from specifications.admin import ModelAdminWithSpecification

class MyObjectAdmin(ModelAdminWithSpecification):
def get_fieldsets(self, request, obj=None):
# Define your fieldsets
fieldsets = [...]
if self.can_add_specification_fields(request, obj):
# Extend your fieldset with specification fields
fieldsets.extend(...)
return fieldsets

The fields are available after saving a specification. The specification can
be changed, but you risk losing data if you do this.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-specifications-0.3.0.tar.gz (10.3 kB view hashes)

Uploaded Source

Built Distribution

django_specifications-0.3.0-py2.py3-none-any.whl (13.9 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page