Swiftpack.co -  Kitura/LoggerAPI as Swift Package
Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
Kitura/LoggerAPI
Logger protocol
.package(url: "https://github.com/Kitura/LoggerAPI.git", from: "IBM-2019")

Kitura

APIDoc Build Status - Master macOS Linux Apache 2 Slack Status

LoggerAPI

A logger protocol that provides a common logging interface for different kinds of loggers. In addition, a class with a set of static functions for logging within your code is provided.

Kitura uses this API throughout its implementation when logging.

Usage

Add dependencies

Add the LoggerAPI package to the dependencies within your application’s Package.swift file. Substitute "x.x.x" with the latest LoggerAPI release:

.package(url: "https://github.com/Kitura/LoggerAPI.git", from: "x.x.x")

Add LoggerAPI to your target's dependencies:

.target(name: "example", dependencies: ["LoggerAPI"]),

Import package

import LoggerAPI

Log messages

Add log messages to your application:

Log.warning("This is a warning.")
Log.error("This is an error.")

Define a logger

You need to define a logger in order to output these messages. You may wish to write your own Logger implementation, or you can use HeliumLogger that writes to standard output:

import LoggerAPI
import HeliumLogger

let myLogger = HeliumLogger(.info)
Log.logger = myLogger

You can find out more about HeliumLogger here.

Logging messages to swift-log

You can direct your log messages to be logged via swift-log by setting the swiftLogger property:

import LoggerAPI
import Logging

let myLogger = Logging.Logger(label: "myLogger")
myLogger.logLevel = .notice
Log.swiftLogger = myLogger

If both logger and swiftLogger are set, then log messages will be sent to both logging backends. The log level configured for a LoggerAPI Logger and a swift-log Logger are independent, so may be used to log at different levels.

Note that because the hierarchy of log levels defined by LoggerAPI and swift-log is slightly different, a mapping is defined between the levels. See the documentation for Log.isLogging() for details.

API documentation

For more information visit our API reference.

Community

We love to talk server-side Swift, and Kitura. Join our Slack to meet the team!

License

This library is licensed under Apache 2.0. Full license text is available in LICENSE.

GitHub

link
Stars: 25
Last commit: 24 weeks ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Dependencies

Release Notes

1.9.0
1 year ago

New features:

  • feat: Adopt swift-log (#47)

It is now possible to direct LoggerAPI log messages to a Logging.Logger provided by swift-log, instead of or in addition to an existing LoggerAPI.Logger.

LoggerAPI now depends upon swift-log in order to provide this facility. This does not change the behavior of existing applications.

Fixes:

  • access to Log.logger and Log.swiftLogger is now thread-safe (#47)

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API