{"id":21513245,"url":"https://github.com/patrickfav/slf4j-timber","last_synced_at":"2025-04-09T18:53:03.644Z","repository":{"id":57714970,"uuid":"115863071","full_name":"patrickfav/slf4j-timber","owner":"patrickfav","description":"SLF4J binding for Timber - a logger with a small, extensible API which provides utility on top of Android's normal Log class.","archived":false,"fork":false,"pushed_at":"2020-11-29T19:19:43.000Z","size":201,"stargazers_count":34,"open_issues_count":0,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-23T20:51:18.582Z","etag":null,"topics":["android","logcat","logging","slf4j","slf4j-binding","timber"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/patrickfav.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-12-31T12:55:59.000Z","updated_at":"2025-03-10T11:53:20.000Z","dependencies_parsed_at":"2022-09-02T22:01:13.511Z","dependency_job_id":null,"html_url":"https://github.com/patrickfav/slf4j-timber","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrickfav%2Fslf4j-timber","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrickfav%2Fslf4j-timber/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrickfav%2Fslf4j-timber/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrickfav%2Fslf4j-timber/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/patrickfav","download_url":"https://codeload.github.com/patrickfav/slf4j-timber/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248093335,"owners_count":21046667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","logcat","logging","slf4j","slf4j-binding","timber"],"created_at":"2024-11-23T22:55:08.259Z","updated_at":"2025-04-09T18:53:03.609Z","avatar_url":"https://github.com/patrickfav.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# slf4j-timber\n\nThe motivation of this project was to ease using existing libraries\nwhich use SLF4J as their logging framework on the Google Android platform\nin combination with [Jake Wharton's Timber logging utility.](https://github.com/JakeWharton/timber)\n\nThis project is based on the [_official_ slf4j-android implementation](https://mvnrepository.com/artifact/org.slf4j/slf4j-android) (+ bugfixes)\nbut directs the logging calls mainly to `Timber.log(...);`.\n\n[![Download](https://api.bintray.com/packages/patrickfav/maven/slf4j-timber/images/download.svg)](https://bintray.com/patrickfav/maven/slf4j-timber/_latestVersion)\n[![Build Status](https://travis-ci.com/patrickfav/slf4j-timber.svg?branch=master)](https://travis-ci.com/patrickfav/slf4j-timber)\n[![Javadocs](https://www.javadoc.io/badge/at.favre.lib/slf4j-timber.svg)](https://www.javadoc.io/doc/at.favre.lib/slf4j-timber)\n[![Coverage Status](https://coveralls.io/repos/github/patrickfav/slf4j-timber/badge.svg?branch=master)](https://coveralls.io/github/patrickfav/slf4j-timber?branch=master)\n[![Maintainability](https://api.codeclimate.com/v1/badges/6b8b476498a327afb38f/maintainability)](https://codeclimate.com/github/patrickfav/slf4j-timber/maintainability)\n\n## Quickstart\n\nAdd the following to your dependencies ([add jcenter to your repositories](https://developer.android.com/studio/build/index.html#top-level) if you haven't)\n\n```groovy\ncompile 'at.favre.lib:slf4j-timber:1.0.0'\n```\n\nAnd that's basically it. SLF4J will automatically look for implementations of `ILoggerFactory` in the classpath (so don't add this\nparallel to `org.slf4j:slf4j-android`)\n\n## Download\n\nThe artifacts are deployed to [jcenter](https://bintray.com/bintray/jcenter) and [Maven Central](https://search.maven.org/).\n\n## Description\n\n### Log level mapping\nThe priorities will be converted to LogCat's priority level and passed to\n`Timber.log(...);`. The `Log.isLoggable()` are not respected here, since `Timber`\nshould be responsible to decide when to log what. The following table shows\nthe mapping from SLF4J log levels to LogCat log levels.\n\n| SLF4J         | Android/Timber |\n| ------------- |:-------------: |\n| TRACE         | VERBOSE        |\n| DEBUG         | DEBUG          |\n| INFO          | INFO           |\n| WARN          | WARN           |\n| ERROR         | ERROR          |\n\n### Logger name mapping\n\nLogger instances created using the LoggerFactory are named either according to\nthe name given as parameter, or the fully qualified class name of the class given as\nparameter. No truncating will take place since Timber handles this itself.\n\n### Limitations\n\nThe Android-Timber binding implementation currently does not support Markers.\nAll logging methods which have a Marker parameter simply delegate to the\ncorresponding method without a Marker parameter, i.e., the Marker parameter\nis silently ignored.\n\n## Digital Signatures\n\n### Signed Commits\n\nAll tags and commits by me are signed with git with my private key:\n\n    GPG key ID: 4FDF85343912A3AB\n    Fingerprint: 2FB392FB05158589B767960C4FDF85343912A3AB\n\n## Build\n\nAssemble the lib with the following command\n\n    ./gradlew :slf4j-timber:assemble\n\nThe `.aar` files can then be found in `/slf4j-timber/build/outputs/aar` folder\n\n\n## Tech Stack\n\n* Java 7\n* Maven\n\n# License\n\nCopyright 2017 Patrick Favre-Bulle\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatrickfav%2Fslf4j-timber","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpatrickfav%2Fslf4j-timber","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatrickfav%2Fslf4j-timber/lists"}