woodpecker 0.2.0

Fast and extensible logging for Rust
Documentation

Woodpecker

Crates.io Docs.rs Linux Build Status Windows Build Status Codecov Coveralls License

Woodpecker - Logging for Rust

Table of Contents

Introduction

woodpecker is a logging framework for Rust.

The goal is to have a fast, extensible and easy logging in Rust application.

Status

The project is currently under development and doesn't provide a lot of features.

Although the basic feature logging is well supported!

Features

The main feature is almost zero overhead if no filtering rules are defined and log is not produced.

Currently supported:

  • pluggable format function
  • multiple log consumers
  • filtering by module (any part of the module path)
  • filtering by file (any part of the file path)
  • conditional code execution depending on the log level
  • logging in a dedicated thread
  • logging to stdout/stderr
  • logging to a file
  • log file rotation (by size)

Documentation

Most of the useful documentation can be gotten using rustdoc.

Check it out on docs.rs/woodpecker.

In your project

In Cargo.toml:

[dependencies]
woodpecker = "0.2"

In your main.rs:

#[macro_use]
extern crate woodpecker;

See examples/basic.rs for the quick overview.

License

Woodpecker project is licensed under Apache-2.0 license.

Logo is licensed under Creative Commons Attribution (CC BY).

Credits

Sprockets for logo are provided by Jon Daiello and Ray Uribe from the Noun Project under Creative Commons Attribution (CC BY).