Cilint NPM | npm.io

CILint

CILint是一个团队开发代码检查工具，进行检查时只关注新增行.

使用ESLint检查javascript的语法
使用Git的Hook在团队中推行

Installation and Usage

可以本地安装和全局安装

本地安装

npm install cilint --save-dev

初始化配置:

./node_modules/.bin/cilint --init

初始化配置的工作包括:

生成.cilintrc.js
生成.eslintrc.js
向.git/hooks注入pre-commit的钩子

之后你可以对任意文件或者目录运行CILint:

./node_modules/.bin/cilint yourfile.js

在git commit时.git/hooks/pre-commit将自动执行, 存在error时将阻止本次提交并提示错误

全局安装

如果你希望在多个项目中使用，我们推荐你使用全局安装:

npm install -g cilint

生成配置文件:

cilint --init

运行CILint:

cilint yourfile.js

团队规范执行

1、在package.json中声明CILint的依赖:

{
  "devDependencies": {
    "cilint": "*"
  }
}

2、在构建文件webpack.config.js或gulpfile.js、fis-conf.js中引入如下代码执行init:

// 等同于`cilint --init`
require('cilint').initializer({
    // override: true,
    // cilintrcUrl: 'https://raw.githubusercontent.com/feix760/cilint/master/conf/cilintrc.js',
    // eslintrcUrl: 'https://raw.githubusercontent.com/feix760/cilint/master/conf/eslintrc.js',
    // editorconfigUrl: 'https://raw.githubusercontent.com/feix760/cilint/master/conf/editorconfig',
});

Configuring

`.cilintrc.js`配置

stopCommit Boolean default true 存在error时是否阻止commit
ignore Array.<String> default [] 代码检查忽略列表

`.eslintrc.js`配置

参考http://eslint.org/docs/user-guide/configuring

API

`cilint.initializer(options)`

初始化执行函数

Arguments

options Object
options.override Boolean 可选 default false 是否覆盖.cilintrc.js,.eslintrc.js等文件
options.cilintrc Object 可选 cilintrc配置项
options.cilintrcUrl String 可选 从指定url拉取cilintrc配置项, 可以结合override = true使用
options.eslintrc Object 可选 eslintrc配置项
options.eslintrcUrl String 可选 从指定url拉取eslintrc配置项
options.editorconfigUrl String 可选 从指定url拉取editorconfig配置项