hexlogger 1.0.0__tar.gz

hexlogger-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Montage
+
+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.

hexlogger-1.0.0/PKG-INFO

@@ -0,0 +1,266 @@
+Metadata-Version: 2.4
+Name: hexlogger
+Version: 1.0.0
+Summary: Premium console logging library with themes, gradients, panels, tables, progress bars, and spinners.
+Author: Itz Montage
+License: MIT
+Project-URL: Homepage, https://github.com/Montagexd/hexlogger
+Keywords: logging,console,terminal,colors,logger,hex,ansi
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+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: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Logging
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# 🔮 HexLogger
+
+**Premium console logging library for Python**
+
+A feature-rich, zero-dependency logging library with beautiful colored output, multiple themes, gradient text, panels, tables, progress bars, and spinners.
+
+## Installation
+
+```bash
+pip install hexlogger
+```
+
+## Quick Start
+
+```python
+import hexlogger
+
+hexlogger.debug("Connecting to server...")
+hexlogger.success("Connected!")
+hexlogger.info("Processing 1000 items")
+hexlogger.warn("Rate limit approaching")
+hexlogger.error("Connection failed")
+hexlogger.critical("System overload!")
+```
+
+**Output:**
+```
+[-(14:30:00)-] [ ● ] DEBUG »  Connecting to server...
+[-(14:30:00)-] [ ● ] SUCCESS »  Connected!
+[-(14:30:00)-] [ ● ] INFO »  Processing 1000 items
+[-(14:30:00)-] [ ● ] WARNING »  Rate limit approaching
+[-(14:30:00)-] [ ● ] ERROR »  Connection failed
+[-(14:30:00)-] [ ● ] CRITICAL »  System overload!
+```
+
+## Themes
+
+```python
+import hexlogger
+
+# Available themes: default, neon, minimal, hacker
+hexlogger.set_theme("neon")
+hexlogger.success("Neon vibes!")
+
+hexlogger.set_theme("hacker")
+hexlogger.success("Matrix mode!")
+
+hexlogger.set_theme("minimal")
+hexlogger.success("Clean and simple")
+```
+
+### Custom Themes
+
+```python
+from hexlogger import add_theme, rgb
+
+add_theme("ocean", {
+    "timestamp": rgb(0, 100, 200),
+    "bracket": rgb(0, 80, 160),
+    "dot": rgb(0, 200, 255),
+    "separator": rgb(0, 150, 200),
+    "debug": rgb(100, 180, 255),
+    "info": rgb(0, 200, 255),
+    "success": rgb(0, 255, 200),
+    "warning": rgb(255, 200, 0),
+    "error": rgb(255, 80, 80),
+    "critical": rgb(255, 0, 50),
+    "fatal": rgb(200, 0, 0),
+    "trace": rgb(100, 150, 200),
+    "divider": rgb(0, 60, 100),
+    "label_debug": "DEBUG",
+    "label_info": "INFO",
+    "label_success": "SUCCESS",
+    "label_warning": "WARNING",
+    "label_error": "ERROR",
+    "label_critical": "CRITICAL",
+    "label_fatal": "FATAL",
+    "label_trace": "TRACE",
+})
+
+hexlogger.set_theme("ocean")
+```
+
+## Dividers & Sections
+
+```python
+hexlogger.divider()
+hexlogger.section("RESULTS")
+hexlogger.rule("Settings", char="═")
+hexlogger.blank(2)
+```
+
+## Banner
+
+```python
+hexlogger.banner("HexLogger\nv1.0.0")
+```
+
+```
+╔═══════════════════╗
+║    HexLogger      ║
+║     v1.0.0        ║
+╚═══════════════════╝
+```
+
+## Panel
+
+```python
+hexlogger.panel("Server: online\nPing: 42ms\nUptime: 99.9%", title="Status")
+```
+
+```
+╭─ Status ──────────────────────────────╮
+│ Server: online                        │
+│ Ping: 42ms                            │
+│ Uptime: 99.9%                         │
+╰───────────────────────────────────────╯
+```
+
+## Table
+
+```python
+hexlogger.table(
+    headers=["Name", "Status", "Ping"],
+    rows=[
+        ["Server 1", "Online", "12ms"],
+        ["Server 2", "Offline", "---"],
+        ["Server 3", "Online", "45ms"],
+    ]
+)
+```
+
+## Gradient Text
+
+```python
+hexlogger.gradient_print("Hello World!", (255, 0, 100), (100, 0, 255))
+hexlogger.rainbow_print("Rainbow text!")
+
+# Get gradient string without printing
+text = hexlogger.gradient_text("Custom gradient", (0, 255, 200), (255, 0, 100))
+```
+
+## Progress Bar
+
+```python
+import time
+
+bar = hexlogger.ProgressBar(total=100, label="Downloading")
+for i in range(100):
+    time.sleep(0.05)
+    bar.update()
+```
+
+## Spinner
+
+```python
+import time
+
+# As context manager
+with hexlogger.Spinner("Loading data...", style="dots"):
+    time.sleep(3)
+
+# Manual control
+spinner = hexlogger.Spinner("Processing...", style="circle")
+spinner.start()
+time.sleep(2)
+spinner.stop("Done!")
+
+# Available styles: dots, line, arrow, bounce, box, circle
+```
+
+## Timer
+
+```python
+# As context manager
+with hexlogger.Timer("Database query"):
+    time.sleep(1.5)
+# Output: [INFO] Database query: 1.500s
+
+# Manual control
+timer = hexlogger.Timer("API call")
+timer.start()
+# ... do work ...
+elapsed = timer.stop()
+```
+
+## Key-Value Pairs
+
+```python
+hexlogger.pair("Server", "production-01")
+hexlogger.pair("Status", "running")
+hexlogger.pair("Uptime", "99.97%")
+```
+
+## Text Styling
+
+```python
+from hexlogger import bold, italic, underline, dim, strike, colorize, Colors
+
+print(bold("Bold text"))
+print(italic("Italic text"))
+print(underline("Underlined"))
+print(colorize("Custom color", Colors.CYAN))
+```
+
+## Configuration
+
+```python
+# Set time format
+hexlogger.set_time_format("%Y-%m-%d %H:%M:%S")
+
+# Hide timestamps
+hexlogger.show_time(False)
+
+# Log to file
+hexlogger.set_log_file("app.log")
+
+# Set minimum log level
+hexlogger.set_min_level("warning")  # Only WARNING and above
+```
+
+## Features
+
+- ✅ Zero dependencies
+- ✅ Beautiful colored output
+- ✅ 4 built-in themes + custom themes
+- ✅ Gradient & rainbow text
+- ✅ Panels, tables, banners
+- ✅ Progress bars with ETA
+- ✅ Animated spinners (6 styles)
+- ✅ Timer utility
+- ✅ File logging
+- ✅ Thread-safe
+- ✅ Windows compatible
+- ✅ Python 3.7+
+
+## License
+
+MIT License - Created by Montage

hexlogger-1.0.0/README.md

@@ -0,0 +1,239 @@
+# 🔮 HexLogger
+
+**Premium console logging library for Python**
+
+A feature-rich, zero-dependency logging library with beautiful colored output, multiple themes, gradient text, panels, tables, progress bars, and spinners.
+
+## Installation
+
+```bash
+pip install hexlogger
+```
+
+## Quick Start
+
+```python
+import hexlogger
+
+hexlogger.debug("Connecting to server...")
+hexlogger.success("Connected!")
+hexlogger.info("Processing 1000 items")
+hexlogger.warn("Rate limit approaching")
+hexlogger.error("Connection failed")
+hexlogger.critical("System overload!")
+```
+
+**Output:**
+```
+[-(14:30:00)-] [ ● ] DEBUG »  Connecting to server...
+[-(14:30:00)-] [ ● ] SUCCESS »  Connected!
+[-(14:30:00)-] [ ● ] INFO »  Processing 1000 items
+[-(14:30:00)-] [ ● ] WARNING »  Rate limit approaching
+[-(14:30:00)-] [ ● ] ERROR »  Connection failed
+[-(14:30:00)-] [ ● ] CRITICAL »  System overload!
+```
+
+## Themes
+
+```python
+import hexlogger
+
+# Available themes: default, neon, minimal, hacker
+hexlogger.set_theme("neon")
+hexlogger.success("Neon vibes!")
+
+hexlogger.set_theme("hacker")
+hexlogger.success("Matrix mode!")
+
+hexlogger.set_theme("minimal")
+hexlogger.success("Clean and simple")
+```
+
+### Custom Themes
+
+```python
+from hexlogger import add_theme, rgb
+
+add_theme("ocean", {
+    "timestamp": rgb(0, 100, 200),
+    "bracket": rgb(0, 80, 160),
+    "dot": rgb(0, 200, 255),
+    "separator": rgb(0, 150, 200),
+    "debug": rgb(100, 180, 255),
+    "info": rgb(0, 200, 255),
+    "success": rgb(0, 255, 200),
+    "warning": rgb(255, 200, 0),
+    "error": rgb(255, 80, 80),
+    "critical": rgb(255, 0, 50),
+    "fatal": rgb(200, 0, 0),
+    "trace": rgb(100, 150, 200),
+    "divider": rgb(0, 60, 100),
+    "label_debug": "DEBUG",
+    "label_info": "INFO",
+    "label_success": "SUCCESS",
+    "label_warning": "WARNING",
+    "label_error": "ERROR",
+    "label_critical": "CRITICAL",
+    "label_fatal": "FATAL",
+    "label_trace": "TRACE",
+})
+
+hexlogger.set_theme("ocean")
+```
+
+## Dividers & Sections
+
+```python
+hexlogger.divider()
+hexlogger.section("RESULTS")
+hexlogger.rule("Settings", char="═")
+hexlogger.blank(2)
+```
+
+## Banner
+
+```python
+hexlogger.banner("HexLogger\nv1.0.0")
+```
+
+```
+╔═══════════════════╗
+║    HexLogger      ║
+║     v1.0.0        ║
+╚═══════════════════╝
+```
+
+## Panel
+
+```python
+hexlogger.panel("Server: online\nPing: 42ms\nUptime: 99.9%", title="Status")
+```
+
+```
+╭─ Status ──────────────────────────────╮
+│ Server: online                        │
+│ Ping: 42ms                            │
+│ Uptime: 99.9%                         │
+╰───────────────────────────────────────╯
+```
+
+## Table
+
+```python
+hexlogger.table(
+    headers=["Name", "Status", "Ping"],
+    rows=[
+        ["Server 1", "Online", "12ms"],
+        ["Server 2", "Offline", "---"],
+        ["Server 3", "Online", "45ms"],
+    ]
+)
+```
+
+## Gradient Text
+
+```python
+hexlogger.gradient_print("Hello World!", (255, 0, 100), (100, 0, 255))
+hexlogger.rainbow_print("Rainbow text!")
+
+# Get gradient string without printing
+text = hexlogger.gradient_text("Custom gradient", (0, 255, 200), (255, 0, 100))
+```
+
+## Progress Bar
+
+```python
+import time
+
+bar = hexlogger.ProgressBar(total=100, label="Downloading")
+for i in range(100):
+    time.sleep(0.05)
+    bar.update()
+```
+
+## Spinner
+
+```python
+import time
+
+# As context manager
+with hexlogger.Spinner("Loading data...", style="dots"):
+    time.sleep(3)
+
+# Manual control
+spinner = hexlogger.Spinner("Processing...", style="circle")
+spinner.start()
+time.sleep(2)
+spinner.stop("Done!")
+
+# Available styles: dots, line, arrow, bounce, box, circle
+```
+
+## Timer
+
+```python
+# As context manager
+with hexlogger.Timer("Database query"):
+    time.sleep(1.5)
+# Output: [INFO] Database query: 1.500s
+
+# Manual control
+timer = hexlogger.Timer("API call")
+timer.start()
+# ... do work ...
+elapsed = timer.stop()
+```
+
+## Key-Value Pairs
+
+```python
+hexlogger.pair("Server", "production-01")
+hexlogger.pair("Status", "running")
+hexlogger.pair("Uptime", "99.97%")
+```
+
+## Text Styling
+
+```python
+from hexlogger import bold, italic, underline, dim, strike, colorize, Colors
+
+print(bold("Bold text"))
+print(italic("Italic text"))
+print(underline("Underlined"))
+print(colorize("Custom color", Colors.CYAN))
+```
+
+## Configuration
+
+```python
+# Set time format
+hexlogger.set_time_format("%Y-%m-%d %H:%M:%S")
+
+# Hide timestamps
+hexlogger.show_time(False)
+
+# Log to file
+hexlogger.set_log_file("app.log")
+
+# Set minimum log level
+hexlogger.set_min_level("warning")  # Only WARNING and above
+```
+
+## Features
+
+- ✅ Zero dependencies
+- ✅ Beautiful colored output
+- ✅ 4 built-in themes + custom themes
+- ✅ Gradient & rainbow text
+- ✅ Panels, tables, banners
+- ✅ Progress bars with ETA
+- ✅ Animated spinners (6 styles)
+- ✅ Timer utility
+- ✅ File logging
+- ✅ Thread-safe
+- ✅ Windows compatible
+- ✅ Python 3.7+
+
+## License
+
+MIT License - Created by Montage