这与更古老的"CoffeeLint"相同,有部分改动,可以更好地支持新的"CoffeeScript"2特性.

• CJSX 文件( JSX 风格) 完全兼容
• 所有规则都输出出列号.

咖啡壶2

CoffeeLint 是帮助保留 CoffeeScript 代码的样式检查器 干净而一致.

关于安装、使用和配置 CoffeeLint 的指南,头部 这里。 。 。 .

建议一个功能,报告错误,或一般性讨论, 头朝前 这里。 。 。 .

团队

当前 :

• 王书

过去 :

• 阿萨·艾尔斯 - 说吧 你不需要咖啡脚本
• 马特·佩皮克

捐款

• 新的规则应订为 warn 级别。 开发者会期望新的修改不会打破他们现有的工作流程, 因此除非您的修改非常有用, 默认为 warn。如果选择使用,则期待讨论 error。 。 。 .

• 在决定如何命名你的规则时,看看现有的规则和测试结构. no_foo.coffee 用于许多旨在捕捉特定错误的测试,而 foo.coffee 用于执行格式化和语法的测试.

步骤

1. 以地为叉取还.
2. 运行 npm install 获取依赖.
3. 在单个文件中创建规则为 src/rules/your_rule_here.coffee,使用现有的 规则作为指南. 您可以使用 http://asaayers.github.io/clfiddle/ 页面存档备份,存于互联网档案馆。 。 。 .
4. 添加您的测试文件 my_test.coffee 页:1 test 目录.
5. 登记您的规则 src/coffeelint.coffee。 。 。 .
6. 使用 npm run testrule test/your_test_here.coffee。 。 。 .
7. 使用 npm test。 。 。 .
8. 检查您的规则的文档是否正常生成( 见 何时更新文档 增加一条新规则 页:1.
9. 平整所有的人,一旦完成,就做出一个承诺.
10. 提交拉动请求 .

新增规则时更新文件

添加新规则时,其文档通过设置 description 其内部财产 rule 属性 :

module.exports = class NoComment

    rule:
        name: 'no_comment'
        level: 'ignore'
        message: 'No comment'
        description: '''
            Disallows any comment in the code
            '''

    tokens: ['#', '###']

    lintToken : (token, tokenApi) ->
        return {context: "Found '#{token[0]}'"}

描述属性是一个可以嵌入 HTML 代码的字符串 :

description: '''
    Disallows any comment in the code. This code would not pass:
    <pre>
    <code>### Some code with comments
    foo = ->
        # some other comments
        bar()
    </code>
    </pre>
    '''

咖啡林网站 生成每个 规则的文档基于此 description 属性.

在增加一条新规则时,建议您检查文件 您的新规则被正确生成。 为了做到这一点,你应该 遵循这些步骤:

• 检查包含更改的分支添加了新规则 .
• 运行 npm run compile。 。 。 .
• 检查 gh-pages 分支 : git checkout origin/gh-pages。 。 。 .
• 运行 cp lib/coffeelint.js js/coffeelint.js。 。 。 .
• 重新生成 HTML 文档 : rake updatehtml。请注意,你会 可能需要安装雷克.
• 打开 index.html 文件与您最喜欢的浏览器,并确保您 规则的文档生成得当.