{"id":1349,"url":"https://github.com/xareelee/XLTestLog","last_synced_at":"2025-08-02T04:30:53.642Z","repository":{"id":30337600,"uuid":"33889967","full_name":"xareelee/XLTestLog","owner":"xareelee","description":"Styling and coloring your XCTest logs on Xcode Console","archived":false,"fork":false,"pushed_at":"2016-10-11T14:26:15.000Z","size":1567,"stargazers_count":56,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-26T04:13:55.522Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xareelee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-04-13T19:46:52.000Z","updated_at":"2023-12-15T09:33:10.000Z","dependencies_parsed_at":"2022-07-31T09:07:55.781Z","dependency_job_id":null,"html_url":"https://github.com/xareelee/XLTestLog","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/xareelee/XLTestLog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xareelee%2FXLTestLog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xareelee%2FXLTestLog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xareelee%2FXLTestLog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xareelee%2FXLTestLog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xareelee","download_url":"https://codeload.github.com/xareelee/XLTestLog/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xareelee%2FXLTestLog/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268334607,"owners_count":24233793,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-01-05T20:15:44.398Z","updated_at":"2025-08-02T04:30:53.341Z","avatar_url":"https://github.com/xareelee.png","language":"Objective-C","funding_links":[],"categories":["Logging","Objective-C"],"sub_categories":["Other Hardware","Other free courses"],"readme":"# XLTestLog\n\n## Notes with Xcode 8 and XLTestLog\n\nSince [Xcode 8 killed XcodeColors](https://github.com/robbiehanson/XcodeColors/issues/88), 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.\n\nXLTestLog v1.1+ will remove **\"color code\"** from logs if you don't privide a `UseXcodeColors == YES` preprocess macro.\n\n\n## Introduction\n\n**XLTestLog** is a lightweight library for stylish XCTest logs. It makes your testing logs more readable in Xcode Console.\n\n - Reformat the log messages to make them more readable.\n - Use indentations and Emoji bullets for different logs.\n - Paint log messages and highlight important keywords using [XcodeColors].\n - Only test logs will be styled. You can distinguish colored test logs from other logs (e.g. `NSLog()`).\n\nThe following is an example for test results in Xcode Console using XLTestLog:\n\n![](./Docs/Images/withXLTestLog.png)\n\n\nAnd this is without using XLTestLog:\n\n![](./Docs/Images/withoutXLTestLog.png)\n\n\nThe 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 from`NSLog()`)**:\n\n```objc\n@implementation XLTestLogDevTests\n\n- (void)testPassedCase {\n  XCTAssert(YES, @\"Pass\");\n  NSLog(@\"This is a message from `NSLog()`.\");\n}\n\n- (void)testFailureCase {\n  XCTAssert(NO, @\"Fail\");\n}\n\n- (void)testPerformanceExample {\n  // This is an example of a performance test case.\n  [self measureBlock:^{\n    int j = 0;\n    for (int i = 0; i \u003c 1000000; i++) {\n      j += i;\n    }\n  }];\n}\n@end\n```\n\n## How to use\n\nNo additional code is needed to use XLTestLog.\n\n1. Include XLTestLog in your test target (see [Installation section](#installation)).\n2. Install [XcodeColors] plugin.\n3. Just run your test, and see the delightful logs in the Xcode Console.\n\n\n## Release Notes\n\n### You should also install XcodeColors\n\nCurrently, you should use XLTestLog with [XcodeColors]. If you don't, it would show the color code in the logs.\n\nIn the next release, XLTestLog will [read the environment variable `XcodeColors`](https://github.com/robbiehanson/XcodeColors#option-1-manual-use--custom-macros) to decide whether using XcodeColors to paint log messages or not.\n\n\n\n## Installation\n\nBefore installing XLTestLog, please read the section **Release Notes**.\n\n### via CocoaPods\n\nYou can install XLTestLog simply via [CocoaPods]:\n\n```\ntarget :MyAppTests do\n  pod 'XLTestLog'\nend\n```\n\n\n### Manually\n\nYou can install XLTestLog manually via adding files in `XLTestLog/` directory into your project.\n\n\n\n## About\n\n### Contribution\n\nAny help would be most welcome. Even buy me a beer. :p\n\n\n### Author\n* Xaree Lee (李岡諭, Kang-Yu Lee), an iOS developer from Taiwan.\n    - \u003cxareelee@gmail.com\u003e\n\n\n### License\nXLTestLog is available under the MIT license. See the [LICENSE] file for more info.\n\n\n\n[CocoaPods]: https://cocoapods.org\n[XcodeColors]: https://github.com/robbiehanson/XcodeColors\n[LICENSE]: ./LICENSE.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxareelee%2FXLTestLog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxareelee%2FXLTestLog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxareelee%2FXLTestLog/lists"}