Xcode Logger is a fast (up to *6x times faster than NSLog and up to 4x times faster than CocoaLumberjack), extremely simple to use, very flexible library which provides scheme-based, customizable and theme based, colorful and filterable NSLog replacements.

*based on synchronous tests running on main thread, comparing XLog_NH vs NSLog vs DDLogVerbose, average operation time after 5 runs with 5000 iterations per test, per run on a MacBook Pro Retina. Xcode Logger had colors enabled for every level while for CocoaLumberjack the colors were disabled.

Xcode Logger has been tested on iOS 7, 8 and OSX. It requires ARC. ![Xcode Logger - Light Theme] (http://i.imgur.com/6yQRTdE.jpg) ![Xcode Logger - Dark Theme] (http://i.imgur.com/OBs2kjH.jpg) ![Xcode Logger Performance: Synchronous Tests] (http://i.imgur.com/MgXsE94.jpg?1) ![Xcode Logger Performance: Asynchronous Tests] (http://i.imgur.com/xlmpt2G.jpg)

Xcode Logger provides multiple types of scheme dependent and independent loggers with multiple levels of logging. It ships by default as plug-and-play with the following types of loggers:

• DLog()  - DEBUG
• DVLog() - DEVELOPMENT
• DDLog() - DEBUG and DEVELOPMENT (a shared log type for both schemes)
• OLog()  - ONLINE SERVICES
• XLog()  - NSLog type (replicates NSLog's behaviour: scheme independent.)

Every log type has the following log levels:

• Simple logger (ex: XLog())
• Simple logger without any header information - _NH (ex: XLog_NH())
• Information logger - _INFO (ex: XLog_INFO())
• Highlight logger - _HIGHLIGHT
• Warning logger - _WARNING
• Error logger - _ERROR

Extremely easy to use, filterable log levels per class.

Color Themes with UIColor, NSColor and RGB colors support (Themers, you're needed here!).

Almost every log type and level can be can be customized as follows:

• Running scheme (except XLog & DDLog types).
• Log Informations Header (except _NH).
• Log status description for all log types and levels (except _NH) which can be used as an argument in custom or default headers.
• Text Color for output (overwrite values from the loaded theme).
• Background Color for output (overwrite values from the loaded theme).
• Number of new lines (spaces) between header and output or between output and the next log statement.
• Timestamp format for timestamp argument in information header.

pod 'XcodeLogger'

Clone or download the repository and add the Xcode Logger folder and its contents to your project.

1. Optional: If you want to have color loggers and you don't have the Xcode Colors plugin installed, you will need to install it.

2. Optional: If you want to use the scheme-dependent loggers, you'll need to create schemes based on your needs and link them with the appropriate logger types (see Scheme linking under How to use). Official information regarding Xcode's schemes can be found here.

3. Required for #2:In order for Xcode Logger to determine your current scheme, Xcode will need to be able to add a value for a key in your project's Info.plist file when building your project so there are two things you'll need to do: First, create a key entry for a string value in your Info.plist file while leaving the value field empty like in the example below: Next you'll need to add the following script to your every scheme under Build > Pre-actions. Be sure to select a target from which to build from! Tip: do this before creating any second custom scheme and just duplicate the scheme.

#This script will provide that value at runtime.
#You can change "XLRunningScheme" with whatever key name you wish as long as it matches the one from Info.plist.

/usr/libexec/PlistBuddy -c "Set :XLRunningScheme \"$SCHEME_NAME\"" "$PROJECT_DIR/$INFOPLIST_FILE"		

![Add the script to your schema] (http://i57.tinypic.com/6thddw.jpg)

To start using Xcode Logger all you have to do is to #import "XcodeLogger.h" in your classes and use the XLog type logger with all its levels as a replacement for NSLog.

To start using scheme-dependent loggers you'll need to do the following (considering you've followed the optional but now-required steps from Setup):

Tell Xcode Logger the name of the key you've defined in your Info.plist and script by calling:

[[XcodeLogger sharedManager] setInfoPlistKeyNameForRunningSchemes:@"XLRunningScheme"];

Link a running scheme name with a logger type:

//Example for setting a scheme for DLog type logger
[[XcodeLogger sharedManager] setBuildSchemeName:@"XL Debug"
                             		forXLogType:XLOGGER_TYPE_DEBUG];

XLOGGER_TYPES:

XLOGGER_TYPE_NSLOG_REPLACEMENT, //XLog
XLOGGER_TYPE_DEBUG,             //DLog
XLOGGER_TYPE_DEVELOPMENT,       //DVLog
XLOGGER_TYPE_DEBUG_DEVELOPMENT, //DDLog
XLOGGER_TYPE_ONLINE_SERVICES    //OLog

That's it!

NOTE: you can't link a scheme with XLOGGER_TYPE_NSLOG_REPLACEMENT or XLOGGER_TYPE_DEBUG_DEVELOPMENT because of their intended purposes. Doing so, will raise an exception.

You can filter single or multiple log levels per class (implementation file).

You have two options: either use a method and set the implementation file name manually or you can use a convenience macro that greatly simplifies the whole process.

//The following examples will output only warnings and errors

//Example Option 1 
//You can call this anywhere since you manually set the file name
[[XcodeLogger sharedManager] filterXLogLevels:@[XL_LEVEL_WARNING,XL_LEVEL_ERROR]
                                  forFileName:@"AppDelegate.m"];

//Example Option 2
//You must call this in the implementation file where you need filters
XL_FILTER_LEVELS(XL_LEVEL_WARNING,XL_LEVEL_ERROR);

//Convenience wrappers for XLOGGER_LEVEL_### enums
XL_LEVEL_SIMPLE           
XL_LEVEL_SIMPLE_NO_HEADER 
XL_LEVEL_INFORMATION      
XL_LEVEL_HIGHLIGHT        
XL_LEVEL_WARNING         
XL_LEVEL_ERROR            

You can change the default and customize the informations header for any XLOGGER_TYPE and XLOGGER_LEVEL like this:

//Example for changing the default Log Status Description
//NEW METHOD
[[XcodeLogger sharedManager] setLogHeaderDescription:@"DEVLOG_INFO"
								          forLogType:XLOGGER_TYPE_DEVELOPMENT
								               level:XLOGGER_LEVEL_INFORMATION];

//Example for changing the informations header for DVLog_INFO()
//This will set the header to show a timestamp followed by the line number
[[XcodeLogger sharedManager] setHeaderForXLogType:XLOGGER_TYPE_DEVELOPMENT
                          					level:XLOGGER_LEVEL_INFORMATION
                          				   format:@"{%@}->[%@]::[#%@]"
                         				arguments:@[XL_ARG_LOG_DESCRIPTION,XL_ARG_TIMESTAMP,XL_ARG_LINE_NUMBER]];

NOTE: you can use XLOGGER_ALL_LEVELS enum to set the same header format for all levels of an XLOGGER_TYPE.

// XLOGGER_LEVELS:

XLOGGER_LEVEL_SIMPLE,          
XLOGGER_LEVEL_SIMPLE_NO_HEADER, //_NH
XLOGGER_LEVEL_INFORMATION,		//_INFO
XLOGGER_LEVEL_HIGHLIGHT,		//_HIGHLIGHT
XLOGGER_LEVEL_WARNING,			//_WARNING
XLOGGER_LEVEL_ERROR,			//_ERROR
XLOGGER_ALL_LEVELS

// XL_ARG macros:

XL_ARG_LOG_DESCRIPTION
XL_ARG_TIMESTAMP      
XL_ARG_CALLEE_ADDRESS 
XL_ARG_CALLEE_METHOD  
XL_ARG_LINE_NUMBER    
XL_ARG_FILE_NAME     

NOTE: the default headers contain the following informations (in order):

[Logger_Type_Level](Timestamp)=> [>Callee_Memory_Address<]:Callee_File_Name:[#Line_Number]:[>Callee_Method<]

If you want you can add or remove new lines (spaces) between the header and the log output by calling:

- (void)setNumberOfNewLinesAfterHeader:(NSUInteger)paramNumberOfLines
                           forXLogType:(XLOGGER_TYPE)paramXLogType
                                 level:(XLOGGER_LEVEL)paramXLogLevel;

Or, add or remove new lines (spaces) between the output and the next log statement by calling:

- (void)setNumberOfNewLinesAfterOutput:(NSUInteger)paramNumberOfLines
                           forXLogType:(XLOGGER_TYPE)paramXLogType
                                 level:(XLOGGER_LEVEL)paramXLogLevel;

You can also change the timestamp format by using a valid NSDateFormatter format string and by calling:

//The default is @"HH:mm:ss"
- (void)setTimestampFormat:(NSString *)paramTimestampFormat;

Xcode Logger uses color themes for its log types and levels. It comes with two default themes and you can very easily create your own.

You can use different themes for different Classes or parts of your implementation files.

You can check the available themes by calling

- (void)printAvailableColorThemes;

You can load a theme by calling:

//paramColorThemeName is case-insensitive
- (void)loadColorThemeWithName:(NSString *)paramColorThemeName;

For convenience, there are two constants defined for the default themes in XcodeLogger.h:

// THE DEFAULT COLOR THEMES FOR XCODE LOGGER
// YOU'RE INVITED TO ADD(CREATE) MORE HERE AND SEND A PULL REQUEST (check -[printColorThemeCreationInstructions])

static NSString *const XLCT_DEFAULT_LIGHT_THEME = @"DEFAULT_LIGHT_THEME";
static NSString *const XLCT_DEFAULT_DARK_THEME  = @"DEFAULT_DARK_THEME";

NOTE: Xcode Logger loads DEFAULT_LIGHT_THEME by default so you don't have to call loadColorThemeWithName: if you're not interested in changing the theme.

First of all, I would be very happy and honoured if you would contribute with new themes by sending a pull request!

All Xcode Logger's themes are defined in XLColorThemes.plist file where you can find two sample themes next to the default ones.

All you have to do is to duplicate those samples, rename and modify them accordingly while preserving the keys for every dictionary except the root key which is the theme's name.

You can use either RGB values separated by whitespace or ,./-*+ or you can use UIColor/NSColor selectors like this blackColor.

When you add a new theme in XLColorThemes.plist it would be cool if you add a constant for its name like the default ones (please use the XLCT_ prefix).

You also have detailed theme creation instructions by calling:

[[XcodeLogger sharedManager] printColorThemeCreationInstructions];

You can enable or disable support for color logs and change the text and background colors of the body of the output (headers excluded).

By default, colors are enabled but you can change this by calling:

- (void)setColorLogsEnabled:(BOOL)paramEnableColors;

You can set the text color for the output by calling:

NEW: 
//XLColor is a convenience macro for cross platform UIColor/NSColor
- (void)setTextColor:(XLColor *)paramTextColor
         forXLogType:(XLOGGER_TYPE)paramLogType
               level:(XLOGGER_LEVEL)paramLogLevel;

- (void)setTextColorForXLogType:(XLOGGER_TYPE)paramXLogType
                          level:(XLOGGER_LEVEL)paramXLogLevel
                        withRed:(NSUInteger)red
                          Green:(NSUInteger)green
                           Blue:(NSUInteger)blue;

And you can set the background color for the output by calling:

NEW:
//XLColor is a convenience macro for cross platform UIColor/NSColor
- (void)setBackgroundColor:(XLColor *)paramBackgroundColor
               forXLogType:(XLOGGER_TYPE)paramLogType
                     level:(XLOGGER_LEVEL)paramLogLevel

- (void)setBackgroundColorForXLogType:(XLOGGER_TYPE)paramXLogType
                                level:(XLOGGER_LEVEL)paramXLogLevel
                              withRed:(NSUInteger)red
                                Green:(NSUInteger)green
                                 Blue:(NSUInteger)blue;

Xcode Logger comes with a class called XLPerformanceTests. You can use its public methods to test Xcode Logger.

This repository contains code samples for both iOS and OSX.
These are GREAT to see and test some examples of uses for Xcode Logger.
You can find them in the master folder after cloning or downloading the repository.

Version 1.1.1:

• LOTS & LOTS of refactoring!
• Log Filters
• Color Themes
• UIColor / NSColor support
• Log status description customization options
• This readme file :)

This library was created and made open-source by Razvan Tanase.

You can also find me on Twitter @razvan_tanase.

I appreciate any feedback, positive or negative so I can improve this project.

You're invited and more than welcomed to contribute to this project! When you have a change you’d like to see in the master repository, please send a pull request.

The MIT License (MIT) Copyright © 2015 Razvan Tanase (Codebringers Software).