small-logger 0.1.0

A tiny Loguru wrapper for styled logging

small-logger

A tiny, opinionated Loguru wrapper that gives your Python apps a consistent, readable log format in two lines of code.

2026-05-11 14:32:01 | INFO     | myapp:main:42                             | Server started on port 8080
2026-05-11 14:32:01 | ERROR    | myapp:handle_request:87                   | Connection refused
                                                                            | Traceback shown below

Installation

uv add small-logger

pip install small-logger

Quick start

from small_logger import init_logger, get_logger

init_logger()  # call once at the start of your app

logger = get_logger()
logger.info("Server started")
logger.warning("Disk usage above 80%")

File logging

Pass your app's name to enable automatic file logging:

init_logger(app_name="my-app")

Logs are written to the platform-appropriate directory:

Platform	Path
Windows	%LOCALAPPDATA%\my-app\Logs\app.log
macOS	~/Library/Logs/my-app/app.log
Linux	~/.local/state/my-app/log/app.log

Files rotate daily at midnight, are kept for 7 days, and are compressed to .zip on rotation.

API

init_logger

init_logger(
    level="INFO",       # TRACE | DEBUG | INFO | SUCCESS | WARNING | ERROR | CRITICAL
    app_name=None,      # enables file logging when provided
    file=None,          # override file logging on/off explicitly
)

Parameter	Default	Description
level	"INFO"	Minimum level to log.
app_name	None	App name for the log file path. When set, file logging is enabled by default.
file	None	Explicitly enable (True) or disable (False) file logging, regardless of app_name.

Call this once at startup. Subsequent calls are no-ops.

get_logger

logger = get_logger()
logger = get_logger(request_id="abc123", user_id=42)

Returns a Loguru logger bound with optional key-value context. The context is included in every message emitted through that logger instance.

Multiline messages

Continuation lines are automatically indented to align with the first line:

logger.info("Query returned 3 rows:\nrow1\nrow2\nrow3")

2026-05-11 14:32:01 | INFO     | myapp:run:10                              | Query returned 3 rows:
                                                                            | row1
                                                                            | row2
                                                                            | row3

License

MIT