refactor: rename TokenFamilyBlacklist model to BlacklistedTokenFamily and add abstract workaround

- Renamed TokenFamilyBlacklist to BlacklistedTokenFamily to align with the existing naming convention used in the token_blacklist app (BlacklistedToken model).
- Updated all references to TokenFamilyBlacklist in the codebase to reflect the new model name.
- Added 'abstract' attribute to the token_family app models to match the pattern used in the token_blacklist models.

Author: juanbailon

rest_framework_simplejwt/token_family/models.py

@@ -21,6 +21,17 @@ class TokenFamily(models.Model):
     class Meta:
         verbose_name = _("Token Family")
         verbose_name_plural = _("Token Families")
+        # Work around for a bug in Django:
+        # https://code.djangoproject.com/ticket/19422
+        #
+        # Also see corresponding ticket:
+        # https://github.com/encode/django-rest-framework/issues/705
+        # 
+        # NOTE: Although this issue did not manifest in the Django shell (calling save()
+        # raised an error as expected), it did occur when running the tests.
+        abstract = (
+            "rest_framework_simplejwt.token_family" not in settings.INSTALLED_APPS
+        )
 
     def __str__(self) -> str:
         return _("Token Family for %(user)s (%(family_id)s)") % {
@@ -29,7 +40,7 @@ def __str__(self) -> str:
         }
 
 
-class TokenFamilyBlacklist(models.Model):
+class BlacklistedTokenFamily(models.Model):
     id = models.BigAutoField(primary_key=True, serialize=False)
     family = models.OneToOneField(TokenFamily, on_delete=models.CASCADE, related_name="blacklisted")
 
@@ -38,6 +49,17 @@ class TokenFamilyBlacklist(models.Model):
     class Meta:
         verbose_name = _("Token Family Blacklist")
         verbose_name_plural = _("Blacklisted Token Families")
+        # Work around for a bug in Django:
+        # https://code.djangoproject.com/ticket/19422
+        #
+        # Also see corresponding ticket:
+        # https://github.com/encode/django-rest-framework/issues/705
+        # 
+        # NOTE: Although this issue did not manifest in the Django shell (calling save()
+        # raised an error as expected), it did occur when running the tests.
+        abstract = (
+            "rest_framework_simplejwt.token_family" not in settings.INSTALLED_APPS
+        )
 
     def __str__(self) -> str:
         return _("Blacklisted Token Family (%(family_id)s) for %(user)s") % {

rest_framework_simplejwt/tokens.py

@@ -18,7 +18,7 @@
 from .models import TokenUser
 from .settings import api_settings
 from .token_blacklist.models import BlacklistedToken, OutstandingToken
-from .token_family.models import TokenFamily, TokenFamilyBlacklist
+from .token_family.models import TokenFamily, BlacklistedTokenFamily
 from .utils import (
     aware_utcnow,
     datetime_from_epoch,
@@ -378,7 +378,7 @@ def verify(self, *args, **kwargs) -> None:
 
             super().verify(*args, **kwargs)  # type: ignore
 
-        def blacklist_family(self) -> TokenFamilyBlacklist:
+        def blacklist_family(self) -> BlacklistedTokenFamily:
             """
             Blacklists the token family.
             """
@@ -397,7 +397,7 @@ def blacklist_family(self) -> TokenFamilyBlacklist:
             )
 
             # Blacklist the entire family
-            return TokenFamilyBlacklist.objects.get_or_create(family=family)[0]
+            return BlacklistedTokenFamily.objects.get_or_create(family=family)[0]
 
         def get_family_id(self) -> Optional[str]:
             return self.payload.get(api_settings.TOKEN_FAMILY_CLAIM, None)
@@ -443,7 +443,7 @@ def check_family_blacklist(token: T) -> None:
                 logger.warning(f"Token of user:{user_id} does not have a family_id. Skipping family blacklist check.")
                 return
 
-            if TokenFamilyBlacklist.objects.filter(family__family_id=family_id).exists():
+            if BlacklistedTokenFamily.objects.filter(family__family_id=family_id).exists():
                 raise TokenError(_("Token family is blacklisted"))
 
         @staticmethod