Plainlog

Installation

pip install plainlog

or add it to your project with

uv add plainlog
uv sync

Quickstart

from plainlog import logger

log = logger.new()
log.info("hello world")
log.warning("look out!")
log.error("something broke")

Or use a profile for more structured output:

from plainlog import logger
from plainlog.configure import apply_log_profile

apply_log_profile("develop", level="DEBUG")
log = logger.new()
log.info("ready to go")

Child Loggers

Create a child logger; its name is auto-detected from the current module:

from plainlog import logger

log = logger.new()
log.info("logged with the module name as logger name")

Processors

Log output is built from a pipeline of processors — a formatter followed by a handler:

import sys
from plainlog import logger
from plainlog.processors import JsonFormatter, Stream

logger.configure(processors=[JsonFormatter(), Stream(sys.stdout)])
log = logger.new()
log.info("hello world", user="alice")

See the Processors docs for the full list of built-in formatters, handlers, and filters (including redaction, level filtering, and buffering).

Idea

Main goal is to be a plain easy to use logging library. Simple, small, and fast.

If you are too lazy for long configuration settings simply use the provided log profiles. Advanced configuration can be done with environment variables or in the code.

No dependencies to other libraries. Pure Python working in different Python implementations.

Status

In development beta, internal interfaces can change.

Changelog

See CHANGELOG.md for the full list of changes, or the Changelog page in the docs.

License

plainlog is distributed under the terms of the BSD 3-Clause License.