hexlogger

Premium console logging library with themes, gradients, panels, tables, progress bars, and spinners.

These details have not been verified by PyPI

Project links

Homepage

Project description

A premium, zero-dependency Python console logging library with beautiful colored output, multiple themes, gradient text, panels, tables, progress bars, and spinners.

pip install hexlogger

import hexlogger

hexlogger.success(" BOT READY ")
hexlogger.info("Logged in as: MyBot#1234")
hexlogger.info("Bot Name: MyBot")
hexlogger.info("Bot ID: 987654321098765432")
hexlogger.info("Shards: 4")
hexlogger.info("Connected to: 128 guilds")
hexlogger.info("Connected to: 94,210 users")
hexlogger.warn("Rate limit hit on /api/messages")
hexlogger.error("Failed to fetch guild: 403 Forbidden")
hexlogger.critical("Shard 2 disconnected unexpectedly")
hexlogger.fatal("Token invalidated — shutting down")

Output:

[-(14:30:00)-] [ ● ] SUCCESS »   BOT READY
[-(14:30:00)-] [ ● ] INFO »  Logged in as: MyBot#1234
[-(14:30:00)-] [ ● ] INFO »  Bot Name: MyBot
[-(14:30:00)-] [ ● ] INFO »  Bot ID: 987654321098765432
[-(14:30:00)-] [ ● ] INFO »  Shards: 4
[-(14:30:00)-] [ ● ] INFO »  Connected to: 128 guilds
[-(14:30:00)-] [ ● ] INFO »  Connected to: 94,210 users
[-(14:30:00)-] [ ● ] WARNING »  Rate limit hit on /api/messages
[-(14:30:00)-] [ ● ] ERROR »  Failed to fetch guild: 403 Forbidden
[-(14:30:00)-] [ ● ] CRITICAL »  Shard 2 disconnected unexpectedly
[-(14:30:00)-] [ ● ] FATAL »  Token invalidated — shutting down

Function	Level
`trace(msg)`	TRACE
`debug(msg)`	DEBUG
`info(msg)`	INFO
`success(msg)`	SUCCESS
`warn(msg)` / `warning(msg)`	WARNING
`error(msg)`	ERROR
`critical(msg)`	CRITICAL
`fatal(msg)`	FATAL

Nine display styles are available. All styles respond to the active theme for color. Switch styles with hexlogger.setstyle(name).

hexlogger.setstyle("default")

[-(14:30:00)-] [ ● ] SUCCESS »   BOT READY
[-(14:30:00)-] [ ● ] INFO »  Logged in as: MyBot#1234
[-(14:30:00)-] [ ● ] INFO »  Bot Name: MyBot
[-(14:30:00)-] [ ● ] INFO »  Bot ID: 987654321098765432
[-(14:30:00)-] [ ● ] INFO »  Shards: 4
[-(14:30:00)-] [ ● ] INFO »  Connected to: 128 guilds
[-(14:30:00)-] [ ● ] INFO »  Connected to: 94,210 users
[-(14:30:00)-] [ ● ] WARNING »  Rate limit hit on /api/messages
[-(14:30:00)-] [ ● ] ERROR »  Failed to fetch guild: 403 Forbidden
[-(14:30:00)-] [ ● ] CRITICAL »  Shard 2 disconnected unexpectedly
[-(14:30:00)-] [ ● ] FATAL »  Token invalidated — shutting down

hexlogger.setstyle("box")

┃ 14:30:00 │ ✓ SUCCESS  │  BOT READY
┃ 14:30:00 │ ℹ INFO     │ Logged in as: MyBot#1234
┃ 14:30:00 │ ℹ INFO     │ Bot Name: MyBot
┃ 14:30:00 │ ℹ INFO     │ Bot ID: 987654321098765432
┃ 14:30:00 │ ℹ INFO     │ Shards: 4
┃ 14:30:00 │ ℹ INFO     │ Connected to: 128 guilds
┃ 14:30:00 │ ℹ INFO     │ Connected to: 94,210 users
┃ 14:30:00 │ ⚠ WARNING  │ Rate limit hit on /api/messages
┃ 14:30:00 │ ✗ ERROR    │ Failed to fetch guild: 403 Forbidden
┃ 14:30:00 │ ☠ CRITICAL │ Shard 2 disconnected unexpectedly
┃ 14:30:00 │ 💀 FATAL    │ Token invalidated — shutting down

hexlogger.setstyle("modern")

14:30:00  ✓ SUCCESS   BOT READY
14:30:00  ℹ INFO  Logged in as: MyBot#1234
14:30:00  ℹ INFO  Bot Name: MyBot
14:30:00  ℹ INFO  Bot ID: 987654321098765432
14:30:00  ℹ INFO  Shards: 4
14:30:00  ℹ INFO  Connected to: 128 guilds
14:30:00  ℹ INFO  Connected to: 94,210 users
14:30:00  ⚠ WARNING  Rate limit hit on /api/messages
14:30:00  ✗ ERROR  Failed to fetch guild: 403 Forbidden
14:30:00  ☠ CRITICAL  Shard 2 disconnected unexpectedly
14:30:00  💀 FATAL  Token invalidated — shutting down

hexlogger.setstyle("bracket")

[14:30:00] [SUCCESS]  BOT READY
[14:30:00] [INFO] Logged in as: MyBot#1234
[14:30:00] [INFO] Bot Name: MyBot
[14:30:00] [INFO] Bot ID: 987654321098765432
[14:30:00] [INFO] Shards: 4
[14:30:00] [INFO] Connected to: 128 guilds
[14:30:00] [INFO] Connected to: 94,210 users
[14:30:00] [WARNING] Rate limit hit on /api/messages
[14:30:00] [ERROR] Failed to fetch guild: 403 Forbidden
[14:30:00] [CRITICAL] Shard 2 disconnected unexpectedly
[14:30:00] [FATAL] Token invalidated — shutting down

hexlogger.setstyle("arrow")

14:30:00 ▸ SUCCESS ▸  BOT READY
14:30:00 ▸ INFO ▸ Logged in as: MyBot#1234
14:30:00 ▸ INFO ▸ Bot Name: MyBot
14:30:00 ▸ INFO ▸ Bot ID: 987654321098765432
14:30:00 ▸ INFO ▸ Shards: 4
14:30:00 ▸ INFO ▸ Connected to: 128 guilds
14:30:00 ▸ INFO ▸ Connected to: 94,210 users
14:30:00 ▸ WARNING ▸ Rate limit hit on /api/messages
14:30:00 ▸ ERROR ▸ Failed to fetch guild: 403 Forbidden
14:30:00 ▸ CRITICAL ▸ Shard 2 disconnected unexpectedly
14:30:00 ▸ FATAL ▸ Token invalidated — shutting down

hexlogger.setstyle("pipe")

▌ 14:30:00 | SUCCESS  |  BOT READY
▌ 14:30:00 | INFO     | Logged in as: MyBot#1234
▌ 14:30:00 | INFO     | Bot Name: MyBot
▌ 14:30:00 | INFO     | Bot ID: 987654321098765432
▌ 14:30:00 | INFO     | Shards: 4
▌ 14:30:00 | INFO     | Connected to: 128 guilds
▌ 14:30:00 | INFO     | Connected to: 94,210 users
▌ 14:30:00 | WARNING  | Rate limit hit on /api/messages
▌ 14:30:00 | ERROR    | Failed to fetch guild: 403 Forbidden
▌ 14:30:00 | CRITICAL | Shard 2 disconnected unexpectedly
▌ 14:30:00 | FATAL    | Token invalidated — shutting down

hexlogger.setstyle("tag")

14:30:00  SUCCESS   BOT READY
14:30:00  INFO  Logged in as: MyBot#1234
14:30:00  INFO  Bot Name: MyBot
14:30:00  INFO  Bot ID: 987654321098765432
14:30:00  INFO  Shards: 4
14:30:00  INFO  Connected to: 128 guilds
14:30:00  INFO  Connected to: 94,210 users
14:30:00  WARNING  Rate limit hit on /api/messages
14:30:00  ERROR  Failed to fetch guild: 403 Forbidden
14:30:00  CRITICAL  Shard 2 disconnected unexpectedly
14:30:00  FATAL  Token invalidated — shutting down

Each level label renders with a distinct background color in the terminal.

hexlogger.setstyle("dots")

✓ 14:30:00 · SUCCESS ·  BOT READY
ℹ 14:30:00 · INFO · Logged in as: MyBot#1234
ℹ 14:30:00 · INFO · Bot Name: MyBot
ℹ 14:30:00 · INFO · Bot ID: 987654321098765432
ℹ 14:30:00 · INFO · Shards: 4
ℹ 14:30:00 · INFO · Connected to: 128 guilds
ℹ 14:30:00 · INFO · Connected to: 94,210 users
⚠ 14:30:00 · WARNING · Rate limit hit on /api/messages
✗ 14:30:00 · ERROR · Failed to fetch guild: 403 Forbidden
☠ 14:30:00 · CRITICAL · Shard 2 disconnected unexpectedly
💀 14:30:00 · FATAL · Token invalidated — shutting down

hexlogger.setstyle("clean")

  14:30:00  SUCCESS    BOT READY
  14:30:00  INFO      Logged in as: MyBot#1234
  14:30:00  INFO      Bot Name: MyBot
  14:30:00  INFO      Bot ID: 987654321098765432
  14:30:00  INFO      Shards: 4
  14:30:00  INFO      Connected to: 128 guilds
  14:30:00  INFO      Connected to: 94,210 users
  14:30:00  WARNING   Rate limit hit on /api/messages
  14:30:00  ERROR     Failed to fetch guild: 403 Forbidden
  14:30:00  CRITICAL  Shard 2 disconnected unexpectedly
  14:30:00  FATAL     Token invalidated — shutting down

Six built-in themes control the colors applied to every style. Themes do not affect the structure of the output — only the 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:

[-(14:30:00)-] [ ● ] OK »   BOT READY
[-(14:30:00)-] [ ● ] INF »  Logged in as: MyBot#1234
[-(14:30:00)-] [ ● ] INF »  Bot Name: MyBot
[-(14:30:00)-] [ ● ] INF »  Bot ID: 987654321098765432
[-(14:30:00)-] [ ● ] INF »  Shards: 4
[-(14:30:00)-] [ ● ] INF »  Connected to: 128 guilds
[-(14:30:00)-] [ ● ] INF »  Connected to: 94,210 users
[-(14:30:00)-] [ ● ] WRN »  Rate limit hit on /api/messages
[-(14:30:00)-] [ ● ] ERR »  Failed to fetch guild: 403 Forbidden
[-(14:30:00)-] [ ● ] CRT »  Shard 2 disconnected unexpectedly
[-(14:30:00)-] [ ● ] FTL »  Token invalidated — shutting down

from hexlogger import rgb

hexlogger._config.add_theme("mytheme", {
    "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.settheme("mytheme")

hexlogger.divider()
hexlogger.divider(char="═", length=80)

────────────────────────────────────────────────────────────

hexlogger.section("RESULTS")
hexlogger.rule("Settings", char="═")
hexlogger.blank(2)

══════════════════════════ RESULTS ═══════════════════════════

hexlogger.banner("HexLogger\nv3.0.0")

╔═══════════════╗
║   HexLogger   ║
║    v3.0.0     ║
╚═══════════════╝

hexlogger.panel(
    "Server: online\nPing: 42ms\nUptime: 99.9%",
    title="Status",
    style="rounded"
)

╭─ Status ──────────────────────────────────────╮
│ Server: online                                │
│ Ping: 42ms                                    │
│ Uptime: 99.9%                                 │
╰───────────────────────────────────────────────╯

Available panel styles: rounded, sharp, double, heavy, ascii

hexlogger.box("Deployment complete.", style="double", align="center")

╔═════════════════════════╗
║   Deployment complete.  ║
╚═════════════════════════╝

Available box styles: rounded, sharp, double, heavy, ascii, stars, dashes

hexlogger.table(
    headers=["Name", "Status", "Ping"],
    rows=[
        ["Server 1", "Online",  "12ms"],
        ["Server 2", "Offline", "---"],
        ["Server 3", "Online",  "45ms"],
    ]
)

╭──────────┬─────────┬──────╮
│ Name     │ Status  │ Ping │
├──────────┼─────────┼──────┤
│ Server 1 │ Online  │ 12ms │
│ Server 2 │ Offline │ ---  │
│ Server 3 │ Online  │ 45ms │
╰──────────┴─────────┴──────╯

hexlogger.pair("Logged in as", "MyBot#1234")
hexlogger.pair("Bot ID",       "987654321098765432")
hexlogger.pair("Guilds",       "128")
hexlogger.pair("Users",        "94,210")

  Logged in as: MyBot#1234
  Bot ID: 987654321098765432
  Guilds: 128
  Users: 94,210

hexlogger.gprint("Hello World!", (255, 0, 100), (100, 0, 255))
hexlogger.rbprint("Rainbow text!")

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)])

from hexlogger import bold, italic, uline, clr, Colors

print(bold("Bold text"))
print(italic("Italic text"))
print(uline("Underlined text"))
print(clr("Cyan text", Colors.CYAN))

from hexlogger import rgb, bgrgb, hexclr, bghex

color    = rgb(255, 128, 0)
bg       = bgrgb(30, 30, 30)
from_hex = hexclr("#FF8800")
bg_hex_  = bghex("#1E1E1E")

import time

bar = hexlogger.Progress(total=100, label="Downloading", width=40)
for i in range(100):
    time.sleep(0.05)
    bar.update()

Downloading │████████████████████░░░░░░░░░░░░░░░░░░░│  52.0% (52/100) [2.6s / ETA 2.4s]

Parameter	Type	Default	Description
`total`	int	—	Total number of steps
`width`	int	`30`	Bar width in characters
`label`	str	`"Progress"`	Label displayed before the bar
`fill`	str	`"█"`	Fill character
`empty`	str	`"░"`	Empty character
`color`	str	theme	Bar color

import time

with hexlogger.Spinner("Loading data...", style="dots"):
    time.sleep(3)

spinner = hexlogger.Spinner("Processing...", style="circle")
spinner.start()
time.sleep(2)
spinner.stop("Done!")

⠹ Loading data...

Available styles: dots, line, arrow, bounce, box, circle

import time

with hexlogger.Timer("Database query"):
    time.sleep(1.5)

timer = hexlogger.Timer("API call")
timer.start()
elapsed = timer.stop()

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

Only messages at or above the configured level are printed.

hexlogger.setlevel("trace")
hexlogger.setlevel("debug")
hexlogger.setlevel("info")
hexlogger.setlevel("warning")
hexlogger.setlevel("error")
hexlogger.setlevel("critical")
hexlogger.setlevel("fatal")

Zero dependencies
6 built-in themes with full custom theme support
9 display styles
RGB, background, and hex color helpers
Gradient and rainbow text
Panels, tables, banners, and boxes
Progress bars with ETA
Animated spinners in 6 styles
Timer utility
File logging with automatic ANSI stripping
Thread-safe output
Windows console compatible
Python 3.7+

MIT License — Created by Itz Montage

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

This version

2.0.3

Feb 27, 2026

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hexlogger-2.0.3.tar.gz (18.0 kB view details)

Uploaded Feb 27, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

hexlogger-2.0.3-py3-none-any.whl (17.3 kB view details)

Uploaded Feb 27, 2026 Python 3

File details

Details for the file hexlogger-2.0.3.tar.gz.

File metadata

Download URL: hexlogger-2.0.3.tar.gz
Upload date: Feb 27, 2026
Size: 18.0 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.10

File hashes

Hashes for hexlogger-2.0.3.tar.gz
Algorithm	Hash digest
SHA256	`a353faaf2a80aa2d61b3d5b190a3888b95016e3537cc4f09a20eaa4b7ec16f38`
MD5	`bb67bf111c5bd52011286b2a3df1eeb7`
BLAKE2b-256	`d2c3453ed68c9b8e8b6d0184b8c688e6bcf2ba60d9d5b2c6fe273b4b577195b2`

See more details on using hashes here.

File details

Details for the file hexlogger-2.0.3-py3-none-any.whl.

File metadata

Download URL: hexlogger-2.0.3-py3-none-any.whl
Upload date: Feb 27, 2026
Size: 17.3 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.10

File hashes

Hashes for hexlogger-2.0.3-py3-none-any.whl
Algorithm	Hash digest
SHA256	`c9c8be8a5a141bb9b1e2a81ec82dc717576627a92093cac7b6625328c14897f8`
MD5	`fdb49b56afa8c060a0b1542829a55a36`
BLAKE2b-256	`2bdf14eeaa453302c215b931c73dbde113a8957f82169f22716fd29f0c2bd873`

See more details on using hashes here.

hexlogger 2.0.3

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File metadata

File hashes