How to enable colored logs in Atlantis with XcodeColors?

First, install XcodeColors via Alcatraz in Xcode, then set Atlantis.Configuration.hasColoredLogs to true and customize colors using Atlantis.XCodeColor with RGB tuples or UIColor. Note that this requires external dependencies and may not work in all setups.

Does Atlantis support Swift Package Manager?

No, the README only provides CocoaPods installation instructions with branches for Swift versions (e.g., swift-4-patch). For SPM or Carthage, you'd need to manually integrate or look for forks, as official support is lacking.

Atlantis vs SwiftyBeaver for Swift logging?

Atlantis excels in automatic pretty-printing of any data type with rich metadata, ideal for debugging complex objects. SwiftyBeaver offers more production features like log destinations (files, cloud) and broader platform support, but may require more configuration for similar readability.

How to filter logs by error code in Atlantis?

Use Atlantis.Configuration.filteredErrorCodes.append(errorCode) to skip specific NSError codes, such as -1099 for offline errors. This allows selective logging while maintaining error highlighting for other cases.

Can Atlantis log to a file in production?

Not currently—the README lists file output as a to-do feature. For production logging, you'd need to supplement Atlantis with custom code or use another framework that supports file persistence out of the box.

Is Atlantis suitable for server-side Swift projects?

Yes, for development debugging due to its type-agnostic pretty-printing, but less so for production because of missing features like file output and dependency on Xcode plugins for colors, which may not apply in server environments.

Open-Awesome

Atlantis

MITSwift1.1.2

A powerful, input-agnostic Swift logging framework designed for maximum readability and development speed.

GitHub

196 stars11 forks0 contributors

What is Atlantis?

Atlantis is a Swift logging framework that automatically pretty-prints any data type with full contextual metadata. It solves the problem of unreadable debug output by formatting logs for maximum clarity, whether you're logging simple strings, complex nested objects, or server responses.

Target Audience

Swift developers building iOS, macOS, or server-side applications who need a powerful, readable logging solution for development and debugging.

Value Proposition

Developers choose Atlantis for its exceptional readability, type-agnostic design, and automatic pretty-printing of any data structure—saving time during debugging compared to basic print statements or other logging frameworks.

Overview

A powerful input-agnostic swift logging framework made to speed up development with maximum readability.

Use Cases

Best For

Debugging complex nested objects and arrays in Swift applications
Adding rich metadata (file, function, line) to log output automatically
Logging server responses and API data with formatted JSON-like output
Filtering logs by level (verbose, debug, error) during development
Using colored log output in Xcode for better visual distinction
Logging within promise chains without breaking expression flow

Not Ideal For

Production environments requiring log persistence to files (file output is a to-do feature, not implemented)
Projects using Swift Package Manager or Carthage for dependency management (only CocoaPods is supported)
Teams avoiding external Xcode plugins or package managers (colored logs require XcodeColors via Alcatraz)
Performance-critical applications where logging overhead must be minimized (pretty-printing and metadata add computational cost)

Pros & Cons

Pros

Type-Agnostic Pretty Printing

Logs any Swift type—from strings and arrays to custom objects and nested structures—with automatic alignment and indentation for exceptional readability, as demonstrated in the README with recursive examples.

Rich Metadata Automation

Includes timestamp, source file, function name, and line number by default, configurable via Atlantis.Configuration.showExtraInfo, reducing manual effort in traceability during debugging.

Flexible Log Filtering

Supports five log levels (Verbose to Error) and error code filtering (e.g., ignoring -1099 offline errors), allowing granular control over output based on development needs.

Tap Extension for Fluent Logging

Enables logging within expression chains like promises via log.tap, returning the original value without breaking flow, as shown with PromiseKit integration examples.

Cons

Missing Production Features

The README admits file output for devices is a to-do item, limiting use in production where logs need to be saved or transmitted externally.

Complex Color Setup

Colored logs depend on installing XcodeColors via the external Alcatraz package manager, adding setup steps and potential compatibility issues in CI/CD or team environments.

Limited Dependency Support

Installation is only documented for CocoaPods with specific branches per Swift version, lacking native support for modern tools like Swift Package Manager, which may hinder adoption in newer projects.

Frequently Asked Questions

Related Projects

CocoaLumberjack

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

Stars13,320

Forks2,272

Last commit27 days ago

Pulse

Network logger for Apple platforms

Stars7,195

Forks375

Last commit24 days ago

SwiftyBeaver

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

Stars6,057

Forks493

Last commit1 year ago

NSLogger

A modern, flexible logging tool

Stars4,978

Forks563

Last commit3 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub