ReadableLogFormatter

open class ReadableLogFormatter: StandardLogFormatter

A LogFormatter configured to be ideal for writing human-readable log files.

By default, this formatter:

  • Uses .Default as the default TimestampStyle
  • Uses .Simple as the default SeverityStyle
  • Uses default field separator delimiters
  • Outputs the call site and calling thread
  • Does not perform text colorization

These defaults can be overridden during instantiation.

  • Initializes a new ReadableLogFormatter instance.

    Declaration

    Swift

    public override init(timestampStyle: TimestampStyle? = .default, severityStyle: SeverityStyle? = .simple, delimiterStyle: DelimiterStyle? = nil, showCallSite: Bool = true, showCallingThread: Bool = true, colorizer: TextColorizer? = nil, colorTable: ColorTable? = nil)

    Parameters

    timestampStyle

    Governs the formatting of the timestamp in the log output. Pass nil to suppress output of the timestamp.

    severityStyle

    Governs the formatting of the LogSeverity in the log output. Pass nil to suppress output of the severity.

    delimiterStyle

    If provided, overrides the default field separator delimiters. Pass nil to use the default delimiters.

    showCallSite

    If true, the source file and line indicating the call site of the log request will be added to formatted log messages.

    showCallingThread

    If true, a hexadecimal string containing an opaque identifier for the calling thread will be added to formatted log messages.

    colorizer

    The TextColorizer that will be used to colorize the output of the receiver. If nil, no colorization will occur.

    colorTable

    If a colorizer is provided, an optional ColorTable may also be provided to supply color information. If nil, DefaultColorTable will be used for colorization.