webscout 8.2.6__py3-none-any.whl → 8.2.8__py3-none-any.whl

webscout/Extra/weather.md

@@ -0,0 +1,281 @@
+<div align="center">
+  <h1>☀️ Webscout Weather Toolkit</h1>
+  <p><strong>Comprehensive weather data retrieval and visualization tools</strong></p>
+  
+  <!-- Badges -->
+  <p>
+    <a href="#-installation"><img src="https://img.shields.io/badge/Easy-Installation-success?style=flat-square" alt="Easy Installation"></a>
+    <a href="#-current-weather-data"><img src="https://img.shields.io/badge/Real--time-Data-blue?style=flat-square" alt="Real-time Data"></a>
+    <a href="#-ascii-art-weather"><img src="https://img.shields.io/badge/ASCII-Visualization-orange?style=flat-square" alt="ASCII Visualization"></a>
+  </p>
+</div>
+
+> [!NOTE]
+> Webscout's Weather Toolkit provides powerful tools to retrieve and display weather information in various formats, including structured data and ASCII art visualization.
+
+## 📋 Table of Contents
+
+- [🚀 Installation](#-installation)
+- [🌡️ Current Weather Data](#-current-weather-data)
+- [🔮 Weather Forecast](#-weather-forecast)
+- [🎨 ASCII Art Weather](#-ascii-art-weather)
+- [📊 Data Structure](#-data-structure)
+- [⚙️ Advanced Usage](#-advanced-usage)
+
+## 🚀 Installation
+
+The Weather Toolkit is included in the Webscout package. Install or update Webscout to get access:
+
+```bash
+pip install -U webscout
+```
+
+## 🌡️ Current Weather Data
+
+Retrieve structured current weather information for any location worldwide.
+
+```python
+from webscout.Extra import weather
+
+# Get weather for a specific location
+forecast = weather.get("London")
+
+# Access current conditions
+print(f"Current weather: {forecast.summary}")
+
+# Access temperature details
+if forecast.current_condition:
+    print(f"Temperature: {forecast.current_condition.temp_c}°C / {forecast.current_condition.temp_f}°F")
+    print(f"Feels like: {forecast.current_condition.feels_like_c}°C")
+    print(f"Conditions: {forecast.current_condition.weather_desc}")
+    print(f"Wind: {forecast.current_condition.wind_speed_kmph} km/h from {forecast.current_condition.wind_direction}")
+    print(f"Humidity: {forecast.current_condition.humidity}%")
+    print(f"Visibility: {forecast.current_condition.visibility} km")
+    print(f"Pressure: {forecast.current_condition.pressure} mb")
+```
+
+## 🔮 Weather Forecast
+
+Access detailed forecast information for today and upcoming days.
+
+```python
+from webscout.Extra import weather
+
+forecast = weather.get("Tokyo")
+
+# Today's forecast
+if forecast.today:
+    print(f"Today ({forecast.today.date_formatted}):")
+    print(f"  Temperature range: {forecast.today.min_temp_c}°C - {forecast.today.max_temp_c}°C")
+    print(f"  Sunrise: {forecast.today.sunrise}, Sunset: {forecast.today.sunset}")
+    
+    # Access hourly forecasts
+    if forecast.today.hourly and len(forecast.today.hourly) > 4:
+        noon = forecast.today.hourly[4]  # Noon (12:00) is usually index 4
+        print(f"  Noon conditions: {noon.weather_desc}")
+        print(f"  Chance of rain: {noon.chance_of_rain}%")
+        print(f"  Humidity: {noon.humidity}%")
+        print(f"  UV Index: {noon.uv_index}")
+
+# Tomorrow's forecast
+if forecast.tomorrow:
+    print(f"\nTomorrow ({forecast.tomorrow.date_formatted}):")
+    print(f"  Temperature range: {forecast.tomorrow.min_temp_c}°C - {forecast.tomorrow.max_temp_c}°C")
+    print(f"  Weather: {forecast.tomorrow.weather_desc}")
+    print(f"  Sunrise: {forecast.tomorrow.sunrise}, Sunset: {forecast.tomorrow.sunset}")
+
+# Extended forecast (next 3 days)
+if forecast.days and len(forecast.days) > 2:
+    print("\nExtended Forecast:")
+    for day in forecast.days[2:5]:  # Days 3-5
+        print(f"  {day.date_formatted}: {day.min_temp_c}°C - {day.max_temp_c}°C, {day.weather_desc}")
+```
+
+## 🎨 ASCII Art Weather
+
+Retrieve weather information as visually appealing ASCII art.
+
+```python
+from webscout.Extra import weather_ascii
+
+# Get ASCII art weather 
+result = weather_ascii.get("Paris")
+
+# Display the ASCII art weather
+print(result.content)
+
+# Get ASCII art with temperature in Fahrenheit
+result_f = weather_ascii.get("New York", units="imperial")
+print(result_f.content)
+
+# Get ASCII art with a specific number of forecast days
+result_days = weather_ascii.get("Berlin", days=3)
+print(result_days.content)
+```
+
+Example output:
+```
+Weather for Paris, France
+
+     \   /     Clear
+      .-.      +20°C
+   ― (   ) ―   ↗ 11 km/h
+      `-'      10 km
+     /   \     0.0 mm
+                        ┌─────────────┐
+┌───────────────────────┤  Wed 14 Apr ├───────────────────────┐
+│             Morning   └──────┬──────┘    Evening    Night   │
+├──────────────────────────────┼──────────────────────────────┤
+│               Cloudy         │               Clear          │
+│      .--.     +20..+22 °C    │     \   /     +15 °C         │
+│   .-(    ).   ↗ 11-13 km/h   │      .-.      ↗ 7-9 km/h     │
+│  (___.__)__)  10 km          │   ― (   ) ―   10 km          │
+│               0.0 mm | 0%    │      `-'      0.0 mm | 0%    │
+└──────────────────────────────┴──────────────────────────────┘
+```
+
+## 📊 Data Structure
+
+The Weather Toolkit returns structured data objects with the following key components:
+
+<details>
+<summary><strong>Forecast Object Structure</strong></summary>
+
+```python
+forecast = weather.get("London")
+
+# Main forecast object attributes
+forecast.location        # Location information (city, country, etc.)
+forecast.summary         # Brief summary of current weather
+forecast.current_condition  # Current weather conditions
+forecast.today           # Today's forecast
+forecast.tomorrow        # Tomorrow's forecast
+forecast.days            # List of daily forecasts (including today and tomorrow)
+
+# Current condition attributes
+current = forecast.current_condition
+current.temp_c           # Temperature in Celsius
+current.temp_f           # Temperature in Fahrenheit
+current.feels_like_c     # "Feels like" temperature in Celsius
+current.feels_like_f     # "Feels like" temperature in Fahrenheit
+current.wind_speed_kmph  # Wind speed in km/h
+current.wind_speed_mph   # Wind speed in mph
+current.wind_direction   # Wind direction (e.g., "NW")
+current.humidity         # Humidity percentage
+current.pressure         # Atmospheric pressure in millibars
+current.visibility       # Visibility in kilometers
+current.weather_desc     # Weather description (e.g., "Partly cloudy")
+current.weather_code     # Weather code for icon mapping
+
+# Daily forecast attributes
+day = forecast.today  # or any day from forecast.days
+day.date              # Date (YYYY-MM-DD)
+day.date_formatted    # Formatted date (e.g., "Wed 14 Apr")
+day.max_temp_c        # Maximum temperature in Celsius
+day.min_temp_c        # Minimum temperature in Celsius
+day.max_temp_f        # Maximum temperature in Fahrenheit
+day.min_temp_f        # Minimum temperature in Fahrenheit
+day.sunrise           # Sunrise time
+day.sunset            # Sunset time
+day.weather_desc      # Weather description
+day.weather_code      # Weather code
+day.hourly            # List of hourly forecasts for this day
+```
+</details>
+
+<details>
+<summary><strong>ASCII Weather Object Structure</strong></summary>
+
+```python
+result = weather_ascii.get("Paris")
+
+# ASCII result attributes
+result.content        # The full ASCII art weather display
+result.location       # Location information
+result.temperature    # Current temperature
+result.conditions     # Current weather conditions
+result.forecast_days  # Number of forecast days included
+```
+</details>
+
+## ⚙️ Advanced Usage
+
+<details>
+<summary><strong>Custom Location Formats</strong></summary>
+
+The Weather Toolkit supports various location formats:
+
+```python
+# City name
+weather.get("London")
+
+# City and country
+weather.get("Paris, France")
+
+# ZIP/Postal code (US)
+weather.get("10001")  # New York, NY
+
+# Latitude and Longitude
+weather.get("40.7128,-74.0060")  # New York coordinates
+```
+</details>
+
+<details>
+<summary><strong>Temperature Units</strong></summary>
+
+Control temperature units in ASCII weather display:
+
+```python
+# Default (metric - Celsius)
+weather_ascii.get("Tokyo")
+
+# Imperial (Fahrenheit)
+weather_ascii.get("New York", units="imperial")
+
+# Metric (Celsius)
+weather_ascii.get("Berlin", units="metric")
+```
+</details>
+
+<details>
+<summary><strong>Forecast Days</strong></summary>
+
+Control the number of forecast days in ASCII weather display:
+
+```python
+# Default (1 day)
+weather_ascii.get("Sydney")
+
+# 3-day forecast
+weather_ascii.get("Rio de Janeiro", days=3)
+
+# 5-day forecast (maximum)
+weather_ascii.get("Moscow", days=5)
+```
+</details>
+
+<details>
+<summary><strong>Error Handling</strong></summary>
+
+Implement proper error handling for robust applications:
+
+```python
+from webscout.Extra import weather
+from webscout.exceptions import APIError
+
+try:
+    forecast = weather.get("London")
+    print(f"Current temperature: {forecast.current_condition.temp_c}°C")
+except APIError as e:
+    print(f"API Error: {e}")
+except Exception as e:
+    print(f"An error occurred: {e}")
+```
+</details>
+
+<div align="center">
+  <p>
+    <a href="https://github.com/OEvortex/Webscout"><img alt="GitHub Repository" src="https://img.shields.io/badge/GitHub-Repository-181717?style=for-the-badge&logo=github&logoColor=white"></a>
+    <a href="https://t.me/PyscoutAI"><img alt="Telegram Group" src="https://img.shields.io/badge/Telegram%20Group-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white"></a>
+  </p>
+</div>

webscout/Litlogger/Readme.md

@@ -0,0 +1,175 @@
+# 📝 LitLogger - The Most Fire Logger You'll Ever Use! 
+
+Yo fam! Meet LitLogger - your new logging bestie that's built different! 🔥 With smart level detection, fire color schemes, and emoji support, your logs never looked this good!
+
+## 🚀 Quick Start
+
+```python
+from webscout import LitLogger, LogFormat, ColorScheme
+
+# Create your logger with style
+logger = LitLogger(
+    name="MyApp",
+    format=LogFormat.MODERN_EMOJI,
+    color_scheme=ColorScheme.CYBERPUNK
+)
+
+# Start logging with swag
+logger.info("App started! 🚀")
+logger.success("Mission accomplished! 💯")
+logger.warning("CPU getting spicy! 🌶️")
+logger.error("Houston, we got a problem! 🔧")
+```
+
+## 💫 Features That Hit Different
+
+### 🎨 Fire Color Schemes
+
+```python
+# Cyberpunk vibes
+logger = LitLogger(color_scheme=ColorScheme.CYBERPUNK)
+
+# Ocean feels
+logger = LitLogger(color_scheme=ColorScheme.OCEAN)
+
+# Matrix mode
+logger = LitLogger(color_scheme=ColorScheme.MATRIX)
+
+# Aurora lights
+logger = LitLogger(color_scheme=ColorScheme.AURORA)
+
+# Sunset mood
+logger = LitLogger(color_scheme=ColorScheme.SUNSET)
+```
+
+### 📝 Lit Log Formats
+
+```python
+# Modern with emojis
+logger = LitLogger(format=LogFormat.MODERN_EMOJI)
+# Output: 🚀 [2024-01-20 15:30:45] INFO Server started!
+
+# Clean and minimal
+logger = LitLogger(format=LogFormat.MODERN_CLEAN)
+# Output: 2024-01-20 15:30:45 INFO Server started
+
+# Boxed style
+logger = LitLogger(format=LogFormat.BOXED)
+# Output: ╭─────────────────────╮
+#        │ [2024-01-20 15:30:45]
+#        │ INFO - MyApp
+#        │ Server started!
+#        ╰─────────────────────╯
+
+# Japanese style
+logger = LitLogger(format=LogFormat.MODERN_BRACKET)
+# Output: 【2024-01-20 15:30:45】「INFO」Server started
+```
+
+### 🧠 Smart Level Detection
+
+```python
+# Auto-detects appropriate log level
+logger.auto("Starting server...")  # INFO
+logger.auto("CPU usage at 95%")   # WARNING
+logger.auto("404: Not Found")     # ERROR
+logger.auto("x = calculate(y)")   # DEBUG
+
+# With context
+logger.auto("Memory usage: 90%", memory=90)  # WARNING
+logger.auto("Response time: 1500ms", latency=1500)  # WARNING
+```
+
+### 🎯 Log Levels
+
+```python
+# All the levels you need
+logger.trace("Entering function...")
+logger.debug("x = 42")
+logger.info("Server started")
+logger.success("Task completed")
+logger.warning("Running low on memory")
+logger.error("Failed to connect")
+logger.critical("System crash!")
+```
+
+## 🌟 Real-World Examples
+
+### API Server Logging
+
+```python
+logger = LitLogger(name="APIServer", format=LogFormat.MODERN_EMOJI)
+
+def handle_request():
+    logger.info("Received new request 📥")
+    try:
+        # Process request
+        logger.success("Request processed successfully ✨")
+    except Exception as e:
+        logger.error(f"Request failed: {e} 💀")
+```
+
+### Performance Monitoring
+
+```python
+logger = LitLogger(name="Monitor", color_scheme=ColorScheme.MATRIX)
+
+def monitor_system():
+    metrics = get_system_metrics()
+    logger.auto(
+        f"CPU: {metrics['cpu']}%, Memory: {metrics['memory']}%",
+        cpu=metrics['cpu'],
+        memory=metrics['memory']
+    )
+```
+
+### Development Debugging
+
+```python
+logger = LitLogger(name="Debug", format=LogFormat.DETAILED)
+
+def complex_calculation(x, y):
+    logger.debug(f"Input: x={x}, y={y}")
+    result = x * y
+    logger.debug(f"Result: {result}")
+    return result
+```
+
+## 🎮 Pro Tips
+
+1. **Custom Color Schemes**: Create your own vibe
+   ```python
+   my_scheme = {
+       "trace": (128, 128, 255),  # Your colors
+       "debug": (255, 0, 255),
+       "info": (0, 255, 255)
+   }
+   logger = LitLogger(color_scheme=my_scheme)
+   ```
+
+2. **Log to File**: Keep records with style
+   ```python
+   logger = LitLogger(
+       name="MyApp",
+       log_path="logs/app.log",
+       console_output=True  # Both file and console
+   )
+   ```
+
+3. **Smart Context**: Let the logger decide
+   ```python
+   # Automatically chooses log level based on content
+   logger.auto("Database connection failed")  # ERROR
+   logger.auto("Cache hit ratio: 95%")       # INFO
+   ```
+
+## 🔥 Why LitLogger?
+
+- 🎨 Beautiful, colorful output
+- 🧠 Smart level detection
+- 📱 Multiple output formats
+- 🌈 Customizable color schemes
+- 💪 Easy to use, hard to mess up
+- ⚡ Fast and lightweight
+
+Made with 💖 by the HelpingAI team

webscout/Provider/AISEARCH/DeepFind.py

@@ -84,30 +84,11 @@ class DeepFind(AISearch):
             >>> ai = DeepFind(proxies={'http': 'http://proxy.com:8080'})  # With proxy
         """
         self.session = requests.Session()
-        self.api_endpoint = "https://www.deepfind.co/?q={query}"
         self.stream_chunk_size = 1024
         self.timeout = timeout
         self.last_response = {}
-        self.headers = {
-            "Accept": "text/x-component",
-            "Accept-Encoding": "gzip, deflate, br, zstd",
-            "Accept-Language": "en-US,en;q=0.9,en-IN;q=0.8",
-            "Content-Type": "text/plain;charset=UTF-8",
-            "DNT": "1",
-            "Next-Action": "f354668f23f516a46ad0abe4dedb84b19068bb54",
-            "Next-Router-State-Tree": '%5B%22%22%2C%7B%22children%22%3A%5B%22__PAGE__%3F%7B%5C%22q%5C%22%3A%5C%22hi%5C%22%7D%22%2C%7B%7D%2C%22%2F%3Fq%3Dhi%22%2C%22refresh%22%5D%7D%2Cnull%2Cnull%2Ctrue%5D',
-            "Origin": "https://www.deepfind.co",
-            "Referer": "https://www.deepfind.co/?q=hi",
-            "Sec-Ch-Ua": '"Not A(Brand";v="8", "Chromium";v="132", "Microsoft Edge";v="132"',
-            "Sec-Ch-Ua-Mobile": "?0",
-            "Sec-Ch-Ua-Platform": '"Windows"',
-            "Sec-Fetch-Dest": "empty",
-            "Sec-Fetch-Mode": "cors",
-            "Sec-Fetch-Site": "same-origin",
-            "User-Agent": LitAgent().random(),
-        }
-        self.session.headers.update(self.headers)
         self.proxies = proxies
+        # Headers will be set per request, as conversationId is dynamic
 
     def search(
         self,
@@ -160,25 +141,61 @@ class DeepFind(AISearch):
             ... except exceptions.APIConnectionError as e:
             ...     print(f"API error: {e}")
         """
-        url = self.api_endpoint.format(query=prompt)
+        conversation_id = uuid4().hex
+        message_id = uuid4().hex
+        url = f"https://www.deepfind.co/s/{conversation_id}"
         payload = [
-            [{"role": "user", "id": uuid4().hex, "content": prompt}],
-            uuid4().hex,
+            {
+                "id": conversation_id,
+                "messages": [
+                    {
+                        "role": "user",
+                        "conversationId": conversation_id,
+                        "messageId": message_id,
+                        "content": prompt,
+                    }
+                ],
+            },
+            conversation_id,
+            message_id,
         ]
+        # Update headers for this conversation
+        headers = {
+            "Accept": "text/x-component",
+            "Accept-Encoding": "gzip, deflate, br, zstd",
+            "Accept-Language": "en-US,en;q=0.9,en-IN;q=0.8",
+            "Content-Type": "text/plain;charset=UTF-8",
+            "DNT": "1",
+            "Next-Action": "f354668f23f516a46ad0abe4dedb84b19068bb54",
+            "Next-Router-State-Tree": f'%5B%22%22%2C%7B%22children%22%3A%5B%22s%22%2C%7B%22children%22%3A%5B%5B%22conversationId%22%2C%22{conversation_id}%22%2C%22d%22%5D%2C%7B%22children%22%3A%5B%22__PAGE__%22%2C%7B%7D%2C%22%2Fs%2F{conversation_id}%22%2C%22refresh%22%5D%7D%5D%7D%5D%7D%2Cnull%2Cnull%2Ctrue%5D',
+            "Origin": "https://www.deepfind.co",
+            "Referer": f"https://www.deepfind.co/s/{conversation_id}",
+            "Sec-Ch-Ua": '"Not A(Brand";v="8", "Chromium";v="132", "Microsoft Edge";v="132"',
+            "Sec-Ch-Ua-Mobile": "?0",
+            "Sec-Ch-Ua-Platform": '"Windows"',
+            "Sec-Fetch-Dest": "empty",
+            "Sec-Fetch-Mode": "cors",
+            "Sec-Fetch-Site": "same-origin",
+            "User-Agent": LitAgent().random(),
+        }
+        self.session.headers.clear()
+        self.session.headers.update(headers)
 
         def for_stream():
             try:
                 with self.session.post(
                     url,
-                    headers=self.headers,
+                    headers=headers,
                     json=payload,
                     stream=True,
                     timeout=self.timeout,
+                    proxies=self.proxies,
                 ) as response:
                     response.raise_for_status()
                     streaming_text = ""
                     for line in response.iter_lines(decode_unicode=True):
                         if line:
+                            # Try to extract content from the new streaming format
                             content_matches = re.findall(r'"content":"([^"\\]*(?:\\.[^"\\]*)*)"', line)
                             if content_matches:
                                 for content in content_matches:
@@ -191,18 +208,6 @@ class DeepFind(AISearch):
                                             yield {"text": delta}
                                         else:
                                             yield Response(delta)
-                            description_matches = re.findall(r'"description":"([^"\\]*(?:\\.[^"\\]*)*)"', line)
-                            if description_matches:
-                                for description in description_matches:
-                                    if description and len(description) > len(streaming_text):
-                                        delta = description[len(streaming_text):]
-                                        streaming_text = description
-                                        delta = delta.replace('\\"', '"').replace('\\n', '\n')
-                                        delta = re.sub(r'\[REF\]\(https?://[^\s]*\)', '', delta)
-                                        if raw:
-                                            yield {"text": f"{delta}\n"}
-                                        else:
-                                            yield Response(f"{delta}\n")
                     self.last_response = Response(streaming_text)
             except requests.exceptions.RequestException as e:
                 raise exceptions.APIConnectionError(f"Request failed: {e}")
@@ -217,7 +222,6 @@ class DeepFind(AISearch):
             if not raw:
                 self.last_response = Response(full_response)
                 return self.last_response
-        
         return for_stream() if stream else for_non_stream()
 
     @staticmethod