- Update

Vendor/CocoaLumberjack/Extensions/DDContextFilterLogFormatter.h

@@ -0,0 +1,63 @@
+#import <Foundation/Foundation.h>
+#import "DDLog.h"
+
+/**
+ * Welcome to Cocoa Lumberjack!
+ * 
+ * The project page has a wealth of documentation if you have any questions.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack
+ * 
+ * If you're new to the project you may wish to read the "Getting Started" page.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack/wiki/GettingStarted
+ * 
+ * 
+ * This class provides a log formatter that filters log statements from a logging context not on the whitelist.
+ * 
+ * A log formatter can be added to any logger to format and/or filter its output.
+ * You can learn more about log formatters here:
+ * https://github.com/CocoaLumberjack/CocoaLumberjack/wiki/CustomFormatters
+ * 
+ * You can learn more about logging context's here:
+ * https://github.com/CocoaLumberjack/CocoaLumberjack/wiki/CustomContext
+ *
+ * But here's a quick overview / refresher:
+ * 
+ * Every log statement has a logging context.
+ * These come from the underlying logging macros defined in DDLog.h.
+ * The default logging context is zero.
+ * You can define multiple logging context's for use in your application.
+ * For example, logically separate parts of your app each have a different logging context.
+ * Also 3rd party frameworks that make use of Lumberjack generally use their own dedicated logging context.
+**/
+@interface DDContextWhitelistFilterLogFormatter : NSObject <DDLogFormatter>
+
+- (id)init;
+
+- (void)addToWhitelist:(int)loggingContext;
+- (void)removeFromWhitelist:(int)loggingContext;
+
+- (NSArray *)whitelist;
+
+- (BOOL)isOnWhitelist:(int)loggingContext;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * This class provides a log formatter that filters log statements from a logging context on the blacklist.
+**/
+@interface DDContextBlacklistFilterLogFormatter : NSObject <DDLogFormatter>
+
+- (id)init;
+
+- (void)addToBlacklist:(int)loggingContext;
+- (void)removeFromBlacklist:(int)loggingContext;
+
+- (NSArray *)blacklist;
+
+- (BOOL)isOnBlacklist:(int)loggingContext;
+
+@end

Vendor/CocoaLumberjack/Extensions/DDContextFilterLogFormatter.m

@@ -0,0 +1,191 @@
+#import "DDContextFilterLogFormatter.h"
+#import <libkern/OSAtomic.h>
+
+/**
+ * Welcome to Cocoa Lumberjack!
+ * 
+ * The project page has a wealth of documentation if you have any questions.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack
+ * 
+ * If you're new to the project you may wish to read the "Getting Started" wiki.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack/wiki/GettingStarted
+**/
+
+#if ! __has_feature(objc_arc)
+#warning This file must be compiled with ARC. Use -fobjc-arc flag (or convert project to ARC).
+#endif
+
+@interface DDLoggingContextSet : NSObject
+
+- (void)addToSet:(int)loggingContext;
+- (void)removeFromSet:(int)loggingContext;
+
+- (NSArray *)currentSet;
+
+- (BOOL)isInSet:(int)loggingContext;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+@implementation DDContextWhitelistFilterLogFormatter
+{
+    DDLoggingContextSet *contextSet;
+}
+
+- (id)init
+{
+    if ((self = [super init]))
+    {
+        contextSet = [[DDLoggingContextSet alloc] init];
+    }
+    return self;
+}
+
+
+- (void)addToWhitelist:(int)loggingContext
+{
+    [contextSet addToSet:loggingContext];
+}
+
+- (void)removeFromWhitelist:(int)loggingContext
+{
+    [contextSet removeFromSet:loggingContext];
+}
+
+- (NSArray *)whitelist
+{
+    return [contextSet currentSet];
+}
+
+- (BOOL)isOnWhitelist:(int)loggingContext
+{
+    return [contextSet isInSet:loggingContext];
+}
+
+- (NSString *)formatLogMessage:(DDLogMessage *)logMessage
+{
+    if ([self isOnWhitelist:logMessage->logContext])
+        return logMessage->logMsg;
+    else
+        return nil;
+}
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+@implementation DDContextBlacklistFilterLogFormatter
+{
+    DDLoggingContextSet *contextSet;
+}
+
+- (id)init
+{
+    if ((self = [super init]))
+    {
+        contextSet = [[DDLoggingContextSet alloc] init];
+    }
+    return self;
+}
+
+
+- (void)addToBlacklist:(int)loggingContext
+{
+    [contextSet addToSet:loggingContext];
+}
+
+- (void)removeFromBlacklist:(int)loggingContext
+{
+    [contextSet removeFromSet:loggingContext];
+}
+
+- (NSArray *)blacklist
+{
+    return [contextSet currentSet];
+}
+
+- (BOOL)isOnBlacklist:(int)loggingContext
+{
+    return [contextSet isInSet:loggingContext];
+}
+
+- (NSString *)formatLogMessage:(DDLogMessage *)logMessage
+{
+    if ([self isOnBlacklist:logMessage->logContext])
+        return nil;
+    else
+        return logMessage->logMsg;
+}
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+@implementation DDLoggingContextSet
+{
+    OSSpinLock lock;
+    NSMutableSet *set;
+}
+
+- (id)init
+{
+    if ((self = [super init]))
+    {
+        set = [[NSMutableSet alloc] init];
+    }
+    return self;
+}
+
+
+- (void)addToSet:(int)loggingContext
+{
+    OSSpinLockLock(&lock);
+    {
+        [set addObject:@(loggingContext)];
+    }
+    OSSpinLockUnlock(&lock);
+}
+
+- (void)removeFromSet:(int)loggingContext
+{
+    OSSpinLockLock(&lock);
+    {
+        [set removeObject:@(loggingContext)];
+    }
+    OSSpinLockUnlock(&lock);
+}
+
+- (NSArray *)currentSet
+{
+    NSArray *result = nil;
+    
+    OSSpinLockLock(&lock);
+    {
+        result = [set allObjects];
+    }
+    OSSpinLockUnlock(&lock);
+    
+    return result;
+}
+
+- (BOOL)isInSet:(int)loggingContext
+{
+    BOOL result = NO;
+    
+    OSSpinLockLock(&lock);
+    {
+        result = [set containsObject:@(loggingContext)];
+    }
+    OSSpinLockUnlock(&lock);
+    
+    return result;
+}
+
+@end

Vendor/CocoaLumberjack/Extensions/DDDispatchQueueLogFormatter.h

@@ -0,0 +1,128 @@
+#import <Foundation/Foundation.h>
+#import <libkern/OSAtomic.h>
+#import "DDLog.h"
+
+
+/**
+ * Welcome to Cocoa Lumberjack!
+ * 
+ * The project page has a wealth of documentation if you have any questions.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack
+ * 
+ * If you're new to the project you may wish to read the "Getting Started" page.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack/wiki/GettingStarted
+ * 
+ * 
+ * This class provides a log formatter that prints the dispatch_queue label instead of the mach_thread_id.
+ * 
+ * A log formatter can be added to any logger to format and/or filter its output.
+ * You can learn more about log formatters here:
+ * https://github.com/CocoaLumberjack/CocoaLumberjack/wiki/CustomFormatters
+ * 
+ * A typical NSLog (or DDTTYLogger) prints detailed info as [<process_id>:<thread_id>].
+ * For example:
+ * 
+ * 2011-10-17 20:21:45.435 AppName[19928:5207] Your log message here
+ * 
+ * Where:
+ * - 19928 = process id
+ * -  5207 = thread id (mach_thread_id printed in hex)
+ * 
+ * When using grand central dispatch (GCD), this information is less useful.
+ * This is because a single serial dispatch queue may be run on any thread from an internally managed thread pool.
+ * For example:
+ * 
+ * 2011-10-17 20:32:31.111 AppName[19954:4d07] Message from my_serial_dispatch_queue
+ * 2011-10-17 20:32:31.112 AppName[19954:5207] Message from my_serial_dispatch_queue
+ * 2011-10-17 20:32:31.113 AppName[19954:2c55] Message from my_serial_dispatch_queue
+ * 
+ * This formatter allows you to replace the standard [box:info] with the dispatch_queue name.
+ * For example:
+ * 
+ * 2011-10-17 20:32:31.111 AppName[img-scaling] Message from my_serial_dispatch_queue
+ * 2011-10-17 20:32:31.112 AppName[img-scaling] Message from my_serial_dispatch_queue
+ * 2011-10-17 20:32:31.113 AppName[img-scaling] Message from my_serial_dispatch_queue
+ * 
+ * If the dispatch_queue doesn't have a set name, then it falls back to the thread name.
+ * If the current thread doesn't have a set name, then it falls back to the mach_thread_id in hex (like normal).
+ * 
+ * Note: If manually creating your own background threads (via NSThread/alloc/init or NSThread/detachNeThread),
+ * you can use [[NSThread currentThread] setName:(NSString *)].
+**/
+@interface DDDispatchQueueLogFormatter : NSObject <DDLogFormatter> {
+@protected
+    
+    NSString *dateFormatString;
+}
+
+/**
+ * Standard init method.
+ * Configure using properties as desired.
+**/
+- (id)init;
+
+/**
+ * The minQueueLength restricts the minimum size of the [detail box].
+ * If the minQueueLength is set to 0, there is no restriction.
+ * 
+ * For example, say a dispatch_queue has a label of "diskIO":
+ * 
+ * If the minQueueLength is 0: [diskIO]
+ * If the minQueueLength is 4: [diskIO]
+ * If the minQueueLength is 5: [diskIO]
+ * If the minQueueLength is 6: [diskIO]
+ * If the minQueueLength is 7: [diskIO ]
+ * If the minQueueLength is 8: [diskIO  ]
+ * 
+ * The default minQueueLength is 0 (no minimum, so [detail box] won't be padded).
+ * 
+ * If you want every [detail box] to have the exact same width,
+ * set both minQueueLength and maxQueueLength to the same value.
+**/
+@property (assign) NSUInteger minQueueLength;
+
+/**
+ * The maxQueueLength restricts the number of characters that will be inside the [detail box].
+ * If the maxQueueLength is 0, there is no restriction.
+ * 
+ * For example, say a dispatch_queue has a label of "diskIO":
+ *
+ * If the maxQueueLength is 0: [diskIO]
+ * If the maxQueueLength is 4: [disk]
+ * If the maxQueueLength is 5: [diskI]
+ * If the maxQueueLength is 6: [diskIO]
+ * If the maxQueueLength is 7: [diskIO]
+ * If the maxQueueLength is 8: [diskIO]
+ * 
+ * The default maxQueueLength is 0 (no maximum, so [detail box] won't be truncated).
+ * 
+ * If you want every [detail box] to have the exact same width,
+ * set both minQueueLength and maxQueueLength to the same value.
+**/
+@property (assign) NSUInteger maxQueueLength;
+
+/**
+ * Sometimes queue labels have long names like "com.apple.main-queue",
+ * but you'd prefer something shorter like simply "main".
+ * 
+ * This method allows you to set such preferred replacements.
+ * The above example is set by default.
+ * 
+ * To remove/undo a previous replacement, invoke this method with nil for the 'shortLabel' parameter.
+**/
+- (NSString *)replacementStringForQueueLabel:(NSString *)longLabel;
+- (void)setReplacementString:(NSString *)shortLabel forQueueLabel:(NSString *)longLabel;
+
+@end
+
+/**
+ * Method declarations that make it easier to extend/modify DDDispatchQueueLogFormatter
+**/
+@interface DDDispatchQueueLogFormatter (OverridableMethods)
+
+- (NSString *)stringFromDate:(NSDate *)date;
+- (NSString *)queueThreadLabelForLogMessage:(DDLogMessage *)logMessage;
+- (NSString *)formatLogMessage:(DDLogMessage *)logMessage;
+
+@end
+

Vendor/CocoaLumberjack/Extensions/DDDispatchQueueLogFormatter.m

@@ -0,0 +1,253 @@
+#import "DDDispatchQueueLogFormatter.h"
+#import <libkern/OSAtomic.h>
+
+/**
+ * Welcome to Cocoa Lumberjack!
+ * 
+ * The project page has a wealth of documentation if you have any questions.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack
+ * 
+ * If you're new to the project you may wish to read the "Getting Started" wiki.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack/wiki/GettingStarted
+**/
+
+#if ! __has_feature(objc_arc)
+#warning This file must be compiled with ARC. Use -fobjc-arc flag (or convert project to ARC).
+#endif
+
+
+@implementation DDDispatchQueueLogFormatter
+{
+    int32_t atomicLoggerCount;
+    NSDateFormatter *threadUnsafeDateFormatter; // Use [self stringFromDate]
+    
+    OSSpinLock lock;
+    
+    NSUInteger _minQueueLength;           // _prefix == Only access via atomic property
+    NSUInteger _maxQueueLength;           // _prefix == Only access via atomic property
+    NSMutableDictionary *_replacements;   // _prefix == Only access from within spinlock
+}
+
+- (id)init
+{
+    if ((self = [super init]))
+    {
+        dateFormatString = @"yyyy-MM-dd HH:mm:ss:SSS";
+        
+        atomicLoggerCount = 0;
+        threadUnsafeDateFormatter = nil;
+        
+        _minQueueLength = 0;
+        _maxQueueLength = 0;
+        _replacements = [[NSMutableDictionary alloc] init];
+        
+        // Set default replacements:
+        
+        _replacements[@"com.apple.main-thread"] = @"main";
+    }
+    return self;
+}
+
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark Configuration
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+@synthesize minQueueLength = _minQueueLength;
+@synthesize maxQueueLength = _maxQueueLength;
+
+- (NSString *)replacementStringForQueueLabel:(NSString *)longLabel
+{
+    NSString *result = nil;
+    
+    OSSpinLockLock(&lock);
+    {
+        result = _replacements[longLabel];
+    }
+    OSSpinLockUnlock(&lock);
+    
+    return result;
+}
+
+- (void)setReplacementString:(NSString *)shortLabel forQueueLabel:(NSString *)longLabel
+{
+    OSSpinLockLock(&lock);
+    {
+        if (shortLabel)
+            _replacements[longLabel] = shortLabel;
+        else
+            [_replacements removeObjectForKey:longLabel];
+    }
+    OSSpinLockUnlock(&lock);
+}
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark DDLogFormatter
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+- (NSString *)stringFromDate:(NSDate *)date
+{
+    int32_t loggerCount = OSAtomicAdd32(0, &atomicLoggerCount);
+    
+    if (loggerCount <= 1)
+    {
+        // Single-threaded mode.
+        
+        if (threadUnsafeDateFormatter == nil)
+        {
+            threadUnsafeDateFormatter = [[NSDateFormatter alloc] init];
+            [threadUnsafeDateFormatter setFormatterBehavior:NSDateFormatterBehavior10_4];
+            [threadUnsafeDateFormatter setDateFormat:dateFormatString];
+        }
+        
+        [threadUnsafeDateFormatter setCalendar:[[NSCalendar alloc] initWithCalendarIdentifier:NSCalendarIdentifierGregorian]];
+        return [threadUnsafeDateFormatter stringFromDate:date];
+    }
+    else
+    {
+        // Multi-threaded mode.
+        // NSDateFormatter is NOT thread-safe.
+        
+        NSString *key = @"DispatchQueueLogFormatter_NSDateFormatter";
+        
+        NSMutableDictionary *threadDictionary = [[NSThread currentThread] threadDictionary];
+        NSDateFormatter *dateFormatter = threadDictionary[key];
+        
+        if (dateFormatter == nil)
+        {
+            dateFormatter = [[NSDateFormatter alloc] init];
+            [dateFormatter setFormatterBehavior:NSDateFormatterBehavior10_4];
+            [dateFormatter setDateFormat:dateFormatString];
+            
+            threadDictionary[key] = dateFormatter;
+        }
+        
+        [dateFormatter setCalendar:[[NSCalendar alloc] initWithCalendarIdentifier:NSCalendarIdentifierGregorian]];
+        return [dateFormatter stringFromDate:date];
+    }
+}
+
+- (NSString *)queueThreadLabelForLogMessage:(DDLogMessage *)logMessage
+{
+    // As per the DDLogFormatter contract, this method is always invoked on the same thread/dispatch_queue
+    
+    NSUInteger minQueueLength = self.minQueueLength;
+    NSUInteger maxQueueLength = self.maxQueueLength;
+    
+    // Get the name of the queue, thread, or machID (whichever we are to use).
+    
+    NSString *queueThreadLabel = nil;
+    
+    BOOL useQueueLabel = YES;
+    BOOL useThreadName = NO;
+    
+    if (logMessage->queueLabel)
+    {
+        // If you manually create a thread, it's dispatch_queue will have one of the thread names below.
+        // Since all such threads have the same name, we'd prefer to use the threadName or the machThreadID.
+        
+        char *names[] = { "com.apple.root.low-priority",
+                          "com.apple.root.default-priority",
+                          "com.apple.root.high-priority",
+                          "com.apple.root.low-overcommit-priority",
+                          "com.apple.root.default-overcommit-priority",
+                          "com.apple.root.high-overcommit-priority"     };
+        
+        int length = sizeof(names) / sizeof(char *);
+        
+        int i;
+        for (i = 0; i < length; i++)
+        {
+            if (strcmp(logMessage->queueLabel, names[i]) == 0)
+            {
+                useQueueLabel = NO;
+                useThreadName = [logMessage->threadName length] > 0;
+                break;
+            }
+        }
+    }
+    else
+    {
+        useQueueLabel = NO;
+        useThreadName = [logMessage->threadName length] > 0;
+    }
+    
+    if (useQueueLabel || useThreadName)
+    {
+        NSString *fullLabel;
+        NSString *abrvLabel;
+        
+        if (useQueueLabel)
+            fullLabel = @(logMessage->queueLabel);
+        else
+            fullLabel = logMessage->threadName;
+        
+        OSSpinLockLock(&lock);
+        {
+            abrvLabel = _replacements[fullLabel];
+        }
+        OSSpinLockUnlock(&lock);
+        
+        if (abrvLabel)
+            queueThreadLabel = abrvLabel;
+        else
+            queueThreadLabel = fullLabel;
+    }
+    else
+    {
+        queueThreadLabel = [NSString stringWithFormat:@"%x", logMessage->machThreadID];
+    }
+    
+    // Now use the thread label in the output
+    
+    NSUInteger labelLength = [queueThreadLabel length];
+    
+    // labelLength > maxQueueLength : truncate
+    // labelLength < minQueueLength : padding
+    //                              : exact
+    
+    if ((maxQueueLength > 0) && (labelLength > maxQueueLength))
+    {
+        // Truncate
+        
+        return [queueThreadLabel substringToIndex:maxQueueLength];
+    }
+    else if (labelLength < minQueueLength)
+    {
+        // Padding
+        
+        NSUInteger numSpaces = minQueueLength - labelLength;
+        
+        char spaces[numSpaces + 1];
+        memset(spaces, ' ', numSpaces);
+        spaces[numSpaces] = '\0';
+        
+        return [NSString stringWithFormat:@"%@%s", queueThreadLabel, spaces];
+    }
+    else
+    {
+        // Exact
+        
+        return queueThreadLabel;
+    }
+}
+
+- (NSString *)formatLogMessage:(DDLogMessage *)logMessage
+{
+    NSString *timestamp = [self stringFromDate:(logMessage->timestamp)];
+    NSString *queueThreadLabel = [self queueThreadLabelForLogMessage:logMessage];
+    
+    return [NSString stringWithFormat:@"%@ [%@] %@", timestamp, queueThreadLabel, logMessage->logMsg];
+}
+
+- (void)didAddToLogger:(id <DDLogger>)logger
+{
+    OSAtomicIncrement32(&atomicLoggerCount);
+}
+
+- (void)willRemoveFromLogger:(id <DDLogger>)logger
+{
+    OSAtomicDecrement32(&atomicLoggerCount);
+}
+
+@end

Vendor/CocoaLumberjack/Extensions/DDMultiFormatter.h

@@ -0,0 +1,30 @@
+#import <Foundation/Foundation.h>
+#import "DDLog.h"
+
+/**
+ * Welcome to Cocoa Lumberjack!
+ *
+ * The project page has a wealth of documentation if you have any questions.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack
+ *
+ * If you're new to the project you may wish to read the "Getting Started" page.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack/wiki/GettingStarted
+ *
+ *
+ * This formatter can be used to chain different formatters together.
+ * The log message will processed in the order of the formatters added.
+ **/
+
+@interface DDMultiFormatter : NSObject <DDLogFormatter>
+
+/**
+ *  Array of chained formatters
+ */
+@property (readonly) NSArray *formatters;
+
+- (void)addFormatter:(id<DDLogFormatter>)formatter;
+- (void)removeFormatter:(id<DDLogFormatter>)formatter;
+- (void)removeAllFormatters;
+- (BOOL)isFormattingWithFormatter:(id<DDLogFormatter>)formatter;
+
+@end

Vendor/CocoaLumberjack/Extensions/DDMultiFormatter.m

@@ -0,0 +1,127 @@
+#import "DDMultiFormatter.h"
+
+/**
+ * Welcome to Cocoa Lumberjack!
+ *
+ * The project page has a wealth of documentation if you have any questions.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack
+ *
+ * If you're new to the project you may wish to read the "Getting Started" page.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack/wiki/GettingStarted
+ **/
+
+#if TARGET_OS_IPHONE
+// Compiling for iOS
+#if __IPHONE_OS_VERSION_MIN_REQUIRED >= 60000 // iOS 6.0 or later
+#define NEEDS_DISPATCH_RETAIN_RELEASE 0
+#else                                         // iOS 5.X or earlier
+#define NEEDS_DISPATCH_RETAIN_RELEASE 1
+#endif
+#else
+// Compiling for Mac OS X
+#if MAC_OS_X_VERSION_MIN_REQUIRED >= 1080     // Mac OS X 10.8 or later
+#define NEEDS_DISPATCH_RETAIN_RELEASE 0
+#else                                         // Mac OS X 10.7 or earlier
+#define NEEDS_DISPATCH_RETAIN_RELEASE 1
+#endif
+#endif
+
+
+@interface DDMultiFormatter ()
+
+- (DDLogMessage *)logMessageForLine:(NSString *)line originalMessage:(DDLogMessage *)message;
+
+@end
+
+
+@implementation DDMultiFormatter {
+    dispatch_queue_t _queue;
+    NSMutableArray *_formatters;
+}
+
+- (id)init {
+    self = [super init];
+    if (self) {
+#if MAC_OS_X_VERSION_MIN_REQUIRED >= 1070
+        _queue = dispatch_queue_create("cocoa.lumberjack.multiformatter", DISPATCH_QUEUE_CONCURRENT);
+#else
+        _queue = dispatch_queue_create("cocoa.lumberjack.multiformatter", NULL);
+#endif
+        _formatters = [NSMutableArray new];
+    }
+    
+    return self;
+}
+
+#if NEEDS_DISPATCH_RETAIN_RELEASE
+- (void)dealloc {
+    dispatch_release(_queue);
+}
+#endif
+
+#pragma mark Processing
+
+- (NSString *)formatLogMessage:(DDLogMessage *)logMessage {
+    __block NSString *line = logMessage->logMsg;
+    
+    dispatch_sync(_queue, ^{
+        for (id<DDLogFormatter> formatter in _formatters) {
+            DDLogMessage *message = [self logMessageForLine:line originalMessage:logMessage];
+            line = [formatter formatLogMessage:message];
+            
+            if (!line) {
+                break;
+            }
+        }
+    });
+    
+    return line;
+}
+
+- (DDLogMessage *)logMessageForLine:(NSString *)line originalMessage:(DDLogMessage *)message {
+    DDLogMessage *newMessage = [message copy];
+    newMessage->logMsg = line;
+    return newMessage;
+}
+
+#pragma mark Formatters
+
+- (NSArray *)formatters {
+    __block NSArray *formatters;
+    
+    dispatch_sync(_queue, ^{
+        formatters = [_formatters copy];
+    });
+    
+    return formatters;
+}
+
+- (void)addFormatter:(id<DDLogFormatter>)formatter {
+    dispatch_barrier_async(_queue, ^{
+        [_formatters addObject:formatter];
+    });
+}
+
+- (void)removeFormatter:(id<DDLogFormatter>)formatter {
+    dispatch_barrier_async(_queue, ^{
+        [_formatters removeObject:formatter];
+    });
+}
+
+- (void)removeAllFormatters {
+    dispatch_barrier_async(_queue, ^{
+        [_formatters removeAllObjects];
+    });
+}
+
+- (BOOL)isFormattingWithFormatter:(id<DDLogFormatter>)formatter {
+    __block BOOL hasFormatter;
+    
+    dispatch_sync(_queue, ^{
+        hasFormatter = [_formatters containsObject:formatter];
+    });
+    
+    return hasFormatter;
+}
+
+@end

Vendor/CocoaLumberjack/Extensions/README.txt

@@ -0,0 +1,7 @@
+This folder contains some sample formatters that may be helpful.
+
+Feel free to change them, extend them, or use them as the basis for your own custom formatter(s).
+
+More information about creating your own custom formatters can be found on the wiki:
+https://github.com/CocoaLumberjack/CocoaLumberjack/wiki/CustomFormatters
+