lazer-rs

Console printer with a fluent API, written in Rust.

lazer

Lazer is a utility for printing to the console using a fluent API. Ported to Rust from the original TypeScript package.

Description

Lazer helps you build, format and print complex messages to the console using an expressive fluent API.

Usage

Simple Example

main.rs

use lazer::{lazer};

fn main() {
    lazer()
        .print("Hello,")
        .print_space()
        .print_green("Green World")
        .print_ln("!");
}

$ cargo run
Hello, Green World!

Complex Example

main.rs

use lazer::{lazer};

fn main() {
    let remote_addr = "127.0.0.1";
    let method = "GET";
    let path = "/a/really/really/really/long/path/here";
    let status = 200;
    let time_ms = 20;
    let size_bytes_string = "1.10kB";

    lazer()
        .print("[").print_utc_time().print("]")
        .print_space(1).print("-").print_space(1)
        .print_pad_right(remote_addr, 15, "_")
        .print_space(2)
        .print_pad_right(method, 4, "_")
        .print_space(2)
        .print_pad_right(path, 20, "_")
        .print_space(2)
        .iff(status >= 200 && status < 300)
            .print_green(&status.to_string())
        .eliff(status >= 300 && status < 400)
            .print_yellow(&status.to_string())
        .eliff(status >= 400)
            .print_red(&status.to_string())
        .end()
        .print_space(2)
        .print_pad_right(&format!("{}ms", time_ms), 6, "_")
        .print_space(2)
        .print_ln(size_bytes_string);
}

$ cargo run
[Tue, 11 May 2021 17:25:18 +0000] - 127.0.0.1_______  GET__  /a/really/really/r+18  200  20ms___  1.10kB

Buffering Example

use lazer::{lazer};

fn get_line_prefix() -> String {
    return lazer().buffer()
        .print_yellow("[").print_yellow("Line Prefix").print_yellow("]")
        .print_space(1).print("-").print_space(1)
        .print_yellow("[").set_color_yellow().print_utc_time().print_yellow("]")
        .print_space(1).print("-").print_space(1)
        .ret();
}

fn main() {
    lazer()
        .print(&get_line_prefix())
        .print_yellow_ln("This is a prefixed line of text output");

    lazer()
        .print(&get_line_prefix())
        .print_yellow_ln("This is another prefixed line of text output");
}

$ cargo run
[Line Prefix] - [Thu, 03 Jun 2021 21:50:35 +0000] - This is a prefixed line of text output
[Line Prefix] - [Thu, 03 Jun 2021 21:50:35 +0000] - This is another prefixed line of text output

Buffer Aliasing Example

import { lazer } from "https://deno.land/x/lazer/mod.ts"

lazer().buffer()
    .set_color_red().print_ln("Some red output to buffer")
    .store('i am an alias');

lazer().buffer()
    .load('i am an alias')
    .print_b();

$ deno run example.ts
Some red output to buffer

Supported Platforms

Deno

import { lazer } from "https://deno.land/x/lazer/mod.ts"

Node.js

npm i --save lazer-js

const { lazer } = require('lazer-js');