webscout 6.3__py3-none-any.whl → 6.5__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.3.dist-info → webscout-6.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 6.3
+Version: 6.5
 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,13 +24,11 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
-Requires-Dist: click
+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
@@ -38,28 +36,22 @@ 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: requests-html
 Requires-Dist: bson
 Requires-Dist: cloudscraper
 Requires-Dist: emoji
 Requires-Dist: openai
 Requires-Dist: prompt-toolkit
-Requires-Dist: fake-useragent
 Requires-Dist: primp
 Requires-Dist: pyreqwest-impersonate
-Requires-Dist: lxml-html-clean
 Requires-Dist: gradio-client
 Requires-Dist: psutil
-Requires-Dist: colorlog
 Requires-Dist: yaspin
-Requires-Dist: cerebras-cloud-sdk
+Requires-Dist: websocket
 Provides-Extra: dev
 Requires-Dist: ruff>=0.1.6; extra == "dev"
 Requires-Dist: pytest>=7.4.2; extra == "dev"
@@ -106,12 +98,11 @@ 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.
@@ -119,7 +110,12 @@ Requires-Dist: unicorn; extra == "local"
 * **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
 
 ## ⚙️ Installation
 ```python
@@ -225,29 +221,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
 
@@ -303,20 +277,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)
 
@@ -329,16 +290,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
 
@@ -817,17 +768,6 @@ with WEBS() as WEBS:
 ___
 </details>
 
-### 🖼️ Text to Images - DeepInfraImager, PollinationsAI, BlackboxAIImager, AiForceimager, NexraImager, HFimager, ArtbitImager, NinjaImager, WebSimAI, AIUncensoredImager, TalkaiImager
-
-**Every TTI provider has the same usage code, you just need to change the import.**
-
-```python
-from webscout import DeepInfraImager
-bot = DeepInfraImager()
-resp = bot.generate("AI-generated image - webscout", 1)
-print(bot.save(resp))
-```
-
 ### 🗣️ Text to Speech - Voicepods, StreamElements
 
 ```python
@@ -936,9 +876,9 @@ ai.tool_registry.register_tool(
     parameters={
         "type": "object",
         "properties": {
-            "location": {"type": "string", "description": "The city and state, or zip code"}
+            "location": {"title": "Location", "type": "string"}
         },
-        "required": ["location"],
+        "required": ["location"]
     },
 )
 
@@ -966,18 +906,12 @@ 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)
+
+# 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)
 ```
 
 ###  ❓ `PERPLEXITY` - Search with PERPLEXITY
@@ -1019,8 +953,7 @@ meta_ai = Meta(fb_email=fb_email, fb_password=fb_password)
 # Text prompt with web search
 response = meta_ai.ask("what is currently happning in bangladesh in aug 2024")
 print(response["message"]) # Access the text message
-print("Sources:", response["sources"]) # Access sources (if ```python
-any)
+print("Sources:", response["sources"]) # Access sources (if any)
 
 # Image generation
 response = meta_ai.ask("Create an image of a cat wearing a hat.") 
@@ -1355,36 +1288,28 @@ 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
+###  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
 
 Code is similar to other providers.
 
 ### `LLM`
 
 ```python
-from webscout.LLM import LLM
-
-# Read the system message from the file
-with open('system.txt', 'r') as file:
-    system_message = file.read()
-
-# Initialize the LLM class with the model name and system message
-llm = LLM(model="microsoft/WizardLM-2-8x22B", system_message=system_message)
-
-while True:
-    # Get the user input
-    user_input = input("User: ")
-
-    # Define the messages to be sent
-    messages = [
-        {"role": "user", "content": user_input}
+from webscout.LLM import LLM, VLM
+
+# Chat with text
+llm = LLM("meta-llama/Meta-Llama-3-70B-Instruct")
+response = llm.chat([{"role": "user", "content": "What's good?"}])
+
+# Chat with images
+vlm = VLM("cogvlm-grounding-generalist")
+response = vlm.chat([{
+    "role": "user",
+    "content": [
+        {"type": "image", "image_url": "cool_pic.jpg"},
+        {"type": "text", "text": "What's in this image?"}
     ]
-
-    # Use the mistral_chat method to get the response
-    response = llm.chat(messages)
-
-    # Print the response
-    print("AI: ", response)
+}])
 ```
 
 ##  💻 Local-LLM