compass.utilities.logs#

COMPASS Ordinance logging utilities

This module implements queued logging, mostly following this blog:” https://www.zopatista.com/python/2019/05/11/asyncio-logging/

Classes

AddLocationFilter([name])

Filter that injects location information into the log record

ExceptionOnlyFilter([name])

Filter to only pass through Exception logging (errors)

JsonExceptionFileHandler(filename[, encoding])

File handler that writes exception info to JSON file

JsonFormatter([fmt, datefmt, style, ...])

Formatter that converts a record into a dictionary

LocalProcessQueueHandler(queue)

QueueHandler that works within a single process (locally)

LocationFileLog(listener, log_dir, location)

Context manager to write logs for a location to a unique file

LocationFilter(location)

Filter down to logs for a specific location

LogListener(logger_names[, level])

Class to listen to logging queue and write logs to files

NoLocationFilter([name])

Filter that catches all records without a location attribute.