Google Git
Sign in
apache / logging-log4j-kotlin / e05d6e13e729e590c3df3cd9fdba458bebff7efe
commite05d6e13e729e590c3df3cd9fdba458bebff7efe[log] [tgz]
authoru-ways <ue95.career@gmail.com>Sun Jan 22 08:53:29 2023 +0000
committeru-ways <ue95.career@gmail.com>Sun Jan 22 08:53:29 2023 +0000
tree5a1d144890eb61f9be4631b3d2dcdb876ccc27f5
parentc73252e7a73910414a24967f63afe05b94e172fa [diff]
Add missing Github PR contributor guidelines to match logging-log4j2
1 file changed
tree: 5a1d144890eb61f9be4631b3d2dcdb876ccc27f5
  1. log4j-api-kotlin/
  2. log4j-api-kotlin-benchmark/
  3. log4j-api-kotlin-sample/
  4. src/
  5. .gitignore
  6. checkstyle-header.txt
  7. checkstyle-import-control.xml
  8. checkstyle-suppressions.xml
  9. checkstyle.xml
  10. findbugs-exclude-filter.xml
  11. LICENSE.txt
  12. NOTICE.txt
  13. pom.xml
  14. README.md
README.md

Apache Log4j 2 (Kotlin API)

Log4j Kotlin API is a Kotlin logging facade based on Log4j 2. Log4j Kotlin API provides Log4j 2 as its default logging implementation, but this is not strictly required (e.g., this API can also be used with Logback or other Log4j 2 API provider implementations). Idiomatic Kotlin features are provided as an alternative to using the Log4j 2 Java API.

Maven Central Build Status

Pull Requests on Github

By sending a pull request you grant the Apache Software Foundation sufficient rights to use and release the submitted work under the Apache license. You grant the same rights (copyright license, patent license, etc.) to the Apache Software Foundation as if you have signed a Contributor License Agreement. For contributions that are judged to be non-trivial, you will be asked to actually signing a Contributor License Agreement.

Usage

Gradle users can add the following dependencies to their build.gradle file:

TODO

compile "org.apache.logging.log4j:log4j-api-kotlin:1.2.0"
compile "org.apache.logging.log4j:log4j-api:2.17.0"
compile "org.apache.logging.log4j:log4j-core:2.17.0"

Documentation

TODO

Requirements

Log4j Kotlin API requires at least Java 8. This also requires Log4j 2 API, but it is specified as transitive dependencies automatically if you are using SBT, Maven, Gradle, or some other similar build system. This also requires Log4j 2 Core (or possibly an other implementation of Log4j 2 API) as a runtime dependency. Some Log4j 2 Core features require optional dependencies which are documented in the Log4j 2 manual.

The Kotlin API requires the full kotlin-reflect dependency in order to name loggers appropriately, and optionally kotlinx-coroutines-core to set the mapped diagnostic context for a coroutine.

The Kotlin dependencies are not exposed transitively -- for maximum compatibility logging-log4j-kotlin is built with Kotlin 1.3, producing binaries that should be forward compatible. For maximum compat, the Kotlin dependencies are “provided” i.e. consumers of this library need to depend on them directly rather than transitively, thus avoiding version clashes.

License

Apache Log4j 2 is distributed under the Apache License, version 2.0.

Download

How to download Log4j, and how to use it from SBT, Maven, Ivy and Gradle.

Issue Tracking

Issues, bugs, and feature requests should be submitted to the JIRA issue tracking system for this project.

Pull request on GitHub are welcome, but please open a ticket in the JIRA issue tracker first, and mention the JIRA issue in the Pull Request.

Building From Source

Log4j Kotlin API requires Maven 3 and Java 8 to build. To install to your local Maven repository, execute the following:

mvn install

Contributing

We love contributions! Take a look at our contributing page.