logion v1.0.0

Logion

Install

Install via yarn add logion | npm install logion.

Usage

Create instance:

import Logion from 'logion';

const logger = new Logion(opts);

Logion comes with an easy to use composable API that supports chaining:

logger
  .text('Hello World!')
  .newline(2)
  .text('Good job', 'success')
  .separate()
  .line('One liner')
  .spinner('oh', 'Beatifull spinner');

API

logion

• logion
  • module.exports ⏏
    • static
      • .Logion
        • new exports.Logion(options)
        • .width ⇒ number
        • .height ⇒ number
        • .disabled ⇒ boolean
        • .paused ⇒ boolean
        • .styleNames ⇒ object
        • .newline([num], [force], [identifier]) ⇒ Instance
        • .indent([num], [identifier]) ⇒ Instance
        • .separate([color], [char], [identifier]) ⇒ Instance
        • .text([string], styles, [identifier]) ⇒ Instance
        • .style(string, styles, [identifier]) ⇒ string
        • .styleReset(string) ⇒ string
        • .line([string], [styles], [indt]) ⇒ Instance
        • .clear() ⇒ Instance
        • .spinner(identifier, [text], [config]) ⇒ Instance
        • .spinnerDone(identifier, [config]) ⇒ Instance
        • .spinnerDoneAll([config]) ⇒ Instance
        • .beep() ⇒ Instance
        • .waitInteraction([text], [config]) ⇒ Promise.<Instance>
        • .log(string, [identifier]) ⇒ Instance
        • .removeLog(identifier) ⇒ Instance
        • .enable() ⇒ Instance
        • .disable() ⇒ Instance
        • .resume() ⇒ Instance
        • .pause() ⇒ Instance
    • inner
      • ~Instance : object
      • ~styleName : "success" | "error" | "info" | "bold" | "underline" | "italic" | "strikethrough"
      • ~color : "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "gray" | "blackBright" | "redBright" | "greenBright" | "yellowBright" | "blueBright" | "magentaBright" | "cyanBright" | "whiteBright"
      • ~spinnerFormatDone ⇒ string

module.exports ⏏

Class representing a logger.

Kind: Exported member

module.exports.Logion

Class representing a logger.

Kind: static class of module.exports

• .Logion
  • new exports.Logion(options)
  • .width ⇒ number
  • .height ⇒ number
  • .disabled ⇒ boolean
  • .paused ⇒ boolean
  • .styleNames ⇒ object
  • .newline([num], [force], [identifier]) ⇒ Instance
  • .indent([num], [identifier]) ⇒ Instance
  • .separate([color], [char], [identifier]) ⇒ Instance
  • .text([string], styles, [identifier]) ⇒ Instance
  • .style(string, styles, [identifier]) ⇒ string
  • .styleReset(string) ⇒ string
  • .line([string], [styles], [indt]) ⇒ Instance
  • .clear() ⇒ Instance
  • .spinner(identifier, [text], [config]) ⇒ Instance
  • .spinnerDone(identifier, [config]) ⇒ Instance
  • .spinnerDoneAll([config]) ⇒ Instance
  • .beep() ⇒ Instance
  • .waitInteraction([text], [config]) ⇒ Promise.<Instance>
  • .log(string, [identifier]) ⇒ Instance
  • .removeLog(identifier) ⇒ Instance
  • .enable() ⇒ Instance
  • .disable() ⇒ Instance
  • .resume() ⇒ Instance
  • .pause() ⇒ Instance

new exports.Logion(options)

Create a logger.

Returns: Instance - a logger instance.

logion.width ⇒ number

Width of a console.

Kind: instance property of Logion
Returns: number - width in chars.
Read only: true

logion.height ⇒ number

Height of a console.

Kind: instance property of Logion
Returns: number - height in chars.
Read only: true

logion.disabled ⇒ boolean

Returns true if a logger is disabled.

Kind: instance property of Logion
Returns: boolean - is disabled.
Read only: true

logion.paused ⇒ boolean

Returns true if a logger is paused.

Kind: instance property of Logion
Returns: boolean - is paused.
Read only: true

logion.styleNames ⇒ object

Shortening style names enum. See Available style names

Kind: instance property of Logion
Returns: object - style names enum.
Read only: true

logion.newline(num, force, identifier) ⇒ Instance

Output a newline(s). Accommodates if line breaks have been used before.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.indent(num, identifier) ⇒ Instance

Output spaces. Can be used in the middle of a line.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.separate(color, char, identifier) ⇒ Instance

Output a separator on a new line. It fills all the available width.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.text(string, styles, identifier) ⇒ Instance

Output a text with stlies applied. Does not add a new line.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.style(string, styles, identifier) ⇒ string

Style a text string. Shortening names could be one of: "success", "error", "info", "bold", "underline", "italic", "strikethrough".

Kind: instance method of Logion
Returns: string - a styled string (with escape codes).

logion.styleReset(string) ⇒ string

Reset all styles for a string.

Kind: instance method of Logion
Returns: string - an unstyled string.

logion.line(string, styles, indt) ⇒ Instance

Output a line of a text with an indent.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.clear() ⇒ Instance

Clear all the output.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.spinner(identifier, text, config) ⇒ Instance

Create a spinner on a new line. You can mark a spinner as done using its identifier with spinnerDone.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.spinnerDone(identifier, config) ⇒ Instance

Mark the spinner as done. If text is not provided, uses spinnerFormatDone to format the original text.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.spinnerDoneAll(config) ⇒ Instance

Mark all spinners that are not already done as done. Uses spinnerFormatDone to format the original text.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.beep() ⇒ Instance

Make a beep sound. May not be played in some consoles.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.waitInteraction(text, config) ⇒ Promise.<Instance>

Output a special spinner and waits for a user interaction. Removes the spinner after interaction and resolves a Promise.

Kind: instance method of Logion
Returns: Promise.<Instance> - a promise which resolves after user interaction (resolver returns a logger instance).

logion.log(string, identifier) ⇒ Instance

Log a row string. Other methods use this under the hood.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.removeLog(identifier) ⇒ Instance

Remove a log message with the corresponding identifier.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.enable() ⇒ Instance

Enable a logger.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.disable() ⇒ Instance

Disable a logger. When disabled, it removes all listeners, resets screen buffer, and clears all logs.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.resume() ⇒ Instance

Update the console with the last messages, resume spinners and listen for user interactions. Use this after pause.

Kind: instance method of Logion
Returns: Instance - a logger instance.

logion.pause() ⇒ Instance

Pause all logging, remove all listeners. Use this to temporary output something outside a logger instance, or to release a process from events listening (by logion).

Kind: instance method of Logion
Returns: Instance - a logger instance.

module.exports~Instance : object

A logger instance.

Kind: inner typedef of module.exports

module.exports~styleName : "success" | "error" | "info" | "bold" | "underline" | "italic" | "strikethrough"

Available style names.

Kind: inner typedef of module.exports

module.exports~color : "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "gray" | "blackBright" | "redBright" | "greenBright" | "yellowBright" | "blueBright" | "magentaBright" | "cyanBright" | "whiteBright"

Supported color names.

Kind: inner typedef of module.exports

module.exports~spinnerFormatDone ⇒ string

Format the spinner text when it is marked as done.

Kind: inner typedef of module.exports
Returns: string - a formated spinner text.

TODO

• Add more tests.
• Add a help message for scrolling and document it.
• Add more text style (colors) variants.
• Fix flickering and rerender screen only if needed.