Skip to content
/ lamu Public

🎀 Impressive terminal logger

License

Notifications You must be signed in to change notification settings

egoist/lamu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

lamu

NPM version NPM downloads Build Status

Install

$ npm install --save lamu

Examples

Default table layout

const lamu = require('lamu')()

lamu.log({
  label: 'success',
  text: 'Nothing goes wrong thus far'
})
lamu.log({
  label: 'warning',
  text: 'But keep eyes open!'
})
lamu.log({
  label: 'error',
  text: 'Things changed'
})
lamu.log({
  label: 'see you',
  color: 'magenta',
  text: 'everything has an end.'
})

// node examples/default

default

Old-school log layout

// only the options are changed:
const lamu = require('lamu')({table: false})

// the rest is the same as default example
// node examples/old

old

Big text friendly

// big text can be correctly indented in table layout
const lamu = require('lamu')()

lamu.log({label: 'info', text: 'hello world'})
lamu.log({label: 'success', text: `Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.`})
lamu.log({label: 'warning', text: 'goodbye world'})
// node examples/big

big

Extra line-spacing

// more eye-friendly
const lamu = require('lamu')({
  lineSpacing: 1
})

lamu.log({label: 'info', text: 'hello world'})
lamu.log({label: 'success', text: `Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.`})
lamu.log({label: 'warning', text: 'goodbye world'})
// node examples/line-spacing

line-spacing

Custom separator

// use ==> instead of :: as separator
const lamu = require('lamu')({
  lineSpacing: 1,
  separator: '==>'
})

lamu.log({label: 'info', text: 'hello world'})
lamu.log({label: 'success', text: `Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.`})
lamu.log({label: 'warning', text: 'goodbye world'})
// node examples/separator

separator

Update existing log

const lamu = require('lamu')({
  lineSpacing: 1
})

lamu.log({label: 'info', text: 'hello world'})

const log = lamu.log({
  label: 'download', 
  text: `please wait...`, 
  color: 'yellow'}
)

lamu.log({label: 'warning', text: 'goodbye world'})

setTimeout(() => {
  lamu.update(log, {text: 'done!', color: 'green'})
}, 1000)

update

API

Lamu({lineSpacing, separator, align})

lineSpacing

Type: number
Default: 0

Extra line-spacing.

separator

Type: string
Default: "::"

Use a custom separator.

align

Type: string
Default: "right"

Align direction for label.

lamu.log({label, color, text})

Log the logs to console, returns the id of least recently added log.

label

Type: string

The label of the log, you can use some built-in label like success error warning info with preset colors.

color

Type: string
Default: "dim"

The name of chalk styles, apply to label text.

text

Type: string

The text of the log.

lamu.update(id, data)

Update an exsiting log by id, id is returned by lamu.log, the usage of data is the same as in lamu.log(data)

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

License

MIT © EGOIST

About

🎀 Impressive terminal logger

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published