How to set up QorumLogs with XcodeColors?

Install Alcatraz via the terminal script, restart Xcode, use the Package Manager to install XcodeColors, then add QorumLogs via Cocoapods or Carthage. Enable it in your code with `QorumLogs.enabled = true` and test with `QorumLogs.test()` to verify colored output.

QorumLogs vs CocoaLumberjack: which is better for iOS logging?

QorumLogs excels with Xcode color integration and simple Google Docs logging, while CocoaLumberjack offers more features, flexibility, and broader ecosystem support. Choose QorumLogs for quick Xcode enhancements; CocoaLumberjack for robust, scalable logging in production.

Can I use QorumLogs without the Google Docs feature?

Yes, disable remote logging by keeping `QorumOnlineLogs.enabled = false` and only use the local color-coded logs in Xcode. This makes it a lightweight debugging tool without external dependencies, ideal for development-only scenarios.

How to filter logs to show only from one file in QorumLogs?

Use `QorumLogs.onlyShowThisFile(ClassName)` or `QorumLogs.onlyShowThisFile("FileName")` where QorumLogs is initialized. This isolates logs from that specific file, helping focus debugging efforts without cluttering the console.

Is QorumLogs still maintained for latest Swift versions?

The README mentions support up to Swift 3.0 with branches for older versions, but it may not be actively maintained for newer Swift releases. Check the GitHub repo for updates or community forks to ensure compatibility with current Xcode.

How to delete logs from Google Docs when using QorumLogs?

In Google Docs, select the rows by their row numbers on the left, right-click, and choose 'Delete rows x-y'. This manual process is awkward, as acknowledged in the FAQ, and lacks automation for efficient log management.

Open-Awesome

QorumLogs

MITSwift0.9

A Swift logging utility that provides colorful, filterable logs in Xcode and remote logging to Google Docs.

GitHub

781 stars82 forks0 contributors

What is QorumLogs?

QorumLogs is a Swift logging utility that enhances debugging in Xcode with color-coded, filterable logs and optional remote logging to Google Docs. It solves the problem of cluttered, hard-to-read console output by providing visual differentiation and remote access to logs for production monitoring.

Target Audience

iOS and tvOS developers using Swift who need improved debugging workflows, especially those working on apps requiring remote log collection or enhanced local log visibility.

Value Proposition

Developers choose QorumLogs for its seamless Xcode integration, minimal setup, and dual functionality of local colorful logs and remote Google Docs logging, all with a simple API that reduces boilerplate code.

Overview

:closed_book: Swift Logging Utility for Xcode & Google Docs

Use Cases

Best For

Adding color-coded log levels to Swift projects in Xcode
Remote logging from iOS apps to Google Docs for production debugging
Filtering console logs to focus on specific files or classes
Enhancing log readability in Xcode with dark or light themes
Reducing typing with autocomplete-friendly logging functions
Attaching user metadata like IDs to remote logs for context

Not Ideal For

Teams using Swift Package Manager as their primary dependency manager
Projects requiring cross-platform logging or server-side Swift applications
Environments with strict security policies that prohibit Xcode plugin installations
Applications needing advanced log aggregation, real-time alerts, or integration with professional monitoring tools like Sentry or the ELK stack

Pros & Cons

Pros

Visual Debugging Clarity

Color-coded log levels (Debug, Info, Warning, Error) in distinct colors with support for both light and dark Xcode themes, making logs quickly identifiable and improving readability, as shown in the README's demo images.

Seamless Xcode Workflow

Integrates with XcodeColors plugin and provides short QL1-QL4 functions that reduce typing and are autocomplete-friendly, speeding up the debugging process with minimal boilerplate code.

Flexible Log Filtering

Allows isolating logs from specific files or classes using `onlyShowThisFile`, helping developers focus on relevant parts of the code during debugging, as demonstrated in the GIF example.

Simple Remote Logging

Enables sending logs to Google Docs in production with minimal code changes—just set `QorumOnlineLogs.enabled = true`—and supports attaching user metadata like IDs for context.

Cons

Plugin Dependency Hassle

Requires installing Alcatraz and XcodeColors plugins, which can be complex, may not work with newer Xcode versions, and are not officially supported by Apple, leading to potential maintenance and compatibility issues.

Limited Remote Logging Capabilities

Remote logging to Google Docs is basic, with manual row deletion and no advanced features like real-time monitoring, log aggregation, or integration with professional tools, making it unsuitable for large-scale production environments.

Missing Modern Swift Tooling

Lacks support for Swift Package Manager, which is now the default dependency manager for Swift projects, forcing developers to rely on Cocoapods or Carthage and potentially complicating integration in modern setups.

Frequently Asked Questions

Related Projects

CocoaLumberjack

A fast & simple, yet powerful & flexible logging framework for macOS, iOS, tvOS, watchOS and visionOS

Stars13,328

Forks2,277

Last commit18 days ago

Pulse

Network logger for Apple platforms

Stars7,013

Forks361

Last commit14 days ago

SwiftyBeaver

Convenient & secure logging during development & release in Swift 4 & 5

Stars6,068

Forks495

Last commit1 year ago

XCGLogger

A debug log framework for use in Swift projects. Allows you to log details to the console (and optionally a file), just like you would have with NSLog() or print(), but with additional information, such as the date, function name, filename and line number.

Stars3,986

Forks477