django-models 0.1.0

Requirements

• Python 3.x

• Django 1.11 or later

Features

Generic Models

• ActiveModel

  Model with is_active boolean field

• CodeModel

  Model with 32 characters hash code to use to identify your record

• SerializerModel

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

Example:

Your Model

from django_models.models import SignalsModel
...

class YourModel(SignalsModel)
    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 slug field

• TimestampedModel

  Model with created_at and updated_at DateTime fields

• UUIDModel

  Model using the field id as UUID

• Signals

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

On save:

• pre_save

• post_save

On Delete

• pre_delete

• post_delete

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()

• History models

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

How to install

$ pip install django-models

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

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

Documentation

Check out the latest django-models documentation at Read the Docs

Contributing

Please send pull requests, very much appreciated.

1. Fork the repository on GitHub.

2. Make a branch off of master and commit your changes to it.

3. Install requirements. pip install -r requirements-dev.txt

4. Install pre-commit. pre-commit install

5. Run the tests with cd test-django-project; py.test -vv -s

6. Create a Pull Request with your contribution