# DaveWoodCom/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.

Repository: https://github.com/DaveWoodCom/XCGLogger
Canonical: https://ross.abutalabs.com/products/xcglogger
Language: Swift
License: MIT
License Family: permissive
Topics: logging, logging-library, ios, tvos, macos, watchos, swift, swift-library, swift-framework, debug, debugging, debugging-tool, cocoapods, xcglogger, carthage, swiftpm
Last push: 2024-07-02T13:12:43+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4468, "days_push": 792, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3986, forks 476 (observed 2026-08-28T04:08:31.742144+00:00)

## What it is
XCGLogger is a debug logging library for Swift projects that enhances log output with contextual details like date, function name, filename, and line number. It supports logging to the console, files, and custom destinations across Apple platforms.

## Use cases
- add structured debug logging to a Swift iOS app
- replace print() statements with logs that include file and line number
- write log output to a file on macOS or iOS
- log with severity levels in a Swift project
- debug a tvOS or watchOS application

## When to choose
- you're building an iOS, macOS, tvOS, or watchOS app in Swift and want richer logs than print()
- you want a lightweight, mature Swift-native logging library with file destination support
- you need CocoaPods, Carthage, or Swift Package Manager integration

## When to avoid
- you need cross-platform logging outside Apple ecosystems
- you want a highly active project with frequent updates
- you need structured/JSON logging or log aggregation integrations out of the box

## Facets
- artifact type: library
- maturity: maintenance
- function: logging, developer-tools
- domain: developer-tools, mobile-development, desktop-applications
- platform: cross-platform
- tags: swift, debugging, cocoapods, carthage, swift-package-manager, apple-platforms, console-logging, file-logging, ios, macos

## Member repositories
- DaveWoodCom/XCGLogger (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:31.742144+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:24:14.191074+00:00, confidence not recorded.
  - readme: https://github.com/DaveWoodCom/XCGLogger (fetched 2026-08-28T04:08:31.742144+00:00, sha 9af63cee72eb)
- Data as of 2026-08-30T08:39:29.467469+00:00.