scribe

# scribe

[![CI](https://github.com/outr/scribe/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/outr/scribe/actions/workflows/ci.yml)
[![Codacy Grade](https://app.codacy.com/project/badge/Grade/f333f6b110974985b2d1dbea39665e9e)](https://www.codacy.com/gh/outr/scribe/dashboard?utm_source=github.com&utm_medium=referral&utm_content=outr/scribe&utm_campaign=Badge_Grade)
[![Codacy Coverage](https://app.codacy.com/project/badge/Coverage/f333f6b110974985b2d1dbea39665e9e)](https://www.codacy.com/gh/outr/scribe/dashboard?utm_source=github.com&utm_medium=referral&utm_content=outr/scribe&utm_campaign=Badge_Coverage)
[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/outr/scribe)
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.outr/scribe_2.13/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.outr/scribe_2.13)
[![Latest version](https://index.scala-lang.org/outr/scribe/scribe/latest.svg)](https://index.scala-lang.org/outr/scribe)
[![Javadocs](https://javadoc.io/badge/com.outr/scribe_2.13.svg)](https://javadoc.io/doc/com.outr/scribe_2.13)

Scribe is a completely different way of thinking about logging. Instead of wrapping around existing logging frameworks
and bearing their performance and design flaws, Scribe is built from the ground up to provide fast and effective logging
in Scala, Scala.js, and Scala Native without the need of configuration files or additional dependencies. All management
of logging can be handled programmatically (of course, classic logging configuration can be utilized as well if desired)
in Scala itself, giving the developer the freedom to use whatever configuration framework, if any, they should choose to
use.

## Availability

Scribe is available on the JVM, Scala.js, and ScalaNative with cross-compiling for Scala 2.12, 2.13, and 3

## Quick Start

For people that want to skip the explanations and see it action, this is the place to start!

### Dependency Configuration

```scala
libraryDependencies += "com.outr" %% "scribe" % "3.19.0"
```

For Cross-Platform projects (JVM, JS, and/or Native):

```scala
libraryDependencies += "com.outr" %%% "scribe" % "3.19.0"
```

Or, if you want interoperability with SLF4J (to allow better interoperability with existing libraries using other loggers):

```scala
libraryDependencies += "com.outr" %% "scribe-slf4j" % "3.19.0"
```

### Usage

```scala
scribe.info("Yes, it's that simple!")
```

### SBT Tip
Using the default logger in Scribe supports auto-line wrapping, but in SBT, the `[info]` prefixes cause that to get
messed up. It's recommended to set:
```sbt
outputStrategy := Some(StdoutOutput)
```
This will disable the `[info]` and `[error]` prefixes so logging looks correct when running your application within SBT.

## Why Another Logging Framework

Yes, we know there are too many Java logging frameworks to count, and a large number of decent logging frameworks in
Scala, so why did we write yet another logg