https://github.com/sgoudham/rall

Really...? Another Logging Library? Yes! This time written in Rust
https://github.com/sgoudham/rall

beginner-project debugging-tools logger logging logging-library rust rust-crate rust-lang rust-library

Last synced: 10 months ago
JSON representation

Really...? Another Logging Library? Yes! This time written in Rust

• Host: GitHub
• URL: https://github.com/sgoudham/rall
• Owner: sgoudham
• License: mit
• Created: 2022-04-01T15:38:09.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2022-04-03T18:51:31.000Z (almost 4 years ago)
• Last Synced: 2025-04-11T22:13:02.674Z (10 months ago)
• Topics: beginner-project, debugging-tools, logger, logging, logging-library, rust, rust-crate, rust-lang, rust-library
• Language: Rust
• Homepage: https://crates.io/crates/rall
• Size: 111 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![build](https://github.com/sgoudham/rall/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/sgoudham/rall/actions/workflows/build.yml)

[![crate.io](https://img.shields.io/crates/v/rall)](https://crates.io/crates/rall)

[![downloads](https://img.shields.io/crates/d/rall)](https://crates.io/crates/rall)

[![license](https://img.shields.io/github/license/sgoudham/rall)](LICENSE)

# Really...? Another Logging Library?

**Yes! :P**

> rall is an incredibly simple and intuitive logger, consider this crate a _failure_ if you can't get setup within **30 seconds!**

## Feature Set

- [x] Logging Levels

- [x] Coloured Output

- [ ] Options for Datetime, Current Function, Line Number, Custom Colours, etc.

- [x] Custom Formatting

- [ ] File support

And much more to come... soon™!

## Quick Start

For the fastest setup possible, declarative macros are exposed that have a predefined format.

This is to allow hassle-free and painless setup that will let you log instantly!

```rust

use rall::{debug, error, fatal, info, trace, warn};

// Log Out To Standard Output

trace!("My Best Friend Hazel {}", ":D");

debug!("My Best Friend Hazel {}", ":D");

info!("My Best Friend Hazel {}", ":D");

warn!("My Best Friend Hazel {}", ":D");

error!("My Best Friend Hazel {}", ":D");

fatal!("My Best Friend Hazel {}", ":D");

```

### Windows Output

![Windows Logs](images/windows_logs.png)

### Unix Output

![Unix Logs](images/unix_logs.png)

### Author Notes

I'm still incredibly early in my Rust journey and so I wanted to get comfortable and try to pick my own brain about

exposing different API's in a Rust crate. I hope to expose an intuitive and easy to understand API design that users can

instantly get started with.