get-comment-message

计算代码注释密度以及注释长度的相关信息

1.安装

npm install get-comment-message --save

2.例子

const {walk} = require('get-comment-message');

walk('目标文件夹/文件路径', [options]).then(res => {
  console.info(res)
})

3.API

walk(path, [options])

• path: 目标文件/文件夹路径
• options: 配置对象
  • onlyAllowZh: 是否只支持注释为中文的标识（默认为true）
  • zhPreNum: 针对于注释中前几位包含中文字符来判定为中文注释（默认为3）
  • skipDir: 跳过遍历的目录名称（默认为node_modules）
  • showError: 是否显示错误信息（默认为false）
  • fileLineThreshold: 文件行数阈值（计算注释密度时，大于该阈值以代码行数为基数，小于该阈值以逻辑行数为基数）（默认为500）

4.返回的数据结构

// 不展示错误信息时
{
  projectCommentMsg: {
    filePath: 检测的文件路径,
    density: 注释密度,
    lenMsg: {
      languageFlag: 注释语言类型：zh | en | zhen,
      len: 注释长度,
      startIndex: 注释开始位置,
      endIndex: 注释结束位置,
      commentFlag: 注释类型：line | block,
      value: 注释内容,
    },
    totalCodeLine: 总代码行数
  }[]
}

// 展示错误信息时
{
  projectCommentMsg: {
    filePath: 检测的文件路径,
    density: 注释密度,
    lenMsg: {
      languageFlag: 注释语言类型：zh | en | zhen,
      len: 注释长度,
      startIndex: 注释开始位置,
      endIndex: 注释结束位置,
      commentFlag: 注释类型：line | block,
      value: 注释内容,
    },
    totalCodeLine: 总代码行数
  }[],
  errorMsg: []
}

5.代码注释密度的计算规则

1. 文件代码行数小于设置的文件行数阈值时：注释密度 = 注释行数 / 逻辑行数（针对于js/jsx/ts/tsx类型的文件）
2. 文件代码行数大于设置的文件行数阈值时：注释密度 = 注释行数 / 实际代码行数

6.代码注释长度的计算规则

英语单词，汉字，数字，符号各为一个词长度

7.适用计算的文件类型

1. js / jsx
2. ts / tsx
3. css / scss / less / sass
4. html
5. vue