@wwkit/opm 1.0.1

package/src/cli/groups/package.js

@@ -0,0 +1,514 @@
+/**
+ * 包管理命令组
+ *
+ * 一组相似命令（npm/pip）的共享路由：同一套 action 分发，仅底层管理器不同。
+ * 新增包管理器：实现 src/managers/base.js 接口后在此 MANAGERS 注册。
+ */
+
+import { parseFlags } from '../helpers/args.js'
+import { NpmManager } from '../../managers/npm.js'
+import { PipManager } from '../../managers/pip.js'
+import { DnfManager } from '../../managers/dnf.js'
+import { AptManager } from '../../managers/apt.js'
+import { BrewManager } from '../../managers/brew.js'
+import { ComposerManager } from '../../managers/composer.js'
+import { BunManager } from '../../managers/bun.js'
+import { WingetManager } from '../../managers/winget.js'
+import { NodeManager } from '../../managers/node.js'
+import { PhpManager } from '../../managers/php.js'
+import { PythonManager } from '../../managers/python.js'
+import { getPresets } from '../../presets.js'
+import { getActiveProxy } from '../../config.js'
+import { output } from '../../formatter.js'
+
+const MANAGERS = {
+  npm: () => new NpmManager(),
+  pip: () => new PipManager(),
+  dnf: () => new DnfManager(),
+  apt: () => new AptManager(),
+  brew: () => new BrewManager(),
+  composer: () => new ComposerManager(),
+  bun: () => new BunManager(),
+  winget: () => new WingetManager(),
+  node: () => new NodeManager(),
+  php: () => new PhpManager(),
+  python: () => new PythonManager(),
+}
+
+const MANAGER_DESC = {
+  npm: 'npm package manager',
+  pip: 'pip package manager',
+  dnf: 'dnf package manager',
+  apt: 'apt package manager',
+  brew: 'brew package manager (Homebrew)',
+  composer: 'composer package manager (PHP)',
+  bun: 'bun package manager (Bun runtime)',
+  winget: 'winget package manager (Windows)',
+  node: 'node version manager (via nvm)',
+  php: 'php version manager (via phpenv)',
+  python: 'python version manager (via uv)',
+}
+
+const ACTIONS = {
+  version:    { desc: 'Show manager version' },
+  installed:  { desc: 'Check if the manager itself is installed' },
+  registry:   { desc: 'Query or set registry/mirror address' },
+  search:     { desc: 'Check if a package is available in the source' },
+  view:       { desc: 'Check if a package is already installed' },
+  info:       { desc: 'Show package details' },
+  versions:   { desc: 'List all available versions of a package' },
+  list:       { desc: 'List all installed packages' },
+  outdated:   { desc: 'List outdated packages' },
+  install:    { desc: 'Install a package' },
+  uninstall:  { desc: 'Uninstall a package' },
+  upgrade:    { desc: 'Upgrade a package' },
+  cache:      { desc: 'Clean cache' },
+  help:       { desc: 'Show help for this manager' },
+}
+
+export class PackageGroup {
+  /**
+   * @param {string} managerName - 管理器名称（npm/pip）
+   */
+  constructor(managerName) {
+    this.name = managerName
+    this.desc = MANAGER_DESC[managerName] || `${managerName} package manager`
+  }
+
+  async run(argv) {
+    const [action, ...rest] = argv
+
+    if (!action || action === '-h' || action === '--help' || action === 'help') {
+      this.printHelp()
+      return
+    }
+
+    if (!ACTIONS[action]) {
+      console.error(`Unknown action: ${action}`)
+      this.printHelp()
+      process.exit(1)
+    }
+
+    const manager = MANAGERS[this.name]()
+    const parsed = parseFlags(rest)
+    const global = parsed.flags.global === 'true' || parsed.flags.g === 'true'
+    let proxy = parsed.flags.proxy || parsed.flags.p || ''
+    if (proxy === 'true') proxy = ''
+    if (!proxy) proxy = getActiveProxy()
+
+    await this._dispatch(manager, action, parsed, { global, proxy })
+  }
+
+  async _dispatch(manager, action, parsed, opts) {
+    const { positional } = parsed
+
+    switch (action) {
+      case 'version': {
+        const result = await manager.getVersion()
+        output((result.version || '').replace(/^v/, ''))
+        break
+      }
+
+      case 'installed': {
+        const result = await manager.getVersion()
+        output({ name: result.name, installed: result.installed, ...(result.version ? { version: result.version } : {}), ...(result.hint ? { hint: result.hint } : {}) })
+        break
+      }
+
+      case 'registry': {
+        if (positional[0] === 'set') {
+          const url = positional[1]
+          if (!url) {
+            console.error(`Usage: opm ${this.name} registry set <url|preset>`)
+            process.exit(1)
+          }
+          const result = await manager.setRegistry(url)
+          output(result)
+        } else if (positional[0] === 'presets') {
+          const presets = getPresets(this.name)
+          const items = Object.entries(presets).map(([name, url]) => ({ name, url }))
+          output(items)
+        } else {
+          const result = await manager.getRegistry()
+          output(result)
+        }
+        break
+      }
+
+      case 'search': {
+        const name = positional[0]
+        const version = positional[1]
+        if (!name) {
+          console.error(`Usage: opm ${this.name} search <name> [version]`)
+          process.exit(1)
+        }
+        const result = await manager.searchPackage(name, version, { proxy: opts.proxy })
+        output(result)
+        break
+      }
+
+      case 'view': {
+        const name = positional[0]
+        if (!name) {
+          console.error(`Usage: opm ${this.name} view <name> [-g]`)
+          process.exit(1)
+        }
+        const result = await manager.isInstalled(name, { global: !!opts.global })
+        output(result)
+        break
+      }
+
+      case 'info': {
+        const name = positional[0]
+        if (!name) {
+          console.error(`Usage: opm ${this.name} info <name>`)
+          process.exit(1)
+        }
+        const result = await manager.packageInfo(name, { proxy: opts.proxy })
+        output(result)
+        break
+      }
+
+      case 'versions': {
+        const name = positional[0]
+        if (!name) {
+          console.error(`Usage: opm ${this.name} versions <name>`)
+          process.exit(1)
+        }
+        const result = await manager.packageVersions(name, { proxy: opts.proxy })
+        output(result)
+        break
+      }
+
+      case 'list': {
+        const result = await manager.listInstalled({ global: !!opts.global })
+        output(result)
+        break
+      }
+
+      case 'outdated': {
+        const result = await manager.listOutdated({ global: !!opts.global, proxy: opts.proxy })
+        output(result)
+        break
+      }
+
+      case 'install': {
+        const name = positional[0]
+        const version = positional[1]
+        if (!name) {
+          console.error(`Usage: opm ${this.name} install <name> [version]`)
+          process.exit(1)
+        }
+        const result = await manager.install(name, version, { global: !!opts.global, proxy: opts.proxy })
+        output(result)
+        break
+      }
+
+      case 'uninstall': {
+        const name = positional[0]
+        if (!name) {
+          console.error(`Usage: opm ${this.name} uninstall <name>`)
+          process.exit(1)
+        }
+        const result = await manager.uninstall(name, { global: !!opts.global })
+        output(result)
+        break
+      }
+
+      case 'upgrade': {
+        const name = positional[0]
+        if (!name) {
+          console.error(`Usage: opm ${this.name} upgrade <name>`)
+          process.exit(1)
+        }
+        const result = await manager.upgrade(name, { global: !!opts.global, proxy: opts.proxy })
+        output(result)
+        break
+      }
+
+      case 'cache': {
+        if (positional[0] !== 'clean') {
+          console.error(`Usage: opm ${this.name} cache clean`)
+          process.exit(1)
+        }
+        const result = await manager.cleanCache()
+        output(result)
+        break
+      }
+
+      default:
+        console.error(`Unknown action: ${action}`)
+        process.exit(1)
+    }
+  }
+
+  printHelp() {
+    console.log(`
+Usage: opm ${this.name} <action> [args] [options]
+
+Actions:
+  version                   Show ${this.name} version
+  installed                 Check if ${this.name} itself is installed
+  registry                   Show active registry (from opm config)
+  registry set <url|preset>  Set active registry (writes opm config)
+  registry presets           List available mirror presets
+  search <name> [version]    Check package availability in source
+  view <name> [-g]           Check if package is installed (local or global)
+  info <name>                Show package details
+  versions <name>            List all available versions
+  list [-g]                   List all installed packages
+  outdated [-g]               List outdated packages
+  install <name> [version]   Install a package
+  uninstall <name>           Uninstall a package
+  upgrade <name>             Upgrade a package to latest
+  cache clean                Clean cache
+  help                       Show this help
+
+Options:
+  -g, --global    Global operation (npm: global node_modules; pip: system Python)
+  -p, --proxy <url>  Proxy address (search/info/versions/outdated/install/upgrade);
+                  overrides config proxy.active when provided
+  -h, --help      Show this help
+
+Examples:
+  opm ${this.name} registry
+  opm ${this.name} registry set <preset|url>
+  opm ${this.name} search <name>
+  opm ${this.name} view <name>
+  opm ${this.name} info <name>
+  opm ${this.name} versions <name>
+  opm ${this.name} list
+  opm ${this.name} outdated
+  opm ${this.name} install <name>
+  opm ${this.name} uninstall <name>
+  opm ${this.name} upgrade <name>
+  opm ${this.name} cache clean
+`)
+  }
+}
+
+/**
+ * 运行时版本管理器元数据（node / php / python）
+ * 由 RuntimeGroup 据此生成一致的帮助文本。
+ */
+const RUNTIME_META = {
+  node: {
+    label: 'Node.js',
+    tool: 'nvm',
+    versionsHint: 'nvm ls-remote',
+    listHint: 'nvm ls',
+    useHint: 'nvm use',
+    currentHint: 'nvm current',
+    defaultHint: 'nvm alias default',
+    latest: 'LTS',
+    installExample: '20',
+    useExample: '20',
+    searchExample: 'v20.20.2',
+    uninstallExample: '18',
+  },
+  php: {
+    label: 'PHP',
+    tool: 'phpenv',
+    versionsHint: 'phpenv install --list',
+    listHint: 'phpenv versions',
+    useHint: 'phpenv global',
+    currentHint: 'phpenv version',
+    defaultHint: 'phpenv global',
+    latest: '',
+    installExample: '8.3',
+    useExample: '8.3',
+    searchExample: '8.3.13',
+    uninstallExample: '8.2',
+  },
+  python: {
+    label: 'Python',
+    tool: 'uv',
+    versionsHint: 'uv python list',
+    listHint: 'uv python list --only-installed',
+    useHint: 'uv python pin',
+    currentHint: 'python --version',
+    defaultHint: '~/.python-version',
+    latest: '',
+    installExample: '3.12',
+    useExample: '3.12',
+    searchExample: '3.12.4',
+    uninstallExample: '3.11',
+  },
+}
+
+/**
+ * 运行时命令组 — 在 PackageGroup（registry/search/info/versions/list/install/...）
+ * 基础上增加 use/current/default 三个版本管理专属 action。
+ * node / php / python 共用同一实现，仅顶层命令名与帮助元数据不同。
+ */
+export class RuntimeGroup extends PackageGroup {
+  constructor(managerName) {
+    super(managerName)
+    this.meta = RUNTIME_META[managerName]
+  }
+
+  async run(argv) {
+    const [action, ...rest] = argv
+
+    if (!action || action === '-h' || action === '--help' || action === 'help') {
+      this.printHelp()
+      return
+    }
+
+    const runtimeActions = new Set(['use', 'current', 'default', 'installed', 'dir', 'install', 'upgrade', 'search', 'versions'])
+    if (runtimeActions.has(action)) {
+      const manager = MANAGERS[this.name]()
+      const parsed = parseFlags(rest)
+      let proxy = parsed.flags.proxy || parsed.flags.p || ''
+      if (proxy === 'true') proxy = ''
+      if (!proxy) proxy = getActiveProxy()
+      await this._dispatch(manager, action, parsed, { global: false, proxy })
+      return
+    }
+
+    return super.run(argv)
+  }
+
+  async _dispatch(manager, action, parsed, opts) {
+    const { positional } = parsed
+
+    switch (action) {
+      case 'installed': {
+        const result = await manager.getVersion()
+        const toolInstalled = manager.cfg.isInstalled()
+        output({
+          name: result.name,
+          installed: result.installed,
+          ...(result.version ? { version: result.version } : {}),
+          ...(result.hint ? { hint: result.hint } : {}),
+          tool: { name: this.meta.tool, installed: toolInstalled },
+        })
+        break
+      }
+
+      case 'use': {
+        const version = positional[0]
+        if (!version) {
+          console.error(`Usage: opm ${this.name} use <version>`)
+          process.exit(1)
+        }
+        const result = await manager.useVersion(version, { proxy: opts.proxy })
+        output(result)
+        break
+      }
+
+      case 'current': {
+        const result = await manager.currentVersion()
+        output(result)
+        break
+      }
+
+      case 'default': {
+        const version = positional[0]
+        if (!version) {
+          console.error(`Usage: opm ${this.name} default <version>`)
+          process.exit(1)
+        }
+        const result = await manager.setDefault(version)
+        output(result)
+        break
+      }
+
+      case 'dir': {
+        const install = manager.getInstallDir ? manager.getInstallDir() : ''
+        output({
+          name: this.name,
+          install,
+        })
+        break
+      }
+
+      case 'install': {
+        const version = positional[0] || (manager.getDefaultVersion ? manager.getDefaultVersion() : '')
+        if (!version) {
+          console.error(`Usage: opm ${this.name} install <version>`)
+          process.exit(1)
+        }
+        const result = await manager.install(this.name, version, { proxy: opts.proxy })
+        output(result)
+        break
+      }
+
+      case 'upgrade': {
+        const result = await manager.upgrade(this.name, { proxy: opts.proxy })
+        output(result)
+        break
+      }
+
+      case 'search': {
+        const version = positional[0]
+        if (!version) {
+          console.error(`Usage: opm ${this.name} search <version>`)
+          process.exit(1)
+        }
+        const result = await manager.searchPackage(this.name, version, { proxy: opts.proxy })
+        output(result)
+        break
+      }
+
+      case 'versions': {
+        const result = await manager.packageVersions(this.name, { proxy: opts.proxy })
+        output(result)
+        break
+      }
+
+      default:
+        return super._dispatch(manager, action, parsed, opts)
+    }
+  }
+
+  /**
+   * 依据元数据生成一致的运行时帮助文本
+   */
+  printHelp() {
+    const { label, tool, versionsHint, listHint, useHint, currentHint, defaultHint, latest, installExample, useExample, searchExample, uninstallExample } = this.meta
+    const latestLabel = latest ? ` install latest ${latest}` : ''
+    const installDesc = `Install a ${label} version (e.g. ${installExample}${latest ? `, --lts` : ''})`
+    console.log(`
+Usage: opm ${this.name} <action> [args] [options]
+
+Actions:
+  version                   Show current ${label} version
+  installed                 Check if ${label} is installed (and its version manager ${tool})
+  registry                  Show active ${label} dist/source mirror (from opm config)
+  registry set <url|preset> Set active ${label} mirror (writes opm config)
+  registry presets          List available mirror presets
+  search <version>          Check if a ${label} version is available for download
+  view <version>            Check if a ${label} version is installed
+  versions                  List all available ${label} versions (${versionsHint})
+  list                      List installed ${label} versions (${listHint})
+  install [version]         ${installDesc} (default: config defaultVersion)
+  uninstall <version>       Uninstall a ${label} version
+  upgrade                   ${latest ? 'Install latest ' + latest : 'Install latest'} ${label}
+  use <version>             Switch to a ${label} version (${useHint})
+  current                   Show current active ${label} version (${currentHint})
+  default <version>         Set default ${label} version (${defaultHint})
+  dir                       Show ${label} install directory
+  help                      Show this help
+
+Options:
+  -p, --proxy <url>  Proxy address (search/versions/install/upgrade/use)
+  -h, --help          Show this help
+
+Examples:
+  opm ${this.name} current
+  opm ${this.name} install ${installExample}
+  opm ${this.name} use ${useExample}
+  opm ${this.name} default ${useExample}
+  opm ${this.name} dir
+  opm ${this.name} list
+  opm ${this.name} versions
+  opm ${this.name} search ${searchExample}
+  opm ${this.name} view ${searchExample}
+  opm ${this.name} uninstall ${uninstallExample}
+  opm ${this.name} upgrade
+`)
+  }
+}
+
+export { MANAGERS, ACTIONS }

package/src/cli/groups/phpenv.js

@@ -0,0 +1,89 @@
+/**
+ * phpenv 命令组 — 管理 phpenv 自身
+ *
+ * phpenv 是常规二进制（~/.phpenv/bin/phpenv），通过 git clone 安装；
+ * install = git clone phpenv + git clone php-build plugin + 写 shell profile；
+ * upgrade = git pull（含 php-build 插件）；uninstall = rm -rf ~/.phpenv。
+ * registry 是 phpenv 的 git 镜像地址（official / gitee）。
+ */
+
+import { execSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { ToolManagerGroup } from './version-manager.js'
+import { Shell } from '@wwkit/shared'
+import { getActiveRegistry } from '../../config.js'
+import { installPhpenv } from '../../managers/php.js'
+
+const shell = new Shell()
+
+/**
+ * 获取 phpenv 根目录
+ * @returns {string}
+ */
+function getPhpenvRoot() {
+  return process.env.PHPENV_ROOT || path.join(os.homedir(), '.phpenv')
+}
+
+/**
+ * 获取 phpenv 二进制路径
+ * @returns {string}
+ */
+function getPhpenvBin() {
+  return path.join(getPhpenvRoot(), 'bin', 'phpenv')
+}
+
+export class PhpenvGroup extends ToolManagerGroup {
+  constructor() {
+    super({
+      name: 'phpenv',
+      desc: 'phpenv version manager (manage phpenv itself)',
+      needsBash: true,
+      isInstalled: () => fs.existsSync(getPhpenvBin()),
+      getPath: () => getPhpenvRoot(),
+      versionCmd: () => `${getPhpenvBin()} --version`,
+      parseVersion: (out) => {
+        const m = out.trim().match(/phpenv\s+([\d.]+)/)
+        return m ? m[1] : out.trim()
+      },
+      install: () => installPhpenv(),
+      upgrade: () => {
+        execSync(`cd "${getPhpenvRoot()}" && git remote set-url origin "${getActiveRegistry('phpenv')}" && git pull --tags`, {
+          stdio: 'inherit',
+          shell: shell.resolveBash(),
+        })
+        const pluginsDir = path.join(getPhpenvRoot(), 'plugins', 'php-build')
+        if (fs.existsSync(pluginsDir)) {
+          execSync(`cd "${pluginsDir}" && git pull`, { stdio: 'inherit', shell: shell.resolveBash() })
+        }
+        return { action: 'upgraded' }
+      },
+      uninstall: () => {
+        fs.rmSync(getPhpenvRoot(), { recursive: true, force: true })
+        return { action: 'uninstalled', hint: 'Remove PHPENV_ROOT/init line from shell profile manually' }
+      },
+      usage: 'opm phpenv <action> [args] [options]',
+      actions: [
+        ['version', 'Show phpenv version'],
+        ['installed', 'Check if phpenv is installed'],
+        ['registry', 'Show active phpenv git mirror (from opm config)'],
+        ['registry set <url|preset>', 'Set active phpenv git mirror (writes opm config)'],
+        ['registry presets', 'List available mirror presets'],
+        ['install', 'Install phpenv (git clone + php-build plugin + shell profile)'],
+        ['upgrade', 'Update phpenv and php-build plugin (git pull)'],
+        ['uninstall', 'Remove phpenv (~/.phpenv)'],
+        ['dir', 'Show phpenv install directory'],
+        ['help', 'Show this help'],
+      ],
+      examples: [
+        'opm phpenv version',
+        'opm phpenv installed',
+        'opm phpenv registry set gitee',
+        'opm phpenv install',
+        'opm phpenv upgrade',
+        'opm phpenv dir',
+      ],
+    })
+  }
+}

package/src/cli/groups/uv.js

@@ -0,0 +1,73 @@
+/**
+ * uv 命令组 — 管理 uv 自身
+ *
+ * uv 是 Astral 出品的快速 Python 包/版本管理器（Rust 实现）。
+ * 安装方式：curl 安装脚本（非 git clone）；
+ * upgrade = uv self update；uninstall = rm 二进制 + 数据目录。
+ * uv 无镜像源，故无 registry action。
+ */
+
+import { execSync, spawnSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { ToolManagerGroup } from './version-manager.js'
+import { installUv, getUvBin } from '../../managers/python.js'
+
+const UV_INSTALL_URL = 'https://astral.sh/uv/install.sh'
+const UV_INSTALL_PS_URL = 'https://astral.sh/uv/install.ps1'
+
+export class UvGroup extends ToolManagerGroup {
+  constructor() {
+    super({
+      name: 'uv',
+      desc: 'uv version manager (manage uv itself)',
+      hasRegistry: false,
+      isInstalled: () => {
+        try {
+          execSync(`${getUvBin()} --version`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+          return true
+        } catch {
+          return false
+        }
+      },
+      getPath: () => getUvBin(),
+      versionCmd: () => `${getUvBin()} --version`,
+      parseVersion: (out) => out.trim(),
+      install: () => installUv(),
+      upgrade: () => {
+        execSync(`${getUvBin()} self update`, { stdio: 'inherit' })
+        return { action: 'upgraded' }
+      },
+      uninstall: () => {
+        const bin = getUvBin()
+        if (bin !== 'uv' && fs.existsSync(bin)) {
+          fs.rmSync(bin, { force: true })
+        }
+        const dataDir = path.join(os.homedir(), '.local', 'share', 'uv')
+        if (fs.existsSync(dataDir)) {
+          fs.rmSync(dataDir, { recursive: true, force: true })
+        }
+        return { action: 'uninstalled', hint: 'Remove ~/.local/bin from PATH manually if needed' }
+      },
+      usage: 'opm uv <action> [options]',
+      actions: [
+        ['version', 'Show uv version'],
+        ['installed', 'Check if uv is installed'],
+        ['install', 'Install uv (curl installer from astral.sh)'],
+        ['upgrade', 'Update uv (uv self update)'],
+        ['uninstall', 'Remove uv (~/.local/bin/uv + ~/.local/share/uv)'],
+        ['dir', 'Show uv install directory'],
+        ['help', 'Show this help'],
+      ],
+      examples: [
+        'opm uv version',
+        'opm uv installed',
+        'opm uv install',
+        'opm uv upgrade',
+        'opm uv dir',
+        'opm uv uninstall',
+      ],
+    })
+  }
+}