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

webscout/zerodir/__init__.py

@@ -0,0 +1,225 @@
+"""
+ZeroDir: A zero-dependency app directories management library
+
+Provides cross-platform directory management for application data, 
+configuration, and cache without external dependencies.
+"""
+
+import os
+import sys
+import json
+import platform
+import tempfile
+import shutil
+import hashlib
+import time
+import datetime
+
+class ZeroDirs:
+    def __init__(self, app_name, app_author=None):
+        """
+        Initialize ZeroDirs with application details
+        
+        :param app_name: Name of the application
+        :param app_author: Author/Company name (optional)
+        """
+        self.app_name = app_name
+        self.app_author = app_author or os.getlogin()
+        self._init_dirs()
+
+    def _init_dirs(self):
+        """Initialize application directories"""
+        self.user_data_dir = self._get_user_data_dir()
+        self.user_config_dir = self._get_user_config_dir()
+        self.user_cache_dir = self._get_user_cache_dir()
+        self.user_log_dir = self._get_user_log_dir()
+        self.temp_dir = self._get_temp_dir()
+
+        # Create directories if they don't exist
+        for directory in [
+            self.user_data_dir, 
+            self.user_config_dir, 
+            self.user_cache_dir, 
+            self.user_log_dir,
+            self.temp_dir
+        ]:
+            os.makedirs(directory, exist_ok=True)
+
+    def _get_user_data_dir(self):
+        """Get user data directory"""
+        system = platform.system().lower()
+        if system == 'windows':
+            base = os.path.expandvars('%LOCALAPPDATA%')
+            return os.path.join(base, self.app_author, self.app_name)
+        elif system == 'darwin':  # macOS
+            return os.path.expanduser(f'~/Library/Application Support/{self.app_name}')
+        else:  # Linux and other Unix-like
+            xdg_data_home = os.environ.get('XDG_DATA_HOME') or os.path.expanduser('~/.local/share')
+            return os.path.join(xdg_data_home, self.app_name)
+
+    def _get_user_config_dir(self):
+        """Get user configuration directory"""
+        system = platform.system().lower()
+        if system == 'windows':
+            base = os.path.expandvars('%APPDATA%')
+            return os.path.join(base, self.app_author, self.app_name)
+        elif system == 'darwin':  # macOS
+            return os.path.expanduser(f'~/Library/Preferences/{self.app_name}')
+        else:  # Linux and other Unix-like
+            xdg_config_home = os.environ.get('XDG_CONFIG_HOME') or os.path.expanduser('~/.config')
+            return os.path.join(xdg_config_home, self.app_name)
+
+    def _get_user_cache_dir(self):
+        """Get user cache directory"""
+        system = platform.system().lower()
+        if system == 'windows':
+            base = os.path.expandvars('%LOCALAPPDATA%')
+            return os.path.join(base, self.app_author, self.app_name, 'Cache')
+        elif system == 'darwin':  # macOS
+            return os.path.expanduser(f'~/Library/Caches/{self.app_name}')
+        else:  # Linux and other Unix-like
+            xdg_cache_home = os.environ.get('XDG_CACHE_HOME') or os.path.expanduser('~/.cache')
+            return os.path.join(xdg_cache_home, self.app_name)
+
+    def _get_user_log_dir(self):
+        """Get user log directory"""
+        system = platform.system().lower()
+        if system == 'windows':
+            base = os.path.expandvars('%LOCALAPPDATA%')
+            return os.path.join(base, self.app_author, self.app_name, 'Logs')
+        elif system == 'darwin':  # macOS
+            return os.path.expanduser(f'~/Library/Logs/{self.app_name}')
+        else:  # Linux and other Unix-like
+            xdg_data_home = os.environ.get('XDG_DATA_HOME') or os.path.expanduser('~/.local/share')
+            return os.path.join(xdg_data_home, self.app_name, 'logs')
+
+    def _get_temp_dir(self):
+        """Get temporary directory for the application"""
+        return os.path.join(tempfile.gettempdir(), f'{self.app_name}_temp')
+
+    def save_config(self, config_data, filename='config.json'):
+        """
+        Save configuration data to config directory
+        
+        :param config_data: Dictionary of configuration data
+        :param filename: Name of the config file (default: config.json)
+        :return: Path to saved config file
+        """
+        config_path = os.path.join(self.user_config_dir, filename)
+        with open(config_path, 'w') as f:
+            json.dump(config_data, f, indent=4)
+        return config_path
+
+    def load_config(self, filename='config.json'):
+        """
+        Load configuration data from config directory
+        
+        :param filename: Name of the config file (default: config.json)
+        :return: Dictionary of configuration data or None if file doesn't exist
+        """
+        config_path = os.path.join(self.user_config_dir, filename)
+        if os.path.exists(config_path):
+            with open(config_path, 'r') as f:
+                return json.load(f)
+        return None
+
+    def cache_file(self, content, filename=None, extension=None):
+        """
+        Cache a file with optional naming and extension
+        
+        :param content: File content or bytes
+        :param filename: Optional custom filename
+        :param extension: Optional file extension
+        :return: Path to cached file
+        """
+        if not filename:
+            # Generate a hash-based filename if not provided
+            content_hash = hashlib.md5(str(content).encode()).hexdigest()
+            filename = f'{content_hash}{extension or ""}'
+        
+        cache_path = os.path.join(self.user_cache_dir, filename)
+        
+        # Write content to file
+        with open(cache_path, 'wb' if isinstance(content, bytes) else 'w') as f:
+            f.write(content)
+        
+        return cache_path
+
+    def clear_cache(self, max_age_days=30):
+        """
+        Clear cache directory, optionally removing files older than max_age_days
+        
+        :param max_age_days: Maximum age of files to keep (default: 30 days)
+        :return: Number of files deleted
+        """
+        current_time = time.time()
+        
+        deleted_count = 0
+        for filename in os.listdir(self.user_cache_dir):
+            filepath = os.path.join(self.user_cache_dir, filename)
+            
+            # Check file age
+            file_age_days = (current_time - os.path.getctime(filepath)) / (24 * 3600)
+            
+            if file_age_days > max_age_days:
+                try:
+                    os.remove(filepath)
+                    deleted_count += 1
+                except Exception:
+                    pass
+        
+        return deleted_count
+
+    def log(self, message, filename='app.log', level='INFO'):
+        """
+        Log a message to the log directory
+        
+        :param message: Log message
+        :param filename: Log filename (default: app.log)
+        :param level: Log level (default: INFO)
+        """
+        log_path = os.path.join(self.user_log_dir, filename)
+        
+        with open(log_path, 'a') as log_file:
+            timestamp = datetime.datetime.now().strftime('%Y-%m-%d %H:%M:%S')
+            log_file.write(f'[{level}] {timestamp}: {message}\n')
+
+def user_data_dir(app_name, app_author=None):
+    """
+    Quick function to get user data directory
+    
+    :param app_name: Name of the application
+    :param app_author: Author/Company name (optional)
+    :return: Path to user data directory
+    """
+    return ZeroDirs(app_name, app_author).user_data_dir
+
+def user_config_dir(app_name, app_author=None):
+    """
+    Quick function to get user config directory
+    
+    :param app_name: Name of the application
+    :param app_author: Author/Company name (optional)
+    :return: Path to user config directory
+    """
+    return ZeroDirs(app_name, app_author).user_config_dir
+
+def user_cache_dir(app_name, app_author=None):
+    """
+    Quick function to get user cache directory
+    
+    :param app_name: Name of the application
+    :param app_author: Author/Company name (optional)
+    :return: Path to user cache directory
+    """
+    return ZeroDirs(app_name, app_author).user_cache_dir
+
+def user_log_dir(app_name, app_author=None):
+    """
+    Quick function to get user log directory
+    
+    :param app_name: Name of the application
+    :param app_author: Author/Company name (optional)
+    :return: Path to user log directory
+    """
+    return ZeroDirs(app_name, app_author).user_log_dir

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 6.4
+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,14 +24,14 @@ 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
 Requires-Dist: nest-asyncio
-Requires-Dist: g4f>=0.2.2.3
-Requires-Dist: g4f[webdriver]
 Requires-Dist: rich
-Requires-Dist: beautifulsoup4
 Requires-Dist: markdownify
 Requires-Dist: requests
 Requires-Dist: google-generativeai
@@ -39,12 +39,10 @@ Requires-Dist: lxml>=5.2.2
 Requires-Dist: termcolor
 Requires-Dist: orjson
 Requires-Dist: PyYAML
-Requires-Dist: appdirs
 Requires-Dist: tls-client
 Requires-Dist: clipman
 Requires-Dist: playsound
 Requires-Dist: ollama
-Requires-Dist: pyfiglet
 Requires-Dist: pillow
 Requires-Dist: bson
 Requires-Dist: cloudscraper
@@ -53,7 +51,6 @@ Requires-Dist: openai
 Requires-Dist: prompt-toolkit
 Requires-Dist: primp
 Requires-Dist: pyreqwest-impersonate
-Requires-Dist: lxml-html-clean
 Requires-Dist: gradio-client
 Requires-Dist: psutil
 Requires-Dist: yaspin
@@ -69,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>
@@ -103,24 +101,24 @@ Requires-Dist: unicorn; extra == "local"
 </div>
 
 ## 🚀 Features
-* **Comprehensive Search:** Leverage Google, DuckDuckGo, and Phind.com for diverse search results.
+* **Comprehensive Search:** Leverage Google, DuckDuckGo for diverse search results.
 * **AI Powerhouse:** Access and interact with various AI models, including OpenAI, Cohere, and more.
-* **YouTube Toolkit:** Transcribe YouTube videos effortlessly and download audio/video content.
+* **[YouTube Toolkit](webscout/Extra/YTToolkit):** Advanced YouTube video and transcript management with multi-language support, versatile downloading, and intelligent data extraction
 * **Tempmail & Temp Number:** Generate temporary email addresses and phone numbers for enhanced privacy.
-* **Text-to-Speech (TTS):** Convert text into natural-sounding speech using various TTS providers.
-* **WebAI:** Experience the power of terminal-based GPT and an open interpreter for code execution and more.
+* **[Text-to-Speech (TTS)](webscout/Provider/TTS/README.md):** Convert text into natural-sounding speech using multiple AI-powered providers like ElevenLabs, StreamElements, and Voicepods.
 * **Offline LLMs:** Utilize powerful language models offline with GGUF support.
 * **Extensive Provider Ecosystem:** Explore a vast collection of providers, including BasedGPT, DeepSeek, and many others.
 * **Local LLM Execution:** Run GGUF models locally with minimal configuration.
 * **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
@@ -226,29 +224,7 @@ python -m webscout --help
 
 [Go To TOP](#webscout-️)
 
-## ⬇️ YTdownloader 
 
-```python
-from os import rename, getcwd
-from webscout import YTdownloader
-def download_audio(video_id):
-    youtube_link = video_id 
-    handler = YTdownloader.Handler(query=youtube_link)
-    for third_query_data in handler.run(format='mp3', quality='128kbps', limit=1):
-        audio_path = handler.save(third_query_data, dir=getcwd())  
-        rename(audio_path, "audio.mp3")
-
-def download_video(video_id):
-    youtube_link = video_id 
-    handler = YTdownloader.Handler(query=youtube_link)
-    for third_query_data in handler.run(format='mp4', quality='auto', limit=1):
-        video_path = handler.save(third_query_data, dir=getcwd())  
-        rename(video_path, "video.mp4")
-        
-if __name__ == "__main__":
-    # download_audio("https://www.youtube.com/watch?v=c0tMvzB0OKw")
-    download_video("https://www.youtube.com/watch?v=c0tMvzB0OKw")
-```
 
 ## ☀️ Weather
 
@@ -304,20 +280,7 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
-## 📝 Transcriber
 
-The `transcriber` function in Webscout is a handy tool that transcribes YouTube videos. 
-
-**Example:**
-
-```python
-from webscout import YTTranscriber
-yt = YTTranscriber()
-from rich import print
-video_url = input("Enter the YouTube video URL: ") 
-transcript = yt.get_transcript(video_url, languages=None) 
-print(transcript)
-```
 
 ## 🔍 GoogleS (formerly DWEBS)
 
@@ -330,16 +293,6 @@ for result in results:
     print(result)
 ```
 
-### BingS
-
-```python
-from webscout import BingS
-from rich import print
-searcher = BingS()
-results = searcher.search("HelpingAI-9B", max_results=20, extract_webpage_text=True, max_extract_characters=1000)
-for result in results:
-    print(result)
-```
 
 ## 🦆 WEBS and AsyncWEBS
 
@@ -901,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
@@ -956,35 +880,15 @@ ai = BLACKBOXAI(
     model=None # You can specify a model if needed
 )
 
-# Start an infinite loop for continuous interaction
-while True:
-    # Define a prompt to send to the AI
-    prompt = input("Enter your prompt: ")
-    
-    # Check if the user wants to exit the loop
-    if prompt.lower() == "exit":
-        break
-    
-    # Use the 'chat' method to send the prompt and receive a response
-    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()
+# Define a prompt to send to the AI
+prompt = "Tell me about india"
+# Use the 'chat' method to send the prompt and receive a response
+r = ai.chat(prompt)
+print(r)
 ```
 
+
 ###  🤖 `Meta AI` - Chat with Meta AI
 
 ```python
@@ -1226,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.