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

webscout/update_checker.py

@@ -1,118 +1,118 @@
-import importlib.metadata
-from typing import Optional, Dict, Any, Literal
-import requests
-from packaging import version
-
-# Constants
-PYPI_URL = "https://pypi.org/pypi/webscout/json"
-YOUTUBE_URL = "https://youtube.com/@OEvortex"
-
-# Create a session for HTTP requests
-session = requests.Session()
-
-# Version comparison result type
-VersionCompareResult = Literal[-1, 0, 1]
-
-def get_package_version(package_name: str) -> Optional[str]:
-    """Get the installed version of a package by name."""
-    try:
-        return importlib.metadata.version(package_name)
-    except importlib.metadata.PackageNotFoundError:
-        return None
-
-def get_installed_version() -> Optional[str]:
-    """Get the currently installed version of webscout.
-
-    Returns:
-        Optional[str]: The installed version string or None if not found
-
-    Examples:
-        >>> version = get_installed_version()
-        >>> print(version)
-        '1.2.3'
-    """
-    return get_package_version('webscout')
-
-def get_pypi_version() -> Optional[str]:
-    """Get the latest version available on PyPI.
-
-    Returns:
-        Optional[str]: The latest version string or None if retrieval failed
-
-    Examples:
-        >>> latest = get_pypi_version()
-        >>> print(latest)
-        '2.0.0'
-    """
-    try:
-        response = session.get(PYPI_URL, timeout=10)
-        response.raise_for_status()
-        data: Dict[str, Any] = response.json()
-        return data.get('info', {}).get('version')
-    except (requests.RequestException, KeyError, ValueError):
-        return None
-
-def version_compare(v1: str, v2: str) -> VersionCompareResult:
-    """Compare two version strings.
-
-    Returns:
-        -1 if v1 < v2, 1 if v1 > v2, 0 if equal or invalid
-
-    Examples:
-        >>> version_compare('1.0.0', '2.0.0')
-        -1
-    """
-    try:
-        version1 = version.parse(v1)
-        version2 = version.parse(v2)
-        if version1 < version2:
-            return -1
-        if version1 > version2:
-            return 1
-        return 0
-    except Exception:
-        return 0
-
-def get_update_message(installed: str, latest: str) -> str:
-    """Generate appropriate update message based on version comparison."""
-    comparison_result = version_compare(installed, latest)
-    youtube_msg = f'\033[1;32mSubscribe to my YouTube Channel: {YOUTUBE_URL}\033[0m'
-    if comparison_result < 0:
-        # Bold red for update available
-        return (
-            f"\033[1;31mNew Webscout version available: {latest} "
-            f"- Update with: pip install --upgrade webscout\033[0m\n{youtube_msg}"
-        )
-    elif comparison_result > 0:
-        # Bold yellow for dev version
-        return (
-            f"\033[1;33mYou're running a development version ({installed}) "
-            f"ahead of latest release ({latest})\033[0m\n{youtube_msg}"
-        )
-    # Bold green for up-to-date
-
-def check_for_updates() -> Optional[str]:
-    """Check if a newer version of Webscout is available.
-
-    Returns:
-        Optional[str]: Update message if newer version exists, None otherwise
-    """
-    installed_version = get_installed_version()
-    if not installed_version:
-        return "\033[1;31mWebscout is not installed.\033[0m"
-
-    latest_version = get_pypi_version()
-    if not latest_version:
-        return "\033[1;31mCould not retrieve latest version from PyPI.\033[0m"
-
-    return get_update_message(installed_version, latest_version)
-
-if __name__ == "__main__":
-    try:
-        update_message = check_for_updates()
-        if update_message:
-            print(update_message)
-    except KeyboardInterrupt:
-        print("\nUpdate check canceled by user.")
-    except Exception as e:
+import importlib.metadata
+from typing import Optional, Dict, Any, Literal
+import requests
+from packaging import version
+
+# Constants
+PYPI_URL = "https://pypi.org/pypi/webscout/json"
+YOUTUBE_URL = "https://youtube.com/@OEvortex"
+
+# Create a session for HTTP requests
+session = requests.Session()
+
+# Version comparison result type
+VersionCompareResult = Literal[-1, 0, 1]
+
+def get_package_version(package_name: str) -> Optional[str]:
+    """Get the installed version of a package by name."""
+    try:
+        return importlib.metadata.version(package_name)
+    except importlib.metadata.PackageNotFoundError:
+        return None
+
+def get_installed_version() -> Optional[str]:
+    """Get the currently installed version of webscout.
+
+    Returns:
+        Optional[str]: The installed version string or None if not found
+
+    Examples:
+        >>> version = get_installed_version()
+        >>> print(version)
+        '1.2.3'
+    """
+    return get_package_version('webscout')
+
+def get_pypi_version() -> Optional[str]:
+    """Get the latest version available on PyPI.
+
+    Returns:
+        Optional[str]: The latest version string or None if retrieval failed
+
+    Examples:
+        >>> latest = get_pypi_version()
+        >>> print(latest)
+        '2.0.0'
+    """
+    try:
+        response = session.get(PYPI_URL, timeout=10)
+        response.raise_for_status()
+        data: Dict[str, Any] = response.json()
+        return data.get('info', {}).get('version')
+    except (requests.RequestException, KeyError, ValueError):
+        return None
+
+def version_compare(v1: str, v2: str) -> VersionCompareResult:
+    """Compare two version strings.
+
+    Returns:
+        -1 if v1 < v2, 1 if v1 > v2, 0 if equal or invalid
+
+    Examples:
+        >>> version_compare('1.0.0', '2.0.0')
+        -1
+    """
+    try:
+        version1 = version.parse(v1)
+        version2 = version.parse(v2)
+        if version1 < version2:
+            return -1
+        if version1 > version2:
+            return 1
+        return 0
+    except Exception:
+        return 0
+
+def get_update_message(installed: str, latest: str) -> str:
+    """Generate appropriate update message based on version comparison."""
+    comparison_result = version_compare(installed, latest)
+    youtube_msg = f'\033[1;32mSubscribe to my YouTube Channel: {YOUTUBE_URL}\033[0m'
+    if comparison_result < 0:
+        # Bold red for update available
+        return (
+            f"\033[1;31mNew Webscout version available: {latest} "
+            f"- Update with: pip install --upgrade webscout\033[0m\n{youtube_msg}"
+        )
+    elif comparison_result > 0:
+        # Bold yellow for dev version
+        return (
+            f"\033[1;33mYou're running a development version ({installed}) "
+            f"ahead of latest release ({latest})\033[0m\n{youtube_msg}"
+        )
+    # Bold green for up-to-date
+
+def check_for_updates() -> Optional[str]:
+    """Check if a newer version of Webscout is available.
+
+    Returns:
+        Optional[str]: Update message if newer version exists, None otherwise
+    """
+    installed_version = get_installed_version()
+    if not installed_version:
+        return "\033[1;31mWebscout is not installed.\033[0m"
+
+    latest_version = get_pypi_version()
+    if not latest_version:
+        return "\033[1;31mCould not retrieve latest version from PyPI.\033[0m"
+
+    return get_update_message(installed_version, latest_version)
+
+if __name__ == "__main__":
+    try:
+        update_message = check_for_updates()
+        if update_message:
+            print(update_message)
+    except KeyboardInterrupt:
+        print("\nUpdate check canceled by user.")
+    except Exception as e:
         print(f"\033[1;31mUpdate check failed: {str(e)}\033[0m")

webscout/version.py

@@ -1,2 +1,2 @@
-__version__ = "8.3.7"
+__version__ = "2025.10.13"
 __prog__ = "webscout"

webscout/version.py.bak

@@ -0,0 +1,2 @@
+__version__ = "2025.10.11"
+__prog__ = "webscout"

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