Popularity
1.7
Stable
Activity
0.0
Stable
59
2
6

Code Quality Rank: L5
Programming language: Objective-C
License: MIT License
Tags: Logging    
Latest version: v1.2.0

XLTestLog alternatives and similar libraries

Based on the "Logging" category.
Alternatively, view XLTestLog alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of XLTestLog or a related project?

Add another 'Logging' Library

README

XLTestLog

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.

Introduction

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:

[](./Docs/Images/withXLTestLog.png)

And this is without using XLTestLog:

[](./Docs/Images/withoutXLTestLog.png)

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;
    }
  }];
}
@end

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.

Installation

Before installing XLTestLog, please read the section Release Notes.

via CocoaPods

You can install XLTestLog simply via CocoaPods:

target :MyAppTests do
  pod 'XLTestLog'
end

Manually

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

About

Contribution

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

Author

License

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


*Note that all licence references and agreements mentioned in the XLTestLog README section above are relevant to that project's source code only.