All Projects â†’ egoist â†’ Lamu

egoist / Lamu

Licence: mit
🎀 Impressive terminal logger

Programming Languages

javascript
184084 projects - #8 most used programming language

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

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].