Classes

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.

A LogConfiguration optimized for use when running within Xcode.

By default, this configuration will attempt to detect the presence of the XcodeColors plug-in, and—if it is present—will enable text colorization.

If text colorization is used, the XcodeLogConfiguration will enable two separate LogRecorders: a StandardOutputLogRecorder, which will be configured to perform colorization of the logs within the Xcode console, and an ASLLogRecorder which will not use colorization. This ensures that the colorization escape sequences used within Xcode do not end up in the Apple System Log (ASL), where they will look like garbage characters.

If no colorization is used, then the XcodeLogConfiguration will configure only a single recorder: an ASLLogRecorder configured to echo output to stdout as well as capturing to the ASL.

A LogRecorder implementation that maintains a set of daily rotating log files, kept for a user-specified number of days.

The StandardOutputLogRecorder logs messages by writing to the standard output stream of the running process.

A LogConfiguration that uses an underlying RotatingLogFileRecorder to maintain a directory of log files that are rotated on a daily basis.

In case the name didn’t give it away, the BasicLogConfiguration class provides a basic implementation of the LogConfiguration protocol.

A LogRecorder implementation that appends log entries to a file.

The FieldBasedLogFormatter provides a simple interface for constructing a customized LogFormatter by specifying different fields.

Let’s say you wanted to construct a LogFormatter that outputs the following fields separated by tabs:

• The LogEntry’s timestamp property as a UNIX time value
• The severity of the LogEntry as a numeric value
• The Payload of the LogEntry

You could do this by constructing a FieldBasedLogFormatter as follows:

let formatter = FieldBasedLogFormatter(fields: [.Timestamp(.UNIX),
                                                .Delimiter(.Tab),
                                                .Severity(.Numeric),
                                                .Delimiter(.Tab),
                                                .Payload])

LogReceptacles provide the low-level interface for accepting log messages.

Although you could use a LogReceptacle directly to perform all logging functions, the Log implementation provides a higher-level interface that’s more convenient to use within your code.

The ConcatenatingLogFormatter lets you combine the output of multiple LogFormatters by contatenating their output and returning the result.

A partial implementation of the LogRecorder protocol.

A standard LogFormatter that provides some common customization points.

A LogFormatter configured to be ideal for writing machine-parsable log files.

By default, this formatter:

• Uses .UNIX as the default TimestampStyle
• Uses .Numeric as the default SeverityStyle
• Uses .Tab as the default DelimiterStyle
• Outputs the call site and calling thread
• Does not perform text colorization

These defaults can be overridden during instantiation.

A LogFormatter ideal for use within Xcode.

By default, this formatter:

• Uses .Default as the default TimestampStyle
• Uses .Xcode as the default SeverityStyle
• Uses default field separator delimiters
• Outputs the call site
• Does not output the calling thread
• Performs text colorization if XcodeColors is installed and enabled

These defaults can be overridden during instantiation.