Skip to content

chRyNaN/logger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

57c755d · Sep 12, 2022
Mar 27, 2021
Sep 12, 2022
Sep 12, 2022
Aug 12, 2021
Aug 20, 2022
Sep 12, 2022
Sep 12, 2022
Jan 14, 2022
Sep 3, 2018
Jan 14, 2022
Aug 20, 2022
Sep 12, 2022
Aug 30, 2018
Aug 30, 2018
Sep 12, 2022

Repository files navigation

logger

A simple Kotlin multi-platform logging abstraction.
GitHub tag (latest by date)

This library provides simple interfaces to wrap any logging utility and use them in Kotlin Multiplatform code.

Log.error("Error message.")

Using the Library

  • Assign the Logger implementation to the Log.logger property (defaults to DefaultLogger):
Log.logger = DefaultLogger()
  • Optionally, call the LogInitializer.init:
Log.init()
  • Log anything:
Log.error(message = "Error Message", throwable = someException)

Platform Specific Implementations

The library provides multiple platform specific Logger implementations that could be used or extended. For instance:

Common

  • DefaultLogger - Platform default logging.
    • Android: LogCatLogger
    • JVM: JavaLogger
    • JS: ConsoleLogger
    • iOS: NSLogger
  • DelegatingLogger - Delegates to one or more Loggers.
  • SimplePrintLineLogger - Uses the println() Kotlin function.
  • NoActionLogger - No operation Logger.

JavaScript

  • ConsoleLogger - Uses the browser console.

Java

  • JavaLogger - Uses the JVM Logger class.
  • JavaAnnotationProcessorMessagerLogger - Uses the JVM Messager class used in Annotation Processors.

Android

  • LogCatLogger - Uses the Android Log functions.

Android Timber

  • TimberLogger - Uses the Android Timber Library.

iOS

  • NSLogger - Uses NSLog.

Building the library

The library is provided through repsy.io. Refer to the releases page for the latest version.
GitHub tag (latest by date)

Repository

repositories {
    maven { url = "https://repo.repsy.io/mvn/chrynan/public" }
}

Dependencies

Core Module:

implementation("com.chrynan.logger:logger-core:$VERSION")

Android Timber Module:

implementation("com.chrynan.logger:logger-android-timber:$VERSION-release")

Documentation

More detailed documentation is available in the docs folder. The entry point to the documentation can be found here.

License

Copyright 2021 chRyNaN

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.