woodpecker

KO | EN

gitlite — search

#data-science #java #video #graphql #github #codex #open-source #chatbot #cli #ui

(★ 8)

Logging for Rust

File Explorer

ZIP Download

- benches.rs
- basic.rs
- tee.rs
- noun_25432_cc.svg
- noun_433413_cc.svg
- woodpecker.png
- woodpecker.svg
- build-kcov
- coverage
- - default.rs
  - mod.rs
- - file.rs
  - mod.rs
  - rotating_file.rs
  - stderr.rs
  - stdout.rs
- - control.rs
  - helpers.rs
  - init.rs
  - logging.rs
  - misc.rs
  - mod.rs
- - imp.rs
  - mod.rs
- config.rs
- global.rs
- levels.rs
- lib.rs
- line_range.rs
- logger.rs
- spec.rs
- examples
.gitignore
.travis.yml
appveyor.yml
Cargo.toml
LICENSE
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

# Project Badges

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Woodpecker - Logging for [Rust][rust]

### Table of Contents

* [Status](#status)
* [`woodpecker` crate in your project](#in-your-project)
* [Features](#features)
* [License](#license)
* [Credits](#credits)

### Introduction

`woodpecker` is a logging framework for [Rust][rust].

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

[rust]: http://rust-lang.org

### 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
* definition of the logging rules via `RUST_LOG` environment variable
* multiple log consumers
* filtering by module (any part of the module path)
* filtering by file (any part of the file path)
* filtering by a line range within a file
* 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](https://docs.rs/woodpecker).

### In your project

In Cargo.toml:

```toml
[dependencies]
woodpecker = "0.4"
```

In your `main.rs`:

```rust
#[macro_use]
extern crate woodpecker;
use woodpecker as wp;

fn main() {
    wp::init();

wp_set_level!(wp::LogLevel::INFO).unwrap();

info!("It's alive!");
}
```

See [examples/basic.rs](https://github.com/niamster/woodpecker/blob/master/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).

woodpecker

File Explorer

# Use via CDN

# Project Badges

Was this content helpful?

Recent Feedback

Download README