Sources/BFKit/Linux/BFKit/BFLog.swift
//
// BFLog.swift
// BFKit-Swift
//
// The MIT License (MIT)
//
// Copyright (c) 2015 - 2019 Fabrizio Brancati.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in all
// copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
// SOFTWARE.
import Foundation
// MARK: - Global functions
/// The private BFLogClass created to manage the log strings.
public enum BFLog {
// MARK: - Variables
/// Activate or not BFLog.
public static var active: Bool = false
/// The log string.
public static var logged: String = ""
/// The detailed log string.
public static var detailedLog: String = ""
// MARK: - Functions
/// Exenteds NSLog.
///
/// Activate it by setting BFLogActive variable to true before using it.
///
/// - Parameters:
/// - message: Console message.
/// - filename: File. Default is #file.
/// - function: Function name. Default is #function.
/// - line: Line number. Default is #line.
public static func log(_ message: String, filename: String = #file, function: StaticString = #function, line: Int = #line) {
if active {
logged += message + "\n"
let filenameWithoutExtension = URL(string: String(describing: NSString(utf8String: filename)))?.deletingPathExtension().lastPathComponent ?? "Unknown file"
let log = "\(filenameWithoutExtension):\(line) \(function): \(message)"
let timestamp = Date().description(dateSeparator: "-", usFormat: true, nanosecond: true)
print("\(timestamp) \(filenameWithoutExtension):\(line) \(function): \(message)")
detailedLog += log + "\n"
}
}
/// Exenteds NSLog with a warning sign.
///
/// Activate it by setting BFLogActive variable to true before using it.
///
/// - Parameters:
/// - message: Console message.
/// - filename: File. Default is #file.
/// - function: Function name. Default is #function.
/// - line: Line number. Default is #line.
public static func warning(_ message: String, filename: String = #file, function: StaticString = #function, line: Int = #line) {
log("[WARNING] \(message)", filename: filename, function: function, line: line)
}
/// Exenteds NSLog with an error sign.
///
/// Activate it by setting BFLogActive variable to true before using it.
///
/// - Parameters:
/// - message: Console message.
/// - filename: File. Default is #file.
/// - function: Function name. Default is #function.
/// - line: Line number. Default is #line.
public static func error(_ message: String, filename: String = #file, function: StaticString = #function, line: Int = #line) {
log("[ERROR] \(message)", filename: filename, function: function, line: line)
}
/// Exenteds NSLog with a debug sign.
///
/// Activate it by setting BFLogActive variable to true before using it.
///
/// - Parameters:
/// - message: Console message.
/// - filename: File. Default is #file.
/// - function: Function name. Default is #function.
/// - line: Line number. Default is #line.
public static func debug(_ message: String, filename: String = #file, function: StaticString = #function, line: Int = #line) {
log("[DEBUG] \(message)", filename: filename, function: function, line: line)
}
/// Exenteds NSLog with an info sign.
///
/// Activate it by setting BFLogActive variable to true before using it.
///
/// - Parameters:
/// - message: Console message.
/// - filename: File. Default is #file.
/// - function: Function name. Default is #function.
/// - line: Line number. Default is #line.
public static func info(_ message: String, filename: String = #file, function: StaticString = #function, line: Int = #line) {
log("[INFO] \(message)", filename: filename, function: function, line: line)
}
/// Clear the log string.
public static func clear() {
logged = ""
detailedLog = ""
}
/// Save the Log in a file.
///
/// - Parameters:
/// - path: Save path.
/// - filename: Log filename.
/// - Throws: write(toFile:, atomically:, encoding:) errors.
public static func saveLog(in path: FileManager.PathType, filename: String) throws {
try FileManager.default.save(file: filename, in: path, content: detailedLog)
}
}