tinycolorlog 0.2.0

A tiny Python logger with colorful ANSI terminal output.

tinycolorlog

A tiny, zero-dependency Python logger with colorful ANSI terminal output.

Installation

pip install tinycolorlog

Usage

from tinycolorlog import logger

logger.info("Server started on port 8080")
logger.success("Database connection established")
logger.error("Failed to read configuration file")

All text — both the [TAG] and the message — is printed in bold italic with full color.

Unicode Font Styles

Pass font= to convert your output into a Unicode font style. This works anywhere Unicode is rendered: terminals, Slack, Discord, GitHub, Notion, etc.

logger.error("Failed to read configuration file", font="monospace")
logger.success("All systems operational", font="bold_italic")
logger.info("Deploying to production", font="double_struck")

Available Fonts

Font name	Preview
bold	𝗯𝗼𝗹𝗱 𝘁𝗲𝘅𝘁
italic	𝘪𝘵𝘢𝘭𝘪𝘤 𝘵𝘦𝘹𝘵
bold_italic	𝙗𝙤𝙡𝙙 𝙞𝙩𝙖𝙡𝙞𝙘 𝙩𝙚𝙭𝙩
monospace	𝚖𝚘𝚗𝚘𝚜𝚙𝚊𝚌𝚎 𝚝𝚎𝚡𝚝
double_struck	𝕕𝕠𝕦𝕓𝕝𝕖 𝕤𝕥𝕣𝕦𝕔𝕜
script	𝓈𝒸𝓇𝒾𝓅𝓉 𝓉𝑒𝓍𝓉
fraktur	𝔣𝔯𝔞𝔨𝔱𝔲𝔯 𝔱𝔢𝔵𝔱

Output

Each method prints bold + italic colored text with a tag prefix:

Method	Color	Tag
logger.info()	🔵 Blue	[INFO]
logger.success()	🟢 Green	[SUCCESS]
logger.error()	🔴 Red	[ERROR]

API Reference

logger.info(message, font=None)

Prints an informational message in blue.

logger.success(message, font=None)

Prints a success message in green.

logger.error(message, font=None)

Prints an error message in red.

Parameters:

• message (str) — The text to display.
• font (str, optional) — A Unicode font style name. See table above. Raises ValueError for unknown font names.

Advanced: Custom Instance

You can also instantiate TinyLogger directly, or use the font converter on its own:

from tinycolorlog.handler import TinyLogger, _convert_font

my_logger = TinyLogger()
my_logger.success("Custom logger works!", font="script")

# Convert text independently
print(_convert_font("hello world", "fraktur"))
# → 𝔥𝔢𝔩𝔩𝔬 𝔴𝔬𝔯𝔩𝔡

License

MIT — see LICENSE for details.