webscout 2025.10.14.1__py3-none-any.whl → 2025.10.16__py3-none-any.whl

webscout/Extra/YTToolkit/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <a href="https://github.com/OEvortex/Webscout">
+  <a href="https://github.com/pyscout/Webscout">
     <img src="https://img.shields.io/badge/YTToolkit-YouTube%20Toolkit-red?style=for-the-badge&logo=youtube&logoColor=white" alt="YTToolkit Logo">
   </a>
   <h1>YTToolkit</h1>

webscout/Extra/tempmail/README.md

@@ -1,6 +1,6 @@
 <div align="center">
-  <a href="https://github.com/OEvortex/Webscout">
-    <img src="https://img.shields.io/badge/WebScout-TempMail%20Module-blue?style=for-the-badge&logo=mail&logoColor=white" alt="WebScout TempMail">
+  <a href="https://github.com/pyscout/Webscout">
+    <img src="https://img.shields.io/badge/WebScout-TempMail%20Toolkit-blue?style=for-the-badge&logo=maildotru&logoColor=white" alt="WebScout TempMail Toolkit">
   </a>
 
   <h1>📧 TempMail</h1>
@@ -484,5 +484,5 @@ Please refer to the main Webscout project's contributing guidelines if you plan
     <a href="https://buymeacoffee.com/oevortex"><img alt="Buy Me A Coffee" src="https://img.shields.io/badge/Buy%20Me%20A%20Coffee-FFDD00?style=for-the-badge&logo=buymeacoffee&logoColor=black"></a>
   </div>
   <p>📧 TempMail - Part of the Webscout Toolkit</p>
-  <a href="https://github.com/OEvortex/Webscout">Back to Main Webscout Project</a>
+  <a href="https://github.com/pyscout/Webscout">Back to Main Webscout Project</a>
 </div>

webscout/Provider/OPENAI/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <a href="https://github.com/OEvortex/Webscout">
+  <a href="https://github.com/pyscout/Webscout">
     <img src="https://img.shields.io/badge/WebScout-OpenAI%20Compatible%20Providers-4285F4?style=for-the-badge&logo=openai&logoColor=white" alt="WebScout OpenAI Compatible Providers">
   </a>
   <br/>

webscout/Provider/TTI/bing.py

@@ -7,6 +7,7 @@ from webscout.Provider.TTI.utils import ImageData, ImageResponse
 from webscout.Provider.TTI.base import TTICompatibleProvider, BaseImages
 from io import BytesIO
 from webscout.litagent import LitAgent
+from webscout.scout import Scout
 
 try:
     from PIL import Image
@@ -81,9 +82,8 @@ class Images(BaseImages):
                 time.sleep(3)
                 try:
                     poll_resp = session.get(polling_url, headers=headers, timeout=timeout)
-                    from bs4 import BeautifulSoup
-                    soup = BeautifulSoup(poll_resp.text, "html.parser")
-                    imgs = [img["src"].split("?")[0] for img in soup.select(".img_cont .mimg") if img.get("src")]
+                    scout = Scout(poll_resp.text, features='html.parser')
+                    imgs = [img["src"].split("?")[0] for img in scout.select(".img_cont .mimg") if img.attrs.get("src")]
                     if imgs:
                         img_url = imgs[0]
                         break
@@ -232,7 +232,7 @@ class BingImageAI(TTICompatibleProvider):
 
 if __name__ == "__main__":
     from rich import print
-    client = BingImageAI(cookie="1QyBY4Z1eHBW6fbI25kdM5TrlRGWzn5PFySapCOfvvz04zaounFG660EipVJSOXXvcdeXXLwsWHdDI8bNymucF_QnMHSlY1mc0pPI7e9Ar6o-_7e9Ik5QOe1nkJIe5vz22pibioTqx0IfVKwmVbX22A3bFD7ODaSZalKFr-AuxgAaRVod-giTTry6Ei7RVgisF7BHlkMPPwtCeO234ujgug")
+    client = BingImageAI(cookie="1Fw9daLSZzVBJXgevTDuc0jHZ60l4m5IiQEwjRCFOwEkpEBDmw3b8CEAALFSwZ1QBu-rATNkfD0i0gfJmVHeFlogqIriGwxNwT9T6fVREgAQD4_qn0VnQYP681NN4K80t6o-eJXnK1MBhdjxTIaok8173LGmLkEWLqHC0k3dYnF7m2kHRhf1dxjEH3WDI56hxiSPZtnggdzrfnuFAmOgCQQ")
     response = client.images.create(
         model="gpt4o",
         prompt="A cat riding a bicycle",

webscout/__init__.py

@@ -1,6 +1,6 @@
 # webscout/__init__.py
 
-from .search import DuckDuckGoSearch, YepSearch
+from .search import *
 from .version import __version__
 from .Provider import *
 from .Provider.TTI import *

webscout/cli.py

@@ -1,7 +1,6 @@
 import sys
 from .swiftcli import CLI, option
 from .search import DuckDuckGoSearch, YepSearch  # Import search classes
-from .DWEBS import GoogleSearch  # Import GoogleSearch from DWEBS
 from .version import __version__
 
 # Alias for backward compatibility
@@ -262,152 +261,6 @@ def weather(location: str, language: str, proxy: str = None, timeout: int = 10):
         raise e
 
 @app.command()
-@option("--keywords", "-k", help="Search keywords", required=True)
-@option("--region", "-r", help="Region for search results (ISO country code)", default="all")
-@option("--safesearch", "-s", help="SafeSearch setting (on, moderate, off)", default="moderate")
-@option("--max-results", "-m", help="Maximum number of results", type=int, default=10)
-@option("--start-num", "-start", help="Starting position for pagination", type=int, default=0)
-@option("--unique", "-u", help="Filter duplicate results", type=bool, default=True)
-@option("--timeout", "-timeout", help="Timeout value for requests", type=int, default=10)
-@option("--proxy", "-p", help="Proxy URL to use for requests")
-@option("--impersonate", "-i", help="Browser to impersonate", default="chrome110")
-def google_text(
-    keywords: str,
-    region: str,
-    safesearch: str,
-    max_results: int,
-    start_num: int,
-    unique: bool,
-    timeout: int = 10,
-    proxy: str = None,
-    impersonate: str = "chrome110"
-):
-    """Perform a text search using Google Search."""
-    google = GoogleSearch(
-        timeout=timeout,
-        proxies={"https": proxy, "http": proxy} if proxy else None,
-        verify=True,
-        lang="en",
-        sleep_interval=0.0,
-        impersonate=impersonate
-    )
-    
-    try:
-        results = google.text(
-            keywords=keywords,
-            region=region,
-            safesearch=safesearch,
-            max_results=max_results,
-            start_num=start_num,
-            unique=unique
-        )
-        
-        # Convert SearchResult objects to dictionaries for printing
-        formatted_results = []
-        for result in results:
-            result_dict = {
-                "title": result.title,
-                "url": result.url,
-                "description": result.description,
-            }
-            # Add any metadata to the result dictionary
-            for k, v in result.metadata.items():
-                result_dict[k] = v
-                
-            formatted_results.append(result_dict)
-            
-        _print_data(formatted_results)
-    except Exception as e:
-        raise e
-
-@app.command()
-@option("--keywords", "-k", help="Search keywords", required=True)
-@option("--region", "-r", help="Region for search results (ISO country code)", default="all")
-@option("--safesearch", "-s", help="SafeSearch setting (on, moderate, off)", default="moderate")
-@option("--max-results", "-m", help="Maximum number of results", type=int, default=10)
-@option("--timeout", "-timeout", help="Timeout value for requests", type=int, default=10)
-@option("--proxy", "-p", help="Proxy URL to use for requests")
-@option("--impersonate", "-i", help="Browser to impersonate", default="chrome110")
-def google_news(
-    keywords: str,
-    region: str,
-    safesearch: str,
-    max_results: int,
-    timeout: int = 10,
-    proxy: str = None,
-    impersonate: str = "chrome110"
-):
-    """Perform a news search using Google Search."""
-    google = GoogleSearch(
-        timeout=timeout,
-        proxies={"https": proxy, "http": proxy} if proxy else None,
-        verify=True,
-        lang="en",
-        sleep_interval=0.0,
-        impersonate=impersonate
-    )
-    
-    try:
-        results = google.news(
-            keywords=keywords,
-            region=region,
-            safesearch=safesearch,
-            max_results=max_results
-        )
-        
-        # Convert SearchResult objects to dictionaries for printing
-        formatted_results = []
-        for result in results:
-            result_dict = {
-                "title": result.title,
-                "url": result.url,
-                "description": result.description,
-            }
-            # Add any metadata to the result dictionary
-            for k, v in result.metadata.items():
-                result_dict[k] = v
-                
-            formatted_results.append(result_dict)
-            
-        _print_data(formatted_results)
-    except Exception as e:
-        raise e
-
-@app.command()
-@option("--query", "-q", help="Search query", required=True)
-@option("--region", "-r", help="Region for suggestions (ISO country code)", default="all")
-@option("--timeout", "-timeout", help="Timeout value for requests", type=int, default=10)
-@option("--proxy", "-p", help="Proxy URL to use for requests")
-@option("--impersonate", "-i", help="Browser to impersonate", default="chrome110")
-def google_suggestions(
-    query: str,
-    region: str,
-    timeout: int = 10,
-    proxy: str = None,
-    impersonate: str = "chrome110"
-):
-    """Get search suggestions from Google Search."""
-    google = GoogleSearch(
-        timeout=timeout,
-        proxies={"https": proxy, "http": proxy} if proxy else None,
-        verify=True,
-        lang="en",
-        sleep_interval=0.0,
-        impersonate=impersonate
-    )
-    
-    try:
-        results = google.suggestions(query=query, region=region)
-        
-        # Format suggestions for printing
-        formatted_results = []
-        for i, suggestion in enumerate(results, 1):
-            formatted_results.append({"position": i, "suggestion": suggestion})
-            
-        _print_data(formatted_results)
-    except Exception as e:
-        raise e
-
 @app.command()
 @option("--keywords", "-k", help="Search keywords", required=True)
 @option("--region", "-r", help="Region for search results", default="all")

webscout/client.py

@@ -34,20 +34,19 @@ from webscout.Provider.OPENAI import *
 try:
     # Use lazy import to avoid module execution issues
     def run_api(*args, **kwargs):
-        """Run the Webscout OpenAI-compatible API server (FastAPI backend)."""
-        from webscout.auth.server import run_api as _run_api
+        from webscout.server.server import run_api as _run_api
         return _run_api(*args, **kwargs)
     
     def start_server(**kwargs):
         """Start the Webscout OpenAI-compatible API server (FastAPI backend)."""
-        from webscout.auth.server import run_api as _run_api
+        from webscout.server.server import run_api as _run_api
         return _run_api(**kwargs)
 except ImportError:
     # Fallback for environments where the backend is not available
     def run_api(*args, **kwargs):
-        raise ImportError("webscout.auth.server.run_api is not available in this environment.")
+        raise ImportError("webscout.server.server.run_api is not available in this environment.")
     def start_server(*args, **kwargs):
-        raise ImportError("webscout.auth.server.start_server is not available in this environment.")
+        raise ImportError("webscout.server.server.start_server is not available in this environment.")
 
 # ---
 # API Documentation

webscout/litprinter/__init__.py

@@ -1,45 +1,3 @@
-"""
->>> from litprinter import litprint
->>> from litprinter import lit
->>> from litprinter import install, uninstall
->>>
->>> litprint("Hello, world!")
-LIT -> [__main__.py:1] in () >>> Hello, world!
->>>
->>> def my_function():
-...    lit(1, 2, 3)
->>> my_function()
-LIT -> [__main__.py:4] in my_function() >>> 1, 2, 3
->>> install()
->>> ic("This is now the builtins.ic()")
-LIT -> [__main__.py:7] in () >>> This is now the builtins.ic()
->>> uninstall()
-
-This module provides enhanced print and logging functionalities for Python,
-allowing developers to debug their code with style and precision. It
-includes the litprint and lit functions for debugging, log for logging, and
-install/uninstall functions for integration into the builtins module.
-It also handles colorizing output and provides different styles and customizable
-options.
-
-LITPRINTER is inspired by the icecream package and provides similar functionality
-with additional features:
-- Variable inspection with expression display
-- Return value handling for inline usage
-- Support for custom formatters for specific data types
-- Execution context tracking
-- Rich-like colorized output with multiple themes (JARVIS, RICH, MODERN, NEON, CYBERPUNK)
-- Better JSON formatting with indent=2 by default
-- Advanced pretty printing for complex data structures with smart truncation
-- Clickable file paths in supported terminals and editors (VSCode compatible)
-- Enhanced visual formatting with better spacing and separators
-- Special formatters for common types (Exception, bytes, set, frozenset, etc.)
-- Smart object introspection for custom classes
-- Logging capabilities with timestamp and log levels
-"""
-
-# Try to import from the standalone litprinter package first
-# If it's not installed
 try:
     import litprinter
     # If standalone package is found, re-export all its components

webscout/scout/README.md

@@ -43,7 +43,7 @@ pip install webscout
 Or install the latest version from GitHub:
 
 ```bash
-pip install git+https://github.com/OEvortex/Webscout.git
+pip install git+https://github.com/pyscout/Webscout.git
 ```
 
 ## 🚀 Quick Start
@@ -147,10 +147,57 @@ Scout provides powerful tools for navigating and manipulating HTML/XML documents
 - **Document Manipulation**: Modify, replace, or remove elements
 - **Dynamic Building**: Easily append or insert new nodes
 
+#### CSS Selector Support
+
+Scout includes a comprehensive CSS selector engine that supports all common selector types:
+
 ```python
-# CSS selector support
-elements = scout.select('div.content > p')
+# Tag selectors
+paragraphs = scout.select('p')
+divs = scout.select('div')
+
+# Class selectors
+items = scout.select('.item')              # Single class
+cards = scout.select('div.card')           # Tag + class
+special = scout.select('.card.special')    # Multiple classes
+
+# ID selectors
+header = scout.select_one('#header')       # Single element by ID
+menu = scout.select('nav#main-menu')       # Tag + ID
+
+# Attribute selectors
+links = scout.select('a[href]')                    # Has attribute
+external = scout.select('a[rel="nofollow"]')       # Attribute value
+images = scout.select('img[alt]')                  # Has alt attribute
+
+# Descendant selectors (space)
+nested = scout.select('div p')                     # Any p inside div
+deep = scout.select('article section p')           # Deeply nested
+
+# Child selectors (>)
+direct = scout.select('ul > li')                   # Direct children only
+menu_items = scout.select('nav#menu > ul > li')    # Multiple levels
+
+# Combined selectors
+complex = scout.select('div.container > p.text[lang="en"]')
+links = scout.select('ol#results > li.item a[href]')
+
+# Get first match only
+first = scout.select_one('p.intro')
+```
 
+**Supported Selector Types:**
+- **Tag**: `p`, `div`, `a`
+- **Class**: `.class`, `div.class`, `.class1.class2`
+- **ID**: `#id`, `div#id`
+- **Attribute**: `[attr]`, `[attr="value"]`
+- **Descendant**: `div p`, `article section p`
+- **Child**: `div > p`, `ul > li`
+- **Combined**: `p.class#id[attr="value"]`
+
+#### Element Navigation
+
+```python
 # Advanced find with attribute matching
 results = scout.find_all('a', attrs={'class': 'external', 'rel': 'nofollow'})
 
@@ -340,6 +387,10 @@ cached_data = scout.cache('parsed_data')
 - `__init__(markup, features='html.parser', from_encoding=None)`: Initialize with HTML content
 - `find(name, attrs={}, recursive=True, text=None)`: Find first matching element
 - `find_all(name, attrs={}, recursive=True, text=None, limit=None)`: Find all matching elements
+- `find_next(name, attrs={}, text=None)`: Find next element in document order
+- `find_all_next(name, attrs={}, text=None, limit=None)`: Find all next elements in document order
+- `find_previous(name, attrs={}, text=None)`: Find previous element in document order
+- `find_all_previous(name, attrs={}, text=None, limit=None)`: Find all previous elements in document order
 - `select(selector)`: Find elements using CSS selector
 - `get_text(separator=' ', strip=False)`: Extract text from document
 - `analyze_text()`: Perform text analysis
@@ -358,7 +409,7 @@ cached_data = scout.cache('parsed_data')
 - `_crawl_page(url, depth=0)`: Crawl a single page (internal method)
 - `_is_valid_url(url)`: Check if a URL is valid (internal method)
 
-For detailed API documentation, please refer to the [documentation](https://github.com/OEvortex/Webscout/wiki).
+For detailed API documentation, please refer to the [documentation](https://github.com/pyscout/Webscout/wiki).
 
 ## 🔧 Dependencies
 
@@ -393,9 +444,9 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 <div align="center">
   <p>Made with ❤️ by the Webscout team</p>
   <p>
-    <a href="https://github.com/OEvortex/Webscout">GitHub</a> •
-    <a href="https://github.com/OEvortex/Webscout/wiki">Documentation</a> •
-    <a href="https://github.com/OEvortex/Webscout/issues">Report Bug</a> •
-    <a href="https://github.com/OEvortex/Webscout/issues">Request Feature</a>
+    <a href="https://github.com/pyscout/Webscout">GitHub</a> •
+    <a href="https://github.com/pyscout/Webscout/wiki">Documentation</a> •
+    <a href="https://github.com/pyscout/Webscout/issues">Report Bug</a> •
+    <a href="https://github.com/pyscout/Webscout/issues">Request Feature</a>
   </p>
 </div>

webscout/scout/core/scout.py

@@ -454,6 +454,68 @@ class Scout:
             pass
         return siblings
 
+    def find_next(self, name=None, attrs={}, text=None, **kwargs) -> Optional[Tag]:
+        """
+        Find the next element in document order.
+
+        Args:
+            name: Tag name to search for
+            attrs: Attributes to match
+            text: Text content to match
+            **kwargs: Additional attributes
+
+        Returns:
+            Optional[Tag]: Next matching element or None
+        """
+        return self._soup.find_next(name, attrs, text, **kwargs)
+
+    def find_all_next(self, name=None, attrs={}, text=None, limit=None, **kwargs) -> List[Tag]:
+        """
+        Find all next elements in document order.
+
+        Args:
+            name: Tag name to search for
+            attrs: Attributes to match
+            text: Text content to match
+            limit: Maximum number of results
+            **kwargs: Additional attributes
+
+        Returns:
+            List[Tag]: List of matching elements
+        """
+        return self._soup.find_all_next(name, attrs, text, limit, **kwargs)
+
+    def find_previous(self, name=None, attrs={}, text=None, **kwargs) -> Optional[Tag]:
+        """
+        Find the previous element in document order.
+
+        Args:
+            name: Tag name to search for
+            attrs: Attributes to match
+            text: Text content to match
+            **kwargs: Additional attributes
+
+        Returns:
+            Optional[Tag]: Previous matching element or None
+        """
+        return self._soup.find_previous(name, attrs, text, **kwargs)
+
+    def find_all_previous(self, name=None, attrs={}, text=None, limit=None, **kwargs) -> List[Tag]:
+        """
+        Find all previous elements in document order.
+
+        Args:
+            name: Tag name to search for
+            attrs: Attributes to match
+            text: Text content to match
+            limit: Maximum number of results
+            **kwargs: Additional attributes
+
+        Returns:
+            List[Tag]: List of matching elements
+        """
+        return self._soup.find_all_previous(name, attrs, text, limit, **kwargs)
+
     def select(self, selector: str) -> List[Tag]:
         """
         Select elements using CSS selector.