django-cfg 1.4.21__py3-none-any.whl → 1.4.24__py3-none-any.whl

django_cfg/apps/accounts/models/activity.py

@@ -11,24 +11,24 @@ class UserActivity(models.Model):
     """
     User activity log.
     """
-    
+
     user = models.ForeignKey('CustomUser', on_delete=models.CASCADE, related_name='activities')
     activity_type = models.CharField(max_length=20, choices=ActivityType.choices)
     description = models.TextField(blank=True)
     ip_address = models.GenericIPAddressField(null=True, blank=True)
     user_agent = models.TextField(blank=True)
-    
+
     # Related objects (generic foreign key could be used here)
     object_id = models.PositiveIntegerField(null=True, blank=True)
     object_type = models.CharField(max_length=50, blank=True)
-    
+
     created_at = models.DateTimeField(auto_now_add=True)
-    
+
     class Meta:
         app_label = 'django_cfg_accounts'
         verbose_name = 'User Activity'
         verbose_name_plural = 'User Activities'
         ordering = ['-created_at']
-    
+
     def __str__(self):
         return f"{self.user.username} - {self.get_activity_type_display()}"

django_cfg/apps/accounts/models/integrations.py

@@ -9,46 +9,46 @@ from .choices import TwilioResponseType, TwilioServiceType
 
 class TwilioResponse(models.Model):
     """Model for storing Twilio API responses and webhook data."""
-    
+
     response_type = models.CharField(max_length=20, choices=TwilioResponseType.choices)
     service_type = models.CharField(max_length=10, choices=TwilioServiceType.choices)
-    
+
     # Twilio identifiers
     message_sid = models.CharField(max_length=34, blank=True, help_text="Twilio Message SID")
     verification_sid = models.CharField(max_length=34, blank=True, help_text="Twilio Verification SID")
-    
+
     # Request/Response data
     request_data = models.JSONField(default=dict, help_text="Original request parameters")
     response_data = models.JSONField(default=dict, help_text="Twilio API response")
-    
+
     # Status and error handling
     status = models.CharField(max_length=20, blank=True, help_text="Message/Verification status")
     error_code = models.CharField(max_length=10, blank=True, help_text="Twilio error code")
     error_message = models.TextField(blank=True, help_text="Error description")
-    
+
     # Contact information
     to_number = models.CharField(max_length=20, blank=True, help_text="Recipient phone/email")
     from_number = models.CharField(max_length=20, blank=True, help_text="Sender phone/email")
-    
+
     # Pricing
     price = models.DecimalField(max_digits=10, decimal_places=6, null=True, blank=True)
     price_unit = models.CharField(max_length=3, blank=True, help_text="Currency code")
-    
+
     # Timestamps
     created_at = models.DateTimeField(auto_now_add=True)
     updated_at = models.DateTimeField(auto_now=True)
     twilio_created_at = models.DateTimeField(null=True, blank=True, help_text="Timestamp from Twilio")
-    
+
     # Relations
     otp_secret = models.ForeignKey(
-        'OTPSecret', 
-        on_delete=models.SET_NULL, 
-        null=True, 
+        'OTPSecret',
+        on_delete=models.SET_NULL,
+        null=True,
         blank=True,
         related_name='twilio_responses',
         help_text="Related OTP if applicable"
     )
-    
+
     class Meta:
         app_label = 'django_cfg_accounts'
         verbose_name = 'Twilio Response'
@@ -60,15 +60,15 @@ class TwilioResponse(models.Model):
             models.Index(fields=['status', 'created_at']),
             models.Index(fields=['response_type', 'service_type']),
         ]
-    
+
     def __str__(self):
         return f"{self.get_response_type_display()} - {self.get_service_type_display()}"
-    
+
     @property
     def has_error(self):
         """Check if response has error."""
         return bool(self.error_code or self.error_message)
-    
+
     @property
     def is_successful(self):
         """Check if response is successful."""

django_cfg/apps/accounts/models/registration.py

@@ -2,9 +2,10 @@
 Registration and source tracking models.
 """
 
-from django.db import models
 from urllib.parse import urlparse
 
+from django.db import models
+
 
 class RegistrationSource(models.Model):
     """Model for tracking user registration sources/projects."""
@@ -43,7 +44,7 @@ class UserRegistrationSource(models.Model):
     source = models.ForeignKey(RegistrationSource, on_delete=models.CASCADE, related_name='user_registration_sources')
     first_registration = models.BooleanField(default=True, help_text="Whether this was the first registration from this source")
     registration_date = models.DateTimeField(auto_now_add=True)
-    
+
     class Meta:
         app_label = 'django_cfg_accounts'
         unique_together = ['user', 'source']

django_cfg/apps/accounts/models/user.py

@@ -2,7 +2,8 @@
 User model and related functionality.
 """
 
-from typing import Optional, List
+from typing import List, Optional
+
 from django.contrib.auth.models import AbstractUser
 from django.db import models
 
@@ -69,7 +70,7 @@ class CustomUser(AbstractUser):
         """Get the first source where user registered."""
         from .registration import UserRegistrationSource
         user_source = UserRegistrationSource.objects.filter(
-            user=self, 
+            user=self,
             first_registration=True
         ).first()
         return user_source.source if user_source else None

django_cfg/apps/accounts/serializers/__init__.py

@@ -1,9 +1,16 @@
-from .profile import UserSerializer, UserProfileUpdateSerializer
-from .otp import OTPSerializer, OTPRequestSerializer, OTPVerifySerializer, OTPRequestResponseSerializer, OTPVerifyResponseSerializer, OTPErrorResponseSerializer
+from .otp import (
+    OTPErrorResponseSerializer,
+    OTPRequestResponseSerializer,
+    OTPRequestSerializer,
+    OTPSerializer,
+    OTPVerifyResponseSerializer,
+    OTPVerifySerializer,
+)
+from .profile import UserProfileUpdateSerializer, UserSerializer
 
 __all__ = [
     'UserSerializer',
-    'UserProfileUpdateSerializer', 
+    'UserProfileUpdateSerializer',
     'OTPSerializer',
     'OTPRequestSerializer',
     'OTPVerifySerializer',

django_cfg/apps/accounts/serializers/otp.py

@@ -1,4 +1,5 @@
 from rest_framework import serializers
+
 from ..models import OTPSecret
 from .profile import UserSerializer
 
@@ -33,11 +34,11 @@ class OTPRequestSerializer(serializers.Serializer):
         """Validate identifier format."""
         if not value:
             raise serializers.ValidationError("Identifier is required.")
-        
+
         value = value.strip()
         if not value:
             raise serializers.ValidationError("Identifier cannot be empty.")
-            
+
         # Auto-detect if it's email or phone
         if '@' in value:
             # Basic email validation
@@ -81,11 +82,11 @@ class OTPVerifySerializer(serializers.Serializer):
         """Validate identifier format."""
         if not value:
             raise serializers.ValidationError("Identifier is required.")
-        
+
         value = value.strip()
         if not value:
             raise serializers.ValidationError("Identifier cannot be empty.")
-            
+
         # Auto-detect if it's email or phone
         if '@' in value:
             # Basic email validation

django_cfg/apps/accounts/serializers/profile.py

@@ -3,7 +3,6 @@ from rest_framework import serializers
 from ..models import CustomUser, RegistrationSource, UserRegistrationSource
 
 
-
 class UserSerializer(serializers.ModelSerializer):
     """Serializer for user details."""
 
@@ -130,7 +129,7 @@ class RegistrationSourceSerializer(serializers.ModelSerializer):
 class UserRegistrationSourceSerializer(serializers.ModelSerializer):
     """Serializer for UserRegistrationSource model."""
     source = RegistrationSourceSerializer(read_only=True)
-    
+
     class Meta:
         model = UserRegistrationSource
         fields = ["id", "user", "source", "first_registration", "registration_date"]
@@ -141,15 +140,15 @@ class UserWithSourcesSerializer(UserSerializer):
     """Extended user serializer with sources information."""
     sources = serializers.SerializerMethodField()
     primary_source = serializers.SerializerMethodField()
-    
+
     class Meta(UserSerializer.Meta):
         fields = UserSerializer.Meta.fields + ['sources', 'primary_source']
-    
+
     def get_sources(self, obj):
         """Get all sources for the user."""
         user_sources = UserRegistrationSource.objects.filter(user=obj).select_related('source')
         return UserRegistrationSourceSerializer(user_sources, many=True).data
-    
+
     def get_primary_source(self, obj):
         """Get the primary source for the user."""
         primary_source = obj.primary_source

django_cfg/apps/accounts/serializers/webhook.py

@@ -15,59 +15,59 @@ class TwilioWebhookSerializer(serializers.Serializer):
     from Twilio. The fields are optional because different webhook types
     send different data.
     """
-    
+
     # Message-related fields (SMS/WhatsApp)
     MessageSid = serializers.CharField(required=False, help_text="Twilio Message SID")
     MessageStatus = serializers.CharField(required=False, help_text="Message status (sent, delivered, failed, etc.)")
     To = serializers.CharField(required=False, help_text="Recipient phone number")
     From = serializers.CharField(required=False, help_text="Sender phone number")
     Body = serializers.CharField(required=False, help_text="Message body")
-    
+
     # Error fields
     ErrorCode = serializers.CharField(required=False, help_text="Twilio error code")
     ErrorMessage = serializers.CharField(required=False, help_text="Error message description")
-    
+
     # Pricing fields
     Price = serializers.DecimalField(max_digits=10, decimal_places=6, required=False, help_text="Message price")
     PriceUnit = serializers.CharField(required=False, help_text="Currency code")
-    
+
     # Verification-related fields (Verify API)
     VerificationSid = serializers.CharField(required=False, help_text="Twilio Verification SID")
     VerificationStatus = serializers.CharField(required=False, help_text="Verification status (approved, canceled, etc.)")
     Channel = serializers.CharField(required=False, help_text="Verification channel (sms, whatsapp, call)")
-    
+
     # Timestamp fields
     DateCreated = serializers.DateTimeField(required=False, help_text="When the message was created")
     DateSent = serializers.DateTimeField(required=False, help_text="When the message was sent")
     DateUpdated = serializers.DateTimeField(required=False, help_text="When the status was last updated")
-    
+
     # Account information
     AccountSid = serializers.CharField(required=False, help_text="Twilio Account SID")
-    
+
     # Additional fields that might be present
     Direction = serializers.CharField(required=False, help_text="Message direction (inbound/outbound)")
     ApiVersion = serializers.CharField(required=False, help_text="Twilio API version")
-    
+
     # Alternative field names (some webhooks use different casing)
     message_sid = serializers.CharField(required=False, help_text="Alternative field name for MessageSid")
     message_status = serializers.CharField(required=False, help_text="Alternative field name for MessageStatus")
     verification_sid = serializers.CharField(required=False, help_text="Alternative field name for VerificationSid")
     verification_status = serializers.CharField(required=False, help_text="Alternative field name for VerificationStatus")
-    
+
     def validate(self, data):
         """
         Ensure that we have at least one of the required identifiers.
         """
         message_sid = data.get('MessageSid') or data.get('message_sid')
         verification_sid = data.get('VerificationSid') or data.get('verification_sid')
-        
+
         if not message_sid and not verification_sid:
             raise serializers.ValidationError(
                 "Either MessageSid or VerificationSid must be provided"
             )
-        
+
         return data
-    
+
     def to_internal_value(self, data):
         """
         Convert the webhook data to internal format.
@@ -78,7 +78,7 @@ class TwilioWebhookSerializer(serializers.Serializer):
         if hasattr(data, 'items'):
             # Convert QueryDict or dict to regular dict
             data = dict(data.items()) if hasattr(data, 'items') else data
-        
+
         return super().to_internal_value(data)
 
 

django_cfg/apps/accounts/services/activity_service.py

@@ -3,7 +3,8 @@ User activity logging service.
 """
 
 import logging
-from typing import Optional, Dict, Any
+from typing import Any, Dict, Optional
+
 from django.utils import timezone
 
 from ..models import CustomUser, UserActivity
@@ -49,10 +50,10 @@ class ActivityService:
                 object_id=object_id,
                 object_type=object_type,
             )
-            
+
             logger.debug(f"Logged activity '{activity_type}' for user {user.email}")
             return activity
-            
+
         except Exception as e:
             logger.error(f"Failed to log activity '{activity_type}' for user {user.email}: {e}")
             return None
@@ -75,10 +76,10 @@ class ActivityService:
             List of UserActivity instances
         """
         queryset = user.activities.all()
-        
+
         if activity_type:
             queryset = queryset.filter(activity_type=activity_type)
-            
+
         return list(queryset.order_by('-created_at')[:limit])
 
     @staticmethod
@@ -93,9 +94,9 @@ class ActivityService:
             Dictionary with activity statistics
         """
         now = timezone.now()
-        
+
         activities = user.activities.all()
-        
+
         stats = {
             "total_activities": activities.count(),
             "recent_24h": activities.filter(
@@ -108,15 +109,15 @@ class ActivityService:
                 created_at__gte=now - timezone.timedelta(days=30)
             ).count(),
         }
-        
+
         # Activity type breakdown
         activity_types = activities.values_list('activity_type', flat=True)
         type_counts = {}
         for activity_type in activity_types:
             type_counts[activity_type] = type_counts.get(activity_type, 0) + 1
-        
+
         stats["by_type"] = type_counts
-        
+
         return stats
 
     @staticmethod
@@ -131,10 +132,10 @@ class ActivityService:
             Number of activities deleted
         """
         cutoff_date = timezone.now() - timezone.timedelta(days=days)
-        
+
         deleted_count, _ = UserActivity.objects.filter(
             created_at__lt=cutoff_date
         ).delete()
-        
+
         logger.info(f"Cleaned up {deleted_count} old activities older than {days} days")
         return deleted_count

django_cfg/apps/accounts/services/otp_service.py

@@ -1,13 +1,15 @@
 import logging
 import traceback
-from django.utils import timezone
-from django.db import transaction
 from typing import Optional
 
+from django.db import transaction
+from django.utils import timezone
+
 from django_cfg.modules.django_telegram import DjangoTelegram
-from ..models import OTPSecret, CustomUser
-from ..utils.notifications import AccountNotifications
+
+from ..models import CustomUser, OTPSecret
 from ..signals import notify_failed_otp_attempt
+from ..utils.notifications import AccountNotifications
 
 logger = logging.getLogger(__name__)
 
@@ -97,8 +99,8 @@ class OTPService:
 
             # Send Telegram notification for OTP request
             try:
-                
-                
+
+
                 # Prepare notification data
                 notification_data = {
                     "Email": cleaned_email,
@@ -107,14 +109,14 @@ class OTPService:
                     "Source URL": source_url or "Direct",
                     "Timestamp": timezone.now().strftime("%Y-%m-%d %H:%M:%S UTC")
                 }
-                
+
                 if created:
                     DjangoTelegram.send_success("New User OTP Request", notification_data)
                 else:
                     DjangoTelegram.send_info("OTP Login Request", notification_data)
-                    
+
                 logger.info(f"Telegram OTP notification sent for {cleaned_email}")
-                
+
             except ImportError:
                 logger.warning("django_cfg DjangoTelegram not available for OTP notifications")
             except Exception as telegram_error:
@@ -150,13 +152,13 @@ class OTPService:
 
             if not otp_secret or not otp_secret.is_valid:
                 logger.warning(f"Invalid OTP for {cleaned_email}")
-                
+
                 # Send Telegram notification for failed OTP attempt
                 try:
                     notify_failed_otp_attempt(cleaned_email, reason="Invalid or expired OTP")
                 except Exception as e:
                     logger.error(f"Failed to send failed OTP notification: {e}")
-                
+
                 return None
 
             # Mark OTP as used
@@ -174,7 +176,7 @@ class OTPService:
 
                 # Send Telegram notification for successful OTP verification
                 try:
-                    
+
                     verification_data = {
                         "Email": cleaned_email,
                         "Username": user.username,
@@ -182,10 +184,10 @@ class OTPService:
                         "Login Time": timezone.now().strftime("%Y-%m-%d %H:%M:%S UTC"),
                         "User ID": user.id
                     }
-                    
+
                     DjangoTelegram.send_success("Successful OTP Login", verification_data)
                     logger.info(f"Telegram OTP verification notification sent for {cleaned_email}")
-                    
+
                 except ImportError:
                     logger.warning("django_cfg DjangoTelegram not available for OTP verification notifications")
                 except Exception as telegram_error:

django_cfg/apps/accounts/signals.py

@@ -3,14 +3,16 @@ Django signals for automatic email notifications on user account changes.
 """
 
 import logging
+
+from django.contrib.auth import get_user_model
 from django.db.models.signals import post_save, pre_save
 from django.dispatch import receiver
-from django.contrib.auth import get_user_model
 from django.utils import timezone
 
-from .utils.notifications import AccountNotifications
 from django_cfg.modules.django_telegram import DjangoTelegram
 
+from .utils.notifications import AccountNotifications
+
 User = get_user_model()
 logger = logging.getLogger(__name__)
 
@@ -30,7 +32,7 @@ def send_user_status_change_emails(sender, instance, **kwargs):
         # Get the old instance from database
         if instance.pk:
             old_instance = User.objects.get(pk=instance.pk)
-            
+
             # Check if user was activated
             if not old_instance.is_active and instance.is_active:
                 AccountNotifications.send_account_status_change(instance, "activated")
@@ -40,7 +42,7 @@ def send_user_status_change_emails(sender, instance, **kwargs):
             elif old_instance.is_active and not instance.is_active:
                 AccountNotifications.send_account_status_change(instance, "deactivated", reason="Account deactivated by administrator")
                 logger.info(f"Account deactivation email sent to {instance.email}")
-                
+
     except User.DoesNotExist:
         # New user, no old instance to compare
         pass
@@ -55,24 +57,24 @@ def send_user_profile_update_email(sender, instance, **kwargs):
         # Get the old instance from database
         if instance.pk:
             old_instance = User.objects.get(pk=instance.pk)
-            
+
             # Check for important changes
             changes = []
-            
+
             if old_instance.email != instance.email:
                 changes.append("email address")
-            
+
             if old_instance.username != instance.username:
                 changes.append("username")
-            
+
             if old_instance.first_name != instance.first_name or old_instance.last_name != instance.last_name:
                 changes.append("name")
-            
+
             # Send notification if there were important changes
             if changes:
                 AccountNotifications.send_profile_update_notification(instance, changes, send_email=True, send_telegram=True)
                 logger.info(f"Profile update notification sent to {instance.email}")
-                
+
     except User.DoesNotExist:
         pass
     except Exception as e:
@@ -112,17 +114,17 @@ def trigger_login_notification(user, ip_address=None):
 def send_security_telegram_alert(title: str, user_email: str, details: dict):
     """Send security alert via Telegram."""
     try:
-        
+
         alert_data = {
             "User": user_email,
             "Alert Type": title,
             "Timestamp": timezone.now().strftime("%Y-%m-%d %H:%M:%S UTC"),
             **details
         }
-        
+
         DjangoTelegram.send_warning(f"Security Alert: {title}", alert_data)
         logger.info(f"Security Telegram alert sent: {title} for {user_email}")
-        
+
     except ImportError:
         logger.warning("django_cfg DjangoTelegram not available for security alerts")
     except Exception as e:
@@ -138,8 +140,8 @@ def notify_failed_otp_attempt(email: str, ip_address: str = None, reason: str =
             "IP Address": ip_address or "Unknown",
             "Attempt Time": timezone.now().strftime("%Y-%m-%d %H:%M:%S UTC")
         }
-        
+
         send_security_telegram_alert("Failed OTP Attempt", email, details)
-        
+
     except Exception as e:
-        logger.error(f"Failed to send failed OTP notification: {e}") 
+        logger.error(f"Failed to send failed OTP notification: {e}")

django_cfg/apps/accounts/urls.py

@@ -1,10 +1,15 @@
-from django.urls import path, include
+from django.urls import include, path
+from drf_spectacular.utils import extend_schema
 from rest_framework.routers import DefaultRouter
 from rest_framework_simplejwt.views import TokenRefreshView
-from drf_spectacular.utils import extend_schema
 
 from .views import OTPViewSet
-from .views.profile import UserProfileView, UserProfileUpdateView, UserProfilePartialUpdateView, upload_avatar
+from .views.profile import (
+    UserProfilePartialUpdateView,
+    UserProfileUpdateView,
+    UserProfileView,
+    upload_avatar,
+)
 
 app_name = 'cfg_accounts'
 
@@ -35,10 +40,10 @@ profile_patterns = [
 urlpatterns = [
     # ViewSet-based endpoints
     path('', include(router.urls)),
-    
+
     # Token endpoints
     path('token/', include(token_patterns)),
-    
+
     # Profile endpoints
     path('profile/', include(profile_patterns)),
 ]