hexlogger 2.0.1__tar.gz → 2.0.3__tar.gz

{hexlogger-2.0.1 → hexlogger-2.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hexlogger
-Version: 2.0.1
+Version: 2.0.3
 Summary: Premium console logging library with themes, gradients, panels, tables, progress bars, and spinners.
 Author: Itz Montage
 License: MIT
@@ -85,11 +85,11 @@ hexlogger.fatal("Token invalidated — shutting down")
 ---
 
 
-Nine display styles are available. All styles respond to the active theme for color. Switch styles with `hexlogger.set_style(name)`.
+Nine display styles are available. All styles respond to the active theme for color. Switch styles with `hexlogger.setstyle(name)`.
 
 
 ```python
-hexlogger.set_style("default")
+hexlogger.setstyle("default")
 ```
 
 ```
@@ -108,7 +108,7 @@ hexlogger.set_style("default")
 
 
 ```python
-hexlogger.set_style("box")
+hexlogger.setstyle("box")
 ```
 
 ```
@@ -127,7 +127,7 @@ hexlogger.set_style("box")
 
 
 ```python
-hexlogger.set_style("modern")
+hexlogger.setstyle("modern")
 ```
 
 ```
@@ -146,7 +146,7 @@ hexlogger.set_style("modern")
 
 
 ```python
-hexlogger.set_style("bracket")
+hexlogger.setstyle("bracket")
 ```
 
 ```
@@ -165,7 +165,7 @@ hexlogger.set_style("bracket")
 
 
 ```python
-hexlogger.set_style("arrow")
+hexlogger.setstyle("arrow")
 ```
 
 ```
@@ -184,7 +184,7 @@ hexlogger.set_style("arrow")
 
 
 ```python
-hexlogger.set_style("pipe")
+hexlogger.setstyle("pipe")
 ```
 
 ```
@@ -203,7 +203,7 @@ hexlogger.set_style("pipe")
 
 
 ```python
-hexlogger.set_style("tag")
+hexlogger.setstyle("tag")
 ```
 
 ```
@@ -224,7 +224,7 @@ hexlogger.set_style("tag")
 
 
 ```python
-hexlogger.set_style("dots")
+hexlogger.setstyle("dots")
 ```
 
 ```
@@ -243,7 +243,7 @@ hexlogger.set_style("dots")
 
 
 ```python
-hexlogger.set_style("clean")
+hexlogger.setstyle("clean")
 ```
 
 ```
@@ -266,12 +266,12 @@ hexlogger.set_style("clean")
 Six built-in themes control the colors applied to every style. Themes do not affect the structure of the output — only the palette.
 
 ```python
-hexlogger.set_theme("default")   # Soft blue/green palette
-hexlogger.set_theme("neon")      # Vivid cyan/magenta palette
-hexlogger.set_theme("minimal")   # Muted grays, abbreviated labels
-hexlogger.set_theme("hacker")    # Green-on-black matrix palette
-hexlogger.set_theme("sunset")    # Warm orange/red palette
-hexlogger.set_theme("ocean")     # Deep blue/teal palette
+hexlogger.settheme("default")   # Soft blue/green palette
+hexlogger.settheme("neon")      # Vivid cyan/magenta palette
+hexlogger.settheme("minimal")   # Muted grays, abbreviated labels
+hexlogger.settheme("hacker")    # Green-on-black matrix palette
+hexlogger.settheme("sunset")    # Warm orange/red palette
+hexlogger.settheme("ocean")     # Deep blue/teal palette
 ```
 
 The `minimal` theme also uses abbreviated level labels:
@@ -318,7 +318,7 @@ hexlogger._config.add_theme("mytheme", {
     "label_trace":    "TRACE",
 })
 
-hexlogger.set_theme("mytheme")
+hexlogger.settheme("mytheme")
 ```
 
 ---
@@ -347,13 +347,13 @@ hexlogger.blank(2)
 
 
 ```python
-hexlogger.banner("HexLogger\nv2.0.0")
+hexlogger.banner("HexLogger\nv3.0.0")
 ```
 
 ```
 ╔═══════════════╗
 ║   HexLogger   ║
-║    v2.0.0     ║
+║    v3.0.0     ║
 ╚═══════════════╝
 ```
 
@@ -430,31 +430,31 @@ hexlogger.pair("Users",        "94,210")
 
 
 ```python
-hexlogger.gradient_print("Hello World!", (255, 0, 100), (100, 0, 255))
-hexlogger.rainbow_print("Rainbow text!")
+hexlogger.gprint("Hello World!", (255, 0, 100), (100, 0, 255))
+hexlogger.rbprint("Rainbow text!")
 
-text  = hexlogger.gradient_text("Custom gradient", (0, 255, 200), (255, 0, 100))
-multi = hexlogger.multi_gradient_text("Multi-stop", [(255,0,0), (0,255,0), (0,0,255)])
+text  = hexlogger.gtext("Custom gradient", (0, 255, 200), (255, 0, 100))
+multi = hexlogger.mgtext("Multi-stop", [(255,0,0), (0,255,0), (0,0,255)])
 ```
 
 
 ```python
-from hexlogger import bold, italic, underline, colorize, Colors
+from hexlogger import bold, italic, uline, clr, Colors
 
 print(bold("Bold text"))
 print(italic("Italic text"))
-print(underline("Underlined text"))
-print(colorize("Cyan text", Colors.CYAN))
+print(uline("Underlined text"))
+print(clr("Cyan text", Colors.CYAN))
 ```
 
 
 ```python
-from hexlogger import rgb, bg_rgb, hex_color, bg_hex
+from hexlogger import rgb, bgrgb, hexclr, bghex
 
 color    = rgb(255, 128, 0)
-bg       = bg_rgb(30, 30, 30)
-from_hex = hex_color("#FF8800")
-bg_hex_  = bg_hex("#1E1E1E")
+bg       = bgrgb(30, 30, 30)
+from_hex = hexclr("#FF8800")
+bg_hex_  = bghex("#1E1E1E")
 ```
 
 ---
@@ -463,7 +463,7 @@ bg_hex_  = bg_hex("#1E1E1E")
 ```python
 import time
 
-bar = hexlogger.ProgressBar(total=100, label="Downloading", width=40)
+bar = hexlogger.Progress(total=100, label="Downloading", width=40)
 for i in range(100):
     time.sleep(0.05)
     bar.update()
@@ -521,10 +521,10 @@ elapsed = timer.stop()
 
 
 ```python
-hexlogger.set_theme("neon")
-hexlogger.set_style("modern")
-hexlogger.set_log_file("app.log")
-hexlogger.set_min_level("warning")
+hexlogger.settheme("neon")
+hexlogger.setstyle("modern")
+hexlogger.setlog("app.log")
+hexlogger.setlevel("warning")
 
 hexlogger._config.time_format = "%Y-%m-%d %H:%M:%S"
 hexlogger._config.show_time   = False
@@ -534,13 +534,13 @@ hexlogger._config.show_time   = False
 Only messages at or above the configured level are printed.
 
 ```python
-hexlogger.set_min_level("trace")
-hexlogger.set_min_level("debug")
-hexlogger.set_min_level("info")
-hexlogger.set_min_level("warning")
-hexlogger.set_min_level("error")
-hexlogger.set_min_level("critical")
-hexlogger.set_min_level("fatal")
+hexlogger.setlevel("trace")
+hexlogger.setlevel("debug")
+hexlogger.setlevel("info")
+hexlogger.setlevel("warning")
+hexlogger.setlevel("error")
+hexlogger.setlevel("critical")
+hexlogger.setlevel("fatal")
 ```
 
 ---

{hexlogger-2.0.1 → hexlogger-2.0.3}/README.md

@@ -58,11 +58,11 @@ hexlogger.fatal("Token invalidated — shutting down")
 ---
 
 
-Nine display styles are available. All styles respond to the active theme for color. Switch styles with `hexlogger.set_style(name)`.
+Nine display styles are available. All styles respond to the active theme for color. Switch styles with `hexlogger.setstyle(name)`.
 
 
 ```python
-hexlogger.set_style("default")
+hexlogger.setstyle("default")
 ```
 
 ```
@@ -81,7 +81,7 @@ hexlogger.set_style("default")
 
 
 ```python
-hexlogger.set_style("box")
+hexlogger.setstyle("box")
 ```
 
 ```
@@ -100,7 +100,7 @@ hexlogger.set_style("box")
 
 
 ```python
-hexlogger.set_style("modern")
+hexlogger.setstyle("modern")
 ```
 
 ```
@@ -119,7 +119,7 @@ hexlogger.set_style("modern")
 
 
 ```python
-hexlogger.set_style("bracket")
+hexlogger.setstyle("bracket")
 ```
 
 ```
@@ -138,7 +138,7 @@ hexlogger.set_style("bracket")
 
 
 ```python
-hexlogger.set_style("arrow")
+hexlogger.setstyle("arrow")
 ```
 
 ```
@@ -157,7 +157,7 @@ hexlogger.set_style("arrow")
 
 
 ```python
-hexlogger.set_style("pipe")
+hexlogger.setstyle("pipe")
 ```
 
 ```
@@ -176,7 +176,7 @@ hexlogger.set_style("pipe")
 
 
 ```python
-hexlogger.set_style("tag")
+hexlogger.setstyle("tag")
 ```
 
 ```
@@ -197,7 +197,7 @@ hexlogger.set_style("tag")
 
 
 ```python
-hexlogger.set_style("dots")
+hexlogger.setstyle("dots")
 ```
 
 ```
@@ -216,7 +216,7 @@ hexlogger.set_style("dots")
 
 
 ```python
-hexlogger.set_style("clean")
+hexlogger.setstyle("clean")
 ```
 
 ```
@@ -239,12 +239,12 @@ hexlogger.set_style("clean")
 Six built-in themes control the colors applied to every style. Themes do not affect the structure of the output — only the palette.
 
 ```python
-hexlogger.set_theme("default")   # Soft blue/green palette
-hexlogger.set_theme("neon")      # Vivid cyan/magenta palette
-hexlogger.set_theme("minimal")   # Muted grays, abbreviated labels
-hexlogger.set_theme("hacker")    # Green-on-black matrix palette
-hexlogger.set_theme("sunset")    # Warm orange/red palette
-hexlogger.set_theme("ocean")     # Deep blue/teal palette
+hexlogger.settheme("default")   # Soft blue/green palette
+hexlogger.settheme("neon")      # Vivid cyan/magenta palette
+hexlogger.settheme("minimal")   # Muted grays, abbreviated labels
+hexlogger.settheme("hacker")    # Green-on-black matrix palette
+hexlogger.settheme("sunset")    # Warm orange/red palette
+hexlogger.settheme("ocean")     # Deep blue/teal palette
 ```
 
 The `minimal` theme also uses abbreviated level labels:
@@ -291,7 +291,7 @@ hexlogger._config.add_theme("mytheme", {
     "label_trace":    "TRACE",
 })
 
-hexlogger.set_theme("mytheme")
+hexlogger.settheme("mytheme")
 ```
 
 ---
@@ -320,13 +320,13 @@ hexlogger.blank(2)
 
 
 ```python
-hexlogger.banner("HexLogger\nv2.0.0")
+hexlogger.banner("HexLogger\nv3.0.0")
 ```
 
 ```
 ╔═══════════════╗
 ║   HexLogger   ║
-║    v2.0.0     ║
+║    v3.0.0     ║
 ╚═══════════════╝
 ```
 
@@ -403,31 +403,31 @@ hexlogger.pair("Users",        "94,210")
 
 
 ```python
-hexlogger.gradient_print("Hello World!", (255, 0, 100), (100, 0, 255))
-hexlogger.rainbow_print("Rainbow text!")
+hexlogger.gprint("Hello World!", (255, 0, 100), (100, 0, 255))
+hexlogger.rbprint("Rainbow text!")
 
-text  = hexlogger.gradient_text("Custom gradient", (0, 255, 200), (255, 0, 100))
-multi = hexlogger.multi_gradient_text("Multi-stop", [(255,0,0), (0,255,0), (0,0,255)])
+text  = hexlogger.gtext("Custom gradient", (0, 255, 200), (255, 0, 100))
+multi = hexlogger.mgtext("Multi-stop", [(255,0,0), (0,255,0), (0,0,255)])
 ```
 
 
 ```python
-from hexlogger import bold, italic, underline, colorize, Colors
+from hexlogger import bold, italic, uline, clr, Colors
 
 print(bold("Bold text"))
 print(italic("Italic text"))
-print(underline("Underlined text"))
-print(colorize("Cyan text", Colors.CYAN))
+print(uline("Underlined text"))
+print(clr("Cyan text", Colors.CYAN))
 ```
 
 
 ```python
-from hexlogger import rgb, bg_rgb, hex_color, bg_hex
+from hexlogger import rgb, bgrgb, hexclr, bghex
 
 color    = rgb(255, 128, 0)
-bg       = bg_rgb(30, 30, 30)
-from_hex = hex_color("#FF8800")
-bg_hex_  = bg_hex("#1E1E1E")
+bg       = bgrgb(30, 30, 30)
+from_hex = hexclr("#FF8800")
+bg_hex_  = bghex("#1E1E1E")
 ```
 
 ---
@@ -436,7 +436,7 @@ bg_hex_  = bg_hex("#1E1E1E")
 ```python
 import time
 
-bar = hexlogger.ProgressBar(total=100, label="Downloading", width=40)
+bar = hexlogger.Progress(total=100, label="Downloading", width=40)
 for i in range(100):
     time.sleep(0.05)
     bar.update()
@@ -494,10 +494,10 @@ elapsed = timer.stop()
 
 
 ```python
-hexlogger.set_theme("neon")
-hexlogger.set_style("modern")
-hexlogger.set_log_file("app.log")
-hexlogger.set_min_level("warning")
+hexlogger.settheme("neon")
+hexlogger.setstyle("modern")
+hexlogger.setlog("app.log")
+hexlogger.setlevel("warning")
 
 hexlogger._config.time_format = "%Y-%m-%d %H:%M:%S"
 hexlogger._config.show_time   = False
@@ -507,13 +507,13 @@ hexlogger._config.show_time   = False
 Only messages at or above the configured level are printed.
 
 ```python
-hexlogger.set_min_level("trace")
-hexlogger.set_min_level("debug")
-hexlogger.set_min_level("info")
-hexlogger.set_min_level("warning")
-hexlogger.set_min_level("error")
-hexlogger.set_min_level("critical")
-hexlogger.set_min_level("fatal")
+hexlogger.setlevel("trace")
+hexlogger.setlevel("debug")
+hexlogger.setlevel("info")
+hexlogger.setlevel("warning")
+hexlogger.setlevel("error")
+hexlogger.setlevel("critical")
+hexlogger.setlevel("fatal")
 ```
 
 ---

hexlogger-2.0.3/hexlogger/__init__.py

@@ -0,0 +1,25 @@
+__version__ = "2.0.3"
+__author__ = "Montage"
+
+from .colors import Colors, rgb, bgrgb, hexclr, bghex
+from .themes import Theme, THEMES, LEVEL_ICONS
+from .config import LogLevel, LoggerConfig, settheme, setstyle, setlog, setlevel
+from .core import debug, info, success, warn, warning, error, critical, fatal, trace
+from .formatting import divider, section, blank, rule, banner, pair
+from .gradient import gtext, gprint, mgtext, mgprint, rbtext, rbprint
+from .widgets import panel, table, box
+from .progress import Progress, Spinner, Timer
+from .utils import clr, bold, italic, uline
+from . import _compat
+
+__all__ = [
+    "debug", "info", "success", "warn", "warning",
+    "error", "critical", "fatal", "trace",
+    "divider", "section", "blank", "rule", "banner", "pair",
+    "gtext", "gprint", "mgtext", "mgprint", "rbtext", "rbprint",
+    "panel", "table", "box",
+    "Progress", "Spinner", "Timer",
+    "clr", "bold", "italic", "uline",
+    "Colors", "rgb", "bgrgb", "hexclr", "bghex",
+    "Theme", "LogLevel", "settheme", "setstyle", "setlog", "setlevel",
+]

hexlogger-2.0.3/hexlogger/_compat.py

@@ -0,0 +1,9 @@
+import os
+
+if os.name == "nt":
+    try:
+        import ctypes
+        k32 = ctypes.windll.kernel32
+        k32.SetConsoleMode(k32.GetStdHandle(-11), 7)
+    except Exception:
+        pass

hexlogger-2.0.3/hexlogger/colors.py

@@ -0,0 +1,66 @@
+__all__ = ["Colors", "rgb", "bgrgb", "hexclr", "bghex"]
+
+
+class Colors:
+    RESET = "\033[0m"
+    BOLD = "\033[1m"
+    DIM = "\033[2m"
+    ITALIC = "\033[3m"
+    UNDERLINE = "\033[4m"
+    BLINK = "\033[5m"
+    REVERSE = "\033[7m"
+    STRIKE = "\033[9m"
+    BLACK = "\033[30m"
+    RED = "\033[31m"
+    GREEN = "\033[32m"
+    YELLOW = "\033[33m"
+    BLUE = "\033[34m"
+    MAGENTA = "\033[35m"
+    CYAN = "\033[36m"
+    WHITE = "\033[37m"
+    GRAY = "\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"
+
+
+def _clamp(v):
+    return max(0, min(255, int(v)))
+
+def rgb(r, g, b):
+    return f"\033[38;2;{_clamp(r)};{_clamp(g)};{_clamp(b)}m"
+
+def bgrgb(r, g, b):
+    return f"\033[48;2;{_clamp(r)};{_clamp(g)};{_clamp(b)}m"
+
+def hexclr(hex_code):
+    try:
+        hex_code = str(hex_code).lstrip("#")
+        if len(hex_code) < 6:
+            hex_code = hex_code.ljust(6, "0")
+        r, g, b = int(hex_code[0:2], 16), int(hex_code[2:4], 16), int(hex_code[4:6], 16)
+        return rgb(r, g, b)
+    except Exception:
+        return Colors.RESET
+
+def bghex(hex_code):
+    try:
+        hex_code = str(hex_code).lstrip("#")
+        if len(hex_code) < 6:
+            hex_code = hex_code.ljust(6, "0")
+        r, g, b = int(hex_code[0:2], 16), int(hex_code[2:4], 16), int(hex_code[4:6], 16)
+        return bgrgb(r, g, b)
+    except Exception:
+        return Colors.RESET

hexlogger-2.0.3/hexlogger/config.py

@@ -0,0 +1,107 @@
+import threading
+from enum import Enum
+
+from .themes import Theme, THEMES
+from .styles import STYLES
+
+__all__ = ["LogLevel", "LoggerConfig", "get_config", "settheme", "setstyle", "setlog", "setlevel"]
+
+
+class LogLevel(Enum):
+    TRACE = 0
+    DEBUG = 1
+    INFO = 2
+    SUCCESS = 3
+    WARNING = 4
+    ERROR = 5
+    CRITICAL = 6
+    FATAL = 7
+
+
+class LoggerConfig:
+    def __init__(self):
+        self.theme = THEMES.get("default", Theme("default", {}))
+        self.style = "default"
+        self.time_format = "%H:%M:%S"
+        self.show_time = True
+        self.log_file = None
+        self.min_level = LogLevel.TRACE
+        self._file_handle = None
+        self._lock = threading.Lock()
+
+    def set_theme(self, name):
+        if name in THEMES:
+            self.theme = THEMES[name]
+        else:
+            raise ValueError(f"Unknown theme: {name}. Available: {', '.join(THEMES.keys())}")
+
+    def set_style(self, name):
+        if name in STYLES:
+            self.style = name
+        else:
+            raise ValueError(f"Unknown style: {name}. Available: {', '.join(STYLES.keys())}")
+
+    def add_theme(self, name, colors):
+        try:
+            theme = Theme(str(name), colors if isinstance(colors, dict) else {})
+            THEMES[str(name)] = theme
+            return theme
+        except Exception:
+            raise ValueError(f"Failed to add theme: {name}")
+
+    def set_log_file(self, path):
+        try:
+            self.log_file = str(path)
+            if self._file_handle:
+                try:
+                    self._file_handle.close()
+                except Exception:
+                    pass
+            self._file_handle = open(self.log_file, "a", encoding="utf-8")
+        except Exception:
+            self._file_handle = None
+            raise
+
+    def close(self):
+        if self._file_handle:
+            try:
+                self._file_handle.close()
+            except Exception:
+                pass
+            self._file_handle = None
+
+    def __del__(self):
+        self.close()
+
+
+_config = LoggerConfig()
+
+
+def get_config():
+    return _config
+
+
+def settheme(name):
+    _config.set_theme(str(name))
+
+
+def setstyle(name):
+    _config.set_style(str(name))
+
+
+def setlog(path):
+    _config.set_log_file(str(path))
+
+
+def setlevel(level):
+    mapping = {
+        "trace": LogLevel.TRACE, "debug": LogLevel.DEBUG,
+        "info": LogLevel.INFO, "success": LogLevel.SUCCESS,
+        "warning": LogLevel.WARNING, "error": LogLevel.ERROR,
+        "critical": LogLevel.CRITICAL, "fatal": LogLevel.FATAL,
+    }
+    key = str(level).lower().strip()
+    if key in mapping:
+        _config.min_level = mapping[key]
+    else:
+        raise ValueError(f"Unknown level: {level}. Available: {', '.join(mapping.keys())}")

hexlogger-2.0.3/hexlogger/core.py

@@ -0,0 +1,49 @@
+from datetime import datetime
+
+from .config import get_config, LogLevel
+from .styles import STYLES
+from .utils import strip_ansi
+
+__all__ = ["debug", "info", "success", "warn", "warning", "error", "critical", "fatal", "trace"]
+
+
+def _get_time():
+    try:
+        return datetime.now().strftime(get_config().time_format)
+    except Exception:
+        return ""
+
+
+def _log(level, message, level_enum):
+    try:
+        cfg = get_config()
+        if level_enum.value < cfg.min_level.value:
+            return
+        t = cfg.theme
+        now = _get_time()
+        style_fn = STYLES.get(cfg.style, STYLES["default"])
+        line = style_fn(now, level, t.get(level), t.get(f"label_{level}"), str(message), t, cfg.show_time)
+        with cfg._lock:
+            print(line)
+            if cfg._file_handle:
+                try:
+                    cfg._file_handle.write(strip_ansi(line) + "\n")
+                    cfg._file_handle.flush()
+                except Exception:
+                    pass
+    except Exception:
+        try:
+            print(f"[{level.upper()}] {message}")
+        except Exception:
+            pass
+
+
+def debug(msg): _log("debug", msg, LogLevel.DEBUG)
+def info(msg): _log("info", msg, LogLevel.INFO)
+def success(msg): _log("success", msg, LogLevel.SUCCESS)
+def warn(msg): _log("warning", msg, LogLevel.WARNING)
+def warning(msg): _log("warning", msg, LogLevel.WARNING)
+def error(msg): _log("error", msg, LogLevel.ERROR)
+def critical(msg): _log("critical", msg, LogLevel.CRITICAL)
+def fatal(msg): _log("fatal", msg, LogLevel.FATAL)
+def trace(msg): _log("trace", msg, LogLevel.TRACE)