# ==============================================================================
# ADTLAS TV ADVERTISING PLATFORM - PYTHON DEPENDENCIES
# ==============================================================================
#
# This file contains all Python package dependencies for the Adtlas TV
# advertising platform. Dependencies are organized by category for better
# maintainability and understanding.
#
# Installation:
#   pip install -r requirements.txt 
#
# Author: Adtlas Development Team
# Version: 2.0.0
# Last Updated: 2025-07-08
# ==============================================================================

# ==============================================================================
# CORE DJANGO FRAMEWORK
# ==============================================================================
# Main Django framework and essential extensions
Django==4.2.7                    # Main Django web framework
djangorestframework==3.14.0      # REST API framework
django-cors-headers==4.3.1       # Cross-Origin Resource Sharing
django-extensions==4.1           # Useful Django extensions
django-session-timeout==0.1.0    # Session timeout management
django-filter==25.1              # Dynamic QuerySet filtering

# ==============================================================================
# ENVIRONMENT AND CONFIGURATION
# ==============================================================================
# Configuration management and environment variables
python-decouple==3.8            # Configuration management
python-dotenv==1.0.0            # Environment variables from .env
django-environ==0.10.0          # Environment-based configuration
django-constance==3.1.0         # Dynamic settings

# ==============================================================================
# ASYNC TASK PROCESSING
# ==============================================================================
# Background task processing and message queuing
celery==5.3.4                   # Distributed task queue
redis==5.0.1                    # Redis client
django-celery-beat==2.8.1       # Periodic task scheduler
django-celery-results==2.6.0    # Task result backend

 # ==============================================================================
# DATABASE DRIVERS AND ORM
# ==============================================================================
# Database connectivity and ORM enhancements
#mysqlclient==2.2.0  # Replaced with PostgreSQL              # MySQL database connector
psycopg2-binary==2.9.9          # PostgreSQL adapter for Python (Primary database)
#PyMySQL==1.1.0                  # Pure Python MySQL client
dj-database-url==2.1.0          # Database URL parsing
# django-model-utils==4.3.0       # Model utilities and mixins

# ==============================================================================
# FILE HANDLING AND MEDIA PROCESSING
# ==============================================================================
# Image, video, and file processing capabilities
Pillow==11.2.1                  # Python Imaging Library
ffmpeg-python==0.2.0            # FFmpeg wrapper for video processing
python-magic==0.4.27            # File type detection
django-storages==1.13.0         # Custom storage backends
# boto3==1.26.0                   # AWS SDK for S3 storage

# ==============================================================================
# DATA PROCESSING AND ANALYTICS
# ==============================================================================
# Data analysis, machine learning, and content recognition
numpy==1.24.4                   # Numerical computing
pandas==2.0.3                   # Data analysis and manipulation
scipy==1.11.4                   # Scientific computing
scikit-learn==1.3.2             # Machine learning library 
opencv-python==4.8.1.78         # Computer vision library

# ==============================================================================
# HTTP REQUESTS AND API INTEGRATION
# ==============================================================================
# HTTP client libraries and API integrations
requests==2.31.0                # HTTP library
urllib3==2.0.7                  # HTTP client
httpx==0.25.2                   # Async HTTP client

# ==============================================================================
# DATA SERIALIZATION AND VALIDATION
# ==============================================================================
# Data validation, serialization, and parsing
marshmallow==3.20.1             # Object serialization/deserialization
lxml==4.9.3                     # XML and HTML processing
beautifulsoup4==4.12.2          # HTML/XML parsing
openpyxl==3.1.2                 # Excel file processing
xlrd==2.0.1                     # Excel file reading
xlsxwriter==3.1.9               # Excel file writing

# ==============================================================================
# DATE, TIME, AND LOCALIZATION
# ==============================================================================
# Date/time handling and internationalization
python-dateutil==2.8.2          # Date/time parsing
pytz==2023.3                    # Timezone definitions
# django-timezone-field==5.1.0    # Timezone field for models

# ==============================================================================
# TEXT PROCESSING AND CONTENT
# ==============================================================================
# Text processing, markdown, and content management
python-slugify==8.0.1           # URL slug generation
markdown==3.5.1                 # Markdown processing
django-ckeditor==6.6.0          # Rich text editor
django-taggit==4.0.0            # Tagging system

# ==============================================================================
# PRODUCTION SERVER AND DEPLOYMENT
# ==============================================================================
# WSGI server and production utilities
gunicorn==21.2.0                # WSGI HTTP Server
whitenoise==6.6.0               # Static file serving
gevent==23.7.0                  # Async networking library
django-maintenance-mode==0.16.0 # Maintenance mode


schedule==1.2.0

# ==============================================================================
# DEVELOPMENT NOTES
# ==============================================================================
# 1. Pin all versions for reproducible builds
# 2. Regularly update dependencies for security patches
# 3. Test thoroughly after dependency updates
# 4. Use virtual environments for isolation
# 5. Consider using pip-tools for dependency management
# 6. Monitor for security vulnerabilities with safety
# ==============================================================================