aiwaf 0.1.8.9__py3-none-any.whl → 0.1.9.0__py3-none-any.whl

aiwaf/__init__.py

@@ -1 +1,19 @@
 default_app_config = "aiwaf.apps.AiwafConfig"
+
+__version__ = "0.1.9.0"
+
+# Import main middleware classes for easier access
+try:
+    from .middleware import (
+        IPAndKeywordBlockMiddleware,
+        RateLimitMiddleware, 
+        AIAnomalyMiddleware,
+        HoneypotTimingMiddleware,
+        UUIDTamperMiddleware
+    )
+except ImportError as e:
+    # Handle import errors gracefully during package installation
+    import sys
+    if 'runserver' in sys.argv or 'migrate' in sys.argv or 'shell' in sys.argv:
+        print(f"Warning: Could not import middleware classes: {e}")
+        print("Tip: Run 'python manage.py aiwaf_diagnose' to troubleshoot")

aiwaf/management/commands/aiwaf_diagnose.py

@@ -0,0 +1,127 @@
+from django.core.management.base import BaseCommand
+from django.conf import settings
+import sys
+
+class Command(BaseCommand):
+    help = 'Diagnose AI-WAF installation and middleware setup'
+
+    def handle(self, *args, **options):
+        self.stdout.write(self.style.HTTP_INFO("🔍 AI-WAF Installation Diagnostics"))
+        self.stdout.write("")
+        
+        # Check AI-WAF import
+        try:
+            import aiwaf
+            version = getattr(aiwaf, '__version__', 'Unknown')
+            self.stdout.write(self.style.SUCCESS(f"✅ AI-WAF imported successfully (version: {version})"))
+        except ImportError as e:
+            self.stdout.write(self.style.ERROR(f"❌ AI-WAF import failed: {e}"))
+            return
+        
+        # Check if aiwaf is in INSTALLED_APPS
+        installed_apps = getattr(settings, 'INSTALLED_APPS', [])
+        if 'aiwaf' in installed_apps:
+            self.stdout.write(self.style.SUCCESS("✅ 'aiwaf' found in INSTALLED_APPS"))
+        else:
+            self.stdout.write(self.style.ERROR("❌ 'aiwaf' NOT found in INSTALLED_APPS"))
+            self.stdout.write(self.style.WARNING("   Add 'aiwaf' to your INSTALLED_APPS in settings.py"))
+        
+        # Check middleware availability
+        self.stdout.write("")
+        self.stdout.write(self.style.HTTP_INFO("🧱 Middleware Availability Check:"))
+        
+        middleware_classes = [
+            'IPAndKeywordBlockMiddleware',
+            'RateLimitMiddleware', 
+            'AIAnomalyMiddleware',
+            'HoneypotTimingMiddleware',
+            'UUIDTamperMiddleware'
+        ]
+        
+        try:
+            import aiwaf.middleware as mw
+            available_classes = dir(mw)
+            
+            for middleware_class in middleware_classes:
+                if middleware_class in available_classes:
+                    self.stdout.write(self.style.SUCCESS(f"  ✅ {middleware_class}"))
+                else:
+                    self.stdout.write(self.style.ERROR(f"  ❌ {middleware_class} (missing)"))
+        except ImportError as e:
+            self.stdout.write(self.style.ERROR(f"❌ Could not import aiwaf.middleware: {e}"))
+        
+        # Check configured middleware
+        self.stdout.write("")
+        self.stdout.write(self.style.HTTP_INFO("⚙️ Configured Middleware:"))
+        
+        middleware_setting = getattr(settings, 'MIDDLEWARE', [])
+        aiwaf_middleware = [mw for mw in middleware_setting if 'aiwaf' in mw.lower()]
+        
+        if aiwaf_middleware:
+            for mw in aiwaf_middleware:
+                # Test if middleware can be imported
+                try:
+                    from django.utils.module_loading import import_string
+                    import_string(mw)
+                    self.stdout.write(self.style.SUCCESS(f"  ✅ {mw}"))
+                except ImportError as e:
+                    self.stdout.write(self.style.ERROR(f"  ❌ {mw} - Import Error: {e}"))
+                except Exception as e:
+                    self.stdout.write(self.style.WARNING(f"  ⚠️  {mw} - Warning: {e}"))
+        else:
+            self.stdout.write(self.style.WARNING("  No AI-WAF middleware found in MIDDLEWARE setting"))
+        
+        # Check storage configuration
+        self.stdout.write("")
+        self.stdout.write(self.style.HTTP_INFO("💾 Storage Configuration:"))
+        
+        storage_mode = getattr(settings, 'AIWAF_STORAGE_MODE', 'models')
+        self.stdout.write(f"  Storage Mode: {storage_mode}")
+        
+        if storage_mode == 'csv':
+            csv_dir = getattr(settings, 'AIWAF_CSV_DATA_DIR', 'aiwaf_data')
+            self.stdout.write(f"  CSV Directory: {csv_dir}")
+        
+        # Check access log
+        access_log = getattr(settings, 'AIWAF_ACCESS_LOG', None)
+        if access_log:
+            import os
+            if os.path.exists(access_log):
+                self.stdout.write(self.style.SUCCESS(f"  ✅ Access log found: {access_log}"))
+            else:
+                self.stdout.write(self.style.WARNING(f"  ⚠️  Access log not found: {access_log}"))
+        else:
+            self.stdout.write(self.style.WARNING("  ⚠️  AIWAF_ACCESS_LOG not configured"))
+        
+        # Check middleware logging
+        middleware_logging = getattr(settings, 'AIWAF_MIDDLEWARE_LOGGING', False)
+        if middleware_logging:
+            self.stdout.write(self.style.SUCCESS("  ✅ Middleware logging enabled"))
+        else:
+            self.stdout.write(self.style.WARNING("  ⚠️  Middleware logging disabled"))
+        
+        # Recommendations
+        self.stdout.write("")
+        self.stdout.write(self.style.HTTP_INFO("💡 Recommendations:"))
+        
+        if 'aiwaf' not in installed_apps:
+            self.stdout.write("  1. Add 'aiwaf' to INSTALLED_APPS")
+            
+        if not aiwaf_middleware:
+            self.stdout.write("  2. Add AI-WAF middleware to MIDDLEWARE setting")
+            
+        if not access_log and not middleware_logging:
+            self.stdout.write("  3. Configure AIWAF_ACCESS_LOG or enable AIWAF_MIDDLEWARE_LOGGING")
+        
+        # Quick fix commands
+        self.stdout.write("")
+        self.stdout.write(self.style.HTTP_INFO("🚀 Quick Fix Commands:"))
+        self.stdout.write("")
+        self.stdout.write("# Update AI-WAF to latest version:")
+        self.stdout.write("pip install --upgrade aiwaf")
+        self.stdout.write("")
+        self.stdout.write("# Run migrations (if using models mode):")
+        self.stdout.write("python manage.py migrate")
+        self.stdout.write("")
+        self.stdout.write("# Test AI-WAF commands:")
+        self.stdout.write("python manage.py add_ipexemption 127.0.0.1 --reason Testing")

{aiwaf-0.1.8.9.dist-info → aiwaf-0.1.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiwaf
-Version: 0.1.8.9
+Version: 0.1.9.0
 Summary: AI-powered Web Application Firewall
 Home-page: https://github.com/aayushgauba/aiwaf
 Author: Aayush Gauba
@@ -324,6 +324,57 @@ MIDDLEWARE = [
 
 > **⚠️ Order matters!** AI-WAF protection middleware should come early. The logger middleware should come near the end to capture final response data.
 
+### **Troubleshooting Middleware Errors**
+
+**Error: `Module "aiwaf.middleware" does not define a "UUIDTamperMiddleware" attribute/class`**
+
+**Solutions:**
+1. **Update AI-WAF to latest version:**
+   ```bash
+   pip install --upgrade aiwaf
+   ```
+
+2. **Run diagnostic commands:**
+   ```bash
+   # Quick debug script (from AI-WAF directory)
+   python debug_aiwaf.py
+   
+   # Django management command  
+   python manage.py aiwaf_diagnose
+   ```
+
+3. **Check available middleware classes:**
+   ```python
+   # In Django shell: python manage.py shell
+   import aiwaf.middleware
+   print(dir(aiwaf.middleware))
+   ```
+
+4. **Verify AI-WAF is in INSTALLED_APPS:**
+   ```python
+   # In settings.py
+   INSTALLED_APPS = [
+       # ... other apps ...
+       'aiwaf',  # Must be included
+   ]
+   ```
+
+5. **Use minimal middleware setup if needed:**
+   ```python
+   MIDDLEWARE = [
+       # ... your existing middleware ...
+       "aiwaf.middleware.IPAndKeywordBlockMiddleware",  # Core protection
+       "aiwaf.middleware.RateLimitMiddleware",          # Rate limiting  
+       "aiwaf.middleware.AIAnomalyMiddleware",          # AI detection
+   ]
+   ```
+
+**Common Issues:**
+- Missing Django: `pip install Django`
+- Old AI-WAF version: `pip install --upgrade aiwaf`
+- Missing migrations: `python manage.py migrate`
+- Import errors: Check `INSTALLED_APPS` includes `'aiwaf'`
+
 ---
 
 ##  Running Detection & Training

{aiwaf-0.1.8.9.dist-info → aiwaf-0.1.9.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-aiwaf/__init__.py,sha256=nQFpJ1YpX48snzLjEQCf8zD2YNh8v0b_kPTrXx8uBYc,46
+aiwaf/__init__.py,sha256=XzdZPG3k3A6cA_FfVC397hcb_di2dW2LV6iULGLbZ5w,653
 aiwaf/apps.py,sha256=nCez-Ptlv2kaEk5HenA8b1pATz1VfhrHP1344gwcY1A,142
 aiwaf/blacklist_manager.py,sha256=92ltIrFfv8WOC4CXwvNVZYfivkRZHGNg3E2QAbHQipQ,550
 aiwaf/decorators.py,sha256=IUKOdM_gdroffImRZep1g1wT6gNqD10zGwcp28hsJCs,825
@@ -11,14 +11,15 @@ aiwaf/utils.py,sha256=BJk5vJCYdGPl_4QQiknjhCbkzv5HZCXgFcBJDMJpHok,3390
 aiwaf/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 aiwaf/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 aiwaf/management/commands/add_ipexemption.py,sha256=srgdVPDJtF7G9GGIqaZ7L3qTuNheoS_uwlhlRO4W2bc,945
+aiwaf/management/commands/aiwaf_diagnose.py,sha256=W2OQbPJ2xXTD4OTJw2VnqJTo4QR3N9acPst3SKXy0E0,5705
 aiwaf/management/commands/aiwaf_logging.py,sha256=FCIqULn2tii2vD9VxL7vk3PV4k4vr7kaA00KyaCExYY,7692
 aiwaf/management/commands/aiwaf_reset.py,sha256=0FIBqpZS8xgFFvAKJ-0zAC_-QNQwRkOHpXb8N-OdFr8,3740
 aiwaf/management/commands/detect_and_train.py,sha256=-o-LZ7QZ5GeJPCekryox1DGXKMmFEkwwrcDsiM166K0,269
 aiwaf/resources/model.pkl,sha256=5t6h9BX8yoh2xct85MXOO60jdlWyg1APskUOW0jZE1Y,1288265
 aiwaf/templatetags/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 aiwaf/templatetags/aiwaf_tags.py,sha256=XXfb7Tl4DjU3Sc40GbqdaqOEtKTUKELBEk58u83wBNw,357
-aiwaf-0.1.8.9.dist-info/licenses/LICENSE,sha256=Ir8PX4dxgAcdB0wqNPIkw84fzIIRKE75NoUil9RX0QU,1069
-aiwaf-0.1.8.9.dist-info/METADATA,sha256=2CYLoXxKDrsQtfL1k5lT08tWIeo1GsEDEXZHRXqs_vI,11548
-aiwaf-0.1.8.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aiwaf-0.1.8.9.dist-info/top_level.txt,sha256=kU6EyjobT6UPCxuWpI_BvcHDG0I2tMgKaPlWzVxe2xI,6
-aiwaf-0.1.8.9.dist-info/RECORD,,
+aiwaf-0.1.9.0.dist-info/licenses/LICENSE,sha256=Ir8PX4dxgAcdB0wqNPIkw84fzIIRKE75NoUil9RX0QU,1069
+aiwaf-0.1.9.0.dist-info/METADATA,sha256=xZRQCE6zKCkNtE54rrWaxBllGdslHApII1CCC1JQE0I,12903
+aiwaf-0.1.9.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aiwaf-0.1.9.0.dist-info/top_level.txt,sha256=kU6EyjobT6UPCxuWpI_BvcHDG0I2tMgKaPlWzVxe2xI,6
+aiwaf-0.1.9.0.dist-info/RECORD,,