Features

• Allows any number of simultaneous connections

• Customizable look of log levels and columns, with presets for each

• Filtering based on level and namespace, as well as filtering by searching

• Search through all records or only through filtered ones

• Display extra fields under the message with Extra mode

• View exception tracebacks or messages in a separate window

• Dark theme (with its own set of colors for levels)

• Pop tabs out of the window, merge records of multiple tabs into one

• Save/load records to/from a file in JSON format

Installation

If you’re using Linux, install PySide6 (or PyQt6) from your package manager before installing cutelog2 (package name is probably python3-pyside6 or python-pyside6). Or just run pip install pyside6 to install it from pip, which is sub-optimal.

$ pip install --upgrade cutelog2

Or install the latest development version from the source:

$ pip install git+https://github.com/eachimei/cutelog2.git

$ pip install cutelog2[pyqt6]

$ QT_API=pyqt6 cutelog2

Usage

1. Start cutelog2

2. Put the following into your code:

import logging
from logging.handlers import SocketHandler

log = logging.getLogger('Root logger')
log.setLevel(1)  # to send all messages to cutelog
socket_handler = SocketHandler('127.0.0.1', 19996)  # default listening address
log.addHandler(socket_handler)
log.info('Hello world!')

Afterwards it’s recommended to designate different loggers for different parts of your program with log_2 = log.getChild(“Child logger”). This will create “log namespaces” which allow you to filter out messages from various subsystems of your program.

The server listens on 127.0.0.1 only. To accept records from other machines, set “Server listen address” in Settings to 0.0.0.0; anyone who can connect can then send records, so only do this on a trusted network. Pickled records are decoded without importing any classes, so a client can’t run code in cutelog2; objects other than basic types show as <module.Class>.

$ cutelog2 records.json
$ my_exporter | python -m cutelog2 --no-server --tab-name "nightly run" -

Code, issues, changelog

Visit the project’s GitHub page.