Книги
Swift
Розділ 6. Файли та введення-виведення
Запис до стандартної помилки

Swift:
Запис до стандартної помилки

Як це зробити:

У Swift запис у стандартний потік помилок можна виконати за допомогою класу FileHandle для прямого доступу до stderr. Ось простий приклад:

import Foundation

// Визначте повідомлення
let errorMessage = "Трапилась помилка.\n"

// Конвертуйте повідомлення у дані
if let data = errorMessage.data(using: .utf8) {
    // Запишіть повідомлення про помилку в stderr
    FileHandle.standardError.write(data)
}

Вивід в stderr (зазвичай переглядається в консолі або терміналі):

Трапилась помилка.

Для більш складного логування або при роботі з зовнішніми бібліотеками можна розглянути використання сторонньої бібліотеки, як-от SwiftLog. Хоча SwiftLog не записує прямо у stderr з коробки, ви можете реалізувати власний бекенд логування для досягнення цього. Ось спрощений приклад визначення власного обробника логу, який записує в stderr:

Спочатку додайте SwiftLog до залежностей вашого проекту в Package.swift:

// swift-tools-version:5.3

import PackageDescription

let package = Package(
    name: "YourPackageName",
    dependencies: [
        .package(url: "https://github.com/apple/swift-log.git", from: "1.0.0"),
    ],
    targets: [
        .target(
            name: "YourTargetName",
            dependencies: [
                .product(name: "Logging", package: "swift-log"),
            ]),
    ]
)

Потім реалізуйте власний обробник логу, який записує в stderr:

import Logging
import Foundation

struct StderrLogHandler: LogHandler {
    let label: String
    
    var logLevel: Logger.Level = .info
    
    func log(level: Logger.Level, message: Logger.Message, metadata: Logger.Metadata?, source: String, file: String, function: String, line: UInt) {
        let output = "\(message)\n"
        if let data = output.data(using: .utf8) {
            FileHandle.standardError.write(data)
        }
    }
    
    subscript(metadataKey metadataKey: String) -> Logger.Metadata.Value? {
        get { return nil }
        set(newValue) { }
    }
    
    var metadata: Logger.Metadata {
        get { return [:] }
        set(newMetadata) { }
    }
}

// Використання
LoggingSystem.bootstrap(StderrLogHandler.init)
let logger = Logger(label: "com.example.yourapp")

logger.error("Це повідомлення про помилку")

Вивід в stderr:

Це повідомлення про помилку

Цей власний обробник дозволяє направляти ваші повідомлення про помилки SwiftLog безпосередньо у стандартний потік помилок, інтегруючись безперервно з іншими повідомленнями логу, які може генерувати ваш додаток.

Написання текстового файлу