Log

gradysim.simulator.log

Logging is an important part of any software. It helps users and developers understand what is happening during the execution of the program. When running GrADyS-SIM NextGen in prototype-mode logging is automatically configured for you.

The logger annotates the output with timing information and execution context to improve understanding.

SimulationFormatter

Bases: Formatter

Custom logging formatter responsible for annotating the simulation logs with useful information about timing and execution context.

Source code in gradysim/simulator/log.py

class SimulationFormatter(logging.Formatter):
    """
    Custom logging formatter responsible for annotating the simulation logs with useful information about
    timing and execution context.
    """
    def __init__(self):
        super().__init__("%(message)s")

    prefix: str = ""

    def clear_iteration(self):
        self.prefix = ""

    def format(self, record: logging.LogRecord) -> str:
        log = super().format(record)
        return f"{record.levelname: <8} {self.prefix}{log}"

format_table(headers, rows)

Formats a text table for console reports. Columns are right-aligned, separated by two spaces and every line is indented by two spaces.

Parameters:

Name	Type	Description	Default
headers	List[str]	Column headers	required
rows	List[List[str]]	Rows of already formatted cells, each with one cell per header	required

Returns:

Type	Description
str	The formatted table, without a trailing newline

Source code in gradysim/simulator/log.py

def format_table(headers: List[str], rows: List[List[str]]) -> str:
    """
    Formats a text table for console reports. Columns are right-aligned, separated by two spaces and every
    line is indented by two spaces.

    Args:
        headers: Column headers
        rows: Rows of already formatted cells, each with one cell per header

    Returns:
        The formatted table, without a trailing newline
    """
    widths = [max([len(header)] + [len(row[i]) for row in rows]) for i, header in enumerate(headers)]
    lines = [
        "  ".join(header.rjust(width) for header, width in zip(headers, widths)),
        "  ".join("-" * width for width in widths),
    ]
    lines += ["  ".join(cell.rjust(width) for cell, width in zip(row, widths)) for row in rows]
    return "\n".join("  " + line for line in lines)

setup_simulation_formatter(debug, log_file)

Sets up the logger for the simulation. Called before the simulation starts to configure the logger.

Parameters:

Name	Type	Description	Default
debug	bool	Include DEBUG level logs	required
log_file	Optional[Path]	Configure a logging handler to save logs in a file. Optional.	required

Returns:

Type	Description
SimulationFormatter	The formatter instance. Is returned because it needs to be updated with current simulation information.

Source code in gradysim/simulator/log.py

def setup_simulation_formatter(debug: bool, log_file: Optional[Path]) -> SimulationFormatter:
    """
    Sets up the logger for the simulation. Called before the simulation starts to configure
    the logger.

    Args:
        debug: Include DEBUG level logs
        log_file: Configure a logging handler to save logs in a file. Optional.

    Returns:
        The formatter instance. Is returned because it needs to be updated with current simulation information.
    """
    logger = logging.getLogger()

    if debug:
        logger.setLevel(logging.DEBUG)
    else:
        logger.setLevel(logging.INFO)

    formatter = SimulationFormatter()
    console_handler = logging.StreamHandler()
    console_handler.setFormatter(formatter)
    logger.addHandler(console_handler)

    if log_file is not None:
        file_handler = logging.FileHandler(log_file)
        file_handler.setFormatter(formatter)
        logger.addHandler(file_handler)

    return formatter