Package Exports

npm-package-json-lint

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (npm-package-json-lint) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

npm-package-json-lint

A package.json linter for Node projects

What is package json lint?

npm-package-json-lint helps enforce standards for your package.json file. Currently it can check for:

validity of data types in nodes. Ex: name should always be a string.
whether a string is a lowercase
whether a version number is a valid
the presence of a given module
the presence of a pre-release version of a module

How do I install it?

First thing first, let's make sure you have the necessary pre-requisites.

System Dependencies

Node

Node.js - v4.2.0+
npm - v2.14.7+

Use the cli

npm install npm-package-json-lint -g

Commands and configuration

Command	Alias	Description
pjl-cli --help	-h	Lists supported CLI options
pjl-cli --version	-v	Lists the current version number
pjl-cli --file	-f	File path including name. Defaults to package.json
pjl-cli --rule	-r	Valid rule name to check. Defaults to nothing
pjl-cli --rules-file	-c	File path of .npmpackagejsonlintrc
pjl-cli --ignore-warnings	-w	Ignore warnings

Examples

Run a specific rule, author-valid-values, on a file relative to the current working directory. pjl-cli -f "../relative-path/package.json" -r "author-valid-values: true"

Run a specific rule, author-valid-values, ignoring warnings on a file relative to the current working directory. pjl-cli -f "../relative-path/package.json" -r "author-valid-values: true" --ignore-warnings

Run using the config in .npmpackagejsonlintrc on a file relative to the current working directory. pjl-cli -f "../relative-path/package.json" -c "./.npmpackagejsonlintrc"

Run using the default config on a file relative to the current working directory pjl-cli -f "../relative-path/package.json"

Lint Rules

npm-package-json-lint has a configurable set of rules. Please see the wiki for a list of available rules configuration instructions. Each rule contains the following properties:

ID - example: author-required
Type - error or warning
Node - example: author
Message - example: author is required
Rule Type - example: required

As mentioned in the "Commands and configuration" section there are two ways to specify rule sets. The first is using --rule to specify a given rule. This will run package json lint with just this rule. The second is using --rules-file to specify a JSON file, named .npmpackagejsonlintrc, to run a set of rules. If neither of the options above are specified then package json lint looks for a global .npmpackagejsonlintrc file in the root of your user directory. Finally, if a global .npmpackagejsonlintrc file doesn't exist then all rules are enabled by default.

JSPM