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

webscout/Litlogger/utils/formatters.py

@@ -1,200 +0,0 @@
-import json
-import re
-import traceback
-from datetime import datetime
-from typing import Any, Dict, Optional, Union
-
-class MessageFormatter:
-    """Utility class for formatting log messages."""
-    
-    @staticmethod
-    def format_exception(exc_info: tuple) -> str:
-        """
-        Format exception information into a readable string.
-        
-        Args:
-            exc_info: Tuple of (type, value, traceback)
-            
-        Returns:
-            Formatted exception string
-        """
-        return "".join(traceback.format_exception(*exc_info))
-
-    @staticmethod
-    def format_dict(data: Dict[str, Any], indent: int = 2) -> str:
-        """
-        Format dictionary into pretty-printed string.
-        
-        Args:
-            data: Dictionary to format
-            indent: Number of spaces for indentation
-            
-        Returns:
-            Formatted string representation
-        """
-        return json.dumps(data, indent=indent, default=str, ensure_ascii=False)
-
-    @staticmethod
-    def format_object(obj: Any) -> str:
-        """
-        Format any object into a string representation.
-        
-        Args:
-            obj: Object to format
-            
-        Returns:
-            String representation of object
-        """
-        if hasattr(obj, "to_dict"):
-            return MessageFormatter.format_dict(obj.to_dict())
-        if hasattr(obj, "__dict__"):
-            return MessageFormatter.format_dict(obj.__dict__)
-        return str(obj)
-
-    @staticmethod
-    def truncate(message: str, max_length: int = 1000, suffix: str = "...") -> str:
-        """
-        Truncate message to maximum length.
-        
-        Args:
-            message: Message to truncate
-            max_length: Maximum length
-            suffix: String to append when truncated
-            
-        Returns:
-            Truncated message
-        """
-        if len(message) <= max_length:
-            return message
-        return message[:max_length - len(suffix)] + suffix
-
-    @staticmethod
-    def mask_sensitive(message: str, patterns: Dict[str, str]) -> str:
-        """
-        Mask sensitive information in message.
-        
-        Args:
-            message: Message to process
-            patterns: Dictionary of {pattern: mask}
-            
-        Returns:
-            Message with sensitive info masked
-        """
-        result = message
-        for pattern, mask in patterns.items():
-            result = re.sub(pattern, mask, result)
-        return result
-
-    @staticmethod
-    def format_context(context: Dict[str, Any]) -> str:
-        """
-        Format context dictionary into readable string.
-        
-        Args:
-            context: Context dictionary
-            
-        Returns:
-            Formatted context string
-        """
-        parts = []
-        for key, value in sorted(context.items()):
-            formatted_value = (
-                MessageFormatter.format_object(value)
-                if isinstance(value, (dict, list, tuple))
-                else str(value)
-            )
-            parts.append(f"{key}={formatted_value}")
-        return " ".join(parts)
-
-    @staticmethod
-    def format_metrics(metrics: Dict[str, Union[int, float]]) -> str:
-        """
-        Format performance metrics into readable string.
-        
-        Args:
-            metrics: Dictionary of metric names and values
-            
-        Returns:
-            Formatted metrics string
-        """
-        parts = []
-        for key, value in sorted(metrics.items()):
-            if isinstance(value, float):
-                formatted = f"{value:.3f}"
-            else:
-                formatted = str(value)
-            parts.append(f"{key}={formatted}")
-        return " ".join(parts)
-
-    @staticmethod
-    def format_timestamp(
-        timestamp: Optional[datetime] = None,
-        format: str = "%Y-%m-%d %H:%M:%S.%f"
-    ) -> str:
-        """
-        Format timestamp into string.
-        
-        Args:
-            timestamp: Datetime object (uses current time if None)
-            format: strftime format string
-            
-        Returns:
-            Formatted timestamp string
-        """
-        if timestamp is None:
-            timestamp = datetime.now()
-        return timestamp.strftime(format)
-
-    @classmethod
-    def format_message(
-        cls,
-        message: str,
-        context: Optional[Dict[str, Any]] = None,
-        metrics: Optional[Dict[str, Union[int, float]]] = None,
-        max_length: Optional[int] = None,
-        mask_patterns: Optional[Dict[str, str]] = None,
-        timestamp_format: Optional[str] = None
-    ) -> str:
-        """
-        Format complete log message with all options.
-        
-        Args:
-            message: Base message
-            context: Optional context dictionary
-            metrics: Optional performance metrics
-            max_length: Optional maximum length
-            mask_patterns: Optional sensitive data patterns
-            timestamp_format: Optional timestamp format
-            
-        Returns:
-            Formatted complete message
-        """
-        parts = []
-        
-        # Add timestamp
-        if timestamp_format:
-            parts.append(cls.format_timestamp(format=timestamp_format))
-            
-        # Add main message
-        parts.append(message)
-        
-        # Add context if present
-        if context:
-            parts.append(cls.format_context(context))
-            
-        # Add metrics if present
-        if metrics:
-            parts.append(cls.format_metrics(metrics))
-            
-        # Join all parts
-        result = " ".join(parts)
-        
-        # Apply masking if needed
-        if mask_patterns:
-            result = cls.mask_sensitive(result, mask_patterns)
-            
-        # Apply length limit if needed
-        if max_length:
-            result = cls.truncate(result, max_length)
-            
-        return result

webscout/Provider/ChatGPTGratis.py

@@ -1,194 +0,0 @@
-from typing import Union, Any, Dict, Generator, Optional
-import requests
-import json
-
-from webscout.AIutel import Optimizers, Conversation, AwesomePrompts
-from webscout.AIbase import Provider
-from webscout import exceptions
-from webscout.litagent import LitAgent as Lit
-
-
-class ChatGPTGratis(Provider):
-    """
-    A class to interact with the chatgptgratis.eu backend API with real-time streaming.
-    """
-    AVAILABLE_MODELS = [
-        "Meta-Llama-3.2-1B-Instruct",
-        "Meta-Llama-3.2-3B-Instruct",
-        "Meta-Llama-3.1-8B-Instruct",
-        "Meta-Llama-3.1-70B-Instruct",
-        "Meta-Llama-3.1-405B-Instruct",
-        "gpt4o"
-    ]
-
-    def __init__(
-        self,
-        model: str = "Meta-Llama-3.2-1B-Instruct",
-        timeout: int = 30,
-        proxies: Optional[Dict[str, str]] = None,
-        intro: Optional[str] = None,
-        filepath: Optional[str] = None,
-        update_file: bool = True,
-        history_offset: int = 10250,
-        act: Optional[str] = None,
-    ) -> None:
-        """
-        Initializes the ChatGPTGratis.
-        """
-        if model not in self.AVAILABLE_MODELS:
-            raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
-
-        self.session = requests.Session()
-        self.timeout = timeout
-        self.api_endpoint = "https://chatgptgratis.eu/backend/chat.php"
-        self.model = model
-
-        # Set up headers similar to a browser request with dynamic User-Agent
-        self.headers = {
-            "Accept": "*/*",
-            "Content-Type": "application/json",
-            "Origin": "https://chatgptgratis.eu",
-            "Referer": "https://chatgptgratis.eu/chat.html",
-            "User-Agent": Lit().random(),
-        }
-        self.session.headers.update(self.headers)
-        self.session.proxies = proxies or {}
-
-        # Set up conversation history and prompts
-        Conversation.intro = (
-            AwesomePrompts().get_act(
-                act, raise_not_found=True, default=None, case_insensitive=True
-            )
-            if act
-            else intro or Conversation.intro
-        )
-        self.conversation = Conversation(
-            True, 8096, filepath, update_file
-        )
-        self.conversation.history_offset = history_offset
-
-    def ask(
-        self,
-        prompt: str,
-        stream: bool = False,
-        raw: bool = False,
-        optimizer: Optional[str] = None,
-        conversationally: bool = False,
-    ) -> Union[Dict[str, Any], Generator[Any, None, None]]:
-        """
-        Sends a request to the API and returns the response.
-        If stream is True, yields response chunks as they are received.
-        """
-        conversation_prompt = self.conversation.gen_complete_prompt(prompt)
-        if optimizer:
-            available_opts = (
-                method for method in dir(Optimizers)
-                if callable(getattr(Optimizers, method)) and not method.startswith("__")
-            )
-            if optimizer in available_opts:
-                conversation_prompt = getattr(Optimizers, optimizer)(
-                    conversation_prompt if conversationally else prompt
-                )
-            else:
-                raise Exception(f"Optimizer is not one of {list(available_opts)}")
-
-        payload = {
-            "message": conversation_prompt,
-            "model": self.model,
-        }
-
-        def for_stream() -> Generator[Dict[str, Any], None, None]:
-            response = self.session.post(
-                self.api_endpoint,
-                json=payload,
-                stream=True,
-                timeout=self.timeout
-            )
-            if not response.ok:
-                raise exceptions.FailedToGenerateResponseError(
-                    f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
-                )
-
-            full_response = ""
-            for line in response.iter_lines():
-                if line:
-                    line_decoded = line.decode('utf-8').strip()
-                    if line_decoded == "data: [DONE]":
-                        break
-                    if line_decoded.startswith("data: "):
-                        try:
-                            json_data = json.loads(line_decoded[6:])
-                            choices = json_data.get("choices", [])
-                            if choices and "delta" in choices[0]:
-                                content = choices[0]["delta"].get("content", "")
-                            else:
-                                content = ""
-                            full_response += content
-                            yield content if raw else {"text": content}
-                        except json.JSONDecodeError:
-                            continue
-            # Update last response and conversation history.
-            self.conversation.update_chat_history(prompt, self.get_message({"text": full_response}))
-
-        def for_non_stream() -> Dict[str, Any]:
-            collected = ""
-            for chunk in for_stream():
-                collected += chunk["text"] if isinstance(chunk, dict) else chunk
-            return {"text": collected}
-
-        return for_stream() if stream else for_non_stream()
-
-    def chat(
-        self,
-        prompt: str,
-        stream: bool = False,
-        optimizer: Optional[str] = None,
-        conversationally: bool = False,
-    ) -> Union[str, Generator[str, None, None]]:
-        """
-        Returns the response as a string.
-        For streaming requests, yields each response chunk as a string.
-        """
-        def stream_response() -> Generator[str, None, None]:
-            for response in self.ask(
-                prompt, stream=True, optimizer=optimizer, conversationally=conversationally
-            ):
-                yield self.get_message(response)
-
-        def non_stream_response() -> str:
-            return self.get_message(self.ask(
-                prompt, stream=False, optimizer=optimizer, conversationally=conversationally
-            ))
-
-        return stream_response() if stream else non_stream_response()
-
-    def get_message(self, response: dict) -> str:
-        """
-        Extracts and returns the text message from the response dictionary.
-        """
-        assert isinstance(response, dict), "Response must be a dictionary."
-        return response.get("text", "")
-
-
-if __name__ == "__main__":
-    print("-" * 80)
-    print(f"{'Model':<50} {'Status':<10} {'Response'}")
-    print("-" * 80)
-
-    for model in ChatGPTGratis.AVAILABLE_MODELS:
-        try:
-            test_ai = ChatGPTGratis(model=model, timeout=60)
-            response = test_ai.chat("Say 'Hello' in one word")
-            response_text = response
-            
-            if response_text and len(response_text.strip()) > 0:
-                status = "✓"
-                # Clean and truncate response
-                clean_text = response_text.strip().encode('utf-8', errors='ignore').decode('utf-8')
-                display_text = clean_text[:50] + "..." if len(clean_text) > 50 else clean_text
-            else:
-                status = "✗"
-                display_text = "Empty or invalid response"
-            print(f"{model:<50} {status:<10} {display_text}")
-        except Exception as e:
-            print(f"{model:<50} {'✗':<10} {str(e)}")

webscout/Provider/TTI/AiForce/README.md

@@ -1,159 +0,0 @@
-# AiForce Provider 🔥
-
-Yo fam! This is the AiForce provider for generating some fire images! Part of the HelpingAI squad! 👑
-
-## Features 💪
-
-- Both sync and async support ⚡
-- 12 fire models to choose from 🎨
-- Smart retry mechanism 🔄
-- Custom image sizes 📐
-- Save with custom names 💾
-- Fire logging with cyberpunk theme 🌟
-- Proxy support for stealth mode 🕵️‍♂️
-
-## Quick Start 🚀
-
-### Installation 📦
-
-```bash
-pip install webscout
-```
-
-### Basic Usage 💫
-
-```python
-# Sync way
-from webscout import AiForceimager
-
-provider = AiForceimager()
-images = provider.generate("Epic dragon")
-paths = provider.save(images)
-
-# Async way
-from webscout import AsyncAiForceimager
-import asyncio
-
-async def generate():
-    provider = AsyncAiForceimager()
-    images = await provider.generate("Cool art")
-    paths = await provider.save(images)
-
-asyncio.run(generate())
-```
-
-## Available Models 🎭
-
-| Model | Description | Best For |
-|-------|-------------|----------|
-| `Flux-1.1-Pro` | Latest pro model (Default) | High quality general purpose |
-| `stable-diffusion-xl-lightning` | Fast SDXL model | Quick generations |
-| `stable-diffusion-xl-base` | Base SDXL model | High quality base |
-| `ideogram` | Artistic model | Creative artwork |
-| `flux` | Standard model | General purpose |
-| `flux-realism` | Photorealistic model | Realistic images |
-| `flux-anime` | Anime style | Anime/manga art |
-| `flux-3d` | 3D rendering | 3D objects/scenes |
-| `flux-disney` | Disney style | Disney-like art |
-| `flux-pixel` | Pixel art | Retro/game art |
-| `flux-4o` | 4k output | High resolution |
-| `any-dark` | Dark theme | Gothic/dark art |
-
-## Advanced Examples 🔥
-
-### Custom Settings 🛠️
-
-```python
-provider = AiForceimager(
-    timeout=120,  # Longer timeout
-    proxies={
-        'http': 'http://proxy.example.com:8080'
-    }
-)
-```
-
-### Multiple Images with Custom Size 📸
-
-```python
-images = provider.generate(
-    prompt="A shiny red sports car",
-    amount=3,  # Generate 3 images
-    model="flux-realism",  # Use realistic model
-    width=1024,  # Custom width
-    height=768,  # Custom height
-    seed=42  # For reproducible results
-)
-```
-
-### Custom Save Options 💾
-
-```python
-paths = provider.save(
-    images,
-    name="sports_car",  # Custom name
-    dir="my_images",  # Custom directory
-    filenames_prefix="v1_"  # Add prefix
-)
-```
-
-### Async with Error Handling ⚡
-
-```python
-async def generate_safely():
-    provider = AsyncAiForceimager()
-    try:
-        images = await provider.generate(
-            prompt="Epic dragon",
-            model="flux-3d",
-            amount=2
-        )
-        paths = await provider.save(images, dir="dragons")
-        print(f"Saved to: {paths}")
-    except Exception as e:
-        print(f"Oops! Something went wrong: {e}")
-
-asyncio.run(generate_safely())
-```
-
-## Tips & Tricks 💡
-
-1. Use `flux-realism` for photorealistic images
-2. Use `flux-3d` for product renders
-3. Use `flux-anime` for anime style art
-4. Set custom timeouts for large images
-5. Use proxies for better reliability
-6. Add seed for reproducible results
-
-## Error Handling 🛡️
-
-The provider handles common errors:
-
-- Network issues
-- API timeouts
-- Invalid inputs
-- File saving errors
-
-Example with retry:
-
-```python
-provider = AiForceimager()
-try:
-    images = provider.generate(
-        "Epic scene",
-        max_retries=5,  # More retries
-        retry_delay=10  # Longer delay
-    )
-except Exception as e:
-    print(f"Generation failed: {e}")
-```
-
-## Contributing 🤝
-
-Pull up to the squad! We're always looking for improvements:
-
-1. Fork it
-2. Create your feature branch
-3. Push your changes
-4. Hit us with that pull request
-
-Made with 💖 by the HelpingAI Team

webscout/Provider/TTI/AiForce/__init__.py

@@ -1,22 +0,0 @@
-"""
-AiForce - Your go-to provider for generating fire images! 🔥
-
-Examples:
-    >>> # Sync Usage
-    >>> from webscout import AiForceimager
-    >>> provider = AiForceimager()
-    >>> images = provider.generate("Cool art")
-    >>> paths = provider.save(images)
-    >>>
-    >>> # Async Usage
-    >>> from webscout import AsyncAiForceimager
-    >>> async def example():
-    ...     provider = AsyncAiForceimager()
-    ...     images = await provider.generate("Epic dragon")
-    ...     paths = await provider.save(images)
-"""
-
-from .sync_aiforce import AiForceimager
-from .async_aiforce import AsyncAiForceimager
-
-__all__ = ["AiForceimager", "AsyncAiForceimager"]