JSPM

  • Created
  • Published
  • Downloads 27446
  • Score
    100M100P100Q140650F
  • License MIT

TypeScript linter Gulp plugin

Package Exports

  • gulp-tslint

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

Readme

gulp-tslint

TypeScript linter plugin for Gulp.

First install gulp-tslint

npm install --save-dev gulp-tslint

Usage:

var tslint = require('gulp-tslint');

gulp.task('tslint', function(){
      gulp.src('source.ts')
        .pipe(tslint())
        .pipe(tslint.report('verbose'));
});

tslint.json is attempted to be read from near the input file.

The output (stringified JSON) is added to file.tslint.output. You can output the errors by using reporters. There are four default reporters:

  • 'json' prints stringified JSON to console.log.
  • 'prose' prints short human-readable failures to console.log.
  • 'verbose' prints longer human-readable failures to console.log.
  • 'full' is like verbose, but displays full path to the file

Reporters are executed only if there is at least one failure.

If there is at least one failure, by default a PluginError is thrown after execution of the reporter:

[gulp] Error in plugin 'gulp-tslint': Failed to lint: invalid.ts

You can prevent throwing the error by setting emitError to false when you're invoking the reporter.

gulp.task('invalid-noemit', function(){
      gulp.src('invalid.ts')
        .pipe(tslint())
        .pipe(tslint.report('prose', {
          emitError: false
        }));
});

You can use your own reporter by supplying a function.

/* Output is in the following form:
 * [{
 *   "name": "invalid.ts",
 *   "failure": "missing whitespace",
 *   // Lines and characters start from 0
 *   "startPosition": {"position": 8, "line": 0, "character": 8},
 *   "endPosition": {"position": 9, "line": 0, "character": 9},
 *   "ruleName": "one-line"
 * }]
 */
var testReporter = function (output, file, options) {
    // file is a reference to the vinyl File object
    console.log("Found " + output.length + " errors in " + file.path);
    // options is a reference to the reporter options, e.g. options.emitError
};

gulp.task('invalid-custom', function(){
      gulp.src('invalid.ts')
        .pipe(tslint())
        .pipe(tslint.report(testReporter));
});

tslint.json can be supplied as a parameter by setting the configuration property.

gulp.task('tslint-json', function(){
      gulp.src('invalid.ts')
        .pipe(tslint({
            configuration: {
              rules: {
                "class-name": true,
                // ...
              }
            }
        }))
        .pipe(tslint.report('prose'));;
});

All default options

var options = {
    configuration: {},
    rulesDirectory: null,
    formattersDirectory: null
};

Development

Fork this repository, run npm install and send pull requests.