Crazy Simple Logging for Scala
Scala
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
notes
project
src
.gitignore
CHANGELOG.md
LICENSE
README.md
build.sbt

README.md

loglady - Crazy Simple Logging in Scala

"My log has something to tell you. Can you hear it?"

loglady is a thin wrapper around slf4j, providing a simple API similar to Python's logging module.

Using slf4j, you're free to choose whatever logging implementation suits your application or taste, but Logback seems like a good default.

The goal of the project is to be very simple, while adding as little overhead as possible.

Influences include logula and slf4s.

Main Features

  • Thin slf4j wrapper
  • Simple API
  • No configuration
  • Supports Scala 2.9.1, 2.9.2 and 2.10.0

Usage Example

import org.eintr.loglady.Logging

class MyClass extends Logging {
  log.info("Hello, Log Lady")

  log.warn("We all float (%.4f) down here", 3.141592)
  
  log.debug("Some random stuff: %d %s %x", 42, List(0, 1, 1, 2, 3, 5), -559038737)
  
  log.error("Formatted date: %1$tm %1$te,%1$tY", new java.util.Date)

  try {
    throw new Exception("Oops!")
  } catch {
    case exc: Exception => {
      log.error(exc, "Something bad happened")
    }
  }
}

To get logging output, you also need a concrete logging library with slf4j. Simply adding logback-classic as a dependency to your project is a simple way. See the logback website for more information.

Getting loglady

loglady is published to the Maven Central repository, requiring minimal configuration using either sbt or maven:

sbt

libraryDependencies += "org.eintr.loglady" %% "loglady" % "1.1.0"

Maven

<dependency>
  <groupId>org.eintr.loglady</groupId>
  <artifactId>loglady_2.10.0</artifactId>
  <version>1.1.0</version>
</dependency>

Note: Replace the scala version to match that of your project.

API Documentation

Generated API docs (scaladoc) can be found at:

http://dln.github.com/loglady/api/

Bug Reports and Contributions

Please submit bug reports and feature requests using the Github issue tracker:

http://github.com/dln/loglady/issues

Patches and suggestions for improvements are very welcome.

Copyright

Copyright (c) 2013 Daniel Lundin

This software is licensed under the Apache License, Version 2.0. Please see LICENSE for details.