SLF4J binding for Timber

SLF4J binding for Timber, a logger with a small, extensible API which provides utility on top of Android's normal Log class by Jake Wharton.

License	The Apache Software License, Version 2.0
Categories	SLF4J Application Layer Libs Logging
GroupId	at.favre.lib
ArtifactId	slf4j-timber
Last Version	1.0.1
Release Date	May 5, 2018
Type	aar
Description	SLF4J binding for Timber SLF4J binding for Timber, a logger with a small, extensible API which provides utility on top of Android's normal Log class by Jake Wharton.
Project URL	https://github.com/patrickfav/slf4j-timber
Source Code Management	https://github.com/patrickfav/slf4j-timber

Download slf4j-timber

Filename	Size
slf4j-timber-1.0.1.pom
slf4j-timber-1.0.1.aar	6 KB
slf4j-timber-1.0.1-sources.jar	8 KB
slf4j-timber-1.0.1-javadoc.jar	24 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/at.favre.lib/slf4j-timber/ -->
<dependency>
    <groupId>at.favre.lib</groupId>
    <artifactId>slf4j-timber</artifactId>
    <version>1.0.1</version>
    <type>aar</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/at.favre.lib/slf4j-timber/
implementation 'at.favre.lib:slf4j-timber:1.0.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/at.favre.lib/slf4j-timber/
implementation ("at.favre.lib:slf4j-timber:1.0.1")

Apache Buildr

'at.favre.lib:slf4j-timber:aar:1.0.1'

Apache Ivy

<dependency org="at.favre.lib" name="slf4j-timber" rev="1.0.1">
  <artifact name="slf4j-timber" type="aar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='at.favre.lib', module='slf4j-timber', version='1.0.1')
)

Scala SBT

libraryDependencies += "at.favre.lib" % "slf4j-timber" % "1.0.1"

Leiningen

[at.favre.lib/slf4j-timber "1.0.1"]

Dependencies

runtime (2)

Group / Artifact	Type	Version
com.jakewharton.timber : timber	jar	4.6.1
org.slf4j : slf4j-api	jar	1.7.25

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

slf4j-timber

The motivation of this project was to ease using existing libraries which use SLF4J as their logging framework on the Google Android platform in combination with Jake Wharton's Timber logging utility.

This project is based on the official slf4j-android implementation (+ bugfixes) but directs the logging calls mainly to Timber.log(...);.

Quickstart

Add the following to your dependencies (add jcenter to your repositories if you haven't)

compile 'at.favre.lib:slf4j-timber:1.0.0'

And that's basically it. SLF4J will automatically look for implementations of ILoggerFactory in the classpath (so don't add this parallel to org.slf4j:slf4j-android)

Download

The artifacts are deployed to jcenter and Maven Central.

Description

Log level mapping

The priorities will be converted to LogCat's priority level and passed to Timber.log(...);. The Log.isLoggable() are not respected here, since Timber should be responsible to decide when to log what. The following table shows the mapping from SLF4J log levels to LogCat log levels.

SLF4J	Android/Timber
TRACE	VERBOSE
DEBUG	DEBUG
INFO	INFO
WARN	WARN
ERROR	ERROR

Logger name mapping

Logger instances created using the LoggerFactory are named either according to the name given as parameter, or the fully qualified class name of the class given as parameter. No truncating will take place since Timber handles this itself.

Limitations

The Android-Timber binding implementation currently does not support Markers. All logging methods which have a Marker parameter simply delegate to the corresponding method without a Marker parameter, i.e., the Marker parameter is silently ignored.

Digital Signatures

Signed Commits

All tags and commits by me are signed with git with my private key:

GPG key ID: 4FDF85343912A3AB
Fingerprint: 2FB392FB05158589B767960C4FDF85343912A3AB

Build

Assemble the lib with the following command

./gradlew :slf4j-timber:assemble

The .aar files can then be found in /slf4j-timber/build/outputs/aar folder

Tech Stack

• Java 7
• Maven

License

Copyright 2017 Patrick Favre-Bulle

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.

Versions

Version
1.0.1 May 5, 2018
1.0.0 Jan 3, 2018
0.2.0 Jan 2, 2018
0.1.0 Jan 2, 2018