souleyez 2.43.34__py3-none-any.whl → 3.0.7__py3-none-any.whl

souleyez/handlers/web_login_test_handler.py

@@ -4,6 +4,7 @@ Web Login Test handler.
 
 Parses and displays results from web login credential tests.
 """
+
 import json
 import logging
 import os

souleyez/handlers/whois_handler.py

@@ -4,6 +4,7 @@ WHOIS handler.
 
 Consolidates parsing and display logic for WHOIS domain lookup jobs.
 """
+
 import logging
 import os
 from typing import Any, Dict, Optional
@@ -44,9 +45,9 @@ class WhoisHandler(BaseToolHandler):
         """
         try:
             from souleyez.parsers.whois_parser import (
-                parse_whois_output,
-                map_to_osint_data,
                 extract_emails,
+                map_to_osint_data,
+                parse_whois_output,
             )
             from souleyez.storage.osint import OsintManager
 

souleyez/handlers/wpscan_handler.py

@@ -4,6 +4,7 @@ WPScan handler.
 
 Consolidates parsing and display logic for WPScan WordPress security scanner jobs.
 """
+
 import logging
 import os
 import re
@@ -45,8 +46,8 @@ class WPScanHandler(BaseToolHandler):
         Extracts WordPress vulnerabilities for plugins, themes, and core.
         """
         try:
-            from souleyez.parsers.wpscan_parser import parse_wpscan_output
             from souleyez.engine.result_handler import detect_tool_error
+            from souleyez.parsers.wpscan_parser import parse_wpscan_output
 
             # Import managers if not provided
             if host_manager is None:

souleyez/history.py

@@ -1,8 +1,9 @@
 #!/usr/bin/env python3
-from pathlib import Path
-from .utils import HISTORY_FILE, ensure_dirs, read_json, write_json, timestamp_str
-import json
 import csv
+import json
+from pathlib import Path
+
+from .utils import HISTORY_FILE, ensure_dirs, read_json, timestamp_str, write_json
 
 # Export directory for JSON/CSV exports
 EXPORT_DIR = Path.home() / ".souleyez" / "exports"

souleyez/importers/msf_importer.py

@@ -2,10 +2,12 @@
 """
 souleyez.importers.msf_importer - Import data from Metasploit Framework exports
 """
-import defusedxml.ElementTree as ET
+
 from pathlib import Path
-from typing import Dict, List, Optional, TYPE_CHECKING
+from typing import TYPE_CHECKING, Dict, List, Optional
+
 import click
+import defusedxml.ElementTree as ET
 
 if TYPE_CHECKING:
     from xml.etree.ElementTree import Element
@@ -19,9 +21,9 @@ class MSFImporter:
     def __init__(self, engagement_id: int):
         """Initialize importer with engagement ID."""
         self.engagement_id = engagement_id
-        from souleyez.storage.hosts import HostManager
         from souleyez.storage.credentials import CredentialsManager
         from souleyez.storage.findings import FindingsManager
+        from souleyez.storage.hosts import HostManager
 
         self.hm = HostManager()
         self.cm = CredentialsManager()

souleyez/importers/smart_importer.py

@@ -2,10 +2,12 @@
 """
 souleyez.importers.smart_importer - Intelligent data import with type detection
 """
-import defusedxml.ElementTree as ET
-from typing import Dict, List, Any, Optional, Tuple
+
 import json
 import re
+from typing import Any, Dict, List, Optional, Tuple
+
+import defusedxml.ElementTree as ET
 
 
 class SmartImporter:
@@ -189,9 +191,9 @@ class SmartImporter:
         Returns:
             Dict with counts of imported items per type
         """
-        from souleyez.storage.hosts import HostManager
-        from souleyez.storage.findings import FindingsManager
         from souleyez.storage.credentials import CredentialsManager
+        from souleyez.storage.findings import FindingsManager
+        from souleyez.storage.hosts import HostManager
 
         results = {
             "hosts": 0,

souleyez/integrations/siem/__init__.py

@@ -21,17 +21,17 @@ Usage:
 """
 
 from souleyez.integrations.siem.base import (
-    SIEMClient,
     SIEMAlert,
-    SIEMRule,
+    SIEMClient,
     SIEMConnectionStatus,
+    SIEMRule,
 )
-from souleyez.integrations.siem.wazuh import WazuhSIEMClient
-from souleyez.integrations.siem.splunk import SplunkSIEMClient
 from souleyez.integrations.siem.elastic import ElasticSIEMClient
-from souleyez.integrations.siem.sentinel import SentinelSIEMClient
-from souleyez.integrations.siem.googlesecops import GoogleSecOpsSIEMClient
 from souleyez.integrations.siem.factory import SIEMFactory
+from souleyez.integrations.siem.googlesecops import GoogleSecOpsSIEMClient
+from souleyez.integrations.siem.sentinel import SentinelSIEMClient
+from souleyez.integrations.siem.splunk import SplunkSIEMClient
+from souleyez.integrations.siem.wazuh import WazuhSIEMClient
 
 __all__ = [
     # Base classes

souleyez/integrations/siem/base.py

@@ -8,7 +8,7 @@ multi-SIEM support (Wazuh, Splunk, Elastic SIEM, Microsoft Sentinel).
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import Dict, List, Any, Optional
+from typing import Any, Dict, List, Optional
 
 
 @dataclass

souleyez/integrations/siem/elastic.py

@@ -6,15 +6,15 @@ Uses the Elasticsearch and Kibana APIs for querying alerts and rules.
 """
 
 from datetime import datetime
-from typing import Dict, List, Optional, Any
+from typing import Any, Dict, List, Optional
 
 import requests
 
 from souleyez.integrations.siem.base import (
-    SIEMClient,
     SIEMAlert,
-    SIEMRule,
+    SIEMClient,
     SIEMConnectionStatus,
+    SIEMRule,
 )
 
 

souleyez/integrations/siem/factory.py

@@ -5,11 +5,10 @@ Creates SIEM clients based on configuration, providing a unified
 interface for working with multiple SIEM platforms.
 """
 
-from typing import Dict, Any, Optional, List
+from typing import Any, Dict, List, Optional
 
 from souleyez.integrations.siem.base import SIEMClient, SIEMConnectionStatus
 
-
 # Registry of available SIEM types
 # Ordered: Open Source first, then Commercial
 SIEM_TYPES = ["wazuh", "elastic", "splunk", "sentinel", "google_secops"]

souleyez/integrations/siem/googlesecops.py

@@ -9,15 +9,15 @@ import base64
 import json
 import time
 from datetime import datetime, timedelta
-from typing import Dict, List, Optional, Any
+from typing import Any, Dict, List, Optional
 
 import requests
 
 from souleyez.integrations.siem.base import (
-    SIEMClient,
     SIEMAlert,
-    SIEMRule,
+    SIEMClient,
     SIEMConnectionStatus,
+    SIEMRule,
 )
 
 
@@ -104,9 +104,9 @@ class GoogleSecOpsSIEMClient(SIEMClient):
         Returns:
             Signed JWT string
         """
+        from cryptography.hazmat.backends import default_backend
         from cryptography.hazmat.primitives import hashes, serialization
         from cryptography.hazmat.primitives.asymmetric import padding
-        from cryptography.hazmat.backends import default_backend
 
         now = int(time.time())
         expiry = now + 3600  # 1 hour

souleyez/integrations/siem/rule_mappings/wazuh_rules.py

@@ -5,7 +5,7 @@ Maps attack types to Wazuh detection rule IDs and provides
 rule metadata for detection validation and recommendations.
 """
 
-from typing import Dict, List, Any
+from typing import Any, Dict, List
 
 # Wazuh rule mappings by attack type
 # These complement the attack_signatures.py definitions

souleyez/integrations/siem/sentinel.py

@@ -6,15 +6,15 @@ Uses Azure REST APIs for querying alerts and analytics rules.
 """
 
 from datetime import datetime, timedelta
-from typing import Dict, List, Optional, Any
+from typing import Any, Dict, List, Optional
 
 import requests
 
 from souleyez.integrations.siem.base import (
-    SIEMClient,
     SIEMAlert,
-    SIEMRule,
+    SIEMClient,
     SIEMConnectionStatus,
+    SIEMRule,
 )
 
 

souleyez/integrations/siem/splunk.py

@@ -7,16 +7,16 @@ Uses the Splunk REST API for querying alerts and search results.
 
 import time
 from datetime import datetime
-from typing import Dict, List, Optional, Any
+from typing import Any, Dict, List, Optional
 
 import requests
 from requests.auth import HTTPBasicAuth
 
 from souleyez.integrations.siem.base import (
-    SIEMClient,
     SIEMAlert,
-    SIEMRule,
+    SIEMClient,
     SIEMConnectionStatus,
+    SIEMRule,
 )
 
 

souleyez/integrations/siem/wazuh.py

@@ -6,17 +6,17 @@ for unified multi-SIEM detection validation.
 """
 
 from datetime import datetime
-from typing import Dict, List, Optional, Any
+from typing import Any, Dict, List, Optional
 
 from souleyez.integrations.siem.base import (
-    SIEMClient,
     SIEMAlert,
-    SIEMRule,
+    SIEMClient,
     SIEMConnectionStatus,
+    SIEMRule,
 )
 from souleyez.integrations.siem.rule_mappings.wazuh_rules import (
-    get_wazuh_rules_for_attack,
     WAZUH_ATTACK_RULES,
+    get_wazuh_rules_for_attack,
 )
 
 

souleyez/integrations/wazuh/__init__.py

@@ -2,7 +2,7 @@
 from .client import WazuhClient
 from .config import WazuhConfig
 from .host_mapper import WazuhHostMapper
-from .sync import WazuhVulnSync, SyncResult
+from .sync import SyncResult, WazuhVulnSync
 
 __all__ = [
     "WazuhClient",

souleyez/integrations/wazuh/client.py

@@ -5,9 +5,10 @@ Connects to Wazuh Manager API (port 55000) for management operations
 and Wazuh Indexer API (port 9200) for querying alerts.
 """
 
-import requests
 from datetime import datetime, timedelta
-from typing import List, Dict, Optional, Any
+from typing import Any, Dict, List, Optional
+
+import requests
 from urllib3.exceptions import InsecureRequestWarning
 
 # Suppress SSL warnings for self-signed certs (common in Wazuh)

souleyez/integrations/wazuh/config.py

@@ -6,10 +6,11 @@ Supports multiple SIEM platforms: Wazuh, Splunk, Elastic, Sentinel.
 """
 
 import json
-from typing import Optional, Dict, Any, List
 from pathlib import Path
-from souleyez.storage.database import get_db
+from typing import Any, Dict, List, Optional
+
 from souleyez.storage.crypto import get_crypto_manager
+from souleyez.storage.database import get_db
 
 # Supported SIEM types (Open Source first, then Commercial)
 SIEM_TYPES = ["wazuh", "elastic", "splunk", "sentinel", "google_secops"]

souleyez/integrations/wazuh/host_mapper.py

@@ -4,9 +4,11 @@ souleyez.integrations.wazuh.host_mapper - Map Wazuh agents to SoulEyez hosts
 
 Maps Wazuh agent IPs to SoulEyez hosts for vulnerability correlation.
 """
+
 from typing import Dict, List, Optional, Tuple
-from souleyez.storage.database import get_db
+
 from souleyez.log_config import get_logger
+from souleyez.storage.database import get_db
 
 logger = get_logger(__name__)
 

souleyez/integrations/wazuh/sync.py

@@ -4,14 +4,17 @@ souleyez.integrations.wazuh.sync - Wazuh vulnerability sync
 
 Syncs vulnerabilities from Wazuh to SoulEyez database.
 """
+
 from dataclasses import dataclass, field
 from datetime import datetime
 from typing import List, Optional
+
 from souleyez.log_config import get_logger
+from souleyez.storage.wazuh_vulns import WazuhVulnsManager
+
 from .client import WazuhClient
 from .config import WazuhConfig
 from .host_mapper import WazuhHostMapper
-from souleyez.storage.wazuh_vulns import WazuhVulnsManager
 
 logger = get_logger(__name__)
 

souleyez/intelligence/__init__.py

@@ -7,6 +7,6 @@ __all__ = [
     "AttackSurfaceAnalyzer",
 ]
 
-from souleyez.intelligence.service_parser import ServiceVersionExtractor
 from souleyez.intelligence.exploit_knowledge import ExploitKnowledgeBase
 from souleyez.intelligence.exploit_suggestions import ExploitSuggestionEngine
+from souleyez.intelligence.service_parser import ServiceVersionExtractor

souleyez/intelligence/correlation_analyzer.py

@@ -3,16 +3,17 @@
 Correlation analyzer for tracking exploitation status.
 Links services, findings, jobs, credentials, and evidence together.
 """
+
 import json
 from datetime import datetime, timedelta
-from typing import Dict, List, Optional
 from pathlib import Path
+from typing import Dict, List, Optional
 
-from souleyez.storage.hosts import HostManager
-from souleyez.storage.findings import FindingsManager
-from souleyez.storage.credentials import CredentialsManager
-from souleyez.engine.background import list_jobs, get_job
+from souleyez.engine.background import get_job, list_jobs
 from souleyez.intelligence.target_parser import TargetParser
+from souleyez.storage.credentials import CredentialsManager
+from souleyez.storage.findings import FindingsManager
+from souleyez.storage.hosts import HostManager
 
 
 class CorrelationAnalyzer:

souleyez/intelligence/exploit_knowledge.py

@@ -3,13 +3,13 @@
 Exploit knowledge base.
 Maps services and versions to known vulnerabilities and MSF modules.
 """
-from typing import List, Dict, Optional
+
+import json
+import os
 import re
 import subprocess
-import json
 import time
-import os
-
+from typing import Dict, List, Optional
 
 # Exploit database with known vulnerabilities
 EXPLOIT_DATABASE = {

souleyez/intelligence/exploit_suggestions.py

@@ -3,14 +3,15 @@
 Exploit suggestion engine.
 Orchestrates version extraction, exploit matching, and ranking.
 """
+
 import re
 import time
 from typing import Dict, List, Optional
-from souleyez.intelligence.service_parser import ServiceVersionExtractor
+
 from souleyez.intelligence.exploit_knowledge import ExploitKnowledgeBase
+from souleyez.intelligence.service_parser import ServiceVersionExtractor
 from souleyez.storage import exploit_attempts
 
-
 # Module-level cache shared across all instances
 _SUGGESTION_CACHE = {}
 _CACHE_TIMEOUT = 30
@@ -102,8 +103,8 @@ class ExploitSuggestionEngine:
                 return cached_result
 
         # Cache miss or expired - do the analysis
-        from souleyez.storage.hosts import HostManager
         from souleyez.storage.findings import FindingsManager
+        from souleyez.storage.hosts import HostManager
         from souleyez.storage.wazuh_vulns import WazuhVulnsManager
 
         hm = HostManager()

souleyez/intelligence/gap_analyzer.py

@@ -5,12 +5,14 @@ souleyez.intelligence.gap_analyzer - Gap analysis between Wazuh and scan finding
 Compares vulnerabilities found by Wazuh (passive, agent-based) vs
 SoulEyez scans (active, network-based) to identify detection gaps.
 """
-from dataclasses import dataclass, field
-from typing import List, Dict, Any, Optional
+
 import re
+from dataclasses import dataclass, field
+from typing import Any, Dict, List, Optional
+
+from souleyez.log_config import get_logger
 from souleyez.storage.database import get_db
 from souleyez.storage.wazuh_vulns import WazuhVulnsManager
-from souleyez.log_config import get_logger
 
 logger = get_logger(__name__)
 

souleyez/intelligence/gap_detector.py

@@ -3,7 +3,9 @@
 Gap detector for identifying unexploited services.
 Prioritizes gaps by exploitation potential.
 """
+
 from typing import Dict, List
+
 from souleyez.intelligence.correlation_analyzer import CorrelationAnalyzer
 
 

souleyez/intelligence/sensitive_tables.py

@@ -2,8 +2,8 @@
 """
 Module for detecting sensitive tables during SQLMap enumeration.
 """
-from typing import Dict, List, Tuple, Optional
 
+from typing import Dict, List, Optional, Tuple
 
 # System databases to NEVER dump (true system metadata only)
 # NOTE: Only skip databases that are ALWAYS system/metadata databases

souleyez/intelligence/service_parser.py

@@ -3,6 +3,7 @@
 Service version extraction and parsing.
 Extracts version info from services table and findings.
 """
+
 import re
 from typing import Dict, List, Optional
 

souleyez/intelligence/surface_analyzer.py

@@ -3,10 +3,10 @@
 Attack surface analysis and scoring.
 Analyzes engagement data to identify high-value targets and exploitation gaps.
 """
-from typing import List, Dict, Optional
-import time
-import math
 
+import math
+import time
+from typing import Dict, List, Optional
 
 # Module-level cache shared across all instances
 _ANALYSIS_CACHE = {}
@@ -17,9 +17,9 @@ class AttackSurfaceAnalyzer:
     """Analyzes and scores attack surface for pentesting engagements."""
 
     def __init__(self):
-        from souleyez.storage.hosts import HostManager
-        from souleyez.storage.findings import FindingsManager
         from souleyez.storage.credentials import CredentialsManager
+        from souleyez.storage.findings import FindingsManager
+        from souleyez.storage.hosts import HostManager
         from souleyez.storage.wazuh_vulns import WazuhVulnsManager
 
         self.hosts_mgr = HostManager()
@@ -130,8 +130,8 @@ class AttackSurfaceAnalyzer:
             f
             for f in findings
             if f.get("ip_address") == host_ip
-            or f.get("url", "").startswith(f"http://{host_ip}")
-            or f.get("url", "").startswith(f"https://{host_ip}")
+            or (f.get("url") or "").startswith(f"http://{host_ip}")
+            or (f.get("url") or "").startswith(f"https://{host_ip}")
         ]
         critical_findings = [
             f for f in host_findings if f.get("severity") == "critical"
@@ -200,11 +200,11 @@ class AttackSurfaceAnalyzer:
                         for f in host_findings
                         if f.get("port") == service["port"]
                         or (
-                            f.get("path", "").startswith("https://")
+                            (f.get("path") or "").startswith("https://")
                             and service["port"] == 443
                         )
                         or (
-                            f.get("path", "").startswith("http://")
+                            (f.get("path") or "").startswith("http://")
                             and service["port"] == 80
                         )
                     ]

souleyez/intelligence/target_parser.py

@@ -3,6 +3,7 @@
 Target parser for job correlation.
 Parses job targets to extract host, port, and service information.
 """
+
 import re
 from typing import Dict, List, Optional
 from urllib.parse import urlparse

souleyez/licensing/__init__.py

@@ -6,12 +6,12 @@ License keys are signed JSON payloads that can be validated without internet.
 """
 
 from souleyez.licensing.validator import (
-    LicenseValidator,
     LicenseInfo,
-    validate_license,
+    LicenseValidator,
     activate_license,
-    get_active_license,
     deactivate_license,
+    get_active_license,
+    validate_license,
 )
 
 __all__ = [