Django Models

Django Models is Library with several useful Models for Django to help you make your templates smart or with less code

Requirements

ActiveModel

Model with is_active boolean field
CodeModel

Model with a code field that automatically generates a hash of 16 characters by default. Useful to identify your record in a more humane way
SerializerModel

Model to return a dict with all data of your django instance without a serializer.

Example:

Your Model

from django_models.models import SerializerModel
...

class YourModel(SerializerModel)
    name = models.CharField(max_length=255)
    ...

Usage

In[1]: from . import YourModel
In[2]: instance = YourModel.objects.first()
In[3]: user.serialize()
Out[3]: {'id': 1, 'name': 'first record', ...}

SlugModel

Model with a slug field. Useful to use in urls or nominal references
TimestampedModel

Model with the DateTime, created_at and updated_at fields. Useful to control when any changes were made.
UUIDModel

Model that uses the id field as a UUID. Useful to be able to have a unique identifier without worrying about sequences.

History Model Model that track each save to generate a History Changes of a record

With SignalModel it allows you to handle or execute an event according to Django's Signals.

On Save:

On Erase:

Example using Pre-save signal

Note: This will be made before you save your model

from django_models.models import SignalsModel
...

class YourModel(SignalsModel)
    ...
    def pre_save(self):
        do_something()

SoftDeleteSignalModel Models

It is the SignalsModel with soft delete implemented. Allows nothing you delete to be really deleted from the system and easy to recover

You can get Django Models by using pip:

$ pip install django-models

If you want to install it from source, grab the git repository from GitHub and run setup.py:

$ git clone git@github.com:rhenter/django_models.git
$ cd django_models
$ python setup.py install

To enable django_models in your project you need to add it to INSTALLED_APPS in your projects settings.py file:

INSTALLED_APPS = (
    ...
    'django_models',
    ...
)

Check out the latest django-models documentation at GitHub Pages

Please send pull requests, very much appreciated.