grunt-flow-type-check

Task to run Facebook's Flow type checker

View the Project on GitHub isuttell/grunt-flow-type-check

Build Status npm downloads npm Release

Getting Started

This plugin requires Grunt ~0.4.5

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-flow-type-check --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-flow-type-check');

The "flow" task

Run this task with the grunt flow command.

Flow is a static type checker, designed to find type errors in JavaScript programs. Typed Flow code easily transforms down to regular JavaScript, so it runs anywhere.

This tasks requires Flow to be installed on your system. It's currently only available on OSX and linux. Detailed instructions can be found on the Getting Started page. For OSX users, the fastest way to install is using Brew.

brew update
brew install flow

Overview

In your project's Gruntfile, add a section named flow to the data object passed into grunt.initConfig().

grunt.initConfig({
  flow: {
    app: {
      src: '.',
      options: {
        background: false,    // Watch/Server mode
        all: false,           // Check all files regardless
        lib: '',              // Library directory
        module: '',           // Module mode
        weak: false,          // Force weak check
        profile: false,       // Turn on profiling
        stripRoot: false,     // Display relative paths
        showAllErrors: false, // Show more than 50 errors
      }
    }
  }
});

Options

src

Type: String Default value: '.'

The directory where .flowconfig is located.

options.weak

Type: Boolean Default value: false

Use the weak option to check the files.

options.showAllErrors

Type: Boolean Default value: false

By default only the first 50 errors are shown. This will show all of them.

options.lib

Type: String Default value: ''

Library folder. This can be defined here or in `flowconfig`.

options.module

Type: String Default value: ''

Module can either be haste or node.

options.all

Type: Boolean Default value: false

Checks all files regardless of if they have /* @flow */ at the top. Use this with care.

options.profile

Type: Boolean Default value: false

Provide some basic profiling information on each run.

options.background

Type: Boolean Default value: false

Run the Flow server in the background. This is used in conjunction with watch.

Usage Examples

Basic

By default we check for .flowconfig in the root directory and then run flow check

grunt.initConfig({
  flow: {
    app: {
      src: '.',
      options: {
        module: 'haste',
        profile: true,
        stripRoot: true,
        showAllErrors: true,
      }
    }
  }
});

Watch

Running flow check each time can be slow. Alternatively, you can run the Flow server in the background and use grunt-contrib-watch to get any current errors when a files changes.

grunt.initConfig({
  flow: {
    watch: {
      src: '.',
      options: {
        // Task-specific options go here.
        background: true,
      }
    }
  },
  watch : {
      flow: {
        files: ['src/**/*.jsx'],
        tasks: ['flow:watch:status'] // Get the status from the server
      }
    }
});

// Run 'flow:watch:start' before the watch task to start the server
grunt.registerTask('watchFlow', ['flow:watch:start', 'watch']);

Single File

You can also run a single file at a time through flow, however this it not recommended for projects with multiple files and/or external dependencies.

grunt.initConfig({
  flow: {
    app: {
      options: {
        showAllErrors: false, // This the only option avaiable in this mode
      },
      files: {
        src: ['src/**/*.jsx'] // Will run flow individually on each .jsx file in the src/ directory
      }
    }
  }
});

Contributing

Please take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using 'grunt test'.

Release History