webscout 6.5__py3-none-any.whl → 6.6__py3-none-any.whl

webscout/update_checker.py

@@ -1,19 +1,26 @@
 """
-Webscout Update Checker
-A utility to check and compare Webscout versions
+Ayy, check it out! 👀
+>>> from webscout import check_for_updates
+>>> check_for_updates()
+'Yo, new Webscout version just dropped: 2.0.0! 🔥
+Level up with: `pip install --upgrade webscout`'
 """
 
-import requests
-import re
 import subprocess
 import sys
 import os
-from packaging import version
 from typing import Optional
 
-from webscout import LitLogger, LogFormat, ColorScheme
+import requests
+from packaging import version
+import re
+
+from webscout import LitLogger, ColorScheme
+from importlib.metadata import version as get_package_version
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import metadata as get_package_metadata
 
-# Initialize logger with custom format
+# Setting up that clean logger format, no cap! 💯
 CUSTOM_FORMAT = """{message}"""
 
 logger = LitLogger(
@@ -22,7 +29,7 @@ logger = LitLogger(
     color_scheme=ColorScheme.OCEAN,
     level_styles={
         "TRACE": "DIM",
-        "DEBUG": "NORMAL",
+        "DEBUG": "NORMAL", 
         "INFO": "BOLD",
         "SUCCESS": "BOLD",
         "WARNING": "BOLD",
@@ -32,38 +39,44 @@ logger = LitLogger(
 )
 
 def get_installed_version() -> Optional[str]:
-    """Get the installed version of webscout"""
-    try:
-        import importlib.metadata
-        return importlib.metadata.version('webscout')
-    except ImportError:
-        try:
-            import pkg_resources
-            return pkg_resources.get_distribution('webscout').version
-        except Exception:
-            logger.error("Could not determine installed version using pkg_resources")
-            return None
-    except Exception:
-        logger.error("Could not determine installed version using importlib.metadata")
-        return None
+    """Yo, let's check what version you're running! 🔍
+
+    What this function's all about:
+    - Checking your setup real quick 💨
+    - Getting them version deets 📱
+    - Handling any problems like a boss 💪
 
-def get_webscout_version() -> Optional[str]:
-    """Get the current webscout version from CLI"""
+    Returns:
+        Optional[str]: Your version number or None if we can't find it
+
+    Examples:
+        >>> version = get_installed_version()
+        >>> print(version)
+        '1.2.3'
+    """
     try:
-        result = subprocess.run(['webscout', '--version'], 
-                              capture_output=True, 
-                              text=True, 
-                              timeout=5)
-        if result.returncode == 0:
-            version_match = re.search(r'\d+\.\d+\.\d+', result.stdout)
-            if version_match:
-                return version_match.group(0)
-    except (subprocess.TimeoutExpired, subprocess.SubprocessError, FileNotFoundError) as e:
-        logger.error(f"Failed to get version from CLI: {str(e)}")
-    return None
+        return get_package_version('webscout')
+    except PackageNotFoundError:
+        return None
+    except Exception as e:
+        return None
 
 def get_pypi_version() -> Optional[str]:
-    """Get the latest version from PyPI"""
+    """Let's see what's fresh on PyPI! 🚀
+
+    This function's vibe:
+    - Hitting up PyPI for the latest drop 🌐
+    - Keeping it smooth with timeout handling ⚡
+    - Making sure we get good data fr fr 💯
+
+    Returns:
+        Optional[str]: Latest version or None if something's not right
+
+    Examples:
+        >>> latest = get_pypi_version()
+        >>> print(latest)
+        '2.0.0'
+    """
     try:
         response = requests.get(
             "https://pypi.org/pypi/webscout/json",
@@ -72,54 +85,100 @@ def get_pypi_version() -> Optional[str]:
         response.raise_for_status()
         return response.json()['info']['version']
     except requests.RequestException as e:
-        logger.error(f"Failed to fetch PyPI version: {str(e)}")
+        pass
     except (KeyError, ValueError) as e:
-        logger.error(f"Failed to parse PyPI response: {str(e)}")
+        pass
+    except Exception as e:
+        pass
     return None
 
 def version_compare(v1: str, v2: str) -> int:
-    """Compare two version strings"""
+    """Time to compare these versions! 💪
+
+    Args:
+        v1: First version we checking
+        v2: Second version to compare with
+
+    Returns:
+        int: -1 if v1's older, 1 if v1's newer, 0 if they twins
+
+    Examples:
+        >>> version_compare('1.0.0', '2.0.0')
+        -1
+    """
     try:
-        return -1 if version.parse(v1) < version.parse(v2) else 1
-    except version.InvalidVersion:
+        version1 = version.parse(v1)
+        version2 = version.parse(v2)
+        if version1 < version2:
+            return -1
+        if version1 > version2:
+            return 1
         return 0
+    except version.InvalidVersion as e:
+        pass
+        return 0
+    except Exception as e:
+        pass
+        return 0
+
+def display_version_info(installed: Optional[str], latest: Optional[str]) -> None:
+    """Let's break down your version status! 📱
+
+    What we doing here:
+    - Comparing your version with the latest drop 🔄
+    - Letting you know if you need to level up ⬆️
+    - Keeping you in the loop with style 💯
+
+    Args:
+        installed: What you running rn
+        latest: What's fresh out there
 
-def display_version_info(installed: Optional[str], current: Optional[str], latest: Optional[str]) -> None:
-    """Display version information"""
+    Examples:
+        >>> display_version_info('1.0.0', '2.0.0')
+        'Yo, new Webscout version just dropped: 2.0.0! 🔥'
+    """
     if installed:
-        logger.info(f"Currently using Webscout version {installed}")
+        pass
     
     if latest and installed:
-        if version_compare(installed, latest) < 0:
+        comparison_result = version_compare(installed, latest)
+        if comparison_result < 0:
             logger.warning(
-                f"A new version of Webscout is available: {latest}\n"
-                f"To update, run: pip install --upgrade webscout"
+                f"Yo, new Webscout version just dropped: {latest}! 🔥\n"
+                f"Level up with: `pip install --upgrade webscout`"
             )
-        else:
-            logger.success("You're running the latest version!")
+        elif comparison_result > 0:
+            logger.success("You already got the latest version, no cap! 💯")
 
 def check_for_updates() -> None:
-    """Check for Webscout updates"""
-    logger.info("Checking for Webscout updates...")
-    
+    """Time to check if you're running the latest! 🚀
+
+    What we doing:
+    - Peeking at your current setup 📱
+    - Checking what's new out there 🌐
+    - Keeping you updated fr fr ⚡
+
+    Examples:
+        >>> check_for_updates()
+        # We got you with them version checks fam!
+    """
     installed_version = get_installed_version()
-    current_version = get_webscout_version()
     latest_version = get_pypi_version()
     
     if not installed_version:
-        logger.error("Could not determine installed Webscout version")
+        pass
         return
         
     if not latest_version:
-        logger.error("Could not determine latest Webscout version from PyPI")
+        pass
         return
     
-    display_version_info(installed_version, current_version, latest_version)
+    display_version_info(installed_version, latest_version)
 
 if __name__ == "__main__":
     try:
         check_for_updates()
     except KeyboardInterrupt:
-        logger.warning("Update check cancelled by user")
+        logger.warning("Update check got cancelled, no worries fam! 🤚")
     except Exception as e:
-        logger.error(f"An unexpected error occurred: {str(e)}")
+        logger.error(f"Uh oh, something went wrong: {str(e)} 😔")

webscout/version.py

@@ -1,2 +1,2 @@
-__version__ = "6.5"
+__version__ = "6.6"
 __prog__ = "webscout"

webscout/zeroart/base.py

@@ -37,25 +37,24 @@ class ZeroArtFont:
         return self.letters.get(char.upper(), self.letters.get(' ', [' ']))
 
     def render(self, text):
-        """
-        Render text as ASCII art
-        
-        :param text: Text to convert
-        :return: Rendered ASCII art as a string
-        """
-        # Ensure text is uppercase
-        text = text.upper()
+        if not text:
+            return ""
+            
+        # Get the maximum height of any character in the font
+        max_height = max(len(self.get_letter(c)) for c in text)
         
-        # Initialize lines for rendering
-        art_lines = [''] * 5  # Assuming 5-line height
+        # Initialize art_lines with empty strings
+        art_lines = ["" for _ in range(max_height)]
         
+        # Process each character
         for char in text:
-            # Get character's art or use space if not found
             char_art = self.get_letter(char)
-            
-            # Combine lines
-            for i in range(len(char_art)):
+            # Pad shorter characters with empty lines to match max_height
+            while len(char_art) < max_height:
+                char_art.append(" " * len(char_art[0]))
+                
+            # Add character art to each line
+            for i in range(max_height):
                 art_lines[i] += char_art[i] + " "
-        
-        # Join lines and remove trailing space
+                
         return "\n".join(art_lines)

webscout/zeroart/effects.py

@@ -4,7 +4,7 @@ ZeroArt Effects: ASCII art text effects and transformations
 
 import random
 import textwrap
-
+ 
 class AsciiArtEffects:
     """Collection of ASCII art text effects"""
     

webscout/zeroart/fonts.py

@@ -1,6 +1,6 @@
 """
 ZeroArt Fonts: Predefined ASCII art fonts
-"""
+""" 
 
 from .base import ZeroArtFont
 

{webscout-6.5.dist-info → webscout-6.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 6.5
+Version: 6.6
 Summary: Search for anything using Google, DuckDuckGo, phind.com, Contains AI models, can transcribe yt videos, temporary email and phone number generation, has TTS support, webai (terminal gpt and open interpreter) and offline LLMs and more
 Author: OEvortex
 Author-email: helpingai5@gmail.com
@@ -24,6 +24,9 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
+Requires-Dist: setuptools
+Requires-Dist: wheel
+Requires-Dist: pip
 Requires-Dist: mistune
 Requires-Dist: tenacity
 Requires-Dist: curl-cffi
@@ -51,7 +54,6 @@ Requires-Dist: pyreqwest-impersonate
 Requires-Dist: gradio-client
 Requires-Dist: psutil
 Requires-Dist: yaspin
-Requires-Dist: websocket
 Provides-Extra: dev
 Requires-Dist: ruff>=0.1.6; extra == "dev"
 Requires-Dist: pytest>=7.4.2; extra == "dev"
@@ -64,6 +66,7 @@ Requires-Dist: unicorn; extra == "local"
 
 <div align="center">
   <!-- Replace `#` with your actual links -->
+  
   <a href="https://t.me/official_helpingai"><img alt="Telegram" src="https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white"></a>
   <a href="https://www.instagram.com/oevortex/"><img alt="Instagram" src="https://img.shields.io/badge/Instagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white"></a>
   <a href="https://www.linkedin.com/in/oe-vortex-29a407265/"><img alt="LinkedIn" src="https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white"></a>
@@ -109,13 +112,13 @@ Requires-Dist: unicorn; extra == "local"
 * **Rawdog Scripting:** Execute Python scripts directly within your terminal using the `rawdog` feature.
 * **GGUF Conversion & Quantization:** Convert and quantize Hugging Face models to GGUF format.
 * **Autollama:** Download Hugging Face models and automatically convert them for Ollama compatibility.
-* **Function Calling (Beta):** Experiment with function calling capabilities for enhanced AI interactions.
 * **[SwiftCLI](webscout/swiftcli/Readme.md):** A powerful and elegant CLI framework that makes it easy to create beautiful command-line interfaces.
 * **[LitPrinter](webscout/litprinter/Readme.md):** Provides beautiful, styled console output with rich formatting and colors
 * **[LitLogger](webscout/litlogger/Readme.md):** Simplifies logging with customizable formats and color schemes
 * **[LitAgent](webscout/litagent/Readme.md):** Powerful and modern user agent generator that keeps your requests fresh and undetectable
 * **[Text-to-Image](webscout/Provider/TTI/README.md):** Generate high-quality images using a wide range of AI art providers
 * **[MarkdownLite](webscout/Extra/markdownlite/README.md):** Powerful HTML to Markdown conversion library with advanced parsing and structured output
+* **[Scout](webscout/scout/README.md):** Advanced web parsing and crawling library with intelligent HTML/XML parsing, web crawling, and Markdown conversion
 
 ## ⚙️ Installation
 ```python
@@ -851,40 +854,11 @@ print(response)
 
 ```python
 from webscout import YEPCHAT
-ai = YEPCHAT(Tools=False)
+ai = YEPCHAT()
 response = ai.chat(input(">>> "))
 for chunk in response:
     print(chunk, end="", flush=True)
-#---------------Tool Call-------------
 
-from rich import print
-from webscout import YEPCHAT
-def get_current_time():
-    import datetime
-    return f"The current time is {datetime.datetime.now().strftime('%H:%M:%S')}"
-def get_weather(location: str) -> str:
-    return f"The weather in {location} is sunny."
-
-
-ai = YEPCHAT(Tools=True) # Set Tools=True to use tools in the chat.
-
-ai.tool_registry.register_tool("get_current_time", get_current_time, "Gets the current time.")
-ai.tool_registry.register_tool(
-    "get_weather",
-    get_weather,
-    "Gets the weather for a given location.",
-    parameters={
-        "type": "object",
-        "properties": {
-            "location": {"title": "Location", "type": "string"}
-        },
-        "required": ["location"]
-    },
-)
-
-response = ai.chat(input(">>> "))
-for chunk in response:
-    print(chunk, end="", flush=True)
 ```
 
 ###  ⬛ `BlackBox` - Search/Chat with BlackBox
@@ -914,20 +888,6 @@ r = ai.chat(prompt)
 print(r)
 ```
 
-###  ❓ `PERPLEXITY` - Search with PERPLEXITY
-
-```python
-from webscout import Perplexity
-from rich import print
-
-perplexity = Perplexity() 
-# Stream the response
-response = perplexity.chat(input(">>> "))
-for chunk in response:
-    print(chunk, end="", flush=True)
-
-perplexity.close()
-```
 
 ###  🤖 `Meta AI` - Chat with Meta AI
 
@@ -1170,125 +1130,8 @@ a = AndiSearch()
 print(a.chat("HelpingAI-9B"))
 ```
 
-### 📞 Function Calling (Beta)
-
-```python
-import json
-import logging
-from webscout import Julius, WEBS
-from webscout.Agents.functioncall import FunctionCallingAgent
-from rich import print
-
-class FunctionExecutor:
-    def __init__(self, llama):
-        self.llama = llama
-
-    def execute_web_search(self, arguments):
-        query = arguments.get("query")
-        if not query:
-            return "Please provide a search query."
-        with WEBS() as webs:
-            search_results = webs.text(query, max_results=5)
-        prompt = (
-            f"Based on the following search results:\n\n{search_results}\n\n"
-            f"Question: {query}\n\n"
-            "Please provide a comprehensive answer to the question based on the search results above. "
-            "Include relevant webpage URLs in your answer when appropriate. "
-            "If the search results don't contain relevant information, please state that and provide the best answer you can based on your general knowledge."
-        )
-        return self.llama.chat(prompt)
-
-    def execute_general_ai(self, arguments):
-        question = arguments.get("question")
-        if not question:
-            return "Please provide a question."
-        return self.llama.chat(question)
-
-    def execute_UserDetail(self, arguments):
-        name = arguments.get("name")
-        age = arguments.get("age")
-        return f"User details - Name: {name}, Age: {age}"
-
-def main():
-    tools = [
-        {
-            "type": "function",
-            "function": {
-                "name": "UserDetail",
-                "parameters": {
-                    "type": "object",
-                    "properties": {
-                        "name": {"title": "Name", "type": "string"},
-                        "age": {"title": "Age", "type": "integer"}
-                    },
-                    "required": ["name", "age"]
-                }
-            }
-        },
-        {
-            "type": "function",
-            "function": {
-                "name": "web_search",
-                "description": "Search the web for information using Google Search.",
-                "parameters": {
-                    "type": "object",
-                    "properties": {
-                        "query": {
-                            "type": "string",
-                            "description": "The search query to be executed."
-                        }
-                    },
-                    "required": ["query"]
-                }
-            }
-        },
-        {
-            "type": "function",
-            "function": {
-                "name": "general_ai",
-                "description": "Use general AI knowledge to answer the question",
-                "parameters": {
-                    "type": "object",
-                    "properties": {
-                        "question": {"type": "string", "description": "The question to answer"}
-                    },
-                    "required": ["question"]
-                }
-            }
-        }
-    ]
-
-    agent = FunctionCallingAgent(tools=tools)
-    llama = Julius()
-    function_executor = FunctionExecutor(llama)
-
-    user_input = input(">>> ")
-    function_call_data = agent.function_call_handler(user_input)
-    print(f"Function Call Data: {function_call_data}")
-
-    try:
-        if "error" not in function_call_data:
-            function_name = function_call_data.get("tool_name")
-            arguments = function_call_data.get("tool_input", {})
-
-            execute_function = getattr(function_executor, f"execute_{function_name}", None)
-            if execute_function:
-                result = execute_function(arguments)
-                print("Function Execution Result:")
-                for c in result:
-                    print(c, end="", flush=True)
-            else:
-                print(f"Unknown function: {function_name}")
-        else:
-            print(f"Error: {function_call_data['error']}")
-    except Exception as e:
-        print(f"An error occurred: {str(e)}")
-
-if __name__ == "__main__":
-    main()
-```
 
-###  LLAMA3, pizzagpt, RUBIKSAI, Koala, Darkai, AI4Chat, Farfalle, PIAI, Felo, Julius, YouChat, YEPCHAT, Cloudflare, TurboSeek, Editee, AI21, Chatify, Cerebras, X0GPT, Lepton, GEMINIAPI, Cleeai, Elmo, Genspark, Upstage, Free2GPT, Bing, DiscordRocks, GPTWeb, LlamaTutor, PromptRefine, AIUncensored, TutorAI, ChatGPTES, Bagoodex, ChatHub, AmigoChat, AIMathGPT, GaurishCerebras, NinjaChat, GeminiPro, Talkai, LLMChat, AskMyAI, Llama3Mitril, Marcus, PerplexityLabs, TypeGPT, Mhystical
+###  LLAMA3, pizzagpt, RUBIKSAI, Koala, Darkai, AI4Chat, Farfalle, PIAI, Felo, Julius, YouChat, YEPCHAT, Cloudflare, TurboSeek, Editee, AI21, Chatify, Cerebras, X0GPT, Lepton, GEMINIAPI, Cleeai, Elmo, Free2GPT, Bing, DiscordRocks, GPTWeb, LlamaTutor, PromptRefine, TutorAI, ChatGPTES, Bagoodex, ChatHub, AmigoChat, AIMathGPT, GaurishCerebras, NinjaChat, GeminiPro, Talkai, LLMChat, AskMyAI, Llama3Mitril, Marcus, TypeGPT, Mhystical, Netwrck, MultiChatAI, JadveOpenAI, OOAi
 
 Code is similar to other providers.