Js-isort NPM | npm.io

js-isort

js-isort is a command line tool for grouping, sorting and deduping ES2015 imports.

The following transformations take place:

Groups imports by module specificity (e.g. built-in vs. external vs. internal)
Collapses imports defined on multiple lines into one line
Sorts imports alphabetically within groups (uses natural sort order)
Sorts import specifiers alphabetically (uses natural sort order)
Separates groups with an empty line

Usage

Usage: js-isort [options] <file ...>

Options:

  -v, --version          output the version number
  --config-path [value]  Path to Babel or Webpack config file containing aliases
  -h, --help             output usage information

Grouping

// 1. Side effects (NOT sorted alphabetically because order may matter)
import './global-styles.css';
import 'babel-polyfill';

// 2. Node.js builtin modules
import fs from 'fs';
import http from 'http';

// 3. External modules
import classNames from 'classnames';
import React from 'react';

// 4. Aliases (from Webpack or Babel)
import App from 'components/App';
import format from 'utils/format';

// 5. Relative parent modules (sorted by depth)
import middleware from '../../middleware';
import getUserId from '../getUserId';

// 6. Relative sibling modules
import queries from './queries';
import styles from './styles';

// 7. Imports from the index.js file
import main from './';

Deduplication

If you have this:

import { Mutation } from 'react-apollo';
import { ApolloProvider } from 'react-apollo';
import ReactApollo from 'react-apollo';

You will get this:

import ReactApollo, { ApolloProvider, Mutation } from 'react-apollo';

Specifiers

If you have this:

import foo1, { foo1000, foo200, foo30, foo4, bar } from 'foo';

You will get this:

import foo1, { bar, foo4, foo30, foo200, foo1000 } from 'foo';

Aliases

In order for aliases to be recognized, you must pass in the path to your Webpack or Babel config file:

js-isort-cli --config-path webpack.config.js myFile.js

Note: it can be expensive to import the config, so js-isort will cache the aliases in a temporary file. The cache is invalidated when the config file is updated.