JSPM – sort-package-json@1.31.0

Package Exports

sort-package-json

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 (sort-package-json) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Sort Package.json

Pass it a JSON string, it'll return a new JSON string, sorted by the keys typically found in a package.json

Pass it an object, it'll return an object sorted by the keys typically found in a package.json

JSON.stringify(sortPackageJson({
  dependencies: {},
  version: '1.0.0',
  keywords: ['thing'],
  name: 'foo',
}), null, 2)
/* string:
{
  "name": "foo",
  "version": "1.0.0",
  "keywords": [
    "thing"
  ],
  "dependencies": {}
}
*/

Install Permanently

API

npm install --save-dev sort-package-json

CLI

npm install --global sort-package-json

CLI Usage:

$ cd my-project
$ cat package.json
{
  "dependencies": {},
  "version": "1.0.0",
  "keywords": [
    "thing"
  ],
  "name": "foo"
}
$ npm i -g sort-package-json
$ sort-package-json
/my-project/package.json is sorted!
$ cat package.json
{
  "name": "foo",
  "version": "1.0.0",
  "keywords": [
    "thing"
  ],
  "dependencies": {}
}

sort-package-json also supports arguments - so you can give it a bunch of package.json file(s) to sort.

$ sort-package-json packages/*/package.json

$ sort-package-json my-package/package.json other-package/package.json

`--check` flag

When you want to check if your files are sorted, you can run CLI with the --check flag (or -c). This will output a list of not sorted files, if any.

$ sort-package-json **/package.json --check
# all files are sorted.


$ sort-package-json **/package.json --check
# foo/package.json
# bar/package.json

# 2 files are not sorted.

Run (with npm@5.2+)

npx sort-package-json

Visual Studio Code Extension

https://github.com/unional/vscode-sort-package-json

ESLint Rule with Autofix

https://github.com/kellyselden/eslint-plugin-json-files#supported-rules

Supported Libraries

Automatically Sort

The package.json file can be sorted automatically before committing, install husky and lint-staged and add the following to the package.json file:

{
  "husky": {
    "hooks": {
      "pre-commit": "lint-staged"
    }
  },
  "lint-staged": {
    "package.json": [
      "sort-package-json",
      "git add"
    ]
  }
}

PFAQ: Potential Frequently Asked Questions

How does it sort?

It sorts using sort-object-keys. It sorts using the well-known keys of a package.json. For the full list it's just easier to read the code. It sorts sub-keys too - sometimes by a well-known order, other times alphabetically. The initial order was derived from the package.json docs with a few extras added for good measure.

It doesn't sort X?

Cool. Send a PR! It might get denied if it is a specific vendor key of an unpopular project (e.g. "my-super-unknown-project"). We sort keys like "browserify" because it is a project with millions of users. If your project has, say, over 100 users, then we'll add it. Sound fair?

Isn't this just like Project X?

Could be. I wanted this one because at the time of writing, nothing is:

Zero config
Able to be used in a library
Quiet (i.e. not spitting out annoying log messages, when used in a library mode)

What?! Why would you want to do this?!

Well, it's nice to have the keys of a package.json in a well sorted order. Almost everyone would agree having "name" at the top of a package.json is sensible (rather than sorted alphabetically or somewhere silly like the bottom), so why not the rest of the package.json?

sort-package-json