changelog 日志自动生成工具升级啦~

背景

19年我发了一篇文章changelog 日志自动生成插件,里面介绍了我开源的一套【auto changelog、commit-lint】规范化代码提交的工具插件合集。

可是因为是第一次发布一些开源的项目，不免开发方案不是很丝滑，用起来也不是很柔顺。

因此基于这些问题，用lerna对这个工具进行了一次升级。大概内容以下：

jimi-web-changelog/cz --> nicecode/commit   // git 格式化 cli 提交插件
jimi-web-changelog/lint  -->  nicecode/commit-lint    // git 提交 lint 校验插件
jimi-web-changelog --> nicecode/changelog   // 日志自动生成插件

CZ 模块配置优化

官方文档

原配置

// 一、安装依赖
cnpm i commitizen jimi-web-changelog --save-dev

// 二、在 package.json 中添加
{
  ...
  "config": {
    "commitizen": {
      "path": "./node_modules/jimi-web-changelog/lib/cz"
    }
  },
  ...
}

新配置

// 一、安装依赖
cnpm i commitizen @nicecode/commit --save-dev

// 二、在 package.json 中添加
{
  ...
  "config": {
    "commitizen": {
      "path": "@nicecode/commit"
    }
  },
  ...
}

lint 模块配置优化

官方文档

原配置

1. 安装依赖
cnpm i husky commitlint jimi-web-changelog --save-dev

2. 在 package.json 中引入如下配置
{
  ...
  "husky": {
    "hooks": {
      "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
    }
  },
  ...
}

三、根目录下 .commitlint.js 
modules.exports = Object.assign({}, require('jimi-web-changelog/lib/lint'), {
  rules: {
    'subject-empty': [2, 'never'],
    'type-empty': [2, 'never'],
    'type-enum': [2, 'always',
      [
        '新功能',
        '修复',
        ...
      ]
    ]
  }
}

新配置

// 1. 安装依赖
cnpm i husky commitlint @nicecode/commit-lint --save-dev

// 2. 在 package.json 中引入如下配置
{
  ...
  "husky": {
    "hooks": {
      "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
    }
  },
  ...
}

// 三、根目录下 .commitlint.js 
modules.exports = {
  extends: ["@nicecode/commit-lint"]
}

changelog 模块配置优化

官方文档

原配置

// 一、安装依赖
cnpm i conventional-changelog-cli jimi-web-changelog --save-dev

// 二、在package.json 中添加命令
{
  ...
  "script": {
    "log": "conventional-changelog --config node_modules/jimi-web-changelog/lib/log -i CHANGELOG.md -s -r 0",
  }
  ...
}

新配置

// 一、安装依赖
cnpm i conventional-changelog-cli @nicecode/changelog --save-dev

// 二、在package.json 中添加命令
{
  ...
  "script": {
    "log": "conventional-changelog --n node_modules/@nicecode/changelog -i CHANGELOG.md -s -r 0",
  }
  ...
}

后记

nicecoder 团队 目前 4 人，致力整合一套提升工做效率和代码规范的工具库，目前咱们的计划的和已完成的有如下几个板块：

期待你的加入：nicecoder

相关连接

@nicecode/tools 经常使用函数库

nicecode 官网

nicecode github地址