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

webscout/Provider/TTI/ImgSys/async_imgsys.py

@@ -1,202 +0,0 @@
-"""ImgSys Asynchronous Provider - Generate images from multiple providers! 🔥
-
-Examples:
-    >>> import asyncio
-    >>> from webscout import AsyncImgSys
-    >>> 
-    >>> async def main():
-    ...     provider = AsyncImgSys()
-    ...     # Generate images
-    ...     images = await provider.generate("A cool cyberpunk city at night")
-    ...     await provider.save(images, dir="my_images")
-    >>> asyncio.run(main())
-"""
-
-import aiohttp
-import os
-import time
-import asyncio
-from typing import List, Optional, Union
-from aiohttp import ClientError
-from pathlib import Path
-
-from webscout.AIbase import ImageProvider
-from webscout.litagent import LitAgent
-
-# Get a fresh user agent! 🔄
-agent = LitAgent()
-
-class AsyncImgSys(ImageProvider):
-    """Your homie for generating fire images using imgsys.org! 🎨
-
-    This provider generates images from multiple providers, with built-in retry logic
-    and error handling to make sure you get your images no cap! 💯
-
-    Examples:
-        >>> import asyncio
-        >>> from webscout import AsyncImgSys
-        >>> async def main():
-        ...     provider = AsyncImgSys()
-        ...     # Generate images
-        ...     images = await provider.generate("A futuristic city")
-        ...     await provider.save(images, "city.jpg")
-        >>> asyncio.run(main())
-    """
-
-    def __init__(
-        self, 
-        timeout: int = 60, 
-        proxies: Optional[dict] = None
-    ):
-        """Initialize your AsyncImgSys provider with custom settings
-
-        Examples:
-            >>> provider = AsyncImgSys(timeout=30)
-            >>> provider = AsyncImgSys(proxies={"http": "http://proxy:8080"})
-
-        Args:
-            timeout (int): HTTP request timeout in seconds (default: 60)
-            proxies (dict, optional): Proxy configuration for requests
-        """
-        self.request_id_endpoint = "https://imgsys.org/api/initiate"
-        self.image_response_endpoint = "https://imgsys.org/api/get"
-        self.image_provider_endpoint = "https://imgsys.org/api/submit"
-        
-        self.headers = {
-            "Accept": "application/json",
-            "Content-Type": "application/json",
-            "User-Agent": agent.random(),
-        }
-        self.timeout = aiohttp.ClientTimeout(total=timeout)
-        self.proxies = proxies
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "jpeg"
-
-    async def generate(
-        self,
-        prompt: str,
-        max_retries: int = 3,
-        retry_delay: int = 5,
-    ) -> List[bytes]:
-        """Generate some fire images from your prompt! 🎨
-
-        Args:
-            prompt (str): Your image description
-            max_retries (int): Max retry attempts if something fails (default: 3)
-            retry_delay (int): Seconds to wait between retries (default: 5)
-
-        Returns:
-            List[bytes]: Your generated images as bytes
-
-        Raises:
-            ValueError: If the inputs ain't valid
-            ClientError: If the API calls fail after retries
-        """
-        # Input validation
-        if not prompt:
-            raise ValueError("Yo fam, the prompt can't be empty! 🤔")
-
-        self.prompt = prompt
-        response = []
-        
-        async with aiohttp.ClientSession(headers=self.headers, timeout=self.timeout) as session:
-            # Get request ID
-            data = {"prompt": prompt}
-            async with session.post(self.request_id_endpoint, json=data) as resp:
-                resp.raise_for_status()
-                request_id = (await resp.json())["requestId"]
-
-            # Poll for results
-            for attempt in range(max_retries):
-                try:
-                    # Get image URLs
-                    async with session.get(
-                        f"{self.image_response_endpoint}?requestId={request_id}"
-                    ) as resp:
-                        resp.raise_for_status()
-                        image_data = await resp.json()
-
-                    if "results" in image_data and len(image_data["results"]) >= 2:
-                        # Get provider names
-                        async with session.post(
-                            self.image_provider_endpoint,
-                            json={"requestId": request_id, "preference": 0}
-                        ) as resp:
-                            resp.raise_for_status()
-                            provider_data = await resp.json()
-
-                        # Download images
-                        for i, url in enumerate(image_data["results"][:2]):
-                            async with session.get(url) as resp:
-                                resp.raise_for_status()
-                                response.append(await resp.read())
-                        
-                        break
-                    else:
-                        if attempt == max_retries - 1:
-                            raise ClientError("Failed to get image results after max retries")
-                        await asyncio.sleep(retry_delay)
-
-                except ClientError as e:
-                    if attempt == max_retries - 1:
-                        raise
-                    await asyncio.sleep(retry_delay)
-
-        return response
-
-    async def save(
-        self,
-        response: List[bytes],
-        name: Optional[str] = None,
-        dir: Optional[Union[str, Path]] = None,
-        filenames_prefix: str = "",
-    ) -> List[str]:
-        """Save your fire generated images! 💾
-
-        Examples:
-            >>> import asyncio
-            >>> from webscout import AsyncImgSys
-            >>> async def main():
-            ...     provider = AsyncImgSys()
-            ...     images = await provider.generate("Cool art")
-            ...     # Save with default settings
-            ...     paths = await provider.save(images)
-            ...     # Save with custom name and directory
-            ...     paths = await provider.save(
-            ...         images,
-            ...         name="my_art",
-            ...         dir="my_images",
-            ...         filenames_prefix="test_"
-            ...     )
-            >>> asyncio.run(main())
-
-        Args:
-            response (List[bytes]): Your generated images
-            name (Optional[str]): Custom name for your images
-            dir (Optional[Union[str, Path]]): Where to save the images (default: current directory)
-            filenames_prefix (str): Prefix for your image files
-
-        Returns:
-            List[str]: Paths to your saved images
-        """
-        save_dir = dir if dir else os.getcwd()
-        if not os.path.exists(save_dir):
-            os.makedirs(save_dir)
-
-        saved_paths = []
-        timestamp = int(time.time())
-        
-        for i, image_bytes in enumerate(response):
-            if name:
-                filename = f"{filenames_prefix}{name}_{i}.{self.image_extension}"
-            else:
-                filename = f"{filenames_prefix}imgsys_{timestamp}_{i}.{self.image_extension}"
-            
-            filepath = os.path.join(save_dir, filename)
-            
-            async with aiohttp.AsyncFile(filepath, "wb") as f:
-                await f.write(image_bytes)
-            
-            saved_paths.append(filepath)
-
-        return saved_paths 

webscout/Provider/TTI/ImgSys/sync_imgsys.py

@@ -1,195 +0,0 @@
-"""ImgSys Synchronous Provider - Generate images from multiple providers! 🔥
-
-Examples:
-    >>> from webscout import ImgSys
-    >>> provider = ImgSys()
-    >>> 
-    >>> # Generate images
-    >>> images = provider.generate("A cool cyberpunk city at night")
-    >>> provider.save(images, dir="my_images")
-"""
-
-import requests
-import os
-import time
-from typing import List, Optional, Union
-from requests.exceptions import RequestException
-from pathlib import Path
-
-from webscout.AIbase import ImageProvider
-from webscout.litagent import LitAgent
-
-# Get a fresh user agent! 🔄
-agent = LitAgent()
-
-class ImgSys(ImageProvider):
-    """Your homie for generating fire images using imgsys.org! 🎨
-
-    This provider generates images from multiple providers, with built-in retry logic
-    and error handling to make sure you get your images no cap! 💯
-
-    Examples:
-        >>> provider = ImgSys()
-        >>> # Generate images
-        >>> images = provider.generate("A futuristic city")
-        >>> provider.save(images, "city.jpg")
-    """
-
-    def __init__(
-        self, 
-        timeout: int = 60, 
-        proxies: Optional[dict] = None
-    ):
-        """Initialize your ImgSys provider with custom settings
-
-        Examples:
-            >>> provider = ImgSys(timeout=30)
-            >>> provider = ImgSys(proxies={"http": "http://proxy:8080"})
-
-        Args:
-            timeout (int): HTTP request timeout in seconds (default: 60)
-            proxies (dict, optional): Proxy configuration for requests
-        """
-        self.request_id_endpoint = "https://imgsys.org/api/initiate"
-        self.image_response_endpoint = "https://imgsys.org/api/get"
-        self.image_provider_endpoint = "https://imgsys.org/api/submit"
-        
-        self.headers = {
-            "Accept": "application/json",
-            "Content-Type": "application/json",
-            "User-Agent": agent.random(),
-        }
-        self.session = requests.Session()
-        self.session.headers.update(self.headers)
-        if proxies:
-            self.session.proxies.update(proxies)
-            
-        self.timeout = timeout
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "jpeg"
-
-    def generate(
-        self,
-        prompt: str,
-        max_retries: int = 3,
-        retry_delay: int = 5,
-    ) -> List[bytes]:
-        """Generate some fire images from your prompt! 🎨
-
-        Args:
-            prompt (str): Your image description
-            max_retries (int): Max retry attempts if something fails (default: 3)
-            retry_delay (int): Seconds to wait between retries (default: 5)
-
-        Returns:
-            List[bytes]: Your generated images as bytes
-
-        Raises:
-            ValueError: If the inputs ain't valid
-            RequestException: If the API calls fail after retries
-        """
-        # Input validation
-        if not prompt:
-            raise ValueError("Yo fam, the prompt can't be empty! 🤔")
-
-        self.prompt = prompt
-        response = []
-        
-        # Get request ID
-        data = {"prompt": prompt}
-        resp = self.session.post(self.request_id_endpoint, json=data, timeout=self.timeout)
-        resp.raise_for_status()
-        request_id = resp.json()["requestId"]
-
-        # Poll for results
-        for attempt in range(max_retries):
-            try:
-                # Get image URLs
-                resp = self.session.get(
-                    f"{self.image_response_endpoint}?requestId={request_id}",
-                    timeout=self.timeout
-                )
-                resp.raise_for_status()
-                image_data = resp.json()
-
-                if "results" in image_data and len(image_data["results"]) >= 2:
-                    # Get provider names
-                    provider_resp = self.session.post(
-                        self.image_provider_endpoint,
-                        json={"requestId": request_id, "preference": 0},
-                        timeout=self.timeout
-                    )
-                    provider_resp.raise_for_status()
-                    provider_data = provider_resp.json()
-
-                    # Download images
-                    for i, url in enumerate(image_data["results"][:2]):
-                        img_resp = self.session.get(url, timeout=self.timeout)
-                        img_resp.raise_for_status()
-                        response.append(img_resp.content)
-                    
-                    break
-                else:
-                    if attempt == max_retries - 1:
-                        raise RequestException("Failed to get image results after max retries")
-                    time.sleep(retry_delay)
-
-            except RequestException as e:
-                if attempt == max_retries - 1:
-                    raise
-                time.sleep(retry_delay)
-
-        return response
-
-    def save(
-        self,
-        response: List[bytes],
-        name: Optional[str] = None,
-        dir: Optional[Union[str, Path]] = None,
-        filenames_prefix: str = "",
-    ) -> List[str]:
-        """Save your fire generated images! 💾
-
-        Examples:
-            >>> provider = ImgSys()
-            >>> images = provider.generate("Cool art")
-            >>> # Save with default settings
-            >>> paths = provider.save(images)
-            >>> # Save with custom name and directory
-            >>> paths = provider.save(
-            ...     images,
-            ...     name="my_art",
-            ...     dir="my_images",
-            ...     filenames_prefix="test_"
-            ... )
-
-        Args:
-            response (List[bytes]): Your generated images
-            name (Optional[str]): Custom name for your images
-            dir (Optional[Union[str, Path]]): Where to save the images (default: current directory)
-            filenames_prefix (str): Prefix for your image files
-
-        Returns:
-            List[str]: Paths to your saved images
-        """
-        save_dir = dir if dir else os.getcwd()
-        if not os.path.exists(save_dir):
-            os.makedirs(save_dir)
-
-        saved_paths = []
-        timestamp = int(time.time())
-        
-        for i, image_bytes in enumerate(response):
-            if name:
-                filename = f"{filenames_prefix}{name}_{i}.{self.image_extension}"
-            else:
-                filename = f"{filenames_prefix}imgsys_{timestamp}_{i}.{self.image_extension}"
-            
-            filepath = os.path.join(save_dir, filename)
-            
-            with open(filepath, "wb") as f:
-                f.write(image_bytes)
-            
-            saved_paths.append(filepath)
-
-        return saved_paths 

webscout/Provider/TTI/MagicStudio/README.md

@@ -1,101 +0,0 @@
-# 🎨 MagicStudio Image Generation
-
-Generate amazing images with MagicStudio's AI art generator! 🚀
-
-## 🌟 Features
-
-- Fast and reliable image generation
-- Both sync and async implementations
-- Smart retry mechanism
-- Proxy support
-- Custom timeouts
-- Easy-to-use interface
-
-## 📦 Installation
-
-```bash
-pip install webscout
-```
-
-## 🚀 Quick Start
-
-### Sync Usage
-
-```python
-from webscout import MagicStudioImager
-
-# Initialize the provider
-provider = MagicStudioImager()
-
-# Generate a single image
-images = provider.generate("A beautiful sunset over mountains")
-paths = provider.save(images)
-
-# Generate multiple images
-images = provider.generate(
-    prompt="Epic dragon breathing fire",
-    amount=3
-)
-paths = provider.save(images, dir="dragon_pics")
-```
-
-### Async Usage
-
-```python
-from webscout import AsyncMagicStudioImager
-import asyncio
-
-async def generate_images():
-    provider = AsyncMagicStudioImager()
-    
-    # Generate multiple images
-    images = await provider.generate(
-        "Epic dragon in cyberpunk city",
-        amount=2
-    )
-    paths = await provider.save(images, dir="outputs")
-
-# Run the async function
-asyncio.run(generate_images())
-```
-
-## ⚙️ Configuration
-
-```python
-# Custom settings
-provider = MagicStudioImager(
-    timeout=120,  # Longer timeout
-    proxies={
-        'http': 'http://proxy:8080',
-        'https': 'http://proxy:8080'
-    }
-)
-
-# Advanced usage
-images = provider.generate(
-    prompt="A shiny red sports car",
-    amount=3,
-    max_retries=5,
-    retry_delay=3
-)
-```
-
-## 🛡️ Error Handling
-
-```python
-try:
-    images = provider.generate("Cool art")
-    paths = provider.save(images)
-except ValueError as e:
-    print(f"Invalid input: {e}")
-except Exception as e:
-    print(f"Generation failed: {e}")
-```
-
-## 💡 Tips
-
-1. Use clear, descriptive prompts
-2. Set longer timeouts for multiple images
-3. Enable proxies for better reliability
-4. Use retry mechanism for stability
-5. Save images with meaningful names

webscout/Provider/TTI/MagicStudio/__init__.py

@@ -1,2 +0,0 @@
-from .async_magicstudio import *
-from .sync_magicstudio import *

webscout/Provider/TTI/MagicStudio/async_magicstudio.py

@@ -1,111 +0,0 @@
-import aiohttp
-import asyncio
-import os
-import uuid
-import time
-from typing import List, Optional, Union, AsyncGenerator
-from pathlib import Path
-
-from webscout.AIbase import AsyncImageProvider
-from webscout.litagent import LitAgent
-
-agent = LitAgent()
-
-class AsyncMagicStudioImager(AsyncImageProvider):
-    """Your go-to async provider for generating fire images with MagicStudio! ⚡"""
-    
-    def __init__(self, timeout: int = 60, proxies: dict = None):
-        """Initialize your async MagicStudio provider with custom settings! ⚙️"""
-        self.api_endpoint = "https://ai-api.magicstudio.com/api/ai-art-generator"
-        self.headers = {
-            "Accept": "application/json, text/plain, */*",
-            "User-Agent": agent.random(),
-            "Origin": "https://magicstudio.com",
-            "Referer": "https://magicstudio.com/ai-art-generator/",
-            "DNT": "1",
-            "Sec-GPC": "1"
-        }
-        self.timeout = timeout
-        self.proxies = proxies
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "jpg"
-
-    async def generate(
-        self,
-        prompt: str,
-        amount: int = 1,
-        max_retries: int = 3,
-        retry_delay: int = 5
-    ) -> List[bytes]:
-        """Generate some fire images from your prompt asynchronously! ⚡"""
-        if not prompt:
-            raise ValueError("Yo fam, prompt can't be empty! 🚫")
-        if not isinstance(amount, int) or amount < 1:
-            raise ValueError("Amount needs to be a positive number! 📈")
-
-        self.prompt = prompt
-        response = []
-
-        async with aiohttp.ClientSession(headers=self.headers) as session:
-            for _ in range(amount):
-                form_data = {
-                    "prompt": prompt,
-                    "output_format": "bytes",
-                    "user_profile_id": "null",
-                    "anonymous_user_id": str(uuid.uuid4()),
-                    "request_timestamp": time.time(),
-                    "user_is_subscribed": "false",
-                    "client_id": uuid.uuid4().hex,
-                }
-
-                for attempt in range(max_retries):
-                    try:
-                        async with session.post(
-                            self.api_endpoint,
-                            data=form_data,
-                            timeout=self.timeout,
-                            proxy=self.proxies.get('http') if self.proxies else None
-                        ) as resp:
-                            resp.raise_for_status()
-                            response.append(await resp.read())
-                            break
-                    except aiohttp.ClientError as e:
-                        if attempt == max_retries - 1:
-                            raise
-                        await asyncio.sleep(retry_delay)
-
-        return response
-
-    async def save(
-        self,
-        response: Union[List[bytes], AsyncGenerator[bytes, None]],
-        name: Optional[str] = None,
-        dir: Optional[Union[str, Path]] = None,
-        filenames_prefix: str = "",
-    ) -> List[str]:
-        """Save your fire generated images asynchronously! 💾"""
-        save_dir = dir if dir else os.getcwd()
-        if not os.path.exists(save_dir):
-            os.makedirs(save_dir)
-
-        name = self.prompt if name is None else name
-        saved_paths = []
-
-        async def save_single_image(image_bytes: bytes, index: int) -> str:
-            filename = f"{filenames_prefix}{name}_{index}.{self.image_extension}"
-            filepath = os.path.join(save_dir, filename)
-            
-            with open(filepath, "wb") as f:
-                f.write(image_bytes)
-            
-            return os.path.basename(filepath)
-
-        if isinstance(response, list):
-            image_list = response
-        else:
-            image_list = [chunk async for chunk in response]
-
-        tasks = [save_single_image(img, i) for i, img in enumerate(image_list)]
-        saved_paths = await asyncio.gather(*tasks)
-        
-        return saved_paths