bline / coffeelint-loader

Coffeelint loader for Webpack

coffeelint loader for webpack

Usage

Apply the coffeelint loader as pre/postLoader in your webpack configuration:

module.exports = {
	module: {
		preLoaders: [
			{
				test: /\.coffee$/, // include .coffee files
				exclude: /node_modules/, // exclude any and all files in the node_modules folder
				loader: "coffeelint-loader"
			}
		]
	},

	// more options in the optional coffeelint object
	coffeelint: {
		// any coffeelint option http://www.coffeelint.com/#options
		// i. e.
		camel_case_classes: 'error',

		// coffeelint errors are displayed by default as warnings
		// set emitErrors to true to display them as errors
		emitErrors: false,

		// coffeelint to not interrupt the compilation
		// if you want any file with coffeelint errors to fail
		// set failOnErrors to true
		failOnErrors: false,

    // same as failOnErrors but will throw an exception for
    // warnings as well
		failOnWarns: false,

		// custom reporter function
		reporter: function(results) {
      var errors = result.error;
      war warns = result.warn;
    }
	}
}

Custom reporter

By default, coffeelint-loader will provide a default reporter.

However, if you prefer a custom reporter, pass a function under the reporter key in coffeelint options. (see usage above)

The reporter function will be passed an object containing error and warn arrays produced by coffeelint with the following structure:

{
  error: [
    {
        rule :      'Name of the violated rule',
        lineNumber: 'Number of the line that caused the violation',
        level:      'The severity level of the violated rule',
        message:    'Information about the violated rule',
        context:    'Optional details about why the rule was violated'
    }
    //...
  ],
  warn: [
    {
      //...
    },
    //...
  ]
}

The reporter function will be excuted with the loader context as this. You may emit messages using this.emitWarning(...) or this.emitError(...). See webpack docs on loader context.

The output in webpack CLI will usually be:

...

WARNING in ./path/to/file.js
<reporter output>

...

License

MIT (http://www.opensource.org/licenses/mit-license.php)

coffeelint-loader's Issues

failOnErrors doesn't work as expected

I tracked down where it's used

if(failOnErrors && result.error.length || failOnWarns && result.warn.length)

Problem is, that result.error will be always an object due to result[data[i].level] = data[i] so that above condition will never succeed.

Add to NPM?

Hi,

I can't see the package listed on NPM? Any chance you can publish it please?

webpack coffeelint options don't work without ./coffeelint.json or options.configFile set

if a file backed coffeelint configuration is not found, none of the coffelint options set in webpack will be used either. i.e you must have ./coffeelint.json or options.configFile set before you can use options in webpack configuration itself.

https://github.com/bline/coffeelint-loader/blob/master/index.js#L36