webscout 8.2.2__py3-none-any.whl → 2026.1.19__py3-none-any.whl

webscout/zeroart/__init__.py

@@ -1,55 +1,218 @@
-"""
-ZeroArt: A zero-dependency ASCII art text generator
-
-Create awesome ASCII art text without external dependencies!
-"""
-
-from .base import ZeroArtFont
-from .fonts import BlockFont, SlantFont, NeonFont, CyberFont
-from .effects import AsciiArtEffects
-
-def figlet_format(text, font='block'):
-    """
-    Generate ASCII art text
-    
-    :param text: Text to convert
-    :param font: Font style (default: 'block')
-    :return: ASCII art representation of text
-    """
-    font_map = {
-        'block': BlockFont(),
-        'slant': SlantFont(),
-        'neon': NeonFont(),
-        'cyber': CyberFont()
-    }
-    
-    selected_font = font_map.get(font.lower(), BlockFont())
-    return selected_font.render(text)
-
-def print_figlet(text, font='block'):
-    """
-    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
-rainbow = AsciiArtEffects.rainbow_effect
-glitch = AsciiArtEffects.glitch_effect
-wrap_text = AsciiArtEffects.wrap_text
-outline = AsciiArtEffects.outline_effect
-
-__all__ = [
-    'figlet_format', 
-    'print_figlet', 
-    'rainbow', 
-    'glitch', 
-    'wrap_text', 
-    'outline',
-    'BlockFont', 
-    'SlantFont', 
-    'NeonFont', 
-    'CyberFont'
-]
+"""
+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 .effects import AsciiArtEffects
+from .fonts import (
+    BlockFont,
+    CyberFont,
+    DottedFont,
+    ElectronicFont,
+    IsometricFont,
+    NeonFont,
+    ShadowFont,
+    SlantFont,
+    ThreeDFont,
+)
+
+FontType = Literal['block', 'slant', 'neon', 'cyber', 'dotted', 'shadow', '3d', 'electronic', 'isometric']
+
+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(),
+        '3d': ThreeDFont(),
+        'electronic': ElectronicFont(),
+        'isometric': IsometricFont()
+    }
+
+    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(),
+        '3d': ThreeDFont(),
+        'electronic': ElectronicFont(),
+        'isometric': IsometricFont()
+    }
+
+    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(),
+        '3d': ThreeDFont(),
+        'electronic': ElectronicFont(),
+        'isometric': IsometricFont()
+    }
+
+    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(),
+        '3d': ThreeDFont(),
+        'electronic': ElectronicFont(),
+        'isometric': IsometricFont()
+    }
+
+    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)
+
+def gradient(text: str, font: Union[str, ZeroArtFont] = 'block', color1: tuple = (255, 0, 0), color2: tuple = (0, 0, 255)) -> str:
+    """
+    Apply a gradient color effect to ASCII art
+
+    :param text: Text to render
+    :param font: Font style (default: 'block')
+    :param color1: Starting RGB color
+    :param color2: Ending RGB color
+    :return: Gradient-styled ASCII art
+    """
+    font_map: Dict[str, ZeroArtFont] = {
+        'block': BlockFont(),
+        'slant': SlantFont(),
+        'neon': NeonFont(),
+        'cyber': CyberFont(),
+        'dotted': DottedFont(),
+        'shadow': ShadowFont(),
+        '3d': ThreeDFont(),
+        'electronic': ElectronicFont(),
+        'isometric': IsometricFont()
+    }
+
+    if isinstance(font, str):
+        selected_font: ZeroArtFont = font_map.get(font.lower(), BlockFont())
+    else:
+        selected_font = font
+    return AsciiArtEffects.gradient_effect(text, selected_font, color1, color2)
+
+def bounce(text: str, font: Union[str, ZeroArtFont] = 'block', bounce_height: int = 2) -> str:
+    """
+    Create a bouncing text effect
+
+    :param text: Text to render
+    :param font: Font style (default: 'block')
+    :param bounce_height: Height of the bounce
+    :return: Bouncing ASCII art
+    """
+    font_map: Dict[str, ZeroArtFont] = {
+        'block': BlockFont(),
+        'slant': SlantFont(),
+        'neon': NeonFont(),
+        'cyber': CyberFont(),
+        'dotted': DottedFont(),
+        'shadow': ShadowFont(),
+        '3d': ThreeDFont(),
+        'electronic': ElectronicFont(),
+        'isometric': IsometricFont()
+    }
+
+    if isinstance(font, str):
+        selected_font: ZeroArtFont = font_map.get(font.lower(), BlockFont())
+    else:
+        selected_font = font
+    return AsciiArtEffects.bouncing_effect(text, selected_font, bounce_height)
+
+__all__ = [
+    'figlet_format',
+    'print_figlet',
+    'rainbow',
+    'glitch',
+    'wrap_text',
+    'outline',
+    'gradient',
+    'bounce',
+    'BlockFont',
+    'SlantFont',
+    'NeonFont',
+    'CyberFont',
+    'DottedFont',
+    'ShadowFont',
+    'ThreeDFont',
+    'ElectronicFont',
+    'IsometricFont',
+    'ZeroArtFont',
+    'FontType'
+]

webscout/zeroart/base.py

@@ -1,60 +1,70 @@
-"""
-ZeroArt Base: Core classes and utilities for ASCII art generation
-"""
-
-class ZeroArtFont:
-    """Base class for ASCII art fonts"""
-    def __init__(self, name):
-        self.name = name
-        self.letters = {}
-        self.special_chars = {}
-
-    def add_letter(self, char, art_lines):
-        """
-        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, art_lines):
-        """
-        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):
-        """
-        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):
-        if not text:
-            return ""
-            
-        # Get the maximum height of any character in the font
-        max_height = max(len(self.get_letter(c)) for c in text)
-        
-        # Initialize art_lines with empty strings
-        art_lines = ["" for _ in range(max_height)]
-        
-        # Process each character
-        for char in text:
-            char_art = 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
+
+
+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 text
+        """
+        if not text:
+            return ""
+
+        # Get maximum height of any character in 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)

webscout/zeroart/effects.py

@@ -1,99 +1,155 @@
-"""
-ZeroArt Effects: ASCII art text effects and transformations
-"""
-
-import random
-import textwrap
- 
-class AsciiArtEffects:
-    """Collection of ASCII art text effects"""
-    
-    @staticmethod
-    def rainbow_effect(text, font):
-        """
-        Apply a rainbow-like color effect to ASCII art
-        
-        :param text: Text to render
-        :param font: Font to use
-        :return: Rainbow-styled ASCII art
-        """
-        colors = [
-            '\033[91m',  # Red
-            '\033[93m',  # Yellow
-            '\033[92m',  # Green
-            '\033[94m',  # Blue
-            '\033[95m',  # Magenta
-        ]
-        
-        art = font.render(text)
-        art_lines = art.split('\n')
-        
-        colored_lines = []
-        for line in art_lines:
-            colored_line = ''
-            for char in line:
-                color = random.choice(colors)
-                colored_line += color + char
-            colored_lines.append(colored_line + '\033[0m')  # Reset color
-        
-        return '\n'.join(colored_lines)
-
-    @staticmethod
-    def glitch_effect(text, font, glitch_intensity=0.1):
-        """
-        Apply a glitch-like distortion to ASCII art
-        
-        :param text: Text to render
-        :param font: Font to use
-        :param glitch_intensity: Probability of character distortion
-        :return: Glitched ASCII art
-        """
-        art = font.render(text)
-        art_lines = art.split('\n')
-        
-        glitched_lines = []
-        glitch_chars = ['~', '^', '`', '¯', '±']
-        
-        for line in art_lines:
-            glitched_line = ''
-            for char in line:
-                if random.random() < glitch_intensity:
-                    glitched_line += random.choice(glitch_chars)
-                else:
-                    glitched_line += char
-            glitched_lines.append(glitched_line)
-        
-        return '\n'.join(glitched_lines)
-
-    @staticmethod
-    def wrap_text(text, width=20):
-        """
-        Wrap ASCII art text to a specific width
-        
-        :param text: Text to wrap
-        :param width: Maximum line width
-        :return: Wrapped text
-        """
-        return textwrap.fill(text, width=width)
-
-    @staticmethod
-    def outline_effect(text, font, outline_char='*'):
-        """
-        Add an outline effect to ASCII art
-        
-        :param text: Text to render
-        :param font: Font to use
-        :param outline_char: Character to use for outline
-        :return: ASCII art with outline
-        """
-        art = font.render(text)
-        art_lines = art.split('\n')
-        
-        outlined_lines = []
-        for line in art_lines:
-            outlined_line = outline_char + line + outline_char
-            outlined_lines.append(outlined_line)
-        
-        top_bottom_line = outline_char * (len(outlined_lines[0]))
-        
-        return '\n'.join([top_bottom_line] + outlined_lines + [top_bottom_line])
+"""
+ZeroArt Effects: ASCII art text effects and transformations
+"""
+
+import random
+import textwrap
+from typing import List, Optional
+
+from .base import ZeroArtFont
+
+
+class AsciiArtEffects:
+    """Collection of ASCII art text effects"""
+
+    @staticmethod
+    def rainbow_effect(text: str, font: ZeroArtFont) -> str:
+        """
+        Apply a rainbow-like color effect to ASCII art
+
+        :param text: Text to render
+        :param font: Font to use
+        :return: Rainbow-styled ASCII art
+        """
+        colors: List[str] = [
+            "\033[91m",  # Red
+            "\033[93m",  # Yellow
+            "\033[92m",  # Green
+            "\033[94m",  # Blue
+            "\033[95m",  # Magenta
+        ]
+
+        art: str = font.render(text)
+        art_lines: List[str] = art.split("\n")
+
+        colored_lines: List[str] = []
+        for line in art_lines:
+            colored_line: str = ""
+            for char in line:
+                color: str = random.choice(colors)
+                colored_line += color + char
+            colored_lines.append(colored_line + "\033[0m")  # Reset color
+
+        return "\n".join(colored_lines)
+
+    @staticmethod
+    def glitch_effect(text: str, font: ZeroArtFont, glitch_intensity: float = 0.1) -> str:
+        """
+        Apply a glitch-like distortion to ASCII art
+
+        :param text: Text to render
+        :param font: Font to use
+        :param glitch_intensity: Probability of character distortion
+        :return: Glitched ASCII art
+        """
+        art: str = font.render(text)
+        art_lines: List[str] = art.split("\n")
+
+        glitched_lines: List[str] = []
+        glitch_chars: List[str] = ["~", "^", "`", "¯", "±"]
+
+        for line in art_lines:
+            glitched_line: str = ""
+            for char in line:
+                if random.random() < glitch_intensity:
+                    glitched_line += random.choice(glitch_chars)
+                else:
+                    glitched_line += char
+            glitched_lines.append(glitched_line)
+
+        return "\n".join(glitched_lines)
+
+    @staticmethod
+    def wrap_text(text: str, width: int = 20) -> str:
+        """
+        Wrap ASCII art text to a specific width
+
+        :param text: Text to wrap
+        :param width: Maximum line width
+        :return: Wrapped text
+        """
+        return textwrap.fill(text, width=width)
+
+    @staticmethod
+    def outline_effect(text: str, font: ZeroArtFont, outline_char: str = "*") -> str:
+        """
+        Add an outline effect to ASCII art
+
+        :param text: Text to render
+        :param font: Font to use
+        :param outline_char: Character to use for outline
+        :return: ASCII art with outline
+        """
+        art: str = font.render(text)
+        art_lines: List[str] = art.split("\n")
+
+        outlined_lines: List[str] = []
+        for line in art_lines:
+            outlined_line: str = outline_char + line + outline_char
+            outlined_lines.append(outlined_line)
+
+        top_bottom_line: str = outline_char * (len(outlined_lines[0]))
+
+        return "\n".join([top_bottom_line] + outlined_lines + [top_bottom_line])
+
+    @staticmethod
+    def gradient_effect(
+        text: str, font: ZeroArtFont, color1: tuple = (255, 0, 0), color2: tuple = (0, 0, 255)
+    ) -> str:
+        """
+        Apply a gradient color effect to ASCII art
+
+        :param text: Text to render
+        :param font: Font to use
+        :param color1: Starting RGB color
+        :param color2: Ending RGB color
+        :return: Gradient-styled ASCII art
+        """
+        art: str = font.render(text)
+        art_lines: List[str] = art.split("\n")
+
+        gradient_lines: List[str] = []
+        num_lines = len(art_lines)
+
+        for i, line in enumerate(art_lines):
+            # Calculate interpolated color
+            ratio = i / max(1, num_lines - 1)
+            r = int(color1[0] * (1 - ratio) + color2[0] * ratio)
+            g = int(color1[1] * (1 - ratio) + color2[1] * ratio)
+            b = int(color1[2] * (1 - ratio) + color2[2] * ratio)
+
+            # Apply ANSI color
+            colored_line = f"\033[38;2;{r};{g};{b}m{line}\033[0m"
+            gradient_lines.append(colored_line)
+
+        return "\n".join(gradient_lines)
+
+    @staticmethod
+    def bouncing_effect(text: str, font: ZeroArtFont, bounce_height: int = 2) -> str:
+        """
+        Create a bouncing text effect
+
+        :param text: Text to render
+        :param font: Font to use
+        :param bounce_height: Height of bounce
+        :return: Bouncing ASCII art
+        """
+        art: str = font.render(text)
+        art_lines: List[str] = art.split("\n")
+
+        bouncing_lines: List[str] = []
+        for i, line in enumerate(art_lines):
+            offset = abs(bounce_height - i % (2 * bounce_height))
+            bouncing_lines.append(" " * offset + line)
+
+        return "\n".join(bouncing_lines)