aLog (atomic logger)

A fast and beautiful logger in 750 bytes.

Getting started

Deno: import "aLog" from "https://deno.land/x/alog/mod.ts";

NPM: import aLog from "atomic-logger";

// create log instance with the name "SERVER" & level "Info"
const log = new aLog("SERVER", aLog.LevelInfo)

// won't call, level below info
log.debug("Some debug thing")
log.info("this", "is", { a: true, b: false }) // 0 [SERVER] INFO this is { a: true, b: false }
log.shout("ALWAYS VISIBLE") // 1 [SERVER] ALWAYS VISIBLE
// Log level info
log.whisper("SOMETIMES VISIBLE") // 2 [SERVER] SOMETIMES VISIBLE

Extending aLog

Create a writer class that inherits Writer and extend the aLog class with it. The custom writer has a single method, write() that takes in metadata about the log event and can console.log, write to the filesystem, or whatever you want.

You can extend or override log methods, add your own levels etc.

Formatting Utility Functions

format()

format(s: string, {b: boolean, it: boolean, it: boolean, fg: string, bg: string}): string Takes in a string and an object of properties, b (bold), it (italics), u (underline), fg (foreground color: “r;g;b”) and bg (background color: “r;g;b”). Returns an ANSI string.

gradient()

gradient(s: string, hue: number, saturation: number, luminosity: number, { b: boolean, it: boolean, u: boolean}): string Takes in a string, HSL values, and an object of properties, b (bold), it (italics), u (underline). Returns an ANSI string.