misty


> Logging utils for command line

Example

Clone misty and run the test.js script.

``sh
git clone https://github.com/alloc/misty
node misty/test.js
`

Usage

`ts
import {
isInteractive,
warn,
warnOnce,
fatal,
success,
clear,
print,
} from 'misty'

if (isInteractive) {
// Prompt the user or something.
}

// Print a yellow message with [!] in front.
warn('Be careful')

// Like warn but messages are deduplicated.
warnOnce('Deprecated: Use foo instead')

// Print a message to stderr with red [!] in front. Then call process.exit(1)
fatal('Bollocks')

// Print a message with green checkmark in front.
success('We did it!')

// Clear the screen and scrollback.
clear()

// Clear two lines above the cursor.
clear(2)

// Like console.log without a line break. Useful for control sequences.
print('...')
`

$3

The misty/task module provides the startTask function, which helps you communicate what your script is doing without spamming the final output. Task logs are transient, so it's best to avoid using tasks for information that could be useful for debugging.

Tasks are logs that:
- have a spinner in front
- stick to the end
- can be updated
- can be finished
- print their elapsed time

`ts
import { startTask } from 'misty/task'

const task = startTask('Building…')
task.update('Analyzing…')
task.finish('Build completed')
`

What else should you know?
- Multiple tasks can be active at once.
- Call finish with no message to hide the task.

$3

The misty/spin module provides functions to customize the spinner
and build your own task-like messages.

`ts
import { setSpinner } from 'misty/spin'

// Customize the spinner!
setSpinner({
interval: 50,
frames: ['◐', '◓', '◑', '◒'],
color: require('kleur').magenta,
})

// These are for advanced usage.
import { spin, spinListeners, getSpinner } from 'misty/spin'
`

What else should you know?
- Animating multiple different spinners is not supported.
- Tasks use the spinner passed to setSpinner.

$3

Prompts are not supported by misty, but I recommend these packages:
- clikey for keypress events
- prompts for user input

$3

Color support is provided by kleur, so you should use that too.

$3

Logs are handled by shared-log`.