Some Django model mixins

mixins.py

# Copyright (c) 2012, Vehbi Sinan Tunalioglu <[email protected]>
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
#
# - Redistributions of source code must retain the above copyright
#   notice, this list of conditions and the following disclaimer.
#
# - Redistributions in binary form must reproduce the above copyright
#   notice, this list of conditions and the following disclaimer in
#   the documentation and/or other materials provided with the
#   distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
# FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
# COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from django.db import models
from echelon.fields import CurrentUserField


class CreateMixin(models.Model):
    """
    Provides a mixin for annotating a DB object with timestamp and
    user information of creation.
    """

    created_at = models.DateTimeField(auto_now_add=True)
    """
    Defines the date and time when the object is created at.
    """

    created_by = CurrentUserField(add_only=True,
                                  related_name="created_%(class)s")
    """
    Relates to the user whom the object is created by.
    """

    class Meta:
        abstract = True


class ModifyMixin(models.Model):
    """
    Provides a mixin for annotating a DB object with timestamp and
    user information of modification.
    """

    modified_at = models.DateTimeField(auto_now_add=True)
    """
    Defines the date and time when the object is modified at.
    """

    modified_by = CurrentUserField(related_name="modified_%(class)s")
    """
    Relates to the user whom the object is modified by.
    """

    class Meta:
        abstract = True

hello django