TraceLog is a highly configurable, flexible, portable, and simple to use debug logging system for Swift and Objective-C applications running on Linux, macOS, iOS, watchOS, and tvOS.
OutputStreamFormatter protocol to define formatters for use with byte output stream type Writers.TextFormat, an implementation of a OutputStreamFormatter that formats its output based on a supplied template (this is the default formatter for Console and File output).JSONFormat, an implementation of a OutputStreamFormatter that formats its output in standard JSON format.OutputStreamWriter protocol to define types that write byte streams to their output and accept OutputStreamFormatter types to format the output.LogEntry tuple type to Writer defining the formal types that a Writer writes..buffer option for .async concurrency modes to allow for buffering when the writer is not available to write to its endpoint.FileWriter.Strategy.fixed on iOS for use with AsyncConcurrencyModeOption.buffer(writeInterval:strategy:). This allows TraceLog to be started up before protected data is available on iOS..async to include options for configuration of the mode (.async(options: Set<AsyncConcurrencyModeOption>) and .async(Writer, options: Set<AsyncConcurrencyModeOption>)).Writer protocol log() method to write(_ entry: Writer.LogEntry) to make it easier to process messages by writers and formatters.Writer return to Swift.Result<Int, FailedReason> to return instructions for TraceLog for buffering and error recovery.ConsoleWriter to accept new OutputStreamFormatter instances allowing you to customize the output log format (default is TextFormat.)FileWriter public interface
FileWriter now requires the log directory be passed in, removing default value of ./.fileConfiguration parameter replacing with new strategy enum.OutputStreamFormatter instances allowing you to customize the output log format (default is TextFormat.)FileWriter archive file name date format to "yyyyMMdd-HHmm-ss-SSS" (This was done for maximum compatibility between platforms and can be overridden in the FileConfiguration object passed at init.)TextFormat to add var encoding: String.Encoding { get } requirement.JSONFormat to add var encoding: String.Encoding { get } requirement.AsyncOption to AsyncConcurrencyModeOption.OutputStreamFormatter, it now requires var encoding: String.Encoding { get }.FileWriter.FileStrategy to FileWriter.Strategy.FileWriter.Strategy.RotateOption to FileWriter.Strategy.RotationOption.TraceLogTestHarness module.logTrace when no trace level is passed. It's now the correct default value of 1 instead of 4 (issue #58).AsyncOption to AsyncConcurrencyModeOption.OutputStreamFormatter, it now requires var encoding: String.Encoding { get }.FileWriter.FileStrategy to FileWriter.Strategy.FileWriter.Strategy.RotateOption to FileWriter.Strategy.RotationOption.TextFormat to add var encoding: String.Encoding { get } requirement.JSONFormat to add var encoding: String.Encoding { get } requirement.OutputStreamFormatter protocol to define formatters for use with byte output stream type Writers.TextFormat, an implementation of a OutputStreamFormatter that formats its output based on a supplied template (this is the default formatter for Console and File output).JSONFormat, an implementation of a OutputStreamFormatter that formats its output in standard JSON format.OutputStreamWriter protocol to define types that write byte streams to their output and accept OutputStreamFormatter types to format the output.LogEntry tuple type to Writer defining the formal types that a Writer writes..buffer option for .async concurrency modes to allow for buffering when the writer is not available to write to its endpoint..async to include options for configuration of the mode (.async(options: Set<AsyncOption>) and .async(Writer, options: Set<AsyncOption>)).Writer protocol log() method to write(_ entry: Writer.LogEntry) to make it easier to process messages by writers and formatters.Writer return to Swift.Result<Int, FailedReason> to return instructions for TraceLog for buffering and error recovery.ConsoleWriter to accept new OutputStreamFormatter instances allowing you to customize the output log format (default is TextFormat.)FileWriter public interface
FileWriter now requires the log directory be passed in, removing default value of ./.fileConfiguration parameter replacing with new strategy enum.OutputStreamFormatter instances allowing you to customize the output log format (default is TextFormat.)FileWriter archive file name date format to "yyyyMMdd-HHmm-ss-SSS" (This was done for maximum compatibility between platforms and can be overridden in the FileConfiguration object passed at init.)TraceLogTestHarness module.logTrace when no trace level is passed. It's now the correct default value of 1 instead of 4 (issue #58).FileWriter class for writing to local log files.TestHarness to assist developers in testing their own Writer types.shell utility to assist in testing Writer types.TestHarness and other Utilities.TestHarness to assist developers in testing their own Writer types.shell utility to assist in testing Writer types.TestHarness and other Utilities.UnifiedLoggingWriter and instead using external AdaptiveSystemLogWriter which adapts to various platforms for latest system log.