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

webscout/zeroart/base.py

@@ -0,0 +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)

webscout/zeroart/effects.py

@@ -0,0 +1,101 @@
+"""
+ZeroArt Effects: ASCII art text effects and transformations
+"""
+
+import random
+import textwrap
+from typing import List, Optional, Union
+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])