OSLog.swift 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415
  1. //
  2. // OSLog.swift
  3. // Loop
  4. //
  5. // Copyright © 2017 LoopKit Authors. All rights reserved.
  6. //
  7. //
  8. // OSLog.swift
  9. // OmniBLE
  10. //
  11. // Copyright © 2017 LoopKit Authors. All rights reserved.
  12. // OSLog updated for FreeAPSX logs
  13. //
  14. import os.log
  15. import Foundation
  16. let loggerLock = NSRecursiveLock()
  17. let baseReporter: IssueReporter = SimpleLogReporter()
  18. let category = Logger.Category.loopKit
  19. extension NSLocking {
  20. func perform<T>(_ block: () throws -> T) rethrows -> T {
  21. lock()
  22. defer { unlock() }
  23. return try block()
  24. }
  25. }
  26. extension NSRecursiveLock {
  27. convenience init(label: String) {
  28. self.init()
  29. name = label
  30. }
  31. }
  32. extension NSLock {
  33. convenience init(label: String) {
  34. self.init()
  35. name = label
  36. }
  37. }
  38. extension OSLog {
  39. convenience init(category: String) {
  40. self.init(subsystem: "com.loopkit.LoopKit", category: category)
  41. }
  42. func debug(_ message: StaticString, _ args: CVarArg...) {
  43. let msg_format = message.withUTF8Buffer{
  44. String(decoding: $0, as: UTF8.self)
  45. }
  46. let msg = String(format: msg_format, args)
  47. DispatchWorkItem(qos: .userInteractive, flags: .enforceQoS) {
  48. loggerLock.perform {
  49. category.logger.debug(
  50. msg,
  51. printToConsole: true,
  52. file: #file,
  53. function: #function,
  54. line: #line
  55. )
  56. }
  57. }.perform()
  58. }
  59. func info(_ message: StaticString, _ args: CVarArg...) {
  60. let msg_format = message.withUTF8Buffer{
  61. String(decoding: $0, as: UTF8.self)
  62. }
  63. let msg = String(format: msg_format, args)
  64. DispatchWorkItem(qos: .userInteractive, flags: .enforceQoS) {
  65. loggerLock.perform {
  66. category.logger.info(
  67. msg,
  68. file: #file,
  69. function: #function,
  70. line: #line
  71. )
  72. }
  73. }.perform()
  74. }
  75. func `default`(_ message: StaticString, _ args: CVarArg...) {
  76. let msg_format = message.withUTF8Buffer{
  77. String(decoding: $0, as: UTF8.self)
  78. }
  79. let msg = String(format: msg_format, args)
  80. DispatchWorkItem(qos: .userInteractive, flags: .enforceQoS) {
  81. loggerLock.perform {
  82. category.logger.debug(
  83. msg,
  84. printToConsole: true,
  85. file: #file,
  86. function: #function,
  87. line: #line
  88. )
  89. }
  90. }.perform()
  91. }
  92. func error(_ message: StaticString, _ args: CVarArg...) {
  93. let msg_format = message.withUTF8Buffer{
  94. String(decoding: $0, as: UTF8.self)
  95. }
  96. let msg = String(format: msg_format, args)
  97. DispatchWorkItem(qos: .userInteractive, flags: .enforceQoS) {
  98. loggerLock.perform {
  99. category.logger.warning(
  100. msg,
  101. description: message.debugDescription,
  102. error: nil,
  103. file: #file,
  104. function: #function,
  105. line: #line
  106. )
  107. }
  108. }.perform()
  109. }
  110. private func log(_ message: StaticString, type: OSLogType, _ args: [CVarArg]) {
  111. switch args.count {
  112. case 0:
  113. os_log(message, log: self, type: type)
  114. case 1:
  115. os_log(message, log: self, type: type, args[0])
  116. case 2:
  117. os_log(message, log: self, type: type, args[0], args[1])
  118. case 3:
  119. os_log(message, log: self, type: type, args[0], args[1], args[2])
  120. case 4:
  121. os_log(message, log: self, type: type, args[0], args[1], args[2], args[3])
  122. case 5:
  123. os_log(message, log: self, type: type, args[0], args[1], args[2], args[3], args[4])
  124. default:
  125. os_log(message, log: self, type: type, args)
  126. }
  127. }
  128. }
  129. protocol IssueReporter: AnyObject {
  130. /// Call this method in `applicationDidFinishLaunching()`.
  131. func setup()
  132. func setUserIdentifier(_: String?)
  133. func reportNonFatalIssue(withName: String, attributes: [String: String])
  134. func reportNonFatalIssue(withError: NSError)
  135. func log(_ category: String, _ message: String, file: String, function: String, line: UInt)
  136. }
  137. final class Logger {
  138. static let `default` = Logger(category: .default, reporter: baseReporter)
  139. static let loopKit = Logger(category: .loopKit, reporter: baseReporter)
  140. enum Category: String {
  141. case `default`
  142. case loopKit
  143. var name: String {
  144. rawValue
  145. }
  146. var logger: Logger {
  147. switch self {
  148. case .default: return .default
  149. case .loopKit: return .loopKit
  150. }
  151. }
  152. fileprivate var log: OSLog {
  153. let subsystem = Bundle.main.bundleIdentifier!
  154. switch self {
  155. case .default: return OSLog.default
  156. case .loopKit: return OSLog(subsystem: subsystem, category: name)
  157. }
  158. }
  159. }
  160. fileprivate enum Error: Swift.Error {
  161. case error(String)
  162. case errorWithInnerError(String, Swift.Error)
  163. case errorWithDescription(String, String)
  164. case errorWithDescriptionAndInnerError(String, String, Swift.Error)
  165. private func domain() -> String {
  166. switch self {
  167. case let .error(domain),
  168. let .errorWithDescription(domain, _),
  169. let .errorWithDescriptionAndInnerError(domain, _, _),
  170. let .errorWithInnerError(domain, _):
  171. return domain
  172. }
  173. }
  174. private func innerError() -> Swift.Error? {
  175. switch self {
  176. case let .errorWithDescriptionAndInnerError(_, _, error),
  177. let .errorWithInnerError(_, error):
  178. return error
  179. default: return nil
  180. }
  181. }
  182. func asNSError() -> NSError {
  183. var info: [String: Any] = ["Description": String(describing: self)]
  184. if let error = innerError() {
  185. info["Error"] = String(describing: error)
  186. }
  187. return NSError(domain: domain(), code: -1, userInfo: info)
  188. }
  189. }
  190. private let category: Category
  191. private let reporter: IssueReporter
  192. let log: OSLog
  193. private init(category: Category, reporter: IssueReporter) {
  194. self.category = category
  195. self.reporter = reporter
  196. log = category.log
  197. }
  198. static func setup() {
  199. loggerLock.perform {
  200. baseReporter.setup()
  201. }
  202. }
  203. func debug(
  204. _ message: @autoclosure () -> String,
  205. printToConsole: Bool = true,
  206. file: String = #file,
  207. function: String = #function,
  208. line: UInt = #line
  209. ) {
  210. let message = "DEV: \(message())"
  211. if printToConsole {
  212. os_log("%@ - %@ - %d %{public}@", log: log, type: .debug, file.file, function, line, message)
  213. }
  214. reporter.log(category.name, message, file: file, function: function, line: line)
  215. }
  216. func info(
  217. _ message: String,
  218. file: String = #file,
  219. function: String = #function,
  220. line: UInt = #line
  221. ) {
  222. let printedMessage = "INFO: \(message)"
  223. os_log("%@ - %@ - %d %{public}@", log: log, type: .info, file.file, function, line, printedMessage)
  224. reporter.log(category.name, printedMessage, file: file, function: function, line: line)
  225. }
  226. func warning(
  227. _ message: String,
  228. description: String? = nil,
  229. error maybeError: Swift.Error? = nil,
  230. file: String = #file,
  231. function: String = #function,
  232. line: UInt = #line
  233. ) {
  234. let loggerError = maybeError.loggerError(message: message, withDescription: description)
  235. let message = "WARN: \(String(describing: loggerError))"
  236. os_log("%@ - %@ - %d %{public}@", log: log, type: .default, file.file, function, line, message)
  237. reporter.log(category.name, message, file: file, function: function, line: line)
  238. reporter.reportNonFatalIssue(withError: loggerError.asNSError())
  239. }
  240. func error(
  241. _ message: String,
  242. description: String? = nil,
  243. error maybeError: Swift.Error? = nil,
  244. file: String = #file,
  245. function: String = #function,
  246. line: UInt = #line
  247. ) -> Never {
  248. errorWithoutFatalError(message, description: description, error: maybeError, file: file, function: function, line: line)
  249. fatalError(
  250. "\(message) @ \(String(describing: description)) @ \(String(describing: maybeError)) @ \(file) @ \(function) @ \(line)"
  251. )
  252. }
  253. fileprivate func errorWithoutFatalError(
  254. _ message: String,
  255. description: String? = nil,
  256. error maybeError: Swift.Error? = nil,
  257. file: String = #file,
  258. function: String = #function,
  259. line: UInt = #line
  260. ) {
  261. let loggerError = maybeError.loggerError(message: message, withDescription: description)
  262. let message = "ERR: \(String(describing: loggerError))"
  263. os_log("%@ - %@ - %d %{public}@", log: log, type: .error, file.file, function, line, message)
  264. reporter.log(category.name, message, file: file, function: function, line: line)
  265. reporter.reportNonFatalIssue(withError: loggerError.asNSError())
  266. }
  267. }
  268. private extension Optional where Wrapped == Swift.Error {
  269. func loggerError(message: String, withDescription description: String?) -> Logger.Error {
  270. switch (description, self) {
  271. case (nil, nil):
  272. return .error(message)
  273. case let (descr?, nil):
  274. return .errorWithDescription(message, descr)
  275. case let (nil, error?):
  276. return .errorWithInnerError(message, error)
  277. case let (descr?, error?):
  278. return .errorWithDescriptionAndInnerError(message, descr, error)
  279. }
  280. }
  281. }
  282. final class SimpleLogReporter: IssueReporter {
  283. private let fileManager = FileManager.default
  284. private var dateFormatter: DateFormatter {
  285. let dateFormatter = DateFormatter()
  286. dateFormatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ssZ"
  287. return dateFormatter
  288. }
  289. func setup() {}
  290. func setUserIdentifier(_: String?) {}
  291. func reportNonFatalIssue(withName _: String, attributes _: [String: String]) {}
  292. func reportNonFatalIssue(withError _: NSError) {}
  293. func log(_ category: String, _ message: String, file: String, function: String, line: UInt) {
  294. let now = Date()
  295. let startOfDay = Calendar.current.startOfDay(for: now)
  296. if !fileManager.fileExists(atPath: SimpleLogReporter.logDir) {
  297. try? fileManager.createDirectory(
  298. atPath: SimpleLogReporter.logDir,
  299. withIntermediateDirectories: false,
  300. attributes: nil
  301. )
  302. }
  303. if !fileManager.fileExists(atPath: SimpleLogReporter.logFile) {
  304. createFile(at: startOfDay)
  305. } else {
  306. if let attributes = try? fileManager.attributesOfItem(atPath: SimpleLogReporter.logFile),
  307. let creationDate = attributes[.creationDate] as? Date, creationDate < startOfDay
  308. {
  309. try? fileManager.removeItem(atPath: SimpleLogReporter.logFilePrev)
  310. try? fileManager.moveItem(atPath: SimpleLogReporter.logFile, toPath: SimpleLogReporter.logFilePrev)
  311. createFile(at: startOfDay)
  312. }
  313. }
  314. let logEntry = "\(dateFormatter.string(from: now)) [\(category)] \(file.file) - \(function) - \(line) - \(message)\n"
  315. let data = logEntry.data(using: .utf8)!
  316. try? data.append(fileURL: URL(fileURLWithPath: SimpleLogReporter.logFile))
  317. }
  318. private func createFile(at date: Date) {
  319. fileManager.createFile(atPath: SimpleLogReporter.logFile, contents: nil, attributes: [.creationDate: date])
  320. }
  321. static var logFile: String {
  322. getDocumentsDirectory().appendingPathComponent("logs/log.txt").path
  323. }
  324. static var logDir: String {
  325. getDocumentsDirectory().appendingPathComponent("logs").path
  326. }
  327. static var logFilePrev: String {
  328. getDocumentsDirectory().appendingPathComponent("logs/log_prev.txt").path
  329. }
  330. static func getDocumentsDirectory() -> URL {
  331. let paths = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)
  332. let documentsDirectory = paths[0]
  333. return documentsDirectory
  334. }
  335. }
  336. private extension Data {
  337. func append(fileURL: URL) throws {
  338. if let fileHandle = FileHandle(forWritingAtPath: fileURL.path) {
  339. defer {
  340. fileHandle.closeFile()
  341. }
  342. fileHandle.seekToEndOfFile()
  343. fileHandle.write(self)
  344. } else {
  345. try write(to: fileURL, options: .atomic)
  346. }
  347. }
  348. }
  349. private extension String {
  350. var file: String { components(separatedBy: "/").last ?? "" }
  351. }