Latest 1.2.0
License MIT
Platforms ios 6.0, osx 10.8, requires ARC
Frameworks Foundation, XCTest

Notes with Xcode 8 and XLTestLog

Since Xcode 8 killed XcodeColors, the current way using XCTestLog on Xcode 8 is just plain texts with emoji. You could still use XCTestLog to stylish XCTest logs without coloring.

XLTestLog v1.1+ will remove "color code" from logs if you don’t privide a UseXcodeColors == YES preprocess macro.


XLTestLog is a lightweight library for stylish XCTest logs. It makes your testing logs more readable in Xcode Console.

  • Reformat the log messages to make them more readable.
  • Use indentations and Emoji bullets for different logs.
  • Paint log messages and highlight important keywords using XcodeColors.
  • Only test logs will be styled. You can distinguish colored test logs from other logs (e.g. NSLog()).

The following is an example for test results in Xcode Console using XLTestLog:

And this is without using XLTestLog:

The readability between them is quite different. The original test code for the console logs is simple (one passed test, one failed test, one measure task, and one message fromNSLog()):

@implementation XLTestLogDevTests

- (void)testPassedCase {
  XCTAssert(YES, @"Pass");
  NSLog(@"This is a message from `NSLog()`.");

- (void)testFailureCase {
  XCTAssert(NO, @"Fail");

- (void)testPerformanceExample {
  // This is an example of a performance test case.
  [self measureBlock:^{
    int j = 0;
    for (int i = 0; i < 1000000; i++) {
      j += i;

How to use

No additional code is needed to use XLTestLog.

  1. Include XLTestLog in your test target (see Installation section).
  2. Install XcodeColors plugin.
  3. Just run your test, and see the delightful logs in the Xcode Console.

Release Notes

You should also install XcodeColors

Currently, you should use XLTestLog with XcodeColors. If you don’t, it would show the color code in the logs.

In the next release, XLTestLog will read the environment variable XcodeColors to decide whether using XcodeColors to paint log messages or not.


Before installing XLTestLog, please read the section Release Notes.

via CocoaPods

You can install XLTestLog simply via CocoaPods:

target :MyAppTests do
  pod 'XLTestLog'


You can install XLTestLog manually via adding files in XLTestLog/ directory into your project.



Any help would be most welcome. Even buy me a beer. :p



XLTestLog is available under the MIT license. See the LICENSE file for more info.

Latest podspec

    "name": "XLTestLog",
    "version": "1.2.0",
    "license": "MIT",
    "summary": "Styling and coloring your XCTest logs on Xcode Console.",
    "description": "XLTestLog is a lightweight library to style and color your XCTest logs on Xcode console for more readability.",
    "homepage": "",
    "authors": {
        "Kang-Yu Xaree Lee": "[email protected]"
    "source": {
        "git": "",
        "tag": "1.2.0",
        "submodules": true
    "requires_arc": true,
    "platforms": {
        "ios": "6.0",
        "osx": "10.8"
    "frameworks": [
    "source_files": "XLTestLog/*.{h,m}"

Pin It on Pinterest

Share This