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

These defaults can be overridden during instantiation.

A LogConfiguration optimized for use when running within Xcode.

The XcodeLogConfiguration sets up 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

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

These defaults can be overridden by providing alternate values to the initializer.