1.0.1 • Published 8 years ago

murky v1.0.1

Weekly downloads
1
License
MIT
Repository
github
Last release
8 years ago

murky

Build Status Coverage Status

This module is written on typescript, and contains the .d.ts file. If you write on typescript: just use it in your project and definitions will be automatically uploaded.

npm i -S murky

About

murky - it's like util.format, but with additional placeholders.

Module Demo

Exports

interface IMurky {
  (fmtStr?: string, ...replacers: Array<any>): string
  (...replacers: Array<any>): string
}

export const color: IMurky = function() { /*...*/ }
export const nocolor: IMurky = function() { /*...*/ }

const auto: IMurky = function() {
  return require('supports-color')
    ? color.apply(null, arguments) as string
    : nocolor.apply(null, arguments) as string
}

export default auto

color/nocolor mode

murky uses supports-color to detect whether a terminal supports color. So in general, you can use the default exported function to obtain the best result.

Notes:

  • if you use the color mode, all no string arguments will be painted by util.inspect.
  • if you use the nocolor mode, all the arguments will be discolored, including the format string. It uses a uncolor module.
  • in any mode all string arguments, except the format string, will be discolored, this is due to the internal module needs.

util.format compatibility

  • you can not specify a format string, like util.format(1, 2, 3) === '1 2 3'.
  • you can print a percent sign, like util.format('%%') === '%'.
  • you can specify more placeholders than you need, like util.format('%s %s', 1) === '1 %s'.
  • you can specify less placeholders than you need, like util.format('', 1) === ' 1'.

List of placeholders

  • %j - alias to %j of util.format.
  • %s - cast any value to string.
  • %l - first cast value to string and then flattens result.
  • %t - first cast value to string and then adds pad to the result, like on the demo picture. Project was started for sake of it :)
  • %d and %n - firstly, if the value is not a finite number or a string which is contained a finite number, then the value will be processed by strings handler, like %s. If the value contains a finite number, it will be formatted by severing of the digit triples.
  • %m and %ms - if the value contains a finite number, it will be formatted by pretty-large-ms. Otherwise value will be processed by strings handler, like %s.
  • %f - if the value contains a finite number, it will be formatted by filesize. Otherwise value will be processed by strings handler, like %s.

More demo's

Life Time Demo Text Block Demo File Stat Demo Unsage Input Demo