Fix PEP8

Author: Rafael Henter

django_models/__init__.py

@@ -17,18 +17,12 @@
 
 from typing import List
 
-default_app_config = 'django_models.apps.DjangoModelsConfig'
+default_app_config = "django_models.apps.DjangoModelsConfig"
 
 from .version import __version__  # noqa
 from . import utils  # noqa
 from . import fields  # noqa
 from . import forms  # noqa
 from . import validators  # noqa
 
-__all__: List[str] = [
-    '__version__',
-    'utils',
-    'fields', 
-    'forms',
-    'validators'
-]
+__all__: List[str] = ["__version__", "utils", "fields", "forms", "validators"]

django_models/apps.py

@@ -4,10 +4,11 @@
 class DjangoModelsConfig(AppConfig):
     """
     Django app configuration for django_models package.
-    
+
     This configuration class is required for Django to properly
     recognize and load the django_models package as a Django app.
     """
-    default_auto_field = 'django.db.models.BigAutoField'
-    name = 'django_models'
-    verbose_name = 'Django Models Library'
+
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "django_models"
+    verbose_name = "Django Models Library"

django_models/fields.py

@@ -1,5 +1,5 @@
 import uuid
-from typing import Any, Optional
+from typing import Any
 
 from django.core.validators import RegexValidator
 from django.db import models
@@ -12,7 +12,7 @@ class UUIDPrimaryKeyField(models.UUIDField):
 
     This field automatically configures itself as:
     - primary_key=True
-    - unique=True  
+    - unique=True
     - editable=False
 
     It generates a UUID4 value automatically when the model instance is saved
@@ -27,9 +27,9 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
             *args: Variable length argument list passed to parent class
             **kwargs: Arbitrary keyword arguments passed to parent class
         """
-        kwargs['primary_key'] = True
-        kwargs['unique'] = True
-        kwargs['editable'] = False
+        kwargs["primary_key"] = True
+        kwargs["unique"] = True
+        kwargs["editable"] = False
         super().__init__(*args, **kwargs)
 
     def pre_save(self, model_instance: Model, add: bool) -> uuid.UUID:
@@ -56,13 +56,13 @@ class CharFieldDigitsOnly(models.CharField):
     """
     A CharField that only accepts digits and whitespace characters.
 
-    This field validates that the input contains only digits (0-9) and 
+    This field validates that the input contains only digits (0-9) and
     whitespace characters. It's useful for fields like phone numbers,
     postal codes, or other numeric identifiers that may contain spaces.
     """
+
     default_validators = [
         RegexValidator(
-            r'^([\s\d]+)$', 
-            'Only digits and whitespace characters are allowed.'
+            r"^([\s\d]+)$", "Only digits and whitespace characters are allowed."
         )
     ]

django_models/forms.py

@@ -1,4 +1,4 @@
-from typing import Any, Tuple, Union
+from typing import Any, Tuple
 from django.forms import ValidationError
 from django.forms.fields import CharField
 from django.utils.translation import gettext_lazy as _
@@ -17,6 +17,7 @@ class InvalidValuesField:
     Attributes:
         invalid_values: A tuple of values that are considered invalid for this field.
     """
+
     invalid_values: Tuple[str, ...] = ()
 
     def clean(self, value: str) -> str:
@@ -49,9 +50,12 @@ class CPFField(InvalidValuesField, CharField):
     Attributes:
         invalid_values: Tuple of known invalid CPF values that should be rejected
     """
-    invalid_values: Tuple[str, ...] = ('00000000191',)
 
-    def __init__(self, max_length: int = 14, min_length: int = 11, *args: Any, **kwargs: Any) -> None:
+    invalid_values: Tuple[str, ...] = ("00000000191",)
+
+    def __init__(
+        self, max_length: int = 14, min_length: int = 11, *args: Any, **kwargs: Any
+    ) -> None:
         """
         Initialize the CPF field.
 
@@ -94,13 +98,22 @@ class CNPJField(InvalidValuesField, CharField):
     Attributes:
         invalid_values: Tuple of known invalid CNPJ values that should be rejected
     """
+
     invalid_values: Tuple[str, ...] = (
-        '00000000000000', '22222222000191', '33333333000191', '44444444000191',
-        '55555555000191', '66666666000191', '77777777000191', '88888888000191',
-        '99999999000191'
+        "00000000000000",
+        "22222222000191",
+        "33333333000191",
+        "44444444000191",
+        "55555555000191",
+        "66666666000191",
+        "77777777000191",
+        "88888888000191",
+        "99999999000191",
     )
 
-    def __init__(self, min_length: int = 14, max_length: int = 18, *args: Any, **kwargs: Any) -> None:
+    def __init__(
+        self, min_length: int = 14, max_length: int = 18, *args: Any, **kwargs: Any
+    ) -> None:
         """
         Initialize the CNPJ field.
 

django_models/models/__init__.py

@@ -3,6 +3,11 @@
 from .history import HistoryModel  # noqa
 
 __all__ = [
-    'SlugModel', 'TimestampedModel', 'UUIDModel', 'SerializerModel',
-    'SignalsModel', 'HistoryModel', 'SoftDeleteSignalModel',
+    "SlugModel",
+    "TimestampedModel",
+    "UUIDModel",
+    "SerializerModel",
+    "SignalsModel",
+    "HistoryModel",
+    "SoftDeleteSignalModel",
 ]

django_models/models/generic.py

@@ -1,5 +1,5 @@
 from functools import partial
-from typing import Any, Dict, Type, Optional
+from typing import Any, Dict, Type
 from uuid import UUID
 
 from django.db import models
@@ -38,7 +38,8 @@ class ActiveModel(models.Model):
     Attributes:
         is_active (BooleanField): Boolean field indicating if the record is active
     """
-    is_active = models.BooleanField(_('Active'), default=True)
+
+    is_active = models.BooleanField(_("Active"), default=True)
 
     class Meta:
         abstract = True
@@ -56,10 +57,11 @@ class CodeModel(models.Model):
     Attributes:
         code (CharField): Unique 8-character code automatically generated
     """
+
     code = models.CharField(
         max_length=32,
         default=generate_code,
-        verbose_name=_('Model code'),
+        verbose_name=_("Model code"),
         unique=True,
     )
 
@@ -85,12 +87,13 @@ def serializer(self) -> Type[ModelSerializer]:
         Returns:
             A ModelSerializer class configured for this model instance
         """
+
         class SelfSerializer(ModelSerializer):
             class Meta:
                 pass
 
         SelfSerializer.Meta.model = self
-        SelfSerializer.Meta.fields = '__all__'
+        SelfSerializer.Meta.fields = "__all__"
         return SelfSerializer
 
     def serialize(self) -> Dict[str, Any]:
@@ -126,6 +129,7 @@ class SlugModel(BaseModel):
     Attributes:
         slug (SlugField): URL-friendly identifier field
     """
+
     slug = models.SlugField(max_length=16)
 
     class Meta:
@@ -143,7 +147,10 @@ class SortOrderModel(models.Model):
     Attributes:
         sort_order (PositiveIntegerField): Field for manual ordering of instances
     """
-    sort_order = models.PositiveIntegerField(default=0, blank=False, null=False, verbose_name=_("Sort"))
+
+    sort_order = models.PositiveIntegerField(
+        default=0, blank=False, null=False, verbose_name=_("Sort")
+    )
 
     class Meta:
         abstract = True
@@ -163,12 +170,13 @@ def _get_next_sort_order(self) -> int:
             return self.sort_order
 
         # Get the highest sort_order value from existing instances
-        last_instance = type(self).objects.order_by('-sort_order').first()
+        last_instance = type(self).objects.order_by("-sort_order").first()
         if last_instance and last_instance.sort_order:
             return last_instance.sort_order + 1
 
         return 1
 
+
 class TimestampedModel(models.Model):
     """
     Abstract model that adds automatic timestamp fields for creation and updates.
@@ -181,12 +189,11 @@ class TimestampedModel(models.Model):
         created_at (DateTimeField): Timestamp when the instance was created
         updated_at (DateTimeField): Timestamp when the instance was last updated
     """
+
     created_at = models.DateTimeField(
-        db_index=True, auto_now_add=True, verbose_name=_('Created at')
-    )
-    updated_at = models.DateTimeField(
-        auto_now=True, verbose_name=_('Updated at')
+        db_index=True, auto_now_add=True, verbose_name=_("Created at")
     )
+    updated_at = models.DateTimeField(auto_now=True, verbose_name=_("Updated at"))
 
     class Meta:
         abstract = True
@@ -203,6 +210,7 @@ class UUIDModel(BaseModel):
     Attributes:
         id (UUIDPrimaryKeyField): UUID primary key field
     """
+
     id = UUIDPrimaryKeyField()
 
     class Meta:

django_models/models/history.py

@@ -5,23 +5,27 @@
 
 class HistoryModel(SignalsModel, TimestampedModel):
     history_model = None
-    history_parent_field_name = 'parent'
+    history_parent_field_name = "parent"
 
     def __init__(self, *args, **kwargs):
         if not self.history_model:
             raise HistoryModelNotSetError(
-                "You should set the history_model attribute of {}".format(type(self).__name__)
+                "You should set the history_model attribute of {}".format(
+                    type(self).__name__
+                )
             )
 
         super().__init__(*args, **kwargs)
 
     def save_history(self):
         data = {self.history_parent_field_name: self}
 
-        history_model_fields = tuple(field.name for field in self.history_model._meta.fields)
+        history_model_fields = tuple(
+            field.name for field in self.history_model._meta.fields
+        )
 
         for field in self._meta.fields:
-            if field.name in ('id', 'created_at', 'updated_at'):
+            if field.name in ("id", "created_at", "updated_at"):
                 continue
 
             if field.name in history_model_fields:

django_models/models/managers.py

@@ -24,9 +24,8 @@ def delete(self):
 
     def hard_delete(self):
         """Delete the records in the current QuerySet."""
-        self._not_support_combined_queries('delete')
-        assert not self.query.is_sliced, \
-            "Cannot use 'limit' or 'offset' with delete."
+        self._not_support_combined_queries("delete")
+        assert not self.query.is_sliced, "Cannot use 'limit' or 'offset' with delete."
 
         if self._fields is not None:
             raise TypeError("Cannot call delete() after .values() or .values_list()")
@@ -55,15 +54,15 @@ def restore(self):
         return super().update(deleted_at=None, is_deleted=False)
 
     def __repr__(self):
-        data = list(self[:REPR_OUTPUT_SIZE + 1])
+        data = list(self[: REPR_OUTPUT_SIZE + 1])
         if len(data) > REPR_OUTPUT_SIZE:
             data[-1] = "...(remaining elements truncated)..."
-        return '<QuerySet %r>' % data
+        return "<QuerySet %r>" % data
 
 
 class SoftDeleteSignalsManager(SignalsManager):
     def __init__(self, *args, **kwargs):
-        self.show_deleted = kwargs.pop('show_deleted', False)
+        self.show_deleted = kwargs.pop("show_deleted", False)
         super().__init__(*args, **kwargs)
 
     def get_queryset(self):
@@ -81,7 +80,7 @@ def restore(self):
         return self.get_queryset().restore()
 
     def filter(self, *args, **kwargs):
-        if 'is_deleted' in kwargs:
+        if "is_deleted" in kwargs:
             qs = SoftDeleteQuerySet(self.model, using=self._db)
             return qs.filter(*args, **kwargs)
         return super().filter(*args, **kwargs)