cars.core.cars_logging

cCars logging module: contains cars logging setup logger for main thread and workers

Attributes

SYS_PLATFORM
IS_WIN
PROGRESS
PROFILING_LOG
profiling_logger

Classes

ProfilingFilter	ProfilingFilter
ProfilinglHandler	Profiling
WorkerHandler	Profiling
LogSender	LogSender

Functions

lock(file)	Lock file for safe writing (Windows version)
setup_logging([loglevel, out_dir, log_dir, pipeline, ...])	Setup the CARS logging configuration
add_progress_message(message)	Add enforced message with INFO level
add_profiling_message(message)	Add enforced message with PROFILING_LOG level
wrap_logger(func, log_dir, log_level)	Wrapper logger function to wrap worker func
logger_func(*args, **kwargs)	Logger function to wrap worker func (with non local method)

Module Contents

cars.core.cars_logging.SYS_PLATFORM

cars.core.cars_logging.IS_WIN

cars.core.cars_logging.lock(file)

Lock file for safe writing (Windows version)

cars.core.cars_logging.PROGRESS = 21

cars.core.cars_logging.PROFILING_LOG = 15

cars.core.cars_logging.profiling_logger

class cars.core.cars_logging.ProfilingFilter(name='')

Bases: logging.Filter

ProfilingFilter

filter(record)

Filter message

class cars.core.cars_logging.ProfilinglHandler(filename, mode='a', encoding=None, delay=False)

Bases: logging.FileHandler

Profiling

sender

emit(record)

Emit

class cars.core.cars_logging.WorkerHandler(filename, mode='a', encoding=None, delay=False)

Bases: logging.FileHandler

Profiling

sender

emit(record)

Emit

class cars.core.cars_logging.LogSender(log_file)

LogSender

log_file

write_log(msg) → None

Write log

cars.core.cars_logging.setup_logging(loglevel='PROGRESS', out_dir=None, log_dir=None, pipeline='', in_worker=False, global_log_file=None)

Setup the CARS logging configuration

Parameters:

loglevel – log level default WARNING

cars.core.cars_logging.add_progress_message(message)

Add enforced message with INFO level to stdout and logging file

Parameters:

message – logging message

cars.core.cars_logging.add_profiling_message(message)

Add enforced message with PROFILING_LOG level to stdout and logging file

Parameters:

message – logging message

cars.core.cars_logging.wrap_logger(func, log_dir, log_level)

Wrapper logger function to wrap worker func and setup the worker logger :param func: wrapped function :param log_dir: output directory of worker logs :param log_level: logging level of the worker logs

cars.core.cars_logging.logger_func(*args, **kwargs)

Logger function to wrap worker func (with non local method) and setup the worker logger

Parameters:

• argv – args of func

• kwargs – kwargs of func