🛸 Space Log

Space Log is a simple function which logs tabular data, similar to that of yarn outdated.

You could - and probably should - just use console.table unless you appreciate a borderless display of data.

How to use Space Log?

Space Log exposes a function, spaceLog, which can be used as a named or default export. Both commonJS and ESM are supported.

The spaceLog function expects two arguments; config and data.

• config.columnKeys: An array of keys, i.e. the data[key] of each column.

• config.headings: An array of headings, i.e. the title of each column.

• data: An array of objects containing the data to log.

  • A hyphen will be rendered if the object does not contain the required key for a given column.
  • A "theme" can be provided for a given key in a row. For example, to indicate that the most populous region of Japan is Kantō the populationTheme uses chalk to render green text.

import chalk from chalk
import { spaceLog } from 'space-log'

spaceLog({
  columnKeys: ['name', 'population', 'area'],
  headings: ['Region', 'Population', 'Area (km²)'],
}, [
  { name: 'Hokkaidō', population: '5.4 million', area: '83,000', areaTheme: chalk.green },
  { name: 'Tōhoku', population: '8.9 million', area: '67,000' },
  { name: 'Kantō', population: '43.3 million', area: '32,000', populationTheme: chalk.green },
  { name: 'Chūbu', population: '21.4 million', area: '67,000' },
  { name: 'Kansai', population: '22.5 million', area: '33,000' },
  { name: 'Chūgoku', population: '7.3 million', area: '32,000' },
  { name: 'Shikoku', population: '3.8 million', area: '19,000' },
  { name: 'Kyūshū & Okinawa', population: '14 million', area: '44,000' },
])