https://github.com/dln/loglady
Crazy Simple Logging for Scala
https://github.com/dln/loglady
logging scala
Last synced: 5 months ago
JSON representation
Crazy Simple Logging for Scala
- Host: GitHub
- URL: https://github.com/dln/loglady
- Owner: dln
- License: apache-2.0
- Created: 2012-01-17T13:34:06.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2015-07-29T00:57:52.000Z (almost 11 years ago)
- Last Synced: 2024-12-15T09:50:24.477Z (over 1 year ago)
- Topics: logging, scala
- Language: Scala
- Homepage:
- Size: 412 KB
- Stars: 23
- Watchers: 3
- Forks: 3
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
loglady - Crazy Simple Logging in Scala
=======================================
> "My log has something to tell you. Can you hear it?"
loglady is a thin wrapper around [slf4j](http://slf4j.org/), providing a
simple API similar to [Python's logging module](http://docs.python.org/library/logging.html).
Using slf4j, you're free to choose whatever logging implementation suits your
application or taste, but [Logback](http://logback.qos.ch/) 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](http://github.com/codahale/logula) and
[slf4s](http://github.com/weiglewilczek/slf4s).
Main Features
-------------
* Thin slf4j wrapper
* Simple API
* No configuration
* Supports Scala 2.9.1, 2.9.2 and 2.10.0
Usage Example
-------------
```scala
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](http://logback.qos.ch/) for more information.
Getting loglady
---------------
loglady is published to the [Maven Central](http://search.maven.org/)
repository, requiring minimal configuration using either sbt or maven:
### sbt
```scala
libraryDependencies += "org.eintr.loglady" %% "loglady" % "1.1.0"
```
### Maven
```xml
org.eintr.loglady
loglady_2.10.0
1.1.0
```
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.