refactor(@142vip/changelog): 模块结构调整，优化工具函数的实现和调用链路

packages/changelog/README.md

@@ -138,18 +138,16 @@ jobs:
 ### 更多功能
 
 ```shell
-@142vip/changelog/0.0.1-alpha.1
 
-Usage:
-  $ @142vip/changelog
+# cli 参数帮助
+npx changelog -h
 
-Commands:
+@142vip/changelog/0.0.1-alpha.1
 
-For more info, run any command with the `--help` flag:
-  $ @142vip/changelog --help
+Usage: @142vip/changelog [options]
 
 Options:
-  -v, --version            Display version number
+  -v --version             Package Version
   -t, --tokens <path>      GitHub Token
   --from <ref>             From tag
   --to <ref>               To tag
@@ -158,8 +156,8 @@ Options:
   --prerelease             Mark release as prerelease
   --output <path>          Output to file instead of sending to GitHub
   --scopeName <scopeName>  Package name in Monorepo，Match the scope in the git commit information
-  --dry                    Dry run
-  -h, --help               Display this message
+  --dry                    Dry run (default: false)
+  -h, --help               display help for command
 ```
 
 ## 配置

packages/changelog/build.config.ts

@@ -1,10 +1,9 @@
 import { defineBuildConfig } from 'unbuild'
 
 export default defineBuildConfig({
-  // entries: [
-  //   'src/index',
-  //   'src/changelog.ts',
-  // ],
+  entries: [
+    'src/index',
+  ],
   declaration: true,
   clean: true,
   rollup: {

packages/changelog/cli.mjs

@@ -1,3 +1,4 @@
+// eslint-disable-next-line antfu/no-import-dist
 import { changelogMain } from './dist/index.mjs'
 
 changelogMain()

packages/changelog/src/core/changelog.ts

@@ -0,0 +1,185 @@
+/* eslint-disable no-console */
+import process from 'node:process'
+import { blue, bold, cyan, dim, red, yellow } from 'kolorist'
+import { Command } from 'commander'
+import type { GitCommit, RawGitCommit } from 'changelogen'
+import { getGitDiff, parseGitCommit } from 'changelogen'
+import { notNullish } from '@antfu/utils'
+import { name as packageName, version as packageVersion } from '../../package.json'
+import {
+  generateMarkdown,
+  generateWebUrl,
+  getCurrentGitBranch,
+  getFirstGitCommit,
+  getGitHubRepo,
+  getLastMatchingTag,
+  isPrerelease,
+  isRepoShallow,
+  printUrl,
+  resolveAuthors,
+  sendRelease,
+  updateChangelog,
+} from '../utils'
+import type {
+  ChangelogEnOptions,
+  ChangelogOptions,
+  ResolvedChangelogOptions,
+} from '../types'
+import { ChangelogDefaultConfig } from './config'
+
+/**
+ * 加载配置
+ * 将用户自定义配置和默认配置合并
+ * @param options
+ */
+async function resolveConfig(options: ChangelogOptions) {
+  const { loadConfig } = await import('c12')
+  const config = await loadConfig<ChangelogOptions>({
+    // 配置文件名，eg: changelog.config.ts
+    name: 'changelog',
+    defaults: ChangelogDefaultConfig,
+    overrides: options,
+    // 在package.json中的配置关键字
+    packageJson: packageName,
+  }).then(r => r.config || ChangelogDefaultConfig)
+
+  config.baseUrl = config.baseUrl ?? 'github.com'
+  config.baseUrlApi = config.baseUrlApi ?? 'api.github.com'
+  // 发布的版本
+  config.to = config.to || await getCurrentGitBranch()
+  // release name
+  config.name = config.name ?? config.to
+  config.from = config.from || await getLastMatchingTag(config.to) || await getFirstGitCommit()
+  // @ts-expect-error backward compatibility
+  config.repo = config.repo || config.github || await getGitHubRepo(config.baseUrl)
+
+  // 是否是预览版本
+  config.prerelease = config.prerelease ?? isPrerelease(config.to)
+
+  // todo 支持多个scope生成
+  config.scopeName = options.scopeName
+
+  if (typeof config.repo !== 'string')
+    throw new Error(`无效的 GitHub 存储库，需要一个字符串，但实际repo参数是： ${JSON.stringify(config.repo)}`)
+
+  return config as ResolvedChangelogOptions
+}
+
+/**
+ * 解析git commit信息
+ * @param commits
+ * @param config
+ */
+function parseCommits(commits: RawGitCommit[], config: ChangelogEnOptions): GitCommit[] {
+  return commits.map(commit => parseGitCommit(commit, config)).filter(notNullish)
+}
+
+/**
+ * 生成markdown文档信息
+ * @param options
+ */
+async function generate(options: ChangelogOptions) {
+  const config = await resolveConfig(options)
+
+  const rawCommits = await getGitDiff(config.from, config.to)
+  const commits = parseCommits(rawCommits, config)
+
+  // 添加贡献者
+  if (config.contributors) {
+    await resolveAuthors(commits, config)
+  }
+  // 生成文档
+  const markdown = await generateMarkdown(commits, config)
+
+  return { config, markdown, commits }
+}
+
+async function dealChangelog(args: ChangelogOptions) {
+  args.token = args.token || process.env.GITHUB_TOKEN
+
+  let webUrl = ''
+
+  try {
+    console.log()
+    console.log(dim(`${bold('@142vip/changelog')} `) + dim(`v${packageVersion}`))
+
+    const { config, markdown, commits } = await generate(args)
+    webUrl = generateWebUrl(config, markdown)
+
+    console.log(cyan(config.from) + dim(' -> ') + blue(config.to) + dim(` (${commits.length} commits)`))
+    console.log(dim('--------------'))
+    console.log()
+    console.log(markdown.replace(/&nbsp;/g, ''))
+    console.log()
+    console.log(dim('--------------'))
+
+    if (config.dry) {
+      console.log(yellow('试运行。已跳过版本发布。'))
+      printUrl(webUrl)
+      return
+    }
+
+    // 更新changelog文档
+    if (typeof config.output === 'string') {
+      await updateChangelog(config.output, markdown, config.name)
+      return
+    }
+
+    // 带token上传
+    if (!config.tokens) {
+      console.error(red('未找到 GitHub 令牌，请通过 GITHUB_TOKEN 环境变量指定。已跳过版本发布。'))
+      printUrl(webUrl)
+      process.exitCode = 1
+      return
+    }
+
+    if (!commits.length && await isRepoShallow()) {
+      console.error(yellow('存储库似乎克隆得很浅，这使得更改日志无法生成。您可能希望在 CI 配置中指定 \'fetch-depth： 0\'。'))
+      printUrl(webUrl)
+      process.exitCode = 1
+      return
+    }
+
+    // 调用api 直接发布
+    await sendRelease(config, markdown)
+  }
+  catch (e: any) {
+    console.error(red(String(e)))
+    if (e?.stack)
+      console.error(dim(e.stack?.split('\n').slice(1).join('\n')))
+
+    // 手动执行，创建release
+    if (webUrl) {
+      printUrl(webUrl, false)
+    }
+    process.exitCode = 1
+  }
+}
+
+/**
+ * cli 入口
+ */
+export function changelogMain() {
+  const program = new Command(packageName)
+
+  // 查看版本
+  program.version(packageVersion, '-v --version', 'Package Version')
+
+  // cli参数
+  program
+    .option('-t, --tokens <path>', 'GitHub Token')
+    .option('--from <ref>', 'From tag')
+    .option('--to <ref>', 'To tag')
+    .option('--github <path>', 'GitHub Repository, e.g. @142vip/core-x')
+    .option('--name <name>', 'Name of the release')
+    .option('--prerelease', 'Mark release as prerelease')
+    .option('--output <path>', 'Output to file instead of sending to GitHub')
+    .option('--scopeName <scopeName>', 'Package name in Monorepo，Match the scope in the git commit information')
+    .option('--dry', 'Dry run', false)
+    .action(async (args: ChangelogOptions) => {
+      await dealChangelog(args)
+    })
+
+  // 解析参数
+  program.parse(process.argv)
+}