webscout 8.3.7__py3-none-any.whl → 2025.10.11__py3-none-any.whl

webscout/litagent/agent.py

@@ -1,582 +1,582 @@
-"""Main LitAgent implementation."""
-
-import random
-import threading
-from typing import Any, Dict, List, Optional
-
-from webscout.litagent.constants import BROWSERS, DEVICES, FINGERPRINTS, OS_VERSIONS
-
-
-class LitAgent:
-    """A lit user agent generator that keeps it fresh! 🌟"""
-
-    def __init__(self, thread_safe: bool = False):
-        """Initialize LitAgent with style! 💫
-
-        Args:
-            thread_safe (bool): Enable thread-safety for multi-threaded applications
-        """
-        self.agents = self._generate_agents(100)  # Keep 100 agents in memory
-        self.thread_safe = thread_safe
-        self.lock = threading.RLock() if thread_safe else None
-        self.ip_pool = self._generate_ip_pool(20)
-        self._ip_index = 0
-        self._refresh_timer = None
-        self._stats = {
-            "total_generated": 100,
-            "requests_served": 0,
-            "browser_usage": {browser: 0 for browser in BROWSERS.keys()},
-            "device_usage": {device: 0 for device in DEVICES.keys()}
-        }
-
-    def _generate_agents(self, count: int) -> List[str]:
-        """Generate some lit user agents! 🛠️"""
-        agents = []
-        for _ in range(count):
-            browser = random.choice(list(BROWSERS.keys()))
-            version = random.randint(*BROWSERS[browser])
-
-            if browser in ['chrome', 'firefox', 'edge', 'opera', 'brave', 'vivaldi']:
-                os_type = random.choice(['windows', 'mac', 'linux'])
-                os_ver = random.choice(OS_VERSIONS[os_type])
-
-                if os_type == 'windows':
-                    platform = f"Windows NT {os_ver}"
-                elif os_type == 'mac':
-                    platform = f"Macintosh; Intel Mac OS X {os_ver}"
-                else:
-                    platform = f"X11; Linux {os_ver}"
-
-                agent = f"Mozilla/5.0 ({platform}) AppleWebKit/537.36 (KHTML, like Gecko) "
-                if browser == 'chrome':
-                    agent += f"Chrome/{version}.0.0.0 Safari/537.36"
-                elif browser == 'firefox':
-                    agent += f"Firefox/{version}.0"
-                elif browser == 'edge':
-                    agent += f"Edge/{version}.0.0.0"
-                elif browser == 'opera':
-                    agent += f"OPR/{version}.0.0.0"
-                elif browser == 'brave':
-                    agent += f"Chrome/{version}.0.0.0 Safari/537.36 Brave/{version}.0.0.0"
-                elif browser == 'vivaldi':
-                    agent += f"Chrome/{version}.0.0.0 Safari/537.36 Vivaldi/{version}.0.{random.randint(1000, 9999)}"
-
-            elif browser == 'safari':
-                device = random.choice(['mac', 'ios'])
-                if device == 'mac':
-                    ver = random.choice(OS_VERSIONS['mac'])
-                    agent = f"Mozilla/5.0 (Macintosh; Intel Mac OS X {ver}) "
-                else:
-                    ver = random.choice(OS_VERSIONS['ios'])
-                    device = random.choice(['iPhone', 'iPad'])
-                    agent = f"Mozilla/5.0 ({device}; CPU OS {ver} like Mac OS X) "
-                agent += f"AppleWebKit/{version}.1.15 (KHTML, like Gecko) Version/{version//100}.0 Safari/{version}.1.15"
-
-            agents.append(agent)
-
-        return list(set(agents))  # Remove any duplicates
-
-    def _update_stats(self, browser_type=None, device_type=None):
-        """Update usage statistics."""
-        if self.thread_safe and self.lock:
-            with self.lock:
-                self._stats["requests_served"] += 1
-                if browser_type:
-                    self._stats["browser_usage"][browser_type] = self._stats["browser_usage"].get(browser_type, 0) + 1
-                if device_type:
-                    self._stats["device_usage"][device_type] = self._stats["device_usage"].get(device_type, 0) + 1
-        else:
-            self._stats["requests_served"] += 1
-            if browser_type:
-                self._stats["browser_usage"][browser_type] = self._stats["browser_usage"].get(browser_type, 0) + 1
-            if device_type:
-                self._stats["device_usage"][device_type] = self._stats["device_usage"].get(device_type, 0) + 1
-
-    def random(self) -> str:
-        """Get a random user agent! 🎲 (with blacklist/whitelist support)"""
-        if hasattr(self, '_whitelist') and self._whitelist:
-            pool = list(self._whitelist)
-        else:
-            pool = [a for a in self.agents if not hasattr(self, '_blacklist') or a not in self._blacklist]
-        if not pool:
-            pool = self.agents
-        if self.thread_safe and self.lock:
-            with self.lock:
-                agent = random.choice(pool)
-                self._update_stats()
-                self._add_to_history(agent)
-                return agent
-        else:
-            agent = random.choice(pool)
-            self._update_stats()
-            self._add_to_history(agent)
-            return agent
-
-    def browser(self, name: str) -> str:
-        """Get a browser-specific agent! 🌐"""
-        name = name.lower()
-        if name not in BROWSERS:
-            return self.random()
-
-        if self.thread_safe and self.lock:
-            with self.lock:
-                agents = [a for a in self.agents if name in a.lower()]
-                agent = random.choice(agents) if agents else self.random()
-                self._update_stats(browser_type=name)
-                return agent
-        else:
-            agents = [a for a in self.agents if name in a.lower()]
-            agent = random.choice(agents) if agents else self.random()
-            self._update_stats(browser_type=name)
-            return agent
-
-    def mobile(self) -> str:
-        """Get a mobile device agent! 📱"""
-        if self.thread_safe and self.lock:
-            with self.lock:
-                agents = [a for a in self.agents if any(d in a for d in DEVICES['mobile'])]
-                agent = random.choice(agents) if agents else self.random()
-                self._update_stats(device_type="mobile")
-                return agent
-        else:
-            agents = [a for a in self.agents if any(d in a for d in DEVICES['mobile'])]
-            agent = random.choice(agents) if agents else self.random()
-            self._update_stats(device_type="mobile")
-            return agent
-
-    def desktop(self) -> str:
-        """Get a desktop agent! 💻"""
-        if self.thread_safe and self.lock:
-            with self.lock:
-                agents = [a for a in self.agents if 'Windows' in a or 'Macintosh' in a or 'Linux' in a]
-                agent = random.choice(agents) if agents else self.random()
-                self._update_stats(device_type="desktop")
-                return agent
-        else:
-            agents = [a for a in self.agents if 'Windows' in a or 'Macintosh' in a or 'Linux' in a]
-            agent = random.choice(agents) if agents else self.random()
-            self._update_stats(device_type="desktop")
-            return agent
-
-    def tablet(self) -> str:
-        """Get a tablet agent! 📱"""
-        if self.thread_safe and self.lock:
-            with self.lock:
-                # Focus on iPad and Android tablets
-                agents = [a for a in self.agents if 'iPad' in a or 'Android' in a and 'Mobile' not in a]
-                agent = random.choice(agents) if agents else self.random()
-                self._update_stats(device_type="tablet")
-                return agent
-        else:
-            agents = [a for a in self.agents if 'iPad' in a or 'Android' in a and 'Mobile' not in a]
-            agent = random.choice(agents) if agents else self.random()
-            self._update_stats(device_type="tablet")
-            return agent
-
-    def smart_tv(self) -> str:
-        """Get a Smart TV agent! 📺"""
-        # Create a TV-specific agent since they may not be in our standard pool
-        tv_type = random.choice(DEVICES['tv'])
-        if 'Samsung' in tv_type:
-            agent = f"Mozilla/5.0 (SMART-TV; SAMSUNG; {tv_type}; Tizen 5.5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.38 Safari/537.36"
-        elif 'LG' in tv_type:
-            agent = f"Mozilla/5.0 (Web0S; {tv_type}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.79 Safari/537.36"
-        elif 'Android' in tv_type:
-            agent = f"Mozilla/5.0 (Linux; Android 9; {tv_type}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.79 Safari/537.36"
-        elif 'Apple' in tv_type:
-            agent = "Mozilla/5.0 (AppleTV; CPU like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"
-        else:
-            agent = f"Mozilla/5.0 (Linux; {tv_type}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.79 Safari/537.36"
-
-        self._update_stats(device_type="tv")
-        return agent
-
-    def gaming(self) -> str:
-        """Get a gaming console agent! 🎮"""
-        console_type = random.choice(DEVICES['console'])
-        if 'PlayStation' in console_type:
-            agent = f"Mozilla/5.0 ({console_type}/5.0) AppleWebKit/601.2 (KHTML, like Gecko)"
-        elif 'Xbox' in console_type:
-            agent = f"Mozilla/5.0 ({console_type}; Xbox; Xbox One) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.102 Safari/537.36 Edge/18.19041"
-        elif 'Nintendo' in console_type:
-            agent = f"Mozilla/5.0 (Nintendo Switch; {console_type}) AppleWebKit/601.6 (KHTML, like Gecko) NintendoBrowser/5.1.0.13343"
-        else:
-            agent = self.random()
-
-        self._update_stats(device_type="console")
-        return agent
-
-    def chrome(self) -> str:
-        """Get a Chrome agent! 🌐"""
-        return self.browser('chrome')
-
-    def firefox(self) -> str:
-        """Get a Firefox agent! 🦊"""
-        return self.browser('firefox')
-
-    def safari(self) -> str:
-        """Get a Safari agent! 🧭"""
-        return self.browser('safari')
-
-    def edge(self) -> str:
-        """Get an Edge agent! 📐"""
-        return self.browser('edge')
-
-    def opera(self) -> str:
-        """Get an Opera agent! 🎭"""
-        return self.browser('opera')
-
-    def brave(self) -> str:
-        """Get a Brave agent! 🦁"""
-        return self.browser('brave')
-
-    def vivaldi(self) -> str:
-        """Get a Vivaldi agent! 🎨"""
-        return self.browser('vivaldi')
-
-    # OS-specific agents
-    def windows(self) -> str:
-        """Get a Windows agent! 🪟"""
-        agents = [a for a in self.agents if 'Windows' in a]
-        agent = random.choice(agents) if agents else self.random()
-        self._update_stats()
-        return agent
-
-    def macos(self) -> str:
-        """Get a macOS agent! 🍎"""
-        agents = [a for a in self.agents if 'Macintosh' in a]
-        agent = random.choice(agents) if agents else self.random()
-        self._update_stats()
-        return agent
-
-    def linux(self) -> str:
-        """Get a Linux agent! 🐧"""
-        agents = [a for a in self.agents if 'Linux' in a and 'Android' not in a]
-        agent = random.choice(agents) if agents else self.random()
-        self._update_stats()
-        return agent
-
-    def android(self) -> str:
-        """Get an Android agent! 🤖"""
-        agents = [a for a in self.agents if 'Android' in a]
-        agent = random.choice(agents) if agents else self.random()
-        self._update_stats()
-        return agent
-
-    def ios(self) -> str:
-        """Get an iOS agent! 📱"""
-        agents = [a for a in self.agents if 'iPhone' in a or 'iPad' in a]
-        agent = random.choice(agents) if agents else self.random()
-        self._update_stats()
-        return agent
-
-    def custom(self, browser: str, version: Optional[str] = None,
-               os: Optional[str] = None, os_version: Optional[str] = None,
-               device_type: Optional[str] = None) -> str:
-        """Generate a custom user agent with specified parameters! 🛠️
-
-        Args:
-            browser: Browser name (chrome, firefox, safari, edge, opera)
-            version: Browser version (optional)
-            os: Operating system (windows, mac, linux, android, ios)
-            os_version: OS version (optional)
-            device_type: Device type (desktop, mobile, tablet)
-        Returns:
-            Customized user agent string
-        """
-        browser = browser.lower() if browser else 'chrome'
-        if browser not in BROWSERS:
-            browser = 'chrome'
-
-        if version:
-            try:
-                version_num = int(version.split('.')[0])
-            except (ValueError, IndexError):
-                version_num = random.randint(*BROWSERS[browser])
-        else:
-            version_num = random.randint(*BROWSERS[browser])
-
-        os = os.lower() if os else random.choice(['windows', 'mac', 'linux'])
-        if os not in OS_VERSIONS:
-            os = 'windows'
-
-        os_ver = os_version or random.choice(OS_VERSIONS[os])
-
-        device_type = device_type.lower() if device_type else 'desktop'
-
-        # Build the user agent
-        if os == 'windows':
-            platform = f"Windows NT {os_ver}"
-        elif os == 'mac':
-            platform = f"Macintosh; Intel Mac OS X {os_ver}"
-        elif os == 'linux':
-            platform = f"X11; Linux {OS_VERSIONS['linux'][0]}"
-        elif os == 'android':
-            platform = f"Linux; Android {os_ver}; {random.choice(DEVICES['mobile'])}"
-        elif os == 'ios':
-            device = 'iPhone' if device_type == 'mobile' else 'iPad'
-            platform = f"{device}; CPU OS {os_ver} like Mac OS X"
-        else:
-            platform = "Windows NT 10.0"  # Default fallback
-
-        agent = f"Mozilla/5.0 ({platform}) AppleWebKit/537.36 (KHTML, like Gecko) "
-
-        if browser == 'chrome':
-            agent += f"Chrome/{version_num}.0.0.0 Safari/537.36"
-        elif browser == 'firefox':
-            agent += f"Firefox/{version_num}.0"
-        elif browser == 'safari':
-            safari_ver = random.randint(*BROWSERS['safari'])
-            agent += f"Version/{version_num}.0 Safari/{safari_ver}.0"
-        elif browser == 'edge':
-            agent += f"Chrome/{version_num}.0.0.0 Safari/537.36 Edg/{version_num}.0.0.0"
-        elif browser == 'opera':
-            agent += f"Chrome/{version_num}.0.0.0 Safari/537.36 OPR/{version_num}.0.0.0"
-        elif browser == 'brave':
-            agent += f"Chrome/{version_num}.0.0.0 Safari/537.36 Brave/{version_num}.1.0"
-
-        self._update_stats(browser_type=browser, device_type=device_type)
-        return agent
-
-    @staticmethod
-    def generate_fingerprint(browser: Optional[str] = None) -> Dict[str, str]:
-        """
-        Generate a consistent browser fingerprint for anti-fingerprinting purposes.
-
-        This method creates a dictionary of HTTP headers and related values that simulate
-        a realistic browser fingerprint, including user agent, accept headers, platform,
-        sec-ch-ua, and various IP-related headers. Optionally, a specific browser type
-        can be requested.
-
-        Args:
-            browser (Optional[str]): The browser name to generate the fingerprint for.
-                If not specified, a random browser is used.
-
-        Returns:
-            Dict[str, str]: A dictionary containing fingerprinting headers and values.
-        """
-        # Get a random user agent using the random() method
-        agent = LitAgent()
-        user_agent = agent.random()
-
-        # If browser is specified, try to get a matching one
-        if browser:
-            browser = browser.lower()
-            if browser in BROWSERS:
-                user_agent = agent.browser(browser)
-
-        accept_language = random.choice(FINGERPRINTS["accept_language"])
-        accept = random.choice(FINGERPRINTS["accept"])
-        platform = random.choice(FINGERPRINTS["platforms"])
-
-        # Generate sec-ch-ua based on the user agent
-        sec_ch_ua = ""
-        for browser_name in FINGERPRINTS["sec_ch_ua"]:
-            if browser_name in user_agent.lower():
-                version = random.randint(*BROWSERS[browser_name])
-                sec_ch_ua = FINGERPRINTS["sec_ch_ua"][browser_name].format(version, version)
-                break
-
-        ip = agent.rotate_ip()
-        fingerprint = {
-            "user_agent": user_agent,
-            "accept_language": accept_language,
-            "accept": accept,
-            "sec_ch_ua": sec_ch_ua,
-            "platform": platform,
-            "x-forwarded-for": ip,
-            "x-real-ip": ip,
-            "x-client-ip": ip,
-            "forwarded": f"for={ip};proto=https",
-            "x-forwarded-proto": "https",
-            "x-request-id": agent.random_id(8) if hasattr(agent, 'random_id') else ''.join(random.choices('0123456789abcdef', k=8)),
-        }
-
-        agent._update_stats(browser_type=browser)
-        return fingerprint
-
-    def refresh(self) -> None:
-        """Refresh the agents with new ones! 🔄"""
-        if self.thread_safe and self.lock:
-            with self.lock:
-                self.agents = self._generate_agents(100)
-                self._stats["total_generated"] += 100
-        else:
-            self.agents = self._generate_agents(100)
-            self._stats["total_generated"] += 100
-
-
-    def auto_refresh(self, interval_minutes: int = 30) -> None:
-        """Set up automatic refreshing of agents pool! ⏱️
-
-        Args:
-            interval_minutes: Minutes between refreshes
-        """
-        if self._refresh_timer:
-            self._refresh_timer.cancel()
-
-        def _refresh_task():
-            self.refresh()
-            self._refresh_timer = threading.Timer(interval_minutes * 60, _refresh_task)
-            self._refresh_timer.daemon = True
-            self._refresh_timer.start()
-
-        self._refresh_timer = threading.Timer(interval_minutes * 60, _refresh_task)
-        self._refresh_timer.daemon = True
-        self._refresh_timer.start()
-
-    def get_stats(self) -> Dict[str, Any]:
-        """Get statistics about agent usage! 📊
-
-        Returns:
-            Dictionary with usage statistics
-        """
-        stats_copy = self._stats.copy()
-        # Calculate top browser
-        top_browser = max(stats_copy["browser_usage"].items(), key=lambda x: x[1])[0] if stats_copy["browser_usage"] else None
-        stats_copy["top_browser"] = top_browser
-
-        # Calculate fake detection avoidance rate (just for fun)
-        stats_copy["avoidance_rate"] = min(99.9, 90 + (stats_copy["total_generated"] / 1000))
-
-        return stats_copy
-
-    def export_stats(self, filename: str) -> bool:
-        """Export usage statistics to a file! 💾
-        Args:
-            filename: Path to export the stats
-        Returns:
-            True if export was successful, False otherwise
-        """
-        try:
-            import json
-            with open(filename, 'w') as f:
-                json.dump(self.get_stats(), f, indent=2)
-            return True
-        except Exception:
-            return False
-
-    def random_crypto_ip(self) -> str:
-        """Generate a random IP address for cryptography purposes."""
-        return ".".join(str(random.randint(0, 255)) for _ in range(4))
-
-    def _generate_ip_pool(self, count: int = 20) -> List[str]:
-        """Generate a pool of random IP addresses."""
-        return [self.random_crypto_ip() for _ in range(count)]
-
-    def rotate_ip(self) -> str:
-        """Rotate through the IP pool and return the next IP."""
-        if not self.ip_pool:
-            self.ip_pool = self._generate_ip_pool(20)
-            self._ip_index = 0
-
-        ip = self.ip_pool[self._ip_index]
-        self._ip_index = (self._ip_index + 1) % len(self.ip_pool)
-        return ip
-
-    # Backwards compatibility for older versions expecting _random_ip
-    def _random_ip(self) -> str:
-        return self.rotate_ip()
-
-    def random_id(self, length: int = 16) -> str:
-        """Generate a random identifier string."""
-        return ''.join(random.choices('0123456789abcdef', k=length)).lower()
-
-    def wearable(self) -> str:
-        """Get a wearable device agent! ⌚"""
-        wearable_type = random.choice(DEVICES['wearable'])
-        # Example user agent for wearables (simplified)
-        if 'Apple Watch' in wearable_type:
-            agent = f"Mozilla/5.0 (AppleWatch; CPU WatchOS like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/9.0 Mobile/13S344 Safari/602.1"
-        elif 'Samsung' in wearable_type:
-            agent = f"Mozilla/5.0 (Linux; Tizen 3.0; {wearable_type}) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/1.0"
-        elif 'Fitbit' in wearable_type:
-            agent = f"Mozilla/5.0 (Linux; {wearable_type}) AppleWebKit/537.36 (KHTML, like Gecko)"
-        elif 'Garmin' in wearable_type:
-            agent = f"Mozilla/5.0 (Linux; {wearable_type}) AppleWebKit/537.36 (KHTML, like Gecko)"
-        else:
-            agent = self.random()
-        self._update_stats(device_type="wearable")
-        return agent
-
-    def set_proxy_pool(self, proxies: List[str]):
-        """Set a pool of proxies for rotation."""
-        self._proxy_pool = proxies
-        self._proxy_index = 0
-
-    def rotate_proxy(self) -> Optional[str]:
-        """Rotate through the proxy pool and return the next proxy."""
-        if not hasattr(self, '_proxy_pool') or not self._proxy_pool:
-            return None
-        proxy = self._proxy_pool[self._proxy_index]
-        self._proxy_index = (self._proxy_index + 1) % len(self._proxy_pool)
-        return proxy
-
-    def add_to_blacklist(self, agent: str):
-        """Add a user agent to the blacklist."""
-        if not hasattr(self, '_blacklist'):
-            self._blacklist = set()
-        self._blacklist.add(agent)
-
-    def add_to_whitelist(self, agent: str):
-        """Add a user agent to the whitelist."""
-        if not hasattr(self, '_whitelist'):
-            self._whitelist = set()
-        self._whitelist.add(agent)
-
-    def _add_to_history(self, agent: str):
-        if not hasattr(self, '_history'):
-            self._history = []
-        self._history.append(agent)
-        if len(self._history) > 50:
-            self._history.pop(0)
-
-    def get_history(self) -> List[str]:
-        """Get the last 50 user agents served."""
-        return getattr(self, '_history', [])
-
-    def validate_agent(self, agent: str) -> bool:
-        """Validate if a user agent string is realistic (basic check)."""
-        return agent.startswith("Mozilla/5.0") and any(b in agent for b in BROWSERS.keys())
-
-if __name__ == "__main__":
-    # Test it out! 🧪
-    agent = LitAgent()
-    print("Random:", agent.random())
-    print("Chrome:", agent.chrome())
-    print("Firefox:", agent.firefox())
-    print("Safari:", agent.safari())
-    print("Mobile:", agent.mobile())
-    print("Desktop:", agent.desktop())
-    print("Tablet:", agent.tablet())
-    print("Smart TV:", agent.smart_tv())
-    print("Gaming:", agent.gaming())
-    print("Wearable:", agent.wearable())
-
-    # Test custom agent
-    print("Custom:", agent.custom(browser="chrome", os="windows", os_version="10.0"))
-
-    # Test fingerprinting
-    print("Fingerprint:", agent.generate_fingerprint("chrome"))
-
-    # Test proxy rotation
-    agent.set_proxy_pool(["http://proxy1.com", "http://proxy2.com"])
-    print("Proxy 1:", agent.rotate_proxy())
-    print("Proxy 2:", agent.rotate_proxy())
-
-    # Test blacklist/whitelist
-    agent.add_to_blacklist("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36")
-    agent.add_to_whitelist("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36")
-    print("Blacklisted:", agent.random())
-    print("Whitelisted:", agent.random())
-
-    # Test agent history
-    for _ in range(55):
-        agent.random()
-    print("History:", agent.get_history())
-
-    # Test agent validation
-    print("Valid agent:", agent.validate_agent("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"))
-    print("Invalid agent:", agent.validate_agent("InvalidUserAgentString"))
-    ip = agent.rotate_ip()
+"""Main LitAgent implementation."""
+
+import random
+import threading
+from typing import Any, Dict, List, Optional
+
+from webscout.litagent.constants import BROWSERS, DEVICES, FINGERPRINTS, OS_VERSIONS
+
+
+class LitAgent:
+    """A lit user agent generator that keeps it fresh! 🌟"""
+
+    def __init__(self, thread_safe: bool = False):
+        """Initialize LitAgent with style! 💫
+
+        Args:
+            thread_safe (bool): Enable thread-safety for multi-threaded applications
+        """
+        self.agents = self._generate_agents(100)  # Keep 100 agents in memory
+        self.thread_safe = thread_safe
+        self.lock = threading.RLock() if thread_safe else None
+        self.ip_pool = self._generate_ip_pool(20)
+        self._ip_index = 0
+        self._refresh_timer = None
+        self._stats = {
+            "total_generated": 100,
+            "requests_served": 0,
+            "browser_usage": {browser: 0 for browser in BROWSERS.keys()},
+            "device_usage": {device: 0 for device in DEVICES.keys()}
+        }
+
+    def _generate_agents(self, count: int) -> List[str]:
+        """Generate some lit user agents! 🛠️"""
+        agents = []
+        for _ in range(count):
+            browser = random.choice(list(BROWSERS.keys()))
+            version = random.randint(*BROWSERS[browser])
+
+            if browser in ['chrome', 'firefox', 'edge', 'opera', 'brave', 'vivaldi']:
+                os_type = random.choice(['windows', 'mac', 'linux'])
+                os_ver = random.choice(OS_VERSIONS[os_type])
+
+                if os_type == 'windows':
+                    platform = f"Windows NT {os_ver}"
+                elif os_type == 'mac':
+                    platform = f"Macintosh; Intel Mac OS X {os_ver}"
+                else:
+                    platform = f"X11; Linux {os_ver}"
+
+                agent = f"Mozilla/5.0 ({platform}) AppleWebKit/537.36 (KHTML, like Gecko) "
+                if browser == 'chrome':
+                    agent += f"Chrome/{version}.0.0.0 Safari/537.36"
+                elif browser == 'firefox':
+                    agent += f"Firefox/{version}.0"
+                elif browser == 'edge':
+                    agent += f"Edge/{version}.0.0.0"
+                elif browser == 'opera':
+                    agent += f"OPR/{version}.0.0.0"
+                elif browser == 'brave':
+                    agent += f"Chrome/{version}.0.0.0 Safari/537.36 Brave/{version}.0.0.0"
+                elif browser == 'vivaldi':
+                    agent += f"Chrome/{version}.0.0.0 Safari/537.36 Vivaldi/{version}.0.{random.randint(1000, 9999)}"
+
+            elif browser == 'safari':
+                device = random.choice(['mac', 'ios'])
+                if device == 'mac':
+                    ver = random.choice(OS_VERSIONS['mac'])
+                    agent = f"Mozilla/5.0 (Macintosh; Intel Mac OS X {ver}) "
+                else:
+                    ver = random.choice(OS_VERSIONS['ios'])
+                    device = random.choice(['iPhone', 'iPad'])
+                    agent = f"Mozilla/5.0 ({device}; CPU OS {ver} like Mac OS X) "
+                agent += f"AppleWebKit/{version}.1.15 (KHTML, like Gecko) Version/{version//100}.0 Safari/{version}.1.15"
+
+            agents.append(agent)
+
+        return list(set(agents))  # Remove any duplicates
+
+    def _update_stats(self, browser_type=None, device_type=None):
+        """Update usage statistics."""
+        if self.thread_safe and self.lock:
+            with self.lock:
+                self._stats["requests_served"] += 1
+                if browser_type:
+                    self._stats["browser_usage"][browser_type] = self._stats["browser_usage"].get(browser_type, 0) + 1
+                if device_type:
+                    self._stats["device_usage"][device_type] = self._stats["device_usage"].get(device_type, 0) + 1
+        else:
+            self._stats["requests_served"] += 1
+            if browser_type:
+                self._stats["browser_usage"][browser_type] = self._stats["browser_usage"].get(browser_type, 0) + 1
+            if device_type:
+                self._stats["device_usage"][device_type] = self._stats["device_usage"].get(device_type, 0) + 1
+
+    def random(self) -> str:
+        """Get a random user agent! 🎲 (with blacklist/whitelist support)"""
+        if hasattr(self, '_whitelist') and self._whitelist:
+            pool = list(self._whitelist)
+        else:
+            pool = [a for a in self.agents if not hasattr(self, '_blacklist') or a not in self._blacklist]
+        if not pool:
+            pool = self.agents
+        if self.thread_safe and self.lock:
+            with self.lock:
+                agent = random.choice(pool)
+                self._update_stats()
+                self._add_to_history(agent)
+                return agent
+        else:
+            agent = random.choice(pool)
+            self._update_stats()
+            self._add_to_history(agent)
+            return agent
+
+    def browser(self, name: str) -> str:
+        """Get a browser-specific agent! 🌐"""
+        name = name.lower()
+        if name not in BROWSERS:
+            return self.random()
+
+        if self.thread_safe and self.lock:
+            with self.lock:
+                agents = [a for a in self.agents if name in a.lower()]
+                agent = random.choice(agents) if agents else self.random()
+                self._update_stats(browser_type=name)
+                return agent
+        else:
+            agents = [a for a in self.agents if name in a.lower()]
+            agent = random.choice(agents) if agents else self.random()
+            self._update_stats(browser_type=name)
+            return agent
+
+    def mobile(self) -> str:
+        """Get a mobile device agent! 📱"""
+        if self.thread_safe and self.lock:
+            with self.lock:
+                agents = [a for a in self.agents if any(d in a for d in DEVICES['mobile'])]
+                agent = random.choice(agents) if agents else self.random()
+                self._update_stats(device_type="mobile")
+                return agent
+        else:
+            agents = [a for a in self.agents if any(d in a for d in DEVICES['mobile'])]
+            agent = random.choice(agents) if agents else self.random()
+            self._update_stats(device_type="mobile")
+            return agent
+
+    def desktop(self) -> str:
+        """Get a desktop agent! 💻"""
+        if self.thread_safe and self.lock:
+            with self.lock:
+                agents = [a for a in self.agents if 'Windows' in a or 'Macintosh' in a or 'Linux' in a]
+                agent = random.choice(agents) if agents else self.random()
+                self._update_stats(device_type="desktop")
+                return agent
+        else:
+            agents = [a for a in self.agents if 'Windows' in a or 'Macintosh' in a or 'Linux' in a]
+            agent = random.choice(agents) if agents else self.random()
+            self._update_stats(device_type="desktop")
+            return agent
+
+    def tablet(self) -> str:
+        """Get a tablet agent! 📱"""
+        if self.thread_safe and self.lock:
+            with self.lock:
+                # Focus on iPad and Android tablets
+                agents = [a for a in self.agents if 'iPad' in a or 'Android' in a and 'Mobile' not in a]
+                agent = random.choice(agents) if agents else self.random()
+                self._update_stats(device_type="tablet")
+                return agent
+        else:
+            agents = [a for a in self.agents if 'iPad' in a or 'Android' in a and 'Mobile' not in a]
+            agent = random.choice(agents) if agents else self.random()
+            self._update_stats(device_type="tablet")
+            return agent
+
+    def smart_tv(self) -> str:
+        """Get a Smart TV agent! 📺"""
+        # Create a TV-specific agent since they may not be in our standard pool
+        tv_type = random.choice(DEVICES['tv'])
+        if 'Samsung' in tv_type:
+            agent = f"Mozilla/5.0 (SMART-TV; SAMSUNG; {tv_type}; Tizen 5.5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.38 Safari/537.36"
+        elif 'LG' in tv_type:
+            agent = f"Mozilla/5.0 (Web0S; {tv_type}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.79 Safari/537.36"
+        elif 'Android' in tv_type:
+            agent = f"Mozilla/5.0 (Linux; Android 9; {tv_type}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.79 Safari/537.36"
+        elif 'Apple' in tv_type:
+            agent = "Mozilla/5.0 (AppleTV; CPU like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"
+        else:
+            agent = f"Mozilla/5.0 (Linux; {tv_type}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.79 Safari/537.36"
+
+        self._update_stats(device_type="tv")
+        return agent
+
+    def gaming(self) -> str:
+        """Get a gaming console agent! 🎮"""
+        console_type = random.choice(DEVICES['console'])
+        if 'PlayStation' in console_type:
+            agent = f"Mozilla/5.0 ({console_type}/5.0) AppleWebKit/601.2 (KHTML, like Gecko)"
+        elif 'Xbox' in console_type:
+            agent = f"Mozilla/5.0 ({console_type}; Xbox; Xbox One) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.102 Safari/537.36 Edge/18.19041"
+        elif 'Nintendo' in console_type:
+            agent = f"Mozilla/5.0 (Nintendo Switch; {console_type}) AppleWebKit/601.6 (KHTML, like Gecko) NintendoBrowser/5.1.0.13343"
+        else:
+            agent = self.random()
+
+        self._update_stats(device_type="console")
+        return agent
+
+    def chrome(self) -> str:
+        """Get a Chrome agent! 🌐"""
+        return self.browser('chrome')
+
+    def firefox(self) -> str:
+        """Get a Firefox agent! 🦊"""
+        return self.browser('firefox')
+
+    def safari(self) -> str:
+        """Get a Safari agent! 🧭"""
+        return self.browser('safari')
+
+    def edge(self) -> str:
+        """Get an Edge agent! 📐"""
+        return self.browser('edge')
+
+    def opera(self) -> str:
+        """Get an Opera agent! 🎭"""
+        return self.browser('opera')
+
+    def brave(self) -> str:
+        """Get a Brave agent! 🦁"""
+        return self.browser('brave')
+
+    def vivaldi(self) -> str:
+        """Get a Vivaldi agent! 🎨"""
+        return self.browser('vivaldi')
+
+    # OS-specific agents
+    def windows(self) -> str:
+        """Get a Windows agent! 🪟"""
+        agents = [a for a in self.agents if 'Windows' in a]
+        agent = random.choice(agents) if agents else self.random()
+        self._update_stats()
+        return agent
+
+    def macos(self) -> str:
+        """Get a macOS agent! 🍎"""
+        agents = [a for a in self.agents if 'Macintosh' in a]
+        agent = random.choice(agents) if agents else self.random()
+        self._update_stats()
+        return agent
+
+    def linux(self) -> str:
+        """Get a Linux agent! 🐧"""
+        agents = [a for a in self.agents if 'Linux' in a and 'Android' not in a]
+        agent = random.choice(agents) if agents else self.random()
+        self._update_stats()
+        return agent
+
+    def android(self) -> str:
+        """Get an Android agent! 🤖"""
+        agents = [a for a in self.agents if 'Android' in a]
+        agent = random.choice(agents) if agents else self.random()
+        self._update_stats()
+        return agent
+
+    def ios(self) -> str:
+        """Get an iOS agent! 📱"""
+        agents = [a for a in self.agents if 'iPhone' in a or 'iPad' in a]
+        agent = random.choice(agents) if agents else self.random()
+        self._update_stats()
+        return agent
+
+    def custom(self, browser: str, version: Optional[str] = None,
+               os: Optional[str] = None, os_version: Optional[str] = None,
+               device_type: Optional[str] = None) -> str:
+        """Generate a custom user agent with specified parameters! 🛠️
+
+        Args:
+            browser: Browser name (chrome, firefox, safari, edge, opera)
+            version: Browser version (optional)
+            os: Operating system (windows, mac, linux, android, ios)
+            os_version: OS version (optional)
+            device_type: Device type (desktop, mobile, tablet)
+        Returns:
+            Customized user agent string
+        """
+        browser = browser.lower() if browser else 'chrome'
+        if browser not in BROWSERS:
+            browser = 'chrome'
+
+        if version:
+            try:
+                version_num = int(version.split('.')[0])
+            except (ValueError, IndexError):
+                version_num = random.randint(*BROWSERS[browser])
+        else:
+            version_num = random.randint(*BROWSERS[browser])
+
+        os = os.lower() if os else random.choice(['windows', 'mac', 'linux'])
+        if os not in OS_VERSIONS:
+            os = 'windows'
+
+        os_ver = os_version or random.choice(OS_VERSIONS[os])
+
+        device_type = device_type.lower() if device_type else 'desktop'
+
+        # Build the user agent
+        if os == 'windows':
+            platform = f"Windows NT {os_ver}"
+        elif os == 'mac':
+            platform = f"Macintosh; Intel Mac OS X {os_ver}"
+        elif os == 'linux':
+            platform = f"X11; Linux {OS_VERSIONS['linux'][0]}"
+        elif os == 'android':
+            platform = f"Linux; Android {os_ver}; {random.choice(DEVICES['mobile'])}"
+        elif os == 'ios':
+            device = 'iPhone' if device_type == 'mobile' else 'iPad'
+            platform = f"{device}; CPU OS {os_ver} like Mac OS X"
+        else:
+            platform = "Windows NT 10.0"  # Default fallback
+
+        agent = f"Mozilla/5.0 ({platform}) AppleWebKit/537.36 (KHTML, like Gecko) "
+
+        if browser == 'chrome':
+            agent += f"Chrome/{version_num}.0.0.0 Safari/537.36"
+        elif browser == 'firefox':
+            agent += f"Firefox/{version_num}.0"
+        elif browser == 'safari':
+            safari_ver = random.randint(*BROWSERS['safari'])
+            agent += f"Version/{version_num}.0 Safari/{safari_ver}.0"
+        elif browser == 'edge':
+            agent += f"Chrome/{version_num}.0.0.0 Safari/537.36 Edg/{version_num}.0.0.0"
+        elif browser == 'opera':
+            agent += f"Chrome/{version_num}.0.0.0 Safari/537.36 OPR/{version_num}.0.0.0"
+        elif browser == 'brave':
+            agent += f"Chrome/{version_num}.0.0.0 Safari/537.36 Brave/{version_num}.1.0"
+
+        self._update_stats(browser_type=browser, device_type=device_type)
+        return agent
+
+    @staticmethod
+    def generate_fingerprint(browser: Optional[str] = None) -> Dict[str, str]:
+        """
+        Generate a consistent browser fingerprint for anti-fingerprinting purposes.
+
+        This method creates a dictionary of HTTP headers and related values that simulate
+        a realistic browser fingerprint, including user agent, accept headers, platform,
+        sec-ch-ua, and various IP-related headers. Optionally, a specific browser type
+        can be requested.
+
+        Args:
+            browser (Optional[str]): The browser name to generate the fingerprint for.
+                If not specified, a random browser is used.
+
+        Returns:
+            Dict[str, str]: A dictionary containing fingerprinting headers and values.
+        """
+        # Get a random user agent using the random() method
+        agent = LitAgent()
+        user_agent = agent.random()
+
+        # If browser is specified, try to get a matching one
+        if browser:
+            browser = browser.lower()
+            if browser in BROWSERS:
+                user_agent = agent.browser(browser)
+
+        accept_language = random.choice(FINGERPRINTS["accept_language"])
+        accept = random.choice(FINGERPRINTS["accept"])
+        platform = random.choice(FINGERPRINTS["platforms"])
+
+        # Generate sec-ch-ua based on the user agent
+        sec_ch_ua = ""
+        for browser_name in FINGERPRINTS["sec_ch_ua"]:
+            if browser_name in user_agent.lower():
+                version = random.randint(*BROWSERS[browser_name])
+                sec_ch_ua = FINGERPRINTS["sec_ch_ua"][browser_name].format(version, version)
+                break
+
+        ip = agent.rotate_ip()
+        fingerprint = {
+            "user_agent": user_agent,
+            "accept_language": accept_language,
+            "accept": accept,
+            "sec_ch_ua": sec_ch_ua,
+            "platform": platform,
+            "x-forwarded-for": ip,
+            "x-real-ip": ip,
+            "x-client-ip": ip,
+            "forwarded": f"for={ip};proto=https",
+            "x-forwarded-proto": "https",
+            "x-request-id": agent.random_id(8) if hasattr(agent, 'random_id') else ''.join(random.choices('0123456789abcdef', k=8)),
+        }
+
+        agent._update_stats(browser_type=browser)
+        return fingerprint
+
+    def refresh(self) -> None:
+        """Refresh the agents with new ones! 🔄"""
+        if self.thread_safe and self.lock:
+            with self.lock:
+                self.agents = self._generate_agents(100)
+                self._stats["total_generated"] += 100
+        else:
+            self.agents = self._generate_agents(100)
+            self._stats["total_generated"] += 100
+
+
+    def auto_refresh(self, interval_minutes: int = 30) -> None:
+        """Set up automatic refreshing of agents pool! ⏱️
+
+        Args:
+            interval_minutes: Minutes between refreshes
+        """
+        if self._refresh_timer:
+            self._refresh_timer.cancel()
+
+        def _refresh_task():
+            self.refresh()
+            self._refresh_timer = threading.Timer(interval_minutes * 60, _refresh_task)
+            self._refresh_timer.daemon = True
+            self._refresh_timer.start()
+
+        self._refresh_timer = threading.Timer(interval_minutes * 60, _refresh_task)
+        self._refresh_timer.daemon = True
+        self._refresh_timer.start()
+
+    def get_stats(self) -> Dict[str, Any]:
+        """Get statistics about agent usage! 📊
+
+        Returns:
+            Dictionary with usage statistics
+        """
+        stats_copy = self._stats.copy()
+        # Calculate top browser
+        top_browser = max(stats_copy["browser_usage"].items(), key=lambda x: x[1])[0] if stats_copy["browser_usage"] else None
+        stats_copy["top_browser"] = top_browser
+
+        # Calculate fake detection avoidance rate (just for fun)
+        stats_copy["avoidance_rate"] = min(99.9, 90 + (stats_copy["total_generated"] / 1000))
+
+        return stats_copy
+
+    def export_stats(self, filename: str) -> bool:
+        """Export usage statistics to a file! 💾
+        Args:
+            filename: Path to export the stats
+        Returns:
+            True if export was successful, False otherwise
+        """
+        try:
+            import json
+            with open(filename, 'w') as f:
+                json.dump(self.get_stats(), f, indent=2)
+            return True
+        except Exception:
+            return False
+
+    def random_crypto_ip(self) -> str:
+        """Generate a random IP address for cryptography purposes."""
+        return ".".join(str(random.randint(0, 255)) for _ in range(4))
+
+    def _generate_ip_pool(self, count: int = 20) -> List[str]:
+        """Generate a pool of random IP addresses."""
+        return [self.random_crypto_ip() for _ in range(count)]
+
+    def rotate_ip(self) -> str:
+        """Rotate through the IP pool and return the next IP."""
+        if not self.ip_pool:
+            self.ip_pool = self._generate_ip_pool(20)
+            self._ip_index = 0
+
+        ip = self.ip_pool[self._ip_index]
+        self._ip_index = (self._ip_index + 1) % len(self.ip_pool)
+        return ip
+
+    # Backwards compatibility for older versions expecting _random_ip
+    def _random_ip(self) -> str:
+        return self.rotate_ip()
+
+    def random_id(self, length: int = 16) -> str:
+        """Generate a random identifier string."""
+        return ''.join(random.choices('0123456789abcdef', k=length)).lower()
+
+    def wearable(self) -> str:
+        """Get a wearable device agent! ⌚"""
+        wearable_type = random.choice(DEVICES['wearable'])
+        # Example user agent for wearables (simplified)
+        if 'Apple Watch' in wearable_type:
+            agent = f"Mozilla/5.0 (AppleWatch; CPU WatchOS like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/9.0 Mobile/13S344 Safari/602.1"
+        elif 'Samsung' in wearable_type:
+            agent = f"Mozilla/5.0 (Linux; Tizen 3.0; {wearable_type}) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/1.0"
+        elif 'Fitbit' in wearable_type:
+            agent = f"Mozilla/5.0 (Linux; {wearable_type}) AppleWebKit/537.36 (KHTML, like Gecko)"
+        elif 'Garmin' in wearable_type:
+            agent = f"Mozilla/5.0 (Linux; {wearable_type}) AppleWebKit/537.36 (KHTML, like Gecko)"
+        else:
+            agent = self.random()
+        self._update_stats(device_type="wearable")
+        return agent
+
+    def set_proxy_pool(self, proxies: List[str]):
+        """Set a pool of proxies for rotation."""
+        self._proxy_pool = proxies
+        self._proxy_index = 0
+
+    def rotate_proxy(self) -> Optional[str]:
+        """Rotate through the proxy pool and return the next proxy."""
+        if not hasattr(self, '_proxy_pool') or not self._proxy_pool:
+            return None
+        proxy = self._proxy_pool[self._proxy_index]
+        self._proxy_index = (self._proxy_index + 1) % len(self._proxy_pool)
+        return proxy
+
+    def add_to_blacklist(self, agent: str):
+        """Add a user agent to the blacklist."""
+        if not hasattr(self, '_blacklist'):
+            self._blacklist = set()
+        self._blacklist.add(agent)
+
+    def add_to_whitelist(self, agent: str):
+        """Add a user agent to the whitelist."""
+        if not hasattr(self, '_whitelist'):
+            self._whitelist = set()
+        self._whitelist.add(agent)
+
+    def _add_to_history(self, agent: str):
+        if not hasattr(self, '_history'):
+            self._history = []
+        self._history.append(agent)
+        if len(self._history) > 50:
+            self._history.pop(0)
+
+    def get_history(self) -> List[str]:
+        """Get the last 50 user agents served."""
+        return getattr(self, '_history', [])
+
+    def validate_agent(self, agent: str) -> bool:
+        """Validate if a user agent string is realistic (basic check)."""
+        return agent.startswith("Mozilla/5.0") and any(b in agent for b in BROWSERS.keys())
+
+if __name__ == "__main__":
+    # Test it out! 🧪
+    agent = LitAgent()
+    print("Random:", agent.random())
+    print("Chrome:", agent.chrome())
+    print("Firefox:", agent.firefox())
+    print("Safari:", agent.safari())
+    print("Mobile:", agent.mobile())
+    print("Desktop:", agent.desktop())
+    print("Tablet:", agent.tablet())
+    print("Smart TV:", agent.smart_tv())
+    print("Gaming:", agent.gaming())
+    print("Wearable:", agent.wearable())
+
+    # Test custom agent
+    print("Custom:", agent.custom(browser="chrome", os="windows", os_version="10.0"))
+
+    # Test fingerprinting
+    print("Fingerprint:", agent.generate_fingerprint("chrome"))
+
+    # Test proxy rotation
+    agent.set_proxy_pool(["http://proxy1.com", "http://proxy2.com"])
+    print("Proxy 1:", agent.rotate_proxy())
+    print("Proxy 2:", agent.rotate_proxy())
+
+    # Test blacklist/whitelist
+    agent.add_to_blacklist("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36")
+    agent.add_to_whitelist("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36")
+    print("Blacklisted:", agent.random())
+    print("Whitelisted:", agent.random())
+
+    # Test agent history
+    for _ in range(55):
+        agent.random()
+    print("History:", agent.get_history())
+
+    # Test agent validation
+    print("Valid agent:", agent.validate_agent("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"))
+    print("Invalid agent:", agent.validate_agent("InvalidUserAgentString"))
+    ip = agent.rotate_ip()
     print(ip)  # 192.168.1.10 (example)