{"id":1335,"url":"https://github.com/Esqarrouth/QorumLogs","last_synced_at":"2025-08-06T13:32:54.789Z","repository":{"id":56921553,"uuid":"42173289","full_name":"Esqarrouth/QorumLogs","owner":"Esqarrouth","description":":closed_book: Swift Logging Utility for Xcode \u0026 Google Docs ","archived":false,"fork":false,"pushed_at":"2018-04-25T21:41:34.000Z","size":105,"stargazers_count":787,"open_issues_count":8,"forks_count":83,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-08-02T23:03:47.238Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Swift","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/Esqarrouth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-09-09T10:57:33.000Z","updated_at":"2025-07-02T05:58:07.000Z","dependencies_parsed_at":"2022-08-20T21:50:26.906Z","dependency_job_id":null,"html_url":"https://github.com/Esqarrouth/QorumLogs","commit_stats":null,"previous_names":["goktugyil/qorumlogs"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/Esqarrouth/QorumLogs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esqarrouth%2FQorumLogs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esqarrouth%2FQorumLogs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esqarrouth%2FQorumLogs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esqarrouth%2FQorumLogs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Esqarrouth","download_url":"https://codeload.github.com/Esqarrouth/QorumLogs/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esqarrouth%2FQorumLogs/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268475669,"owners_count":24256153,"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.081Z","updated_at":"2025-08-06T13:32:54.490Z","avatar_url":"https://github.com/Esqarrouth.png","language":"Swift","funding_links":[],"categories":["Logging","Libs","Swift","Other","Applications"],"sub_categories":["Other Hardware","Logging","Text","Other","📦 Other (22)"],"readme":"QorumLogs\n==========\n\n[![Cocoapods Compatible](https://img.shields.io/cocoapods/v/QorumLogs.svg)](https://img.shields.io/cocoapods/v/QorumLogs.svg) [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)\n\n\u003cp\u003e\n\u003ca href=\"http://cocoapods.org/pods/QorumLogs\"\u003e\u003cimg src=\"https://img.shields.io/cocoapods/at/QorumLogs.svg?label=Apps%20Using%20QorumLogs\u0026colorB=28B9FE\"\u003e\u003c/a\u003e\n\u003ca href=\"http://cocoapods.org/pods/QorumLogs\"\u003e\u003cimg src=\"https://img.shields.io/cocoapods/dt/QorumLogs.svg?label=Total%20Downloads\u0026colorB=28B9FE\"\u003e\u003c/a\u003e\n\u003ca href=\"http://cocoapods.org/pods/QorumLogs\"\u003e\u003cimg src=\"https://img.shields.io/cocoapods/dm/QorumLogs.svg?label=Downloads\u0026colorB=28B9FE\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nSwift Logging Utility in Xcode \u0026 Google Docs\n\n## Log Levels\n\n```swift\nclass MyAwesomeViewController: UIViewController {\n    override func viewDidLoad() {\n        super.viewDidLoad()\n        QL1(\"Debug\")\n        QL2(\"Info\")\n        QL3(\"Warning\")\n        awesomeFunction()\n    }\n    func awesomeFunction() {\n        QL4(\"Error\")\n    }\n}\n```\n\n\n![demo](http://i.imgur.com/SzxTXyv.png)\n\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n## Works for both night mode and lightmode\n\n![demo](http://i.imgur.com/Zq4yUM6.png)\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n## Autocomplete Friendly: Type 2 Letters\n\n-![demo](http://i.imgur.com/3gPJHaY.gif)\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n## Filter File Specific Logs:\nPaste this where QorumLogs is initiliazed:\n```swift\n  QorumLogs.onlyShowThisFile(NewClass)\n```\n\n![demo](http://i.imgur.com/K7OWqBw.gif)\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n## Google Docs Support:\n\nIn production, send all your logs to Google Docs with only 1 line of extra code.\n```swift\n  QorumLogs.enabled = false\n  QorumOnlineLogs.enabled = true\n```\n![demo](http://i.imgur.com/TtYAHfW.png)\n\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n## Spot System Logs:\nSystem logs are white (or black) after all, yours are not :)\n\n![demo](http://i.imgur.com/rJKInKk.png)\n\n## Installation\n\n### Prerequisites\n\n1. If you don't have [Alcatraz](https://github.com/supermarin/Alcatraz) or [XcodeColors](https://github.com/robbiehanson/XcodeColors) installed, lets install them.\nOpen up your terminal and paste this:\n\n  ``` bash\ncurl -fsSL https://raw.github.com/supermarin/Alcatraz/master/Scripts/install.sh | sh\n   ```\n2. Restart Xcode after the installation\n3. Alcatraz requires Xcode Command Line Tools, which can be installed in Xcode \u003e Preferences \u003e Downloads. (You might not need this in the latest Xcode version)\n4. In Xcode click Window \u003e Package Manager, type in 'XcodeColors' in the search bar. Click Install.\n5. Restart Xcode after the installation\n\n### Install via Cocoapods\n\nYou can use [Cocoapods](http://cocoapods.org/) to install `QorumLogs` by adding it to your `Podfile`:\n```ruby\nplatform :ios, '8.0' # platform :tvos, '9.0' (for tvOS)\nuse_frameworks!\n\npod 'QorumLogs' #Stable release for Swift 3.0\n\npod 'QorumLogs', :git =\u003e 'https://github.com/goktugyil/QorumLogs.git' #Latest release for Swift 3.0\npod 'QorumLogs', :git =\u003e 'https://github.com/goktugyil/QorumLogs.git', :branch =\u003e 'Swift2.3' #For Swift 2.3\npod 'QorumLogs', '~\u003e 0.8' #For Swift 2.2\n\n```\n\n(Cocoapods forces you to import the framework in every file. If anyone has a solution or workaround, inform me please)\n\n### Install via Carthage\n\nYou can install `QorumLogs` via [Carthage](https://github.com/Carthage/Carthage) by adding the following line to your `Cartfile`:\n\n```\ngithub \"goktugyil/QorumLogs\"\n```\n\n### Install Manually\n\nDownload and drop 'QorumLogs.swift' in your project.\n\n### Check Installation Works Correctly\n1. In your AppDelegate or anywhere else enter this: (If Cocoapods or Carthage you must add `import QorumLogs`)\n\n  ```swift\n  QorumLogs.enabled = true\n  QorumLogs.test()\n  ```\n2. You will see something this:\n\n![demo](http://i.imgur.com/xMRrgv2.png)\n\nCongratulations!\n\n## Log Storage in GoogleDocs (Optional, ~4 minutes)\n[Learn to integrate GoogleDocs](./Log To GoogleDocs.md)\n\n## Detailed Features:\n\n#### Log Levels\n\nSets the minimum log level that is seen in the debug area:\n\n1. Debug - Detailed logs only used while debugging\n2. Info - General information about app state\n3. Warning - Indicates possible error\n4. Error - An unexpected error occured, its recoverable\n```swift\n  QorumLogs.minimumLogLevelShown = 2\n  QorumOnlineLogs.minimumLogLevelShown = 4 // Its a good idea to have OnlineLog level a bit higher\n  QL1(\"mylog\") // Doesn't show this level anywhere, because minimum level is 2\n  QL2(\"mylog\")  // Shows this only in debugger\n  QL3(\"mylog\") // Shows this only in debugger\n  QL4(\"mylog\") // Shows this in debugger and online logs\n```\nQL methods can print in both Debugger and Google Docs, depending on which is active.\n\n#### Hide Other Classes\n\nYou need to write the name of the actual file, you can do this by a string and also directly the class name can be appropriate if it is the same as the file name. Add the following code where you setup QorumLogs:\n```swift\n  QorumLogs.onlyShowThisFile(MyAwesomeViewController)\n  QorumLogs.onlyShowThisFile(\"MyAwesomeViewController\")\n```\n\nYou do not need the extension of the file.\n\n#### Print Lines\n```swift\n  QLPlusLine()\n  QL2(\"Text between line\")\n  QLShortLine()\n```\n![demo](http://i.imgur.com/hQWOYit.png)\n\n#### Add Custom Colors\n\nAdd custom colors for Mac, iOS, tvOS:\n```swift\n    QorumLogs.colorsForLogLevels[0] = QLColor(r: 255, g: 255, b: 0)\n    QorumLogs.colorsForLogLevels[1] = QLColor(red: 255, green: 20, blue: 147)\n```\n\n```swift\n    QL1(\"Mylog\")\n```\n![demo](http://i.imgur.com/yTmNnU6.png)\n\n#### OnlineLogs - User Information\n```swift\n   QorumOnlineLogs.extraInformation[\"userId\"] = \"sfkoFvvbKgr\"\n   QorumOnlineLogs.extraInformation[\"name\"] = \"Will Smith\"\n   QL1(\"Will is awesome!\")\n   QL5(\"Will rules!\")\n```\n![demo](http://i.imgur.com/5xoVRrY.png)\n\nYou only need to set the extraInformation one time.\n\n#### KZLinkedConsole support:\nKZLinkedConsole is a plugin for Xcode which add clickable link to place in code from log was printed. All you need to do is install it. For more information go to https://github.com/krzysztofzablocki/KZLinkedConsole  \n\n## FAQ\n\n#### How to delete rows inside google docs?\nUnfortunately you can't just select the rows inside Google Docs and delete them. You need to select the rows where there are row numbers, then right click, then press delete click \"Delete rows x-y\" http://i.imgur.com/0XyAAbD.png\n\n## Requirements\n\n- Xcode 6 or later (Tested on 6.4)\n- iOS 7 or later (Tested on 7.1)\n- tvOS 9 or later\n\n## Possible features\n\n- Different colors for white and black Xcode themes\n- Easily editable colors\n- Device information to Google Docs\n- Google Docs shows in exact order\n- Automatically getting entry ids for Google Docs\n- Pod support with QL methods written customly\n\n## Thanks for making this possible\n- [XcodeColors](https://github.com/robbiehanson/XcodeColors)\n- [Magic](https://github.com/ArtSabintsev/Magic)\n\n\n## License\nQorumLogs is available under the MIT license. See the [LICENSE file](https://github.com/goktugyil/QorumLogs/blob/master/LICENSE).\n\n## Keywords\nDebugging, logging, remote logging, remote debugging, qorum app, swift log, library, framework, tool, google docs, google drive, google forms\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FEsqarrouth%2FQorumLogs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FEsqarrouth%2FQorumLogs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FEsqarrouth%2FQorumLogs/lists"}