vfile-statistics

vfile utility to count messages per category: failures, warnings, etc

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
vfile-statistics
3.0.09 months ago8 years agoMinified + gzip package size for vfile-statistics in KB

Readme

vfile-statistics
!Buildbuild-badgebuild !Coveragecoverage-badgecoverage !Downloadsdownloads-badgedownloads !Sizesize-badgesize !Sponsorssponsors-badgecollective !Backersbackers-badgecollective !Chatchat-badgechat
vfile utility to count messages per category (fatal, warn, info, etc).

Contents

*   [`statistics(file)`](#statisticsfile)
*   [`Statistics`](#statistics)

What is this?

This tiny package gives you stats about messages in files.

When should I use this?

This is really tiny, you could do it yourself, but this is useful as a building block.

Install

This package is ESM onlyesm. In Node.js (version 16+), install with npm:
npm install vfile-statistics

In Deno with esm.shesmsh:
import {statistics} from 'https://esm.sh/vfile-statistics@3'

In browsers with esm.shesmsh:
<script type="module">
  import {statistics} from 'https://esm.sh/vfile-statistics@3?bundle'
</script>

Use

import {VFile} from 'vfile'
import {statistics} from 'vfile-statistics'

const file = new VFile({path: '~/example.md'})

file.message('This could be better')
file.message('That could be better')

try {
  file.fail('This is terribly wrong')
} catch {}

file.info('This is perfect')

console.log(statistics(file))

Yields:
{fatal: 1, nonfatal: 3, warn: 2, info: 1, total: 4}

API

This package exports the identifier statisticsapi-statistics. There is no default export.

statistics(file)

Get stats for a file, list of files, or list of messages.
Parameters
`VFile`, or `VFileMessage`)
— file, message, or list of files or messages
Returns
Statistics (Statisticsapi-statistics-map).

Statistics

Statistics (TypeScript type).
Fields
  • fatal — fatal errors (fatal: true)
  • warn — warning messages (fatal: false)
  • info — informational messages (fatal: undefined)
  • nonfatal — warning or info messages
  • total — all messages

Types

This package is fully typed with TypeScript. It exports the additional type Statisticsapi-statistics-map.

Compatibility

Projects maintained by the unified collective are compatible with maintained versions of Node.js.
When we cut a new major release, we drop support for unmaintained versions of Node. This means we try to keep the current release line, vfile-statistics@^3, compatible with Node.js 16.

Contribute

See contributing.mdcontributing in vfile/.githubhealth for ways to get started. See support.mdsupport for ways to get help.
This project has a code of conductcoc. By interacting with this repository, organization, or community you agree to abide by its terms.

License

MITlicense © Titus Wormerauthor