@momsfriendlydevco/readable

1.2.1 • Public • Published

@momsfriendlydevco/readable

Utility formatters to take raw data and present it in a readable format.

Features:

  • No dependencies
  • Tiny footprint
  • Customizable time / size units
  • Code is as small as possible and easily copy/pasteable

API

readable.defaults

Obejct containing all the default settings. These are deep merged with any setting object given to a formatter.

readable.fileSize(bytes, [options])

Return a human readable file size.

readable.fileSize(1024) //= "1kb"
readable.fileSize(1536) //= "1.5kb"
readable.fileSize(1048576) //= "1mb"
readable.fileSize(1073741824) //= "1tb"
readable.fileSize(1288490188) //= "1.2tb"

This function can take the following options:

Option Type Default Description
decimals number 1 Decimal places to format the number into
decimalsAbsolute boolean true If true the decimals will be clipped entirely if the number is exactly correct (e.g. if the input is 1024 the output is 1kb not 1.0kb)
units Object (See code) A list of units to output, each is named in the plural with a boolean indicating if it should be reported e.g. {units: {years: true}} to enable years as a usable unit
formatters Object (See code) A list of formatters for each named unit, each should be a function taking a single value. e.g. {formatters: {days: v => \${v} days`}}`
formatters.fallback Function or String "" The fallback formatter to use, if it is a string its used as is, if it is a function it is called with the value
values Object (See code) A list of unit values to work with if the unit is enabled, each is the plural key of the measure with the number of milliseconds within the unit as the key

readable.relativeTime(timestamp, [options])

Return a human readable relative time distance.

readable.relativeTime(new Date(Date.now() - 50)) //= "Just now"
readable.relativeTime(new Date(Date.now() - 50), {units: {milliseconds: true}}) //= "50ms"
readable.relativeTime(Date.now() - 5000) //= "5s"
readable.relativeTime(new Date(Date.now() - 60000)) //= "1m"
readable.relativeTime(new Date(Date.now() - 65000)) //= "1m5s"
readable.relativeTime(moment().subtract(1, 'w').subtract(2, 'd')) //= "9D"

This function can take the following options:

Option Type Default Description
units Object (See code) A list of units to output, each is named in the plural with a boolean indicating if it should be reported e.g. {units: {years: true}} to enable years as a usable unit
formatters Object (See code) A list of formatters for each named unit, each should be a function taking a single value. e.g. {formatters: {days: v => \${v} days`}}`
formatters.fallback Function or String "Just now" The fallback formatter to use, if it is a string its used as is, if it is a function it is called with the value
formatters.input Function (See code) Input mangler, by defaults this converts dates and Moment objects to a millisecond offset from now
formatters.combiner Function (See code) Function used to combine all compiled units, by default this joins everything into a string with no spacing and truncates any training spaces
values Object (See code) A list of unit values to work with if the unit is enabled, each is the plural key of the measure with the number of milliseconds within the unit as the key

readable.sizeOf(data, [options])

Calculate the (approximate in some cases) size of a variable as quickly as possible.

readable.sizeOf(123) //= 4 (JS uses 64bit integers)
readable.sizeOf('a') //= 3 (1 byte + enclosing speachmarks)
readable.sizeOf({}) //= 2 (enclosing braces only)
readable.sizeOf({foo: 'abc'}) //= 14

The following assumptions are made:

  • Whitespace for stringified data is ignored
  • Strings are 1 char to 1 byte (unless options.stringDeepScan is specified)
  • Numbers are 64 bit / 2 bytes
  • Circular references are resolved to a given byte size (see options.circular)

This function can take the following options:

Option Type Default Description
circular boolean or number false Calculate circular references as this byte value, if boolean false references are not checked
stringDeepScan boolean false Calculate additional UTf-8 storage space
stringOverhead number 2 Additional bytes for string storage, set to 2 to store enclosing speachmarks
fallback function (See code) Function to use to calculate all non-handled types (defaults to JSON.stringify length)

Package Sidebar

Install

npm i @momsfriendlydevco/readable

Weekly Downloads

74

Version

1.2.1

License

MIT

Unpacked Size

35.6 kB

Total Files

7

Last publish

Collaborators

  • 1watt
  • eekthecat
  • hash-bang
  • melromero
  • mr-yellow