npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

grunt-html-html-report-converter

v3.1.4

Published

Converts the JSON report of the grunt-html task to HTML.

Downloads

13

Readme

grunt-html-html-report-converter

Latest version Dependency status Coverage

This module provides a grunt multi-task for converts the JSON report generated by the grunt-html task to the HTML format. It uses grunt-html-html-reporter to format the validation results.

Installation

You need node >= 4, and grunt >= 0.4.5 installed and your project build managed by a Gruntfile with the necessary modules listed in package.json; including grunt-html. If you haven't used Grunt before, be sure to check out the [Getting Started] guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with you favourite package manager:

npm i -D grunt-html-html-report-converter
pnpm i -D grunt-html-html-report-converter
yarn add -D grunt-html-html-report-converter

Configuration

Add the htmllint-html-report-converter entry with the task configuration to the options of the grunt.initConfig method:

grunt.initConfig({
  'htmllint-html-report-converter': {
    all: {
      src: 'results/report.json',
      dest: 'results/report.html'
    }
  }
});

Default options support the most usual usage scenario:

'html-html-report-converter': {
  options: {
    targetExtension: '.html',
    ignoreMissing: false,
    showFileNameOnly: false,
    showCommonPathOnly: true,
    force: false
  },
  all: {
    src: 'results/report.json',
    dest: 'results/report.html'
  }
}

Task Options

force

Type: Boolean Default value: false

If set to true, it suppresses failures, which happened during the report conversion. Instead of making the Grunt fail, the errors will be written only to the console.

ignoreMissing

Type: Boolean Default: false

If the src property does not point to any files, or if it is missing, the task will make the Grunt run fail. If you set the ignoreMissing option to true, Grunt will continue executing other tasks.

includeUnreported

Type: Boolean Default: false

If the src property does not point to any files, or if it is missing, the task will assume, that no messages existed for the input files, which which were above the configured severity. It will create the report nevertheless and include all input files there.

targetExtension

Type: String Default: ".html:

If the dest property specified only the target directory, the converted report file will be stored there with the file extension replaced to ".html" or to the extesion specified by this property.

showFileNameOnly

Type: Boolean Default value: false

Cuts the directory from tested HTML files, when creating page titles from in the report. If you use unique names for files alone, you will not get too long page titles, if you flip this flag tp true.

Task Data

The configuration consists of src and dest property pairs. The src property has to point to an existing source path. The dest property has to point to the path, where the converted report should be written.

If you do not end the dest path by the path separator (slash, for example), the dest path will be considered as if it includes the converted report file name too.

If you end the dest path by a path separator (slash, for example), the converted report will be created using the source report name with the HTML expension.

If you specify more source files or directories, or use wildcards, the target path should be a directory - ended by the path separator (slash, for example).

If you set includeUnreported to true and you expect all input files reported with zero messages, include the input property. Set it to the files, which were input of the htmllint task. For example:

'html-html-report-converter': {
  options: {
    includeUnreported: true
  },
  all: {
    input: 'snapshots/*.html',
    src: 'results/report.json',
    dest: 'results/report.html'
  }
}

src

Type: String or Array

Path to the file with the JSON report generated by the htmllint task, or a path pattern identifying these file, or an array of these.

dest

Type: String

Path to the file, which will be the HTML report written to. Or only the path to the directory, where it should be written, if the source report name with the HTML expension shoudl be used.

input

Type: String|Array|Object

Files, which were input of the htmllint task. The format is the same as for the src parameter - the Grunt source file specification.

Loading

Load the plugin in Gruntfile.js:

grunt.loadNpmTasks('grunt-html-html-report-converter');

Build

Call the htmllint-html-report-converter task:

$ grunt htmllint-html-report-converter

or integrate it to your build sequence in Gruntfile.js:

grunt.registerTask('default', ['htmllint-html-report-converter', ...]);

Notes

This task will be usually executed right after the htmllint task. For example:

grunt.initConfig({
  htmllint: {
    options: {
      errorlevels: ['error', 'warning', 'info'],
      reporter: 'json',
      reporterOutput: 'output/report.json',
    },
    all: {
      src: ['input/*.html']
    }
  },

  'htmllint-html-report-converter': {
    all: {
      src: 'output/report.json',
      dest: 'output/'
    }
  }
});

grunt.loadNpmTasks('grunt-html');
grunt.loadNpmTasks('grunt-html-html-report-converter');

grunt.registerTask('default', [
  'htmllint', 'html-html-report-converter']);

The installation of the necessary Grunt tasks, again, one of the package managers:

npm i -D grunt-html grunt-html-html-report-converter
pnpm i -D grunt-html grunt-html-html-report-converter
yarn add -D grunt-html grunt-html-html-report-converter

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

License

Copyright (c) 2017-2022 Ferdinand Prantl

Licensed under the MIT license.