а вот и код

.gitignore

@@ -0,0 +1,10 @@
+.project
+.pydevproject
+.settings
+
+*~
+
+*.pyc
+*.pyo
+
+*.sqlite

README.rst

@@ -0,0 +1,72 @@
+======================
+Django-temporal-models
+======================
+
+Django-temporal-models это темпоральные модели навеянные 1совскими регистрами сведений.
+
+Небольшой пример
+==============
+	from temporal.models import models, TemporalForeignKey, TemporalModel, TemporalTrail
+
+	class Person(TemporalModel):
+	    first_name = models.CharField(max_length=255)
+	    last_name = models.CharField(max_length=255)
+	    salary = models.PositiveIntegerField()
+	    organization = TemporalForeignKey('Organization')
+
+	    history = TemporalTrail()
+
+	    def __str__(self):
+	        return u"%s %s" % (self.first_name, self.last_name)
+
+	class Organization(TemporalModel):
+	    name = models.CharField(max_length=255)
+
+	    history = TemporalTrail()
+
+	    def __str__(self):
+	        return u"%s" % (self.name)
+
+	...
+
+	>>> from app.models import Organization, Person
+	>>> from datetime import date
+	>>>
+	>>>	org = Organization.objects.create(name=u'Муниципальное унитарное предприятие городского транспорта "Тюменьгортранс"', date_begin=date(1997, 01, 31))
+	>>>
+	>>> org.name = u'Муниципальное учреждение пассажирского городского транспорта "Тюменьгортранс"'
+	>>> org.date_begin = date(2004,7,1)
+	>>> org.save()
+	>>>
+	>>> org.name = u'Муниципальное казенное учреждение "Тюменьгортранс"'
+	>>> org.date_begin = date(2012,1,11)
+	>>> org.save()
+	>>>
+	>>> org.get_actual(date(2010,1,1))
+	<OrganizationTemporal: Муниципальное учреждение пассажирского городского транспорта "Тюменьгортранс" as of 2004-07-01..2012-01-10>
+	>>>
+	>>> person = Person.objects.create(first_name=u'Василий', last_name=u'Пупкин', salary=7000, organization=org, date_begin=date(2000,5,10))
+	>>>	
+	>>> person.date_begin=date(2005,1,1)
+	>>> person.salary=12000
+	>>> person.save()
+	>>>
+	>>> person.date_begin=date(2010,1,1)
+	>>> person.salary=17000
+	>>> person.save()
+	>>>
+	>>> person.date_begin=date(2012,2,1)
+	>>> person.salary=20000
+	>>> person.save()
+	>>>
+	>>> person.get_actual()
+	<PersonTemporal: Василий Пупкин as of 2012-02-01..>
+	>>> 
+	>>> person.get_actual().organization
+	<OrganizationTemporal: Муниципальное казенное учреждение "Тюменьгортранс" as of 2012-01-11..>
+	>>> 
+	>>> person.get_actual(date(2011,10,1))
+	<PersonTemporal: Василий Пупкин as of 2010-01-01..2012-01-31>
+	>>>
+	>>> person.get_actual(date(2011,10,1)).organization
+	<OrganizationTemporal: Муниципальное учреждение пассажирского городского транспорта "Тюменьгортранс" as of 2004-07-01..2012-01-10>

example/app/models.py

@@ -0,0 +1,20 @@
+from temporal.models import models, TemporalForeignKey, TemporalModel, TemporalTrail
+
+class Person(TemporalModel):
+    first_name = models.CharField(max_length=255)
+    last_name = models.CharField(max_length=255)
+    salary = models.PositiveIntegerField()
+    organization = TemporalForeignKey('Organization')
+
+    history = TemporalTrail()
+
+    def __str__(self):
+        return u"%s %s" % (self.first_name, self.last_name)
+
+class Organization(TemporalModel):
+    name = models.CharField(max_length=255)
+
+    history = TemporalTrail()
+
+    def __str__(self):
+        return u"%s" % (self.name)

example/app/tests.py

@@ -0,0 +1,16 @@
+"""
+This file demonstrates writing tests using the unittest module. These will pass
+when you run "manage.py test".
+
+Replace this with more appropriate tests for your application.
+"""
+
+from django.test import TestCase
+
+
+class SimpleTest(TestCase):
+    def test_basic_addition(self):
+        """
+        Tests that 1 + 1 always equals 2.
+        """
+        self.assertEqual(1 + 1, 2)

example/app/views.py

@@ -0,0 +1 @@
+# Create your views here.

example/manage.py

@@ -0,0 +1,14 @@
+#!/usr/bin/env python
+from django.core.management import execute_manager
+import imp
+try:
+    imp.find_module('settings') # Assumed to be in the same directory.
+except ImportError:
+    import sys
+    sys.stderr.write("Error: Can't find the file 'settings.py' in the directory containing %r. It appears you've customized things.\nYou'll have to run django-admin.py, passing it your settings module.\n" % __file__)
+    sys.exit(1)
+
+import settings
+
+if __name__ == "__main__":
+    execute_manager(settings)

example/settings.py

@@ -0,0 +1,149 @@
+# Django settings for example project.
+
+from os.path import dirname, realpath, join
+at_project_root = lambda *args: join(realpath(dirname(__file__)), *args)
+
+
+DEBUG = True
+TEMPLATE_DEBUG = DEBUG
+
+ADMINS = (
+    # ('Your Name', 'your_email@example.com'),
+)
+
+MANAGERS = ADMINS
+
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.contrib.gis.db.backends.mysql', # Add 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
+        'NAME': 'example',                      # Or path to database file if using sqlite3.
+        'USER': '',                      # Not used with sqlite3.
+        'PASSWORD': '',                  # Not used with sqlite3.
+        'HOST': 'localhost',                      # Set to empty string for localhost. Not used with sqlite3.
+    }
+}
+
+# Local time zone for this installation. Choices can be found here:
+# http://en.wikipedia.org/wiki/List_of_tz_zones_by_name
+# although not all choices may be available on all operating systems.
+# On Unix systems, a value of None will cause Django to use the same
+# timezone as the operating system.
+# If running in a Windows environment this must be set to the same as your
+# system time zone.
+TIME_ZONE = 'America/Chicago'
+
+# Language code for this installation. All choices can be found here:
+# http://www.i18nguy.com/unicode/language-identifiers.html
+LANGUAGE_CODE = 'en-us'
+
+SITE_ID = 1
+
+# If you set this to False, Django will make some optimizations so as not
+# to load the internationalization machinery.
+USE_I18N = True
+
+# If you set this to False, Django will not format dates, numbers and
+# calendars according to the current locale
+USE_L10N = True
+
+# Absolute filesystem path to the directory that will hold user-uploaded files.
+# Example: "/home/media/media.lawrence.com/media/"
+MEDIA_ROOT = ''
+
+# URL that handles the media served from MEDIA_ROOT. Make sure to use a
+# trailing slash.
+# Examples: "http://media.lawrence.com/media/", "http://example.com/media/"
+MEDIA_URL = ''
+
+# Absolute path to the directory static files should be collected to.
+# Don't put anything in this directory yourself; store your static files
+# in apps' "static/" subdirectories and in STATICFILES_DIRS.
+# Example: "/home/media/media.lawrence.com/static/"
+STATIC_ROOT = ''
+
+# URL prefix for static files.
+# Example: "http://media.lawrence.com/static/"
+STATIC_URL = '/static/'
+
+# URL prefix for admin static files -- CSS, JavaScript and images.
+# Make sure to use a trailing slash.
+# Examples: "http://foo.com/static/admin/", "/static/admin/".
+ADMIN_MEDIA_PREFIX = '/static/admin/'
+
+# Additional locations of static files
+STATICFILES_DIRS = (
+    # Put strings here, like "/home/html/static" or "C:/www/django/static".
+    # Always use forward slashes, even on Windows.
+    # Don't forget to use absolute paths, not relative paths.
+)
+
+# List of finder classes that know how to find static files in
+# various locations.
+STATICFILES_FINDERS = (
+    'django.contrib.staticfiles.finders.FileSystemFinder',
+    'django.contrib.staticfiles.finders.AppDirectoriesFinder',
+#    'django.contrib.staticfiles.finders.DefaultStorageFinder',
+)
+
+# Make this unique, and don't share it with anybody.
+SECRET_KEY = 'jkiqbq$c7^5qvw1w^lib2sm4&lpl-=2vykpzwgg1jr=(&c1tu1'
+
+# List of callables that know how to import templates from various sources.
+TEMPLATE_LOADERS = (
+    'django.template.loaders.filesystem.Loader',
+    'django.template.loaders.app_directories.Loader',
+#     'django.template.loaders.eggs.Loader',
+)
+
+MIDDLEWARE_CLASSES = (
+    'django.middleware.common.CommonMiddleware',
+    'django.contrib.sessions.middleware.SessionMiddleware',
+    'django.middleware.csrf.CsrfViewMiddleware',
+    'django.contrib.auth.middleware.AuthenticationMiddleware',
+    'django.contrib.messages.middleware.MessageMiddleware',
+)
+
+ROOT_URLCONF = 'example.urls'
+
+TEMPLATE_DIRS = (
+    # Put strings here, like "/home/html/django_templates" or "C:/www/django/templates".
+    # Always use forward slashes, even on Windows.
+    # Don't forget to use absolute paths, not relative paths.
+)
+
+INSTALLED_APPS = (
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.sites',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    # Uncomment the next line to enable the admin:
+    # 'django.contrib.admin',
+    # Uncomment the next line to enable admin documentation:
+    # 'django.contrib.admindocs',
+    'app'
+)
+
+# A sample logging configuration. The only tangible logging
+# performed by this configuration is to send an email to
+# the site admins on every HTTP 500 error.
+# See http://docs.djangoproject.com/en/dev/topics/logging for
+# more details on how to customize your logging configuration.
+LOGGING = {
+    'version': 1,
+    'disable_existing_loggers': False,
+    'handlers': {
+        'mail_admins': {
+            'level': 'ERROR',
+            'class': 'django.utils.log.AdminEmailHandler'
+        }
+    },
+    'loggers': {
+        'django.request': {
+            'handlers': ['mail_admins'],
+            'level': 'ERROR',
+            'propagate': True,
+        },
+    }
+}

example/temporal

@@ -0,0 +1 @@
+../temporal

example/urls.py

@@ -0,0 +1,17 @@
+from django.conf.urls.defaults import patterns, include, url
+
+# Uncomment the next two lines to enable the admin:
+# from django.contrib import admin
+# admin.autodiscover()
+
+urlpatterns = patterns('',
+    # Examples:
+    # url(r'^$', 'example.views.home', name='home'),
+    # url(r'^example/', include('example.foo.urls')),
+
+    # Uncomment the admin/doc line below to enable admin documentation:
+    # url(r'^admin/doc/', include('django.contrib.admindocs.urls')),
+
+    # Uncomment the next line to enable the admin:
+    # url(r'^admin/', include(admin.site.urls)),
+)

temporal/models/__init__.py

@@ -0,0 +1,80 @@
+# -*- coding: utf-8 -*-
+
+from django.contrib.gis.db import models
+from django.contrib.gis.db.models.query import GeoQuerySet as QuerySet
+from django.contrib.auth.models import User
+
+from django.db.models import Q
+from datetime import date
+
+from temporal.models.fields import TemporalForeignKey
+from temporal.models.trail import TemporalTrail
+
+
+#def temporal_period(obj):
+#    return '%s..%s' % (obj.date_begin.date(), obj.date_end and obj.date_end.date() or '')
+
+
+class FakeDeleteQuerySet(QuerySet):
+    ' QuerySet, не удаляющий данные физически '
+
+    def delete(self):
+        self.update(**{'deleted': True})
+    delete.alters_data = True
+
+
+class ActualManager(models.GeoManager):
+    ' Менеджер актуальных записей '
+
+    def get_query_set(self):
+        return FakeDeleteQuerySet(self.model, using=self._db).filter(deleted=False)
+
+    def get_plain_queryset(self):
+        return QuerySet(self.model, using=self._db)
+
+
+class ActualModel(models.Model):
+    ' Модель для актуальных данных '
+
+    # Поле для пометки актуальных записей.
+    # Если запись уже не актуальна - она не удаляется физически, а лишь помечается как неактивная
+    deleted = models.BooleanField(u'Удален', default=False, editable=False)
+
+    # По-умолчанию будут выдаваться только актуальные записи
+    # Порядок важен! _default_manager - это первый объявленный менеджер
+    objects = ActualManager()
+
+    def delete(self, *args, **kwargs):
+        '''
+        fake delete
+        '''
+        real_delete = kwargs.get('real_delete', False)
+        if not real_delete:
+            self.deleted = True
+            self.save()
+        else:
+            super(ActualModel, self).delete(*args, **kwargs)
+
+    class Meta:
+        abstract = True
+
+
+class TemporalModel(ActualModel):
+    '''
+    Модель для темпоральных данных.
+    '''
+
+    date_begin = models.DateTimeField();
+    date_end = models.DateTimeField(null=True, blank=True, editable=False);
+
+    def delete(self, *args, **kwargs):
+        kwargs['date_delete'] = kwargs.get('date_delete', date.today())
+        self.date_begin = kwargs['date_delete'] 
+        super(TemporalModel, self).delete(*args, **kwargs)
+
+    def get_actual(self, actual_date=None):
+        return self.history.get_actual(actual_date)
+
+    class Meta:
+        unique_together = ("id", "date_begin")
+        abstract = True