@unic/estatico-eslint

@unic/estatico-eslint

Uses ESLint to lint and automatically fix code.

Installation

$ npm install --save-dev @unic/estatico-eslint

Usage

Recommended: Create .eslintrc.js which extends the default config:

module.exports = {
  extends: require.resolve('@unic/estatico-eslint/.eslintrc.js'),
  globals: {
    Modernizr: true,
  },
};

Specify gulp task:

const gulp = require('gulp');
const env = require('minimist')(process.argv.slice(2));

/**
 * JavaScript linting task
 * Uses ESLint to lint (and optionally auto-fix files)
 *
 * Using `--watch` (or manually setting `env` to `{ watch: true }`) starts file watcher
 * When combined with `--skipBuild`, the task will not run immediately but only after changes
 * Adding `--fix` will auto-fix issues and save the files back to the file system
 */
gulp.task('js:lint', () => {
  const task = require('@unic/estatico-eslint');

  const instance = task({
    src: [
      './src/**/*.js',
    ],
    srcBase: './src',
    dest: './src',
    watch: {
      src: [
        './src/**/*.js',
      ],
      name: 'js:lint',
    },
  }, env);
  
  // Don't immediately run task when skipping build
  if (env.watch && env.skipBuild) {
    return instance;
  }

  return instance();
});

Run task (assuming the project's package.json specifies "scripts": { "gulp": "gulp" }): $ npm run gulp js:lint

See possible flags specified above.

API

plugin(options, env) => taskFn

options

src (required)

Type: Array or String
Default: null

Passed to gulp.src.

srcBase (required)

Type: String
Default: null

Passed as base option to gulp.src.

dest

Type: String
Default: null

Passed to gulp.dest when plugins.eslint.fix is enabled.

watch

Type: Object
Default: null

Passed to file watcher when --watch is used.

plugins

Type: Object

plugins.eslint

Type: Object
Default:

{
  fix: true,
}

Passed to eslint via gulp-eslint.

plugins.changed

Type: Object
Default:

{
  firstPass: true,
}

Passed to gulp-changed-in-place.

logger

Type: { info: Function, debug: Function, error: Function }
Default: Instance of estatico-utils's Logger utility.

Set of logger utility functions used within the task.

env

Type: Object
Default: {}

Result from parsing CLI arguments via minimist, e.g. { dev: true, watch: true }. Some defaults are affected by this, see above.

License

Apache 2.0.