Allow overriding user's attribute names for related managers

Author: macro1

CHANGES.rst

@@ -5,6 +5,7 @@ tip (unreleased)
 ----------------
 - Removed some incompatibilities with non-default admin sites (gh-92)
 - Fixed error caused by ``HistoryRequestMiddleware`` during anonymous requests (gh-115 fixes gh-114)
+- Added workaround for clashing related historical accessors on User (gh-121)
 
 1.5.0 (2014-08-17)
 ------------------

simple_history/models.py

@@ -57,8 +57,10 @@ def python_2_unicode_compatible(klass):
 class HistoricalRecords(object):
     thread = threading.local()
 
-    def __init__(self, verbose_name=None, bases=(models.Model,)):
+    def __init__(self, verbose_name=None, bases=(models.Model,),
+                 user_related_name=None):
         self.user_set_verbose_name = verbose_name
+        self.user_related_name = user_related_name
         try:
             if isinstance(bases, basestring):
                 raise TypeError
@@ -178,7 +180,8 @@ def get_instance(self):
         return {
             'history_id': models.AutoField(primary_key=True),
             'history_date': models.DateTimeField(),
-            'history_user': models.ForeignKey(user_model, null=True),
+            'history_user': models.ForeignKey(
+                user_model, null=True, related_name=self.user_related_name),
             'history_type': models.CharField(max_length=1, choices=(
                 ('+', 'Created'),
                 ('~', 'Changed'),

simple_history/tests/external/models/__init__.py

@@ -12,7 +12,7 @@ class Poll(models.Model):
 
     This model intentionally conflicts with the 'Polls' model in 'tests.models'.
     """
-    history = HistoricalRecords()
+    history = HistoricalRecords(user_related_name='+')
 
     class Meta:
         app_label = 'external'