python-coloured-logger

A lightweight Python package that provides clean, coloured logging output for Flask, FastAPI, and any standard Python application.

It extends Python’s built-in logging module with readable coloured console output and simple setup helpers.

Features

• Coloured console logging
• Works with standard Python logging
• Flask integration
• FastAPI / Uvicorn integration
• Simple setup API
• Lightweight with minimal configuration

Installation

Install from PyPI:

pip install python-coloured-logger

Quick Start

from coloured_logger import get_logger

logger = get_logger("my-app")

logger.debug("Debug message")
logger.info("Server started")
logger.success("Database connected")
logger.warning("High memory usage")
logger.error("Request failed")
logger.critical("System crash")

Example output:

[20/06/2026] [INFO] Server started
[20/06/2026] [SUCCESS] Database connected
[20/06/2026] [WARNING] High memory usage
[20/06/2026] [ERROR] Request failed

Flask Integration

from flask import Flask
from coloured_logger import setup_logging

app = Flask(__name__)

setup_logging(logger_name="flask.app")

@app.route("/")
def index():
    app.logger.info("Request received")
    return "Hello World"

FastAPI Integration

from fastapi import FastAPI
from coloured_logger import setup_logging

app = FastAPI()

setup_logging(logger_name="uvicorn")

@app.get("/")
async def root():
    return {"message": "Hello World"}

Standard Python Logging

from coloured_logger import setup_logging
import logging

setup_logging()

logger = logging.getLogger("example")

logger.info("Using standard logging")

Environment Variables

Enable or Disable Colours

By default, colours are enabled.

COLOURED_LOGGER_COLOR=True

or for Flask-specific configuration:

FLASK_LOG_COLOR=True

Disable colours:

COLOURED_LOGGER_COLOR=False

Custom Date Format

COLOURED_LOGGER_DATE_FORMAT=%Y-%m-%d %H:%M:%S

or:

FLASK_LOG_DATE_FORMAT=%H:%M:%S

Supported Log Levels

Requirements

• Python 3.8+
• Flask (optional)
• FastAPI / Uvicorn (optional)

License

MIT License

Contributing

Pull requests, issues, and suggestions are welcome.

If you find a bug or want to improve the package, feel free to open an issue or submit a PR.

Links

• PyPI: https://pypi.org/project/python-coloured-logger/
• GitHub: https://github.com/Skulldorom/python-coloured-logger