@wwkit/opm 1.0.1 → 1.0.3

package/src/tools/git/index.js

@@ -0,0 +1,378 @@
+/**
+ * opm git 命令组 — Git 配置管理
+ *
+ * 命令：init / config / user / log / export / import / help
+ * 聚焦冷门或多步骤操作，log 支持指定 workdir 免切换目录查看提交历史。
+ * export 保存两个 commit 之间的差异到文件，默认从 mark 到 HEAD。
+ * mark 用 lightweight git tag 标记基准 commit，对用户透明。
+ */
+
+import path from 'node:path'
+import fs from 'node:fs'
+import { execSync } from 'node:child_process'
+import { parseFlags } from '../../cli/helpers/args.js'
+import { output } from '../../formatter.js'
+import {
+  listConfig, getConfigValue, setConfigValue, unsetConfigValue,
+  getUser, setUser,
+  initGitConfig, saveDiff, importDiff,
+  getMark, setMark, unsetMark,
+  getGitVersion, installGit, uninstallGit, upgradeGit,
+} from './config.js'
+
+const ACTIONS = {
+  version:   { desc: 'Show installed git version' },
+  install:   { desc: 'Install git via system package manager (dnf/yum/apt/apk)' },
+  uninstall: { desc: 'Uninstall git via system package manager' },
+  upgrade:   { desc: 'Upgrade git via system package manager' },
+  init:     { desc: 'Initialize git global config from opm config (user/ssl/pull.rebase)' },
+  config:   { desc: 'View/set/unset git config (with --scope global|local|system)' },
+  user:     { desc: 'View/set user.name and user.email' },
+  log:      { desc: 'Show commit history (with -d/--dir for workdir, -n for count)' },
+  export:   { desc: 'Export diff to file (default: mark -> HEAD, or -f <n> override)' },
+  import:   { desc: 'Import diff file into working tree (git apply --reject)' },
+  help:     { desc: 'Show this help' },
+}
+
+export class GitGroup {
+  constructor() {
+    this.name = 'git'
+    this.desc = 'Git config management (init/config/user/log/export)'
+  }
+
+  async run(argv) {
+    const [action, ...rest] = argv
+
+    if (!action || action === '-h' || action === '--help' || action === 'help') {
+      this.printHelp()
+      return
+    }
+
+    const parsed = parseFlags(rest)
+
+    switch (action) {
+      case 'version':
+        return this._version()
+      case 'install':
+        return this._install(parsed)
+      case 'uninstall':
+        return this._uninstall()
+      case 'upgrade':
+        return this._upgrade(parsed)
+      case 'init':
+        return this._init(parsed)
+      case 'config':
+        return this._config(parsed)
+      case 'user':
+        return this._user(parsed)
+      case 'log':
+        return this._log(parsed)
+      case 'export':
+        return this._export(parsed)
+      case 'import':
+        return this._import(parsed)
+      default:
+        console.error(`Unknown action: ${action}`)
+        this.printHelp()
+        process.exit(1)
+    }
+  }
+
+  _resolveProxy(parsed) {
+    let proxy = parsed.flags.p || parsed.flags.proxy || ''
+    if (proxy === 'true') proxy = ''
+    return proxy
+  }
+
+  _version() {
+    const result = getGitVersion()
+    output(result)
+  }
+
+  _install(parsed) {
+    const proxy = this._resolveProxy(parsed)
+    const result = installGit(proxy)
+    output(result)
+  }
+
+  _uninstall() {
+    const result = uninstallGit()
+    output(result)
+  }
+
+  _upgrade(parsed) {
+    const proxy = this._resolveProxy(parsed)
+    const result = upgradeGit(proxy)
+    output(result)
+  }
+
+  _getScope(parsed) {
+    return parsed.flags.scope || 'global'
+  }
+
+  async _init(parsed) {
+    const force = parsed.flags.f === 'true' || parsed.flags.force === 'true'
+    const result = await initGitConfig(force)
+    output(result)
+  }
+
+  async _config(parsed) {
+    const scope = this._getScope(parsed)
+    const unsetKey = parsed.flags.unset || ''
+
+    if (unsetKey) {
+      const ok = unsetConfigValue(unsetKey, scope)
+      output({ scope, key: unsetKey, unset: ok })
+      return
+    }
+
+    const [key, value] = parsed.positional
+
+    if (key && value) {
+      const ok = setConfigValue(key, value, scope)
+      output({ scope, key, value, set: ok })
+      return
+    }
+
+    if (key) {
+      const val = getConfigValue(key, scope)
+      output({ scope, key, value: val })
+      return
+    }
+
+    const result = listConfig(scope)
+    output({ scope, ...result })
+  }
+
+  async _user(parsed) {
+    const scope = this._getScope(parsed)
+    const name = parsed.flags.n || parsed.flags.name || ''
+    const email = parsed.flags.e || parsed.flags.email || ''
+
+    if (name || email) {
+      const result = setUser(name, email, scope)
+      output({ scope, ...result })
+      return
+    }
+
+    const result = getUser(scope)
+    output({ scope, ...result })
+  }
+
+  _log(parsed) {
+    const workDir = parsed.flags.d || parsed.flags.dir || process.cwd()
+    const resolvedDir = path.resolve(workDir)
+    if (!this._getGitDir(resolvedDir)) {
+      console.error(`Not a git repository: ${resolvedDir}`)
+      process.exit(1)
+    }
+    const n = parseInt(parsed.flags.n || parsed.flags.count || '10', 10) || 10
+    const opts = { encoding: 'utf8', timeout: 5000, cwd: resolvedDir, stdio: ['pipe', 'pipe', 'pipe'] }
+    const raw = execSync(`git log --oneline -${n}`, opts).trim()
+    if (!raw) {
+      output({ commits: [], message: 'No commits yet' })
+      return
+    }
+    const commits = raw.split('\n').map((line) => {
+      const idx = line.indexOf(' ')
+      return { hash: line.slice(0, idx), subject: line.slice(idx + 1) }
+    })
+    output({ dir: resolvedDir, count: commits.length, commits })
+  }
+
+  _printRecentLog(workDir, count = 5) {
+    const resolvedDir = path.resolve(workDir)
+    if (!this._getGitDir(resolvedDir)) return
+    const opts = { encoding: 'utf8', timeout: 5000, cwd: resolvedDir, stdio: ['pipe', 'pipe', 'pipe'] }
+    try {
+      const raw = execSync(`git log --oneline -${count}`, opts).trim()
+      if (raw) {
+        console.error(`\nRecent ${count} commits:`)
+        for (const line of raw.split('\n')) {
+          console.error(`  ${line}`)
+        }
+      }
+    } catch {}
+  }
+
+  async _export(parsed) {
+    const [sub] = parsed.positional
+
+    if (sub === 'mark') {
+      return this._exportMark(parsed)
+    }
+
+    return this._exportDiff(parsed)
+  }
+
+  _exportMark(parsed) {
+    const workDir = parsed.flags.d || parsed.flags.dir || process.cwd()
+    const ref = parsed.positional[1]
+
+    if (parsed.flags.unset === 'true') {
+      const ok = unsetMark(workDir)
+      output({ mark: 'removed', ok })
+      return
+    }
+
+    if (!ref) {
+      const mark = getMark(workDir)
+      if (!mark) {
+        output({ mark: 'not-set' })
+        console.error('\nTips: mark not set, set a diff base first:')
+        console.error('  opm git export mark HEAD        # mark current HEAD as diff base')
+        console.error('  opm git export mark <commit>   # mark a commit as diff base')
+        console.error('  opm git log -d <dir> -n 10     # view commit history without cd')
+        this._printRecentLog(workDir)
+        return
+      }
+      output({ mark: 'set', ...mark })
+      console.error('\nTips:')
+      console.error('  opm git log -d <dir> -n 10     # view commit history without cd')
+      console.error('  opm git export mark <commit>   # change diff base to another commit')
+      console.error('  opm git export mark --unset     # remove current mark')
+      console.error('  opm git export                  # export diff (mark -> HEAD)')
+      this._printRecentLog(workDir)
+      return
+    }
+
+    const resolvedRef = ref === '0' || ref.toLowerCase() === 'head' ? 'HEAD' : ref
+    const result = setMark(workDir, resolvedRef)
+    output({ mark: 'set', ...result })
+  }
+
+  _exportDiff(parsed) {
+    const workDir = parsed.flags.d || parsed.flags.dir || process.cwd()
+    const resolvedDir = path.resolve(workDir)
+    const gitDir = this._getGitDir(resolvedDir)
+    if (!gitDir) {
+      console.error(`Not a git repository: ${resolvedDir}`)
+      process.exit(1)
+    }
+
+    const fromRaw = parsed.flags.f || parsed.flags.from || ''
+    let fromRef
+    if (fromRaw) {
+      const n = parseInt(fromRaw, 10)
+      fromRef = isNaN(n) ? fromRaw : `HEAD~${n}`
+    } else {
+      const mark = getMark(resolvedDir)
+      if (!mark) {
+        console.error('No mark found. Set a mark first:')
+        console.error('  opm git export mark HEAD        # mark current HEAD as diff base')
+        console.error('  opm git export mark <commit>   # mark a commit as diff base')
+        console.error('  opm git log -d <dir> -n 10     # view commit history without cd')
+        process.exit(1)
+      }
+      fromRef = mark.commit
+    }
+
+    let outFile = parsed.flags.o || parsed.flags.output || ''
+    if (!outFile) {
+      const opts = { encoding: 'utf8', timeout: 5000, cwd: resolvedDir, stdio: ['pipe', 'pipe', 'pipe'] }
+      const gitRoot = execSync('git rev-parse --show-toplevel', opts).trim()
+      const name = parsed.flags.n || parsed.flags.name || ''
+      const fileName = name ? `${name}.diff` : (() => {
+        const fromShort = execSync(`git rev-parse --short ${fromRef}`, opts).trim()
+        const toShort = execSync('git rev-parse --short HEAD', opts).trim()
+        return `changes-${fromShort}-to-${toShort}.diff`
+      })()
+      outFile = path.join(gitRoot, '.webwork', 'git', fileName)
+    }
+
+    const filePath = path.resolve(outFile)
+    const dir = path.dirname(filePath)
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true })
+
+    const result = saveDiff(resolvedDir, filePath, fromRef)
+    output(result)
+  }
+
+  async _import(parsed) {
+    const diffFile = parsed.positional[0]
+    if (!diffFile) {
+      console.error('Usage: opm git import <difffile> [-d <workdir>]')
+      process.exit(1)
+    }
+
+    const workDir = parsed.flags.d || parsed.flags.dir || process.cwd()
+    const resolvedDir = path.resolve(workDir)
+    const gitDir = this._getGitDir(resolvedDir)
+    if (!gitDir) {
+      console.error(`Not a git repository: ${resolvedDir}`)
+      process.exit(1)
+    }
+
+    const result = importDiff(resolvedDir, diffFile)
+    output(result)
+  }
+
+  _getGitDir(dir) {
+    try {
+      execSync('git rev-parse --git-dir', { encoding: 'utf8', timeout: 5000, cwd: dir, stdio: ['pipe', 'pipe', 'pipe'] })
+      return true
+    } catch {
+      return false
+    }
+  }
+
+  printHelp() {
+    const actionLines = Object.entries(ACTIONS)
+      .map(([sig, { desc }]) => `  ${sig.padEnd(12)} ${desc}`)
+      .join('\n')
+
+    console.log(`
+Usage: opm git <action> [options]
+
+Actions:
+${actionLines}
+
+Export subcommands:
+  export mark [-d dir]            Show current diff base mark
+  export mark 0|HEAD [-d dir]     Set diff base mark to current HEAD
+  export mark <commit> [-d dir]   Set diff base mark to a commit
+  export mark --unset [-d dir]    Remove the diff base mark
+  export [-d dir]               Export diff (mark -> HEAD)
+  export -f <n> [-d dir]        Export diff (HEAD~n -> HEAD, override mark)
+  export -f <ref> [-d dir]      Export diff (<ref> -> HEAD, override mark)
+
+Options:
+  -d, --dir <dir>               Git repository directory (default: cwd)
+  -p, --proxy <url>             Proxy for install/upgrade
+  --scope <global|local|system>  Config scope (default: global)
+  -n, --name <name>              User name (user) / diff file name (export)
+  -n, --count <n>                Number of commits to show (log, default: 10)
+  -e, --email <email>            User email (user)
+  -o, --output <file>            Output file path (export)
+  -f, --from <n>|<ref>           Override from ref (export)
+  -f, --force                    Force overwrite existing config (init)
+  --unset <key>                  Unset a config key (config)
+  -h, --help                     Show this help
+
+Examples:
+  opm git version                Show installed git version
+  opm git install                Install git via system package manager
+  opm git upgrade                Upgrade git to latest
+  opm git uninstall              Uninstall git
+  opm git init                  Initialize global config from opm config
+  opm git config                 List all global config
+  opm git config pull.rebase true      Set pull to use rebase
+  opm git user                  Show current user.name and user.email
+  opm git log                    Show recent 10 commits (cwd)
+  opm git log -n 5               Show recent 5 commits (cwd)
+  opm git log -d /path/to/repo   Show commits in specified repo
+  opm git export mark             Show current diff base mark (cwd)
+  opm git export mark 0           Set diff base to current HEAD (cwd)
+  opm git export mark HEAD        Set diff base to current HEAD (cwd)
+  opm git export mark 3af967b   Set diff base at commit (cwd)
+  opm git export mark --unset   Remove diff base mark (cwd)
+  opm git export mark abc -d /repo  Set diff base at commit in /repo
+  opm git export                Export diff in current repo (mark -> HEAD)
+  opm git export -f 2           Override: HEAD~2 -> HEAD (current repo)
+  opm git export -d /path/to/repo  Export diff in specified repo
+  opm git export -n feature     Save as feature.diff
+  opm git import file.diff      Import diff file (current repo)
+  opm git import file.diff -d /repo  Import diff file into specified repo
+`)
+  }
+}