spanlogger 1.0.0__tar.gz

spanlogger-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rowsvips
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

spanlogger-1.0.0/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: spanlogger
+Version: 1.0.0
+Summary: Professional colored terminal logger with timestamps, symbols, and title bar support.
+Author: rowsvips
+License: MIT
+Project-URL: Homepage, https://vmshops.mysellauth.com
+Keywords: logger,terminal,colored,console,logging,ansi,cli
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# spanlogger
+
+Professional colored terminal logger for Python by **rowsvips**.
+
+Zero dependencies. Thread-safe. Windows & Linux compatible.
+
+## Install
+
+```bash
+pip install spanlogger
+```
+
+## Quick Start
+
+```python
+from spanlogger import Logger, Colors
+
+log = Logger(title="MyApp", show_time=True)
+
+log.info("Application started")
+log.success("Connected to server")
+log.warning("Rate limit approaching")
+log.error("Connection failed")
+log.money("Payment received [$50.00]")
+log.debug("Internal state: ok")
+log.captcha("Captcha detected on session_abc****")
+log.custom("Special event", symbol="★", color=Colors.BRIGHT_YELLOW)
+```
+
+## Output
+
+```
+07:23 AM [¥] Application started
+07:23 AM [+] Connected to server
+07:23 AM [!] Rate limit approaching
+07:23 AM [-] Connection failed
+07:23 AM [$] Payment received [$50.00]
+07:23 AM [~] Internal state: ok
+07:23 AM [¥] Captcha detected on session_abc****
+07:23 AM [★] Special event
+```
+
+## Title Bar
+
+```python
+log.print_title_bar(
+    "MyApp v1.0",
+    "@rowsvips",
+    "vmshops.mysellauth.com",
+    stats={"Success": 10, "Failed": 2}
+)
+```
+
+```
+────────────────────────────────────────────────────────────────────────────────
+ MyApp v1.0 | @rowsvips | vmshops.mysellauth.com | Success: 10 - Failed: 2
+────────────────────────────────────────────────────────────────────────────────
+```
+
+## Console Window Title
+
+```python
+log.set_title("MyApp v1.0", "@rowsvips")
+log.set_title_stats(Success=10, Failed=2, Captcha=5)
+```
+
+## Counter System
+
+```python
+log.increment("success")
+log.increment("failed", 3)
+
+print(log.get_count("success"))
+print(log.get_all_counts())
+
+log.reset_counts()
+```
+
+## Contextual Helpers
+
+```python
+log.redeemed("code_abc****", "session_123****", "[AT: 2.5s | Type: Premium]")
+log.failed("Process Task", "Error: session expired")
+log.added("Account", "user_xyz****", "session_123****")
+log.removed("Session", "session_old****")
+log.thread_sleep(5, "Before retry")
+```
+
+## Custom Symbols & Colors
+
+```python
+log.custom("Diamond", symbol="♦", color=Colors.BRIGHT_MAGENTA)
+log.custom("Heart", symbol="♥", color=Colors.BRIGHT_RED)
+log.custom("Arrow", symbol="→", color=Colors.BRIGHT_CYAN)
+```
+
+## Inline Colored Text
+
+```python
+token = Logger.colorize("session_abc****", Colors.BRIGHT_CYAN)
+log.info(f"Processing on {token}")
+
+log.info(f"Status: {Logger.bold('ACTIVE')}")
+```
+
+## Utilities
+
+```python
+log.separator()
+log.separator(char="=", length=40, color=Colors.CYAN)
+
+log.blank()
+log.clear()
+
+log.banner("All Done!", color=Colors.BRIGHT_GREEN, width=50)
+```
+
+## Options
+
+| Parameter | Default | Description |
+|---|---|---|
+| `title` | `"Application"` | Application title |
+| `show_time` | `True` | Show timestamps |
+| `time_format` | `"%I:%M %p"` | Time format (12h AM/PM) |
+| `title_separator` | `" \| "` | Separator for title parts |
+| `title_color` | `Colors.CYAN` | Title bar color |
+| `time_color` | `Colors.BRIGHT_BLACK` | Timestamp color |
+| `bracket_style` | `"square"` | Bracket style: square, round, angle, curly |
+| `log_file` | `None` | Optional file path to save logs |
+
+## Log File
+
+```python
+log = Logger(log_file="app.log")
+log.info("This goes to terminal AND file")
+```
+
+## Log Levels
+
+| Method | Symbol | Color |
+|---|---|---|
+| `info()` | `[¥]` | Cyan |
+| `success()` | `[+]` | Green |
+| `warning()` | `[!]` | Yellow |
+| `error()` | `[-]` | Red |
+| `money()` | `[$]` | Bright Green |
+| `input_log()` | `[>]` | Magenta |
+| `debug()` | `[~]` | Gray |
+| `captcha()` | `[¥]` | Yellow |
+| `custom()` | Custom | Custom |
+
+## Default Instance
+
+```python
+from spanlogger import log
+
+log.info("Quick access without creating an instance")
+```
+
+## License
+
+MIT - by rowsvips | vmshops.mysellauth.com

spanlogger-1.0.0/README.md

@@ -0,0 +1,162 @@
+# spanlogger
+
+Professional colored terminal logger for Python by **rowsvips**.
+
+Zero dependencies. Thread-safe. Windows & Linux compatible.
+
+## Install
+
+```bash
+pip install spanlogger
+```
+
+## Quick Start
+
+```python
+from spanlogger import Logger, Colors
+
+log = Logger(title="MyApp", show_time=True)
+
+log.info("Application started")
+log.success("Connected to server")
+log.warning("Rate limit approaching")
+log.error("Connection failed")
+log.money("Payment received [$50.00]")
+log.debug("Internal state: ok")
+log.captcha("Captcha detected on session_abc****")
+log.custom("Special event", symbol="★", color=Colors.BRIGHT_YELLOW)
+```
+
+## Output
+
+```
+07:23 AM [¥] Application started
+07:23 AM [+] Connected to server
+07:23 AM [!] Rate limit approaching
+07:23 AM [-] Connection failed
+07:23 AM [$] Payment received [$50.00]
+07:23 AM [~] Internal state: ok
+07:23 AM [¥] Captcha detected on session_abc****
+07:23 AM [★] Special event
+```
+
+## Title Bar
+
+```python
+log.print_title_bar(
+    "MyApp v1.0",
+    "@rowsvips",
+    "vmshops.mysellauth.com",
+    stats={"Success": 10, "Failed": 2}
+)
+```
+
+```
+────────────────────────────────────────────────────────────────────────────────
+ MyApp v1.0 | @rowsvips | vmshops.mysellauth.com | Success: 10 - Failed: 2
+────────────────────────────────────────────────────────────────────────────────
+```
+
+## Console Window Title
+
+```python
+log.set_title("MyApp v1.0", "@rowsvips")
+log.set_title_stats(Success=10, Failed=2, Captcha=5)
+```
+
+## Counter System
+
+```python
+log.increment("success")
+log.increment("failed", 3)
+
+print(log.get_count("success"))
+print(log.get_all_counts())
+
+log.reset_counts()
+```
+
+## Contextual Helpers
+
+```python
+log.redeemed("code_abc****", "session_123****", "[AT: 2.5s | Type: Premium]")
+log.failed("Process Task", "Error: session expired")
+log.added("Account", "user_xyz****", "session_123****")
+log.removed("Session", "session_old****")
+log.thread_sleep(5, "Before retry")
+```
+
+## Custom Symbols & Colors
+
+```python
+log.custom("Diamond", symbol="♦", color=Colors.BRIGHT_MAGENTA)
+log.custom("Heart", symbol="♥", color=Colors.BRIGHT_RED)
+log.custom("Arrow", symbol="→", color=Colors.BRIGHT_CYAN)
+```
+
+## Inline Colored Text
+
+```python
+token = Logger.colorize("session_abc****", Colors.BRIGHT_CYAN)
+log.info(f"Processing on {token}")
+
+log.info(f"Status: {Logger.bold('ACTIVE')}")
+```
+
+## Utilities
+
+```python
+log.separator()
+log.separator(char="=", length=40, color=Colors.CYAN)
+
+log.blank()
+log.clear()
+
+log.banner("All Done!", color=Colors.BRIGHT_GREEN, width=50)
+```
+
+## Options
+
+| Parameter | Default | Description |
+|---|---|---|
+| `title` | `"Application"` | Application title |
+| `show_time` | `True` | Show timestamps |
+| `time_format` | `"%I:%M %p"` | Time format (12h AM/PM) |
+| `title_separator` | `" \| "` | Separator for title parts |
+| `title_color` | `Colors.CYAN` | Title bar color |
+| `time_color` | `Colors.BRIGHT_BLACK` | Timestamp color |
+| `bracket_style` | `"square"` | Bracket style: square, round, angle, curly |
+| `log_file` | `None` | Optional file path to save logs |
+
+## Log File
+
+```python
+log = Logger(log_file="app.log")
+log.info("This goes to terminal AND file")
+```
+
+## Log Levels
+
+| Method | Symbol | Color |
+|---|---|---|
+| `info()` | `[¥]` | Cyan |
+| `success()` | `[+]` | Green |
+| `warning()` | `[!]` | Yellow |
+| `error()` | `[-]` | Red |
+| `money()` | `[$]` | Bright Green |
+| `input_log()` | `[>]` | Magenta |
+| `debug()` | `[~]` | Gray |
+| `captcha()` | `[¥]` | Yellow |
+| `custom()` | Custom | Custom |
+
+## Default Instance
+
+```python
+from spanlogger import log
+
+log.info("Quick access without creating an instance")
+```
+
+## License
+
+MIT - by rowsvips | vmshops.mysellauth.com

spanlogger-1.0.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "spanlogger"
+version = "1.0.0"
+description = "Professional colored terminal logger with timestamps, symbols, and title bar support."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [
+    {name = "rowsvips"}
+]
+keywords = ["logger", "terminal", "colored", "console", "logging", "ansi", "cli"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: System :: Logging",
+]
+
+[project.urls]
+Homepage = "https://vmshops.mysellauth.com"
+
+[tool.setuptools.packages.find]
+include = ["spanlogger*"]

spanlogger-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

spanlogger-1.0.0/spanlogger/__init__.py

@@ -0,0 +1,5 @@
+from .logger import Logger, Colors, LogLevel, log
+
+__all__ = ["Logger", "Colors", "LogLevel", "log"]
+__version__ = "1.0.0"
+__author__ = "rowsvips"

spanlogger-1.0.0/spanlogger/logger.py

@@ -0,0 +1,335 @@
+import io
+import os
+import sys
+import threading
+from datetime import datetime
+from enum import Enum
+from typing import Optional
+
+
+class Colors:
+    RESET      = "\033[0m"
+    BOLD       = "\033[1m"
+    DIM        = "\033[2m"
+    UNDERLINE  = "\033[4m"
+
+    BLACK      = "\033[30m"
+    RED        = "\033[31m"
+    GREEN      = "\033[32m"
+    YELLOW     = "\033[33m"
+    BLUE       = "\033[34m"
+    MAGENTA    = "\033[35m"
+    CYAN       = "\033[36m"
+    WHITE      = "\033[37m"
+
+    BRIGHT_BLACK   = "\033[90m"
+    BRIGHT_RED     = "\033[91m"
+    BRIGHT_GREEN   = "\033[92m"
+    BRIGHT_YELLOW  = "\033[93m"
+    BRIGHT_BLUE    = "\033[94m"
+    BRIGHT_MAGENTA = "\033[95m"
+    BRIGHT_CYAN    = "\033[96m"
+    BRIGHT_WHITE   = "\033[97m"
+
+    BG_BLACK   = "\033[40m"
+    BG_RED     = "\033[41m"
+    BG_GREEN   = "\033[42m"
+    BG_YELLOW  = "\033[43m"
+    BG_BLUE    = "\033[44m"
+    BG_MAGENTA = "\033[45m"
+    BG_CYAN    = "\033[46m"
+    BG_WHITE   = "\033[47m"
+
+    BG_BRIGHT_BLACK   = "\033[100m"
+    BG_BRIGHT_RED     = "\033[101m"
+    BG_BRIGHT_GREEN   = "\033[102m"
+    BG_BRIGHT_YELLOW  = "\033[103m"
+    BG_BRIGHT_BLUE    = "\033[104m"
+    BG_BRIGHT_MAGENTA = "\033[105m"
+    BG_BRIGHT_CYAN    = "\033[106m"
+    BG_BRIGHT_WHITE   = "\033[107m"
+
+
+class LogLevel(Enum):
+    INFO     = ("¥", Colors.CYAN,          Colors.BRIGHT_CYAN)
+    SUCCESS  = ("+", Colors.GREEN,         Colors.BRIGHT_GREEN)
+    WARNING  = ("!", Colors.YELLOW,        Colors.BRIGHT_YELLOW)
+    ERROR    = ("-", Colors.RED,           Colors.BRIGHT_RED)
+    MONEY    = ("$", Colors.BRIGHT_GREEN,  Colors.BRIGHT_GREEN)
+    INPUT    = (">", Colors.MAGENTA,       Colors.BRIGHT_MAGENTA)
+    DEBUG    = ("~", Colors.BRIGHT_BLACK,  Colors.BRIGHT_BLACK)
+    CAPTCHA  = ("¥", Colors.YELLOW,        Colors.BRIGHT_YELLOW)
+    CUSTOM   = ("*", Colors.BRIGHT_WHITE,  Colors.BRIGHT_WHITE)
+
+    def __init__(self, symbol: str, bracket_color: str, message_color: str):
+        self.symbol = symbol
+        self.bracket_color = bracket_color
+        self.message_color = message_color
+
+
+class Logger:
+    _lock = threading.Lock()
+
+    def __init__(
+        self,
+        title: str = "Application",
+        show_time: bool = True,
+        time_format: str = "%I:%M %p",
+        title_separator: str = " | ",
+        title_color: str = Colors.CYAN,
+        time_color: str = Colors.BRIGHT_BLACK,
+        bracket_style: str = "square",
+        log_file: Optional[str] = None,
+    ):
+        self.title = title
+        self.show_time = show_time
+        self.time_format = time_format
+        self.title_separator = title_separator
+        self.title_color = title_color
+        self.time_color = time_color
+        self.bracket_style = bracket_style
+        self.log_file = log_file
+        self._counters: dict[str, int] = {}
+        self._title_stats: dict[str, str] = {}
+        self._title_parts: list[str] = []
+
+        if os.name == "nt":
+            self._enable_windows_ansi()
+
+        self._brackets = {
+            "square": ("[", "]"),
+            "round":  ("(", ")"),
+            "angle":  ("<", ">"),
+            "curly":  ("{", "}"),
+        }
+
+    @staticmethod
+    def _enable_windows_ansi():
+        try:
+            import ctypes
+            kernel32 = ctypes.windll.kernel32
+            kernel32.SetConsoleMode(kernel32.GetStdHandle(-11), 7)
+        except Exception:
+            pass
+
+        try:
+            if sys.stdout.encoding and sys.stdout.encoding.lower() != "utf-8":
+                sys.stdout = io.TextIOWrapper(
+                    sys.stdout.buffer, encoding="utf-8", errors="replace", line_buffering=True
+                )
+            if sys.stderr.encoding and sys.stderr.encoding.lower() != "utf-8":
+                sys.stderr = io.TextIOWrapper(
+                    sys.stderr.buffer, encoding="utf-8", errors="replace", line_buffering=True
+                )
+        except Exception:
+            pass
+
+    def _get_brackets(self) -> tuple[str, str]:
+        return self._brackets.get(self.bracket_style, ("[", "]"))
+
+    def _get_timestamp(self) -> str:
+        if not self.show_time:
+            return ""
+        now = datetime.now().strftime(self.time_format)
+        return f"{self.time_color}{now}{Colors.RESET}"
+
+    def _format_message(self, level: LogLevel, message: str, extra_color: Optional[str] = None) -> str:
+        lb, rb = self._get_brackets()
+        color = extra_color or level.message_color
+
+        time_str = self._get_timestamp()
+        time_part = f"{time_str} " if time_str else ""
+
+        symbol_part = (
+            f"{level.bracket_color}{lb}"
+            f"{Colors.BOLD}{level.message_color}{level.symbol}"
+            f"{Colors.RESET}{level.bracket_color}{rb}{Colors.RESET}"
+        )
+
+        msg_part = f"{color}{message}{Colors.RESET}"
+
+        return f"{time_part}{symbol_part} {msg_part}"
+
+    def _write(self, formatted: str, raw_message: str = ""):
+        with self._lock:
+            sys.stdout.write(formatted + "\n")
+            sys.stdout.flush()
+
+            if self.log_file and raw_message:
+                try:
+                    with open(self.log_file, "a", encoding="utf-8") as f:
+                        timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+                        f.write(f"[{timestamp}] {raw_message}\n")
+                except Exception:
+                    pass
+
+    def info(self, message: str):
+        formatted = self._format_message(LogLevel.INFO, message)
+        self._write(formatted, f"[INFO] {message}")
+
+    def success(self, message: str):
+        formatted = self._format_message(LogLevel.SUCCESS, message)
+        self._write(formatted, f"[SUCCESS] {message}")
+
+    def warning(self, message: str):
+        formatted = self._format_message(LogLevel.WARNING, message)
+        self._write(formatted, f"[WARNING] {message}")
+
+    def error(self, message: str):
+        formatted = self._format_message(LogLevel.ERROR, message)
+        self._write(formatted, f"[ERROR] {message}")
+
+    def money(self, message: str):
+        formatted = self._format_message(LogLevel.MONEY, message)
+        self._write(formatted, f"[MONEY] {message}")
+
+    def input_log(self, message: str):
+        formatted = self._format_message(LogLevel.INPUT, message)
+        self._write(formatted, f"[INPUT] {message}")
+
+    def debug(self, message: str):
+        formatted = self._format_message(LogLevel.DEBUG, message)
+        self._write(formatted, f"[DEBUG] {message}")
+
+    def captcha(self, message: str):
+        formatted = self._format_message(LogLevel.CAPTCHA, message)
+        self._write(formatted, f"[CAPTCHA] {message}")
+
+    def custom(self, message: str, symbol: str = "*", color: str = Colors.BRIGHT_WHITE):
+        lb, rb = self._get_brackets()
+        time_str = self._get_timestamp()
+        time_part = f"{time_str} " if time_str else ""
+
+        symbol_part = (
+            f"{color}{lb}"
+            f"{Colors.BOLD}{color}{symbol}"
+            f"{Colors.RESET}{color}{rb}{Colors.RESET}"
+        )
+        msg_part = f"{color}{message}{Colors.RESET}"
+        formatted = f"{time_part}{symbol_part} {msg_part}"
+        self._write(formatted, f"[CUSTOM] {message}")
+
+    def set_title(self, *parts: str):
+        self._title_parts = list(parts)
+        self._refresh_title()
+
+    def set_title_stats(self, **stats: any):
+        for key, value in stats.items():
+            self._title_stats[key] = str(value)
+        self._refresh_title()
+
+    def _refresh_title(self):
+        parts = list(self._title_parts)
+
+        if self._title_stats:
+            stats_str = " - ".join(
+                f"{k}: {v}" for k, v in self._title_stats.items()
+            )
+            parts.append(stats_str)
+
+        full_title = self.title_separator.join(parts)
+
+        sys.stdout.write(f"\033]0;{full_title}\007")
+        sys.stdout.flush()
+
+    def print_title_bar(self, *parts: str, stats: Optional[dict] = None):
+        all_parts = list(parts)
+
+        if stats:
+            stats_parts = []
+            for k, v in stats.items():
+                stats_parts.append(f"{k}: {v}")
+            stats_str = " - ".join(stats_parts)
+            all_parts.append(stats_str)
+
+        separator = f"{Colors.BRIGHT_BLACK}{self.title_separator}{Colors.RESET}"
+        colored_parts = [f"{self.title_color}{p}{Colors.RESET}" for p in all_parts]
+        bar = separator.join(colored_parts)
+
+        with self._lock:
+            sys.stdout.write(f"{Colors.BRIGHT_BLACK}{'─' * 80}{Colors.RESET}\n")
+            sys.stdout.write(f" {bar}\n")
+            sys.stdout.write(f"{Colors.BRIGHT_BLACK}{'─' * 80}{Colors.RESET}\n")
+            sys.stdout.flush()
+
+    def increment(self, key: str, amount: int = 1) -> int:
+        with self._lock:
+            self._counters[key] = self._counters.get(key, 0) + amount
+            return self._counters[key]
+
+    def get_count(self, key: str) -> int:
+        return self._counters.get(key, 0)
+
+    def get_all_counts(self) -> dict[str, int]:
+        return dict(self._counters)
+
+    def reset_counts(self):
+        with self._lock:
+            self._counters.clear()
+
+    def separator(self, char: str = "─", length: int = 60, color: str = Colors.BRIGHT_BLACK):
+        line = f"{color}{char * length}{Colors.RESET}"
+        self._write(line)
+
+    def blank(self):
+        self._write("")
+
+    def banner(self, text: str, color: str = Colors.CYAN, width: int = 60):
+        border = f"{color}{'═' * width}{Colors.RESET}"
+        padded = text.center(width)
+        banner_text = f"{color}{padded}{Colors.RESET}"
+        with self._lock:
+            sys.stdout.write(f"{border}\n{banner_text}\n{border}\n")
+            sys.stdout.flush()
+
+    def clear(self):
+        os.system("cls" if os.name == "nt" else "clear")
+
+    @staticmethod
+    def colorize(text: str, color: str) -> str:
+        return f"{color}{text}{Colors.RESET}"
+
+    @staticmethod
+    def bold(text: str) -> str:
+        return f"{Colors.BOLD}{text}{Colors.RESET}"
+
+    @staticmethod
+    def dim(text: str) -> str:
+        return f"{Colors.DIM}{text}{Colors.RESET}"
+
+    def redeemed(self, promo: str, token: str, details: str = ""):
+        msg = f"Redeemed {Colors.BRIGHT_GREEN}{promo}{Colors.RESET}"
+        msg += f" {Colors.CYAN}On{Colors.RESET} {Colors.BRIGHT_CYAN}{token}{Colors.RESET}"
+        if details:
+            msg += f" {Colors.BRIGHT_BLACK}{details}{Colors.RESET}"
+        formatted = self._format_message(LogLevel.MONEY, msg)
+        self._write(formatted, f"[REDEEMED] {promo} on {token} {details}")
+
+    def failed(self, action: str, reason: str = ""):
+        msg = f"Failed to {Colors.BRIGHT_RED}{action}{Colors.RESET}"
+        if reason:
+            msg += f", {Colors.YELLOW}{reason}{Colors.RESET}"
+        formatted = self._format_message(LogLevel.ERROR, msg)
+        self._write(formatted, f"[FAILED] {action} - {reason}")
+
+    def added(self, item_type: str, item: str, target: str = ""):
+        msg = f"Added {Colors.BRIGHT_GREEN}{item_type}{Colors.RESET} {Colors.GREEN}{item}{Colors.RESET}"
+        if target:
+            msg += f" {Colors.CYAN}To{Colors.RESET} {Colors.BRIGHT_CYAN}{target}{Colors.RESET}"
+        formatted = self._format_message(LogLevel.SUCCESS, msg)
+        self._write(formatted, f"[ADDED] {item_type} {item} to {target}")
+
+    def removed(self, item_type: str, item: str):
+        msg = f"Removed {Colors.YELLOW}{item_type}{Colors.RESET}: {Colors.BRIGHT_YELLOW}{item}{Colors.RESET}"
+        formatted = self._format_message(LogLevel.WARNING, msg)
+        self._write(formatted, f"[REMOVED] {item_type} {item}")
+
+    def thread_sleep(self, seconds: int, reason: str = ""):
+        msg = f"Thread Sleeping for {Colors.BRIGHT_CYAN}{seconds}s{Colors.RESET}"
+        if reason:
+            msg += f" {Colors.BRIGHT_BLACK}{reason}{Colors.RESET}"
+        formatted = self._format_message(LogLevel.INPUT, msg)
+        self._write(formatted, f"[SLEEP] {seconds}s {reason}")
+
+
+log = Logger()

spanlogger-1.0.0/spanlogger.egg-info/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: spanlogger
+Version: 1.0.0
+Summary: Professional colored terminal logger with timestamps, symbols, and title bar support.
+Author: rowsvips
+License: MIT
+Project-URL: Homepage, https://vmshops.mysellauth.com
+Keywords: logger,terminal,colored,console,logging,ansi,cli
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# spanlogger
+
+Professional colored terminal logger for Python by **rowsvips**.
+
+Zero dependencies. Thread-safe. Windows & Linux compatible.
+
+## Install
+
+```bash
+pip install spanlogger
+```
+
+## Quick Start
+
+```python
+from spanlogger import Logger, Colors
+
+log = Logger(title="MyApp", show_time=True)
+
+log.info("Application started")
+log.success("Connected to server")
+log.warning("Rate limit approaching")
+log.error("Connection failed")
+log.money("Payment received [$50.00]")
+log.debug("Internal state: ok")
+log.captcha("Captcha detected on session_abc****")
+log.custom("Special event", symbol="★", color=Colors.BRIGHT_YELLOW)
+```
+
+## Output
+
+```
+07:23 AM [¥] Application started
+07:23 AM [+] Connected to server
+07:23 AM [!] Rate limit approaching
+07:23 AM [-] Connection failed
+07:23 AM [$] Payment received [$50.00]
+07:23 AM [~] Internal state: ok
+07:23 AM [¥] Captcha detected on session_abc****
+07:23 AM [★] Special event
+```
+
+## Title Bar
+
+```python
+log.print_title_bar(
+    "MyApp v1.0",
+    "@rowsvips",
+    "vmshops.mysellauth.com",
+    stats={"Success": 10, "Failed": 2}
+)
+```
+
+```
+────────────────────────────────────────────────────────────────────────────────
+ MyApp v1.0 | @rowsvips | vmshops.mysellauth.com | Success: 10 - Failed: 2
+────────────────────────────────────────────────────────────────────────────────
+```
+
+## Console Window Title
+
+```python
+log.set_title("MyApp v1.0", "@rowsvips")
+log.set_title_stats(Success=10, Failed=2, Captcha=5)
+```
+
+## Counter System
+
+```python
+log.increment("success")
+log.increment("failed", 3)
+
+print(log.get_count("success"))
+print(log.get_all_counts())
+
+log.reset_counts()
+```
+
+## Contextual Helpers
+
+```python
+log.redeemed("code_abc****", "session_123****", "[AT: 2.5s | Type: Premium]")
+log.failed("Process Task", "Error: session expired")
+log.added("Account", "user_xyz****", "session_123****")
+log.removed("Session", "session_old****")
+log.thread_sleep(5, "Before retry")
+```
+
+## Custom Symbols & Colors
+
+```python
+log.custom("Diamond", symbol="♦", color=Colors.BRIGHT_MAGENTA)
+log.custom("Heart", symbol="♥", color=Colors.BRIGHT_RED)
+log.custom("Arrow", symbol="→", color=Colors.BRIGHT_CYAN)
+```
+
+## Inline Colored Text
+
+```python
+token = Logger.colorize("session_abc****", Colors.BRIGHT_CYAN)
+log.info(f"Processing on {token}")
+
+log.info(f"Status: {Logger.bold('ACTIVE')}")
+```
+
+## Utilities
+
+```python
+log.separator()
+log.separator(char="=", length=40, color=Colors.CYAN)
+
+log.blank()
+log.clear()
+
+log.banner("All Done!", color=Colors.BRIGHT_GREEN, width=50)
+```
+
+## Options
+
+| Parameter | Default | Description |
+|---|---|---|
+| `title` | `"Application"` | Application title |
+| `show_time` | `True` | Show timestamps |
+| `time_format` | `"%I:%M %p"` | Time format (12h AM/PM) |
+| `title_separator` | `" \| "` | Separator for title parts |
+| `title_color` | `Colors.CYAN` | Title bar color |
+| `time_color` | `Colors.BRIGHT_BLACK` | Timestamp color |
+| `bracket_style` | `"square"` | Bracket style: square, round, angle, curly |
+| `log_file` | `None` | Optional file path to save logs |
+
+## Log File
+
+```python
+log = Logger(log_file="app.log")
+log.info("This goes to terminal AND file")
+```
+
+## Log Levels
+
+| Method | Symbol | Color |
+|---|---|---|
+| `info()` | `[¥]` | Cyan |
+| `success()` | `[+]` | Green |
+| `warning()` | `[!]` | Yellow |
+| `error()` | `[-]` | Red |
+| `money()` | `[$]` | Bright Green |
+| `input_log()` | `[>]` | Magenta |
+| `debug()` | `[~]` | Gray |
+| `captcha()` | `[¥]` | Yellow |
+| `custom()` | Custom | Custom |
+
+## Default Instance
+
+```python
+from spanlogger import log
+
+log.info("Quick access without creating an instance")
+```
+
+## License
+
+MIT - by rowsvips | vmshops.mysellauth.com

spanlogger-1.0.0/spanlogger.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+spanlogger/__init__.py
+spanlogger/logger.py
+spanlogger.egg-info/PKG-INFO
+spanlogger.egg-info/SOURCES.txt
+spanlogger.egg-info/dependency_links.txt
+spanlogger.egg-info/top_level.txt

spanlogger-1.0.0/spanlogger.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

spanlogger-1.0.0/spanlogger.egg-info/top_level.txt

@@ -0,0 +1 @@
+spanlogger