webscout 8.3.7__py3-none-any.whl → 2025.10.11__py3-none-any.whl

webscout/zeroart/README.md

@@ -1,89 +1,89 @@
-# 🎨 ZeroArt: Zero-Dependency ASCII Art Generator
-
-## 🚀 Overview
-
-ZeroArt is a powerful, lightweight Python library for generating stunning ASCII art text with zero external dependencies. Transform your plain text into eye-catching, stylized art with just a few lines of code!
-
-## ✨ Features
-
-- **Multiple Font Styles**
-  - Block Font
-  - Slant Font
-  - Neon Font
-  - Cyber Font
-
-- **Zero Dependencies**
-  - Completely standalone library
-  - No external package requirements
-
-- **Easy to Use**
-  - Simple, intuitive API
-  - Minimal setup needed
-
-- **Text Effects**
-  - Rainbow coloring
-  - Glitch effect
-  - Text wrapping
-  - Outline generation
-
-## 🛠 Installation
-
-No installation required! Just copy the `zeroart` directory into your project.
-
-## 💻 Usage Examples
-
-### Basic ASCII Art
-
-```python
-from webscout import zeroart
-
-# Generate ASCII art
-art = zeroart.figlet_format("PYTHON", font='block')
-print(art)
-
-# Directly print ASCII art
-zeroart.print_figlet("CODING", font='slant')
-```
-
-### Font Styles
-
-```python
-from webscout import zeroart
-
-# Different font styles
-print(zeroart.figlet_format("AWESOME", font='block'))   # Block style
-print(zeroart.figlet_format("CODING", font='slant'))    # Slant style
-print(zeroart.figlet_format("NEON", font='neon'))       # Neon style
-print(zeroart.figlet_format("CYBER", font='cyber'))     # Cyber style
-```
-
-### Text Effects
-
-```python
-from webscout import zeroart
-
-# Rainbow effect
-print(zeroart.rainbow("COLORFUL", font='neon'))
-
-# Glitch effect
-print(zeroart.glitch("GLITCH", font='cyber'))
-
-# Outline effect
-print(zeroart.outline("BORDER", font='block'))
-```
-
-## 🎨 Available Fonts
-
-1. **Block Font**: Classic, bold block-style letters
-2. **Slant Font**: Elegant, slanted text
-3. **Neon Font**: Glowing, pixel-style art
-4. **Cyber Font**: Cyberpunk-inspired rendering
-
-## 🤝 Contributing
-
-Contributions are welcome! 
-
-- Fork the repository
-- Create a new font
-- Add text effects
-- Improve existing code
+# 🎨 ZeroArt: Zero-Dependency ASCII Art Generator
+
+## 🚀 Overview
+
+ZeroArt is a powerful, lightweight Python library for generating stunning ASCII art text with zero external dependencies. Transform your plain text into eye-catching, stylized art with just a few lines of code!
+
+## ✨ Features
+
+- **Multiple Font Styles**
+  - Block Font
+  - Slant Font
+  - Neon Font
+  - Cyber Font
+
+- **Zero Dependencies**
+  - Completely standalone library
+  - No external package requirements
+
+- **Easy to Use**
+  - Simple, intuitive API
+  - Minimal setup needed
+
+- **Text Effects**
+  - Rainbow coloring
+  - Glitch effect
+  - Text wrapping
+  - Outline generation
+
+## 🛠 Installation
+
+No installation required! Just copy the `zeroart` directory into your project.
+
+## 💻 Usage Examples
+
+### Basic ASCII Art
+
+```python
+from webscout import zeroart
+
+# Generate ASCII art
+art = zeroart.figlet_format("PYTHON", font='block')
+print(art)
+
+# Directly print ASCII art
+zeroart.print_figlet("CODING", font='slant')
+```
+
+### Font Styles
+
+```python
+from webscout import zeroart
+
+# Different font styles
+print(zeroart.figlet_format("AWESOME", font='block'))   # Block style
+print(zeroart.figlet_format("CODING", font='slant'))    # Slant style
+print(zeroart.figlet_format("NEON", font='neon'))       # Neon style
+print(zeroart.figlet_format("CYBER", font='cyber'))     # Cyber style
+```
+
+### Text Effects
+
+```python
+from webscout import zeroart
+
+# Rainbow effect
+print(zeroart.rainbow("COLORFUL", font='neon'))
+
+# Glitch effect
+print(zeroart.glitch("GLITCH", font='cyber'))
+
+# Outline effect
+print(zeroart.outline("BORDER", font='block'))
+```
+
+## 🎨 Available Fonts
+
+1. **Block Font**: Classic, bold block-style letters
+2. **Slant Font**: Elegant, slanted text
+3. **Neon Font**: Glowing, pixel-style art
+4. **Cyber Font**: Cyberpunk-inspired rendering
+
+## 🤝 Contributing
+
+Contributions are welcome! 
+
+- Fork the repository
+- Create a new font
+- Add text effects
+- Improve existing code

webscout/zeroart/__init__.py

@@ -1,135 +1,135 @@
-"""
-ZeroArt: A zero-dependency ASCII art text generator
-
-Create awesome ASCII art text without external dependencies!
-"""
-
-from typing import Dict, List, Literal, Optional, Union
-from .base import ZeroArtFont
-from .fonts import BlockFont, SlantFont, NeonFont, CyberFont, DottedFont, ShadowFont
-from .effects import AsciiArtEffects
-
-FontType = Literal['block', 'slant', 'neon', 'cyber', 'dotted', 'shadow']
-
-def figlet_format(text: str, font: Union[str, ZeroArtFont] = 'block') -> str:
-    """
-    Generate ASCII art text
-    
-    :param text: Text to convert
-    :param font: Font style (default: 'block')
-    :return: ASCII art representation of text
-    """
-    font_map: Dict[str, ZeroArtFont] = {
-        'block': BlockFont(),
-        'slant': SlantFont(),
-        'neon': NeonFont(),
-        'cyber': CyberFont(),
-        'dotted': DottedFont(),
-        'shadow': ShadowFont()
-    }
-    
-    if isinstance(font, str):
-        selected_font: ZeroArtFont = font_map.get(font.lower(), BlockFont())
-    else:
-        selected_font = font
-    return selected_font.render(text)
-
-def print_figlet(text: str, font: Union[str, ZeroArtFont] = 'block') -> None:
-    """
-    Print ASCII art text directly
-    
-    :param text: Text to convert and print
-    :param font: Font style (default: 'block')
-    """
-    print(figlet_format(text, font))
-
-# Expose additional effects with font handling
-def rainbow(text: str, font: Union[str, ZeroArtFont] = 'block') -> str:
-    """
-    Apply a rainbow-like color effect to ASCII art
-    
-    :param text: Text to render
-    :param font: Font style (default: 'block')
-    :return: Rainbow-styled ASCII art
-    """
-    font_map: Dict[str, ZeroArtFont] = {
-        'block': BlockFont(),
-        'slant': SlantFont(),
-        'neon': NeonFont(),
-        'cyber': CyberFont(),
-        'dotted': DottedFont(),
-        'shadow': ShadowFont()
-    }
-    
-    if isinstance(font, str):
-        selected_font: ZeroArtFont = font_map.get(font.lower(), BlockFont())
-    else:
-        selected_font = font
-    return AsciiArtEffects.rainbow_effect(text, selected_font)
-
-def glitch(text: str, font: Union[str, ZeroArtFont] = 'block', glitch_intensity: float = 0.1) -> str:
-    """
-    Apply a glitch-like distortion to ASCII art
-    
-    :param text: Text to render
-    :param font: Font style (default: 'block')
-    :param glitch_intensity: Probability of character distortion
-    :return: Glitched ASCII art
-    """
-    font_map: Dict[str, ZeroArtFont] = {
-        'block': BlockFont(),
-        'slant': SlantFont(),
-        'neon': NeonFont(),
-        'cyber': CyberFont(),
-        'dotted': DottedFont(),
-        'shadow': ShadowFont()
-    }
-    
-    if isinstance(font, str):
-        selected_font: ZeroArtFont = font_map.get(font.lower(), BlockFont())
-    else:
-        selected_font = font
-    return AsciiArtEffects.glitch_effect(text, selected_font, glitch_intensity)
-
-wrap_text = AsciiArtEffects.wrap_text
-
-def outline(text: str, font: Union[str, ZeroArtFont] = 'block', outline_char: str = '*') -> str:
-    """
-    Add an outline effect to ASCII art
-    
-    :param text: Text to render
-    :param font: Font style (default: 'block')
-    :param outline_char: Character to use for outline
-    :return: ASCII art with outline
-    """
-    font_map: Dict[str, ZeroArtFont] = {
-        'block': BlockFont(),
-        'slant': SlantFont(),
-        'neon': NeonFont(),
-        'cyber': CyberFont(),
-        'dotted': DottedFont(),
-        'shadow': ShadowFont()
-    }
-    
-    if isinstance(font, str):
-        selected_font: ZeroArtFont = font_map.get(font.lower(), BlockFont())
-    else:
-        selected_font = font
-    return AsciiArtEffects.outline_effect(text, selected_font, outline_char)
-
-__all__ = [
-    'figlet_format', 
-    'print_figlet', 
-    'rainbow', 
-    'glitch', 
-    'wrap_text', 
-    'outline',
-    'BlockFont', 
-    'SlantFont', 
-    'NeonFont', 
-    'CyberFont',
-    'DottedFont',
-    'ShadowFont',
-    'ZeroArtFont',
-    'FontType'
+"""
+ZeroArt: A zero-dependency ASCII art text generator
+
+Create awesome ASCII art text without external dependencies!
+"""
+
+from typing import Dict, List, Literal, Optional, Union
+from .base import ZeroArtFont
+from .fonts import BlockFont, SlantFont, NeonFont, CyberFont, DottedFont, ShadowFont
+from .effects import AsciiArtEffects
+
+FontType = Literal['block', 'slant', 'neon', 'cyber', 'dotted', 'shadow']
+
+def figlet_format(text: str, font: Union[str, ZeroArtFont] = 'block') -> str:
+    """
+    Generate ASCII art text
+    
+    :param text: Text to convert
+    :param font: Font style (default: 'block')
+    :return: ASCII art representation of text
+    """
+    font_map: Dict[str, ZeroArtFont] = {
+        'block': BlockFont(),
+        'slant': SlantFont(),
+        'neon': NeonFont(),
+        'cyber': CyberFont(),
+        'dotted': DottedFont(),
+        'shadow': ShadowFont()
+    }
+    
+    if isinstance(font, str):
+        selected_font: ZeroArtFont = font_map.get(font.lower(), BlockFont())
+    else:
+        selected_font = font
+    return selected_font.render(text)
+
+def print_figlet(text: str, font: Union[str, ZeroArtFont] = 'block') -> None:
+    """
+    Print ASCII art text directly
+    
+    :param text: Text to convert and print
+    :param font: Font style (default: 'block')
+    """
+    print(figlet_format(text, font))
+
+# Expose additional effects with font handling
+def rainbow(text: str, font: Union[str, ZeroArtFont] = 'block') -> str:
+    """
+    Apply a rainbow-like color effect to ASCII art
+    
+    :param text: Text to render
+    :param font: Font style (default: 'block')
+    :return: Rainbow-styled ASCII art
+    """
+    font_map: Dict[str, ZeroArtFont] = {
+        'block': BlockFont(),
+        'slant': SlantFont(),
+        'neon': NeonFont(),
+        'cyber': CyberFont(),
+        'dotted': DottedFont(),
+        'shadow': ShadowFont()
+    }
+    
+    if isinstance(font, str):
+        selected_font: ZeroArtFont = font_map.get(font.lower(), BlockFont())
+    else:
+        selected_font = font
+    return AsciiArtEffects.rainbow_effect(text, selected_font)
+
+def glitch(text: str, font: Union[str, ZeroArtFont] = 'block', glitch_intensity: float = 0.1) -> str:
+    """
+    Apply a glitch-like distortion to ASCII art
+    
+    :param text: Text to render
+    :param font: Font style (default: 'block')
+    :param glitch_intensity: Probability of character distortion
+    :return: Glitched ASCII art
+    """
+    font_map: Dict[str, ZeroArtFont] = {
+        'block': BlockFont(),
+        'slant': SlantFont(),
+        'neon': NeonFont(),
+        'cyber': CyberFont(),
+        'dotted': DottedFont(),
+        'shadow': ShadowFont()
+    }
+    
+    if isinstance(font, str):
+        selected_font: ZeroArtFont = font_map.get(font.lower(), BlockFont())
+    else:
+        selected_font = font
+    return AsciiArtEffects.glitch_effect(text, selected_font, glitch_intensity)
+
+wrap_text = AsciiArtEffects.wrap_text
+
+def outline(text: str, font: Union[str, ZeroArtFont] = 'block', outline_char: str = '*') -> str:
+    """
+    Add an outline effect to ASCII art
+    
+    :param text: Text to render
+    :param font: Font style (default: 'block')
+    :param outline_char: Character to use for outline
+    :return: ASCII art with outline
+    """
+    font_map: Dict[str, ZeroArtFont] = {
+        'block': BlockFont(),
+        'slant': SlantFont(),
+        'neon': NeonFont(),
+        'cyber': CyberFont(),
+        'dotted': DottedFont(),
+        'shadow': ShadowFont()
+    }
+    
+    if isinstance(font, str):
+        selected_font: ZeroArtFont = font_map.get(font.lower(), BlockFont())
+    else:
+        selected_font = font
+    return AsciiArtEffects.outline_effect(text, selected_font, outline_char)
+
+__all__ = [
+    'figlet_format', 
+    'print_figlet', 
+    'rainbow', 
+    'glitch', 
+    'wrap_text', 
+    'outline',
+    'BlockFont', 
+    'SlantFont', 
+    'NeonFont', 
+    'CyberFont',
+    'DottedFont',
+    'ShadowFont',
+    'ZeroArtFont',
+    'FontType'
 ]

webscout/zeroart/base.py

@@ -1,66 +1,66 @@
-"""
-ZeroArt Base: Core classes and utilities for ASCII art generation
-"""
-from typing import Dict, List, Optional, Union
-
-class ZeroArtFont:
-    """Base class for ASCII art fonts"""
-    def __init__(self, name: str) -> None:
-        self.name: str = name
-        self.letters: Dict[str, List[str]] = {}
-        self.special_chars: Dict[str, List[str]] = {}
-
-    def add_letter(self, char: str, art_lines: List[str]) -> None:
-        """
-        Add a custom letter to the font
-        
-        :param char: Character to add
-        :param art_lines: List of art lines representing the character
-        """
-        self.letters[char.upper()] = art_lines
-
-    def add_special_char(self, name: str, art_lines: List[str]) -> None:
-        """
-        Add a special ASCII art character or design
-        
-        :param name: Name of the special character
-        :param art_lines: List of art lines representing the character
-        """
-        self.special_chars[name] = art_lines
-
-    def get_letter(self, char: str) -> List[str]:
-        """
-        Get ASCII art for a specific character
-        
-        :param char: Character to retrieve
-        :return: List of art lines or default space
-        """
-        return self.letters.get(char.upper(), self.letters.get(' ', [' ']))
-
-    def render(self, text: str) -> str:
-        """
-        Render text as ASCII art
-        
-        :param text: Text to render as ASCII art
-        :return: ASCII art representation of the text
-        """
-        if not text:
-            return ""
-              # Get the maximum height of any character in the font
-        max_height: int = max(len(self.get_letter(c)) for c in text)
-        
-        # Initialize art_lines with empty strings
-        art_lines: List[str] = ["" for _ in range(max_height)]
-        
-        # Process each character
-        for char in text:
-            char_art: List[str] = self.get_letter(char)
-            # 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] + " "
-                
-        return "\n".join(art_lines)
+"""
+ZeroArt Base: Core classes and utilities for ASCII art generation
+"""
+from typing import Dict, List, Optional, Union
+
+class ZeroArtFont:
+    """Base class for ASCII art fonts"""
+    def __init__(self, name: str) -> None:
+        self.name: str = name
+        self.letters: Dict[str, List[str]] = {}
+        self.special_chars: Dict[str, List[str]] = {}
+
+    def add_letter(self, char: str, art_lines: List[str]) -> None:
+        """
+        Add a custom letter to the font
+        
+        :param char: Character to add
+        :param art_lines: List of art lines representing the character
+        """
+        self.letters[char.upper()] = art_lines
+
+    def add_special_char(self, name: str, art_lines: List[str]) -> None:
+        """
+        Add a special ASCII art character or design
+        
+        :param name: Name of the special character
+        :param art_lines: List of art lines representing the character
+        """
+        self.special_chars[name] = art_lines
+
+    def get_letter(self, char: str) -> List[str]:
+        """
+        Get ASCII art for a specific character
+        
+        :param char: Character to retrieve
+        :return: List of art lines or default space
+        """
+        return self.letters.get(char.upper(), self.letters.get(' ', [' ']))
+
+    def render(self, text: str) -> str:
+        """
+        Render text as ASCII art
+        
+        :param text: Text to render as ASCII art
+        :return: ASCII art representation of the text
+        """
+        if not text:
+            return ""
+              # Get the maximum height of any character in the font
+        max_height: int = max(len(self.get_letter(c)) for c in text)
+        
+        # Initialize art_lines with empty strings
+        art_lines: List[str] = ["" for _ in range(max_height)]
+        
+        # Process each character
+        for char in text:
+            char_art: List[str] = self.get_letter(char)
+            # 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] + " "
+                
+        return "\n".join(art_lines)