@wwkit/opm 1.0.1

package/src/managers/python.js

@@ -0,0 +1,180 @@
+/**
+ * python（Python runtime）版本管理器实现（基于 uv）
+ *
+ * 通过 uv CLI 管理多个 Python 版本。uv 是常规二进制（~/.local/bin/uv），
+ * 非 shell function，直接调用即可。
+ *
+ * 源查询使用 uv python list，本地查询使用 uv python list --only-installed。
+ * 镜像通过 UV_PYTHON_INSTALL_MIRROR 环境变量传递给 uv。
+ *
+ * 与 node/php 差异较大处由子类覆盖：
+ *  - getVersion / currentVersion：直接读系统 `python3`/`python`（而非 uv 子命令）
+ *  - setDefault：写 ~/.python-version 文件
+ */
+
+import { execSync, spawnSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { RuntimeManager } from './runtime.js'
+
+const UV_INSTALL_URL = 'https://astral.sh/uv/install.sh'
+const UV_INSTALL_PS_URL = 'https://astral.sh/uv/install.ps1'
+
+/**
+ * 获取 uv 二进制路径（默认 ~/.local/bin/uv，否则依赖 PATH）
+ * @returns {string}
+ */
+export function getUvBin() {
+  const localBin = path.join(os.homedir(), '.local', 'bin', 'uv')
+  if (fs.existsSync(localBin)) return localBin
+  return 'uv'
+}
+
+/**
+ * 检查 uv 是否已安装
+ * @returns {boolean}
+ */
+export function isUvInstalled() {
+  try {
+    execSync(`${getUvBin()} --version`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 安装 uv（curl 安装脚本）
+ * @returns {{ action: string, hint: string }}
+ */
+export function installUv() {
+  if (process.platform === 'win32') {
+    const r = spawnSync(
+      'powershell',
+      ['-ExecutionPolicy', 'ByPass', '-c', `irm ${UV_INSTALL_PS_URL} | iex`],
+      { stdio: 'inherit' }
+    )
+    if (r.status !== 0) {
+      throw new Error('uv install failed (powershell exited non-zero)')
+    }
+  } else {
+    execSync(`curl -LsSf "${UV_INSTALL_URL}" | sh`, { stdio: 'inherit', shell: true })
+  }
+  return { action: 'installed', hint: 'Restart shell or ensure ~/.local/bin is in PATH' }
+}
+
+export class PythonManager extends RuntimeManager {
+  constructor() {
+    super({
+      name: 'python',
+      mirrorEnv: 'UV_PYTHON_INSTALL_MIRROR',
+      prefix: getUvBin(),
+      isInstalled: () => isUvInstalled(),
+      installTool: () => installUv(),
+      toolName: 'uv',
+      toolMissingMsg: 'uv not installed, run `opm uv install` first',
+      listCmd: ['python', 'list', '--only-installed'],
+      listRemoteCmd: ['python', 'list'],
+      installCmd: (v) => ['python', 'install', v],
+      uninstallCmd: (n) => ['python', 'uninstall', n],
+      resultName: (v) => v,
+      useCmd: (v) => ['python', 'pin', v],
+      useAction: 'pinned (current directory)',
+      noCacheMsg: 'no cache for uv-managed python',
+      installUsage: 'Usage: opm python install <version> (e.g. 3.12, 3.12.4)',
+      notInstalledHint: 'No Python found, run `opm uv install` and `opm python install <version>`',
+      upgradeNoVersionMsg: 'No Python version available to upgrade to',
+      info: {
+        description: 'Python programming language interpreter',
+        homepage: 'https://www.python.org',
+        license: 'PSF License',
+        author: 'Python Software Foundation',
+        repository: 'https://github.com/python/cpython',
+      },
+    })
+  }
+
+  /**
+   * 获取当前激活 python 的安装目录
+   * @returns {string}
+   */
+  getInstallDir() {
+    try {
+      const out = this._exec(['python', 'find'], { allowNonZero: true }).trim()
+      if (!out) return ''
+      return path.dirname(path.dirname(out))
+    } catch {}
+    return ''
+  }
+
+  /**
+   * 解析 uv python list --only-installed 输出为已安装版本列表
+   * 输出格式: cpython-3.12.4-linux-x86_64-gnu     /path/to/python
+   * @param {string} out
+   * @returns {{ name: string, version: string, current: boolean }[]}
+   * @private
+   */
+  _parseInstalled(out) {
+    const items = []
+    for (const line of out.split('\n')) {
+      const m = line.match(/cpython-(\d+\.\d+\.\d+)/)
+      if (m) {
+        items.push({ name: m[1], version: m[1], current: false })
+      }
+    }
+    return items
+  }
+
+  /**
+   * 解析 uv python list 输出为可用版本列表
+   * @param {string} out
+   * @returns {string[]}
+   * @private
+   */
+  _parseRemote(out) {
+    const versions = []
+    for (const line of out.split('\n')) {
+      const m = line.match(/cpython-(\d+\.\d+\.\d+)/)
+      if (m && !versions.includes(m[1])) {
+        versions.push(m[1])
+      }
+    }
+    return versions
+  }
+
+  /**
+   * 查询系统 Python 版本
+   * @returns {{ version: string, installed: boolean } | null}
+   * @private
+   */
+  _systemVersion() {
+    for (const cmd of ['python3', 'python']) {
+      try {
+        const out = execSync(`${cmd} --version`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+        const m = out.trim().match(/Python\s+(\d+\.\d+\.\d+)/)
+        if (m) return { version: m[1], installed: true }
+      } catch {}
+    }
+    return null
+  }
+
+  async getVersion() {
+    const v = this._systemVersion()
+    if (v) {
+      return { name: 'python', installed: true, version: v.version }
+    }
+    return { name: 'python', installed: false, hint: this.cfg.notInstalledHint }
+  }
+
+  async currentVersion() {
+    const v = this._systemVersion()
+    return { current: v ? v.version : 'unknown' }
+  }
+
+  async setDefault(version) {
+    const homeVersionFile = path.join(os.homedir(), '.python-version')
+    fs.writeFileSync(homeVersionFile, `${version}\n`, 'utf8')
+    return { version, action: 'default set (~/.python-version)' }
+  }
+}

package/src/managers/runtime.js

@@ -0,0 +1,309 @@
+/**
+ * 运行时版本管理器基类（node / php / python 共用）
+ *
+ * 三个运行时均通过底层版本管理工具（nvm / phpenv / uv）管理多版本，
+ * 接口一致（registry/search/view/info/versions/list/install/uninstall/upgrade/use/current/default）。
+ * 差异（命令前缀、镜像环境变量、动作命令参数、解析函数）通过 cfg 配置注入；
+ * 解析函数由子类实现。python 的 getVersion/currentVersion/setDefault 等差异较大，
+ * 由子类覆盖。
+ */
+
+import { execSync, spawnSync } from 'node:child_process'
+import { PackageManager } from './base.js'
+import { Shell } from '@wwkit/shared'
+import { getActiveRegistry, setActiveRegistry, getConfig } from '../config.js'
+
+const shell = new Shell()
+
+/**
+ * @typedef {Object} RuntimeConfig
+ * @property {string} name
+ * @property {string} mirrorEnv - dist 镜像环境变量名
+ * @property {string} prefix - 工具调用前缀（如 `source ".../nvm.sh" && nvm`、bin 路径）
+ * @property {boolean} [needsBash=false] - 命令是否需要 bash（nvm source / phpenv 脚本）；原生二进制（uv）为 false
+ * @property {() => boolean} isInstalled
+ * @property {string} toolMissingMsg
+ * @property {string[]} listCmd - 列出已安装版本的参数
+ * @property {string[]} listRemoteCmd - 列出可用版本的参数
+ * @property {string[]} [currentCmd] - 查询当前版本的参数（python 覆盖）
+ * @property {(out: string) => string} [parseCurrent] - 解析当前版本（空串 = 无有效版本）
+ * @property {(v: string) => string[]} installCmd
+ * @property {(n: string) => string[]} uninstallCmd
+ * @property {(v: string) => string} resultName - install 结果的 name 字段
+ * @property {string[]} [upgradeLts] - 升级为 LTS 的参数（node）；缺省走「装最新版」逻辑
+ * @property {(v: string) => string[]} useCmd
+ * @property {string} useAction
+ * @property {(v: string) => string[]} defaultCmd
+ * @property {string} noCacheMsg
+ * @property {string} installUsage
+ * @property {string} notInstalledHint
+ * @property {string} upgradeNoVersionMsg
+ * @property {Object} info - packageInfo 静态元数据
+ */
+
+export class RuntimeManager extends PackageManager {
+  /**
+   * @param {RuntimeConfig} cfg
+   */
+  constructor(cfg) {
+    super()
+    this.name = cfg.name
+    this.cfg = cfg
+  }
+
+  /**
+   * 构造工具调用环境（含 dist 镜像 + proxy）
+   * @param {string} [proxy]
+   * @returns {Record<string,string>}
+   * @private
+   */
+  _buildEnv(proxy) {
+    const env = { ...process.env }
+    const mirror = getActiveRegistry(this.name)
+    if (mirror) {
+      env[this.cfg.mirrorEnv] = mirror
+    }
+    if (proxy) {
+      Object.assign(env, {
+        HTTP_PROXY: proxy,
+        HTTPS_PROXY: proxy,
+        ALL_PROXY: proxy,
+        http_proxy: proxy,
+        https_proxy: proxy,
+        all_proxy: proxy,
+      })
+    }
+    return env
+  }
+
+  /**
+   * 构造完整 shell 命令
+   * @param {string[]} args
+   * @returns {string}
+   * @private
+   */
+  _cmd(args) {
+    return `${this.cfg.prefix} ${args.join(' ')}`
+  }
+
+  /**
+   * 执行工具命令，返回 stdout
+   * @param {string[]} args
+   * @param {{ allowNonZero?: boolean, proxy?: string }} [opts]
+   * @returns {string}
+   * @private
+   */
+  _exec(args, opts = {}) {
+    if (!this.cfg.isInstalled()) {
+      throw new Error(this.cfg.toolMissingMsg)
+    }
+    try {
+      return execSync(this._cmd(args), {
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+        shell: shell.shellForExec(this.cfg.needsBash),
+        env: this._buildEnv(opts.proxy),
+      })
+    } catch (err) {
+      if (opts.allowNonZero) {
+        return err.stdout ? err.stdout.toString() : ''
+      }
+      const stderr = err.stderr ? err.stderr.toString().trim() : ''
+      if (stderr) {
+        throw new Error(stderr)
+      }
+      return err.stdout ? err.stdout.toString() : ''
+    }
+  }
+
+  /**
+   * 执行工具命令，输出直接继承到终端
+   * @param {string[]} args
+   * @param {{ proxy?: string }} [opts]
+   * @private
+   */
+  _execInherit(args, opts = {}) {
+    if (!this.cfg.isInstalled()) {
+      throw new Error(this.cfg.toolMissingMsg)
+    }
+    const result = spawnSync(this._cmd(args), {
+      stdio: 'inherit',
+      shell: shell.shellForExec(this.cfg.needsBash),
+      env: this._buildEnv(opts.proxy),
+    })
+    if (result.error) {
+      throw new Error(result.error.message)
+    }
+    if (result.status !== 0) {
+      throw new Error(`${this.name} ${args.join(' ')} exited with code ${result.status}`)
+    }
+  }
+
+  /**
+   * 解析已安装版本列表（子类实现）
+   * @param {string} out
+   * @returns {{ name: string, version: string, current: boolean }[]}
+   */
+  _parseInstalled(out) {
+    throw new Error(`${this.name}: _parseInstalled not implemented`)
+  }
+
+  /**
+   * 解析可用版本列表（子类实现）
+   * @param {string} out
+   * @returns {string[]}
+   */
+  _parseRemote(out) {
+    throw new Error(`${this.name}: _parseRemote not implemented`)
+  }
+
+  async getRegistry() {
+    return { registry: getActiveRegistry(this.name) }
+  }
+
+  async setRegistry(url) {
+    return { registry: setActiveRegistry(this.name, url) }
+  }
+
+  async getVersion() {
+    try {
+      const out = this._exec(this.cfg.currentCmd, { allowNonZero: true })
+      const parsed = this.cfg.parseCurrent(out)
+      if (parsed) {
+        return { name: this.name, installed: true, version: parsed }
+      }
+    } catch {}
+    return { name: this.name, version: '', installed: false, hint: this.cfg.notInstalledHint }
+  }
+
+  /**
+   * 获取当前激活版本的安装目录（子类实现）
+   * @returns {string}
+   */
+  getInstallDir() {
+    return ''
+  }
+
+  /**
+   * 获取配置中的默认安装版本
+   * @returns {string}
+   */
+  getDefaultVersion() {
+    return getConfig()[this.name]?.defaultVersion || ''
+  }
+
+  async searchPackage(name, version, opts = {}) {
+    const { registry } = await this.getRegistry()
+    const out = this._exec(this.cfg.listRemoteCmd, { allowNonZero: true, proxy: opts.proxy })
+    const versions = this._parseRemote(out)
+    if (versions.length === 0) {
+      if (version) return { name, version, exists: false, available: false, registry }
+      return { name, exists: false, registry }
+    }
+    if (version) {
+      return { name, version, exists: true, available: versions.includes(version), registry }
+    }
+    return {
+      name,
+      exists: true,
+      latest: versions[versions.length - 1],
+      versions,
+      registry,
+    }
+  }
+
+  async isInstalled(name, opts = {}) {
+    const out = this._exec(this.cfg.listCmd, { allowNonZero: true })
+    const items = this._parseInstalled(out)
+    const hit = items.find((i) => i.name === name)
+    if (hit) {
+      return { name, installed: true, version: hit.version, current: hit.current }
+    }
+    return { name, installed: false }
+  }
+
+  async packageInfo(name, opts = {}) {
+    return { name: this.name, ...this.cfg.info }
+  }
+
+  async packageVersions(name, opts = {}) {
+    const { registry } = await this.getRegistry()
+    const out = this._exec(this.cfg.listRemoteCmd, { allowNonZero: true, proxy: opts.proxy })
+    return { name, versions: this._parseRemote(out), registry }
+  }
+
+  async listInstalled(opts = {}) {
+    const out = this._exec(this.cfg.listCmd, { allowNonZero: true })
+    return this._parseInstalled(out)
+  }
+
+  async listOutdated(opts = {}) {
+    return []
+  }
+
+  async install(name, version, opts = {}) {
+    if (!version) {
+      throw new Error(this.cfg.installUsage)
+    }
+    if (!this.cfg.isInstalled() && this.cfg.installTool) {
+      console.log(`[opm] ${this.cfg.toolName} not installed, auto-installing...`)
+      this.cfg.installTool()
+    }
+    this._execInherit(this.cfg.installCmd(version), { proxy: opts.proxy })
+    return { name: this.cfg.resultName(version), version, action: 'installed' }
+  }
+
+  async uninstall(name, opts = {}) {
+    this._execInherit(this.cfg.uninstallCmd(name))
+    return { name, action: 'uninstalled' }
+  }
+
+  async upgrade(name, opts = {}) {
+    if (this.cfg.upgradeLts) {
+      this._execInherit(this.cfg.upgradeLts, { proxy: opts.proxy })
+      return { name: 'lts', version: 'latest', action: 'upgraded' }
+    }
+    const out = this._exec(this.cfg.listRemoteCmd, { allowNonZero: true, proxy: opts.proxy })
+    const versions = this._parseRemote(out)
+    const latest = versions[versions.length - 1]
+    if (!latest) {
+      throw new Error(this.cfg.upgradeNoVersionMsg)
+    }
+    this._execInherit(this.cfg.installCmd(latest), { proxy: opts.proxy })
+    return { name: latest, version: latest, action: 'upgraded' }
+  }
+
+  async cleanCache() {
+    return { action: this.cfg.noCacheMsg }
+  }
+
+  /**
+   * 切换当前版本
+   * @param {string} version
+   * @param {{ proxy?: string }} [opts]
+   * @returns {Promise<{ version: string, action: string }>}
+   */
+  async useVersion(version, opts = {}) {
+    this._execInherit(this.cfg.useCmd(version), { proxy: opts.proxy })
+    return { version, action: this.cfg.useAction }
+  }
+
+  /**
+   * 查询当前激活版本
+   * @returns {Promise<{ current: string }>}
+   */
+  async currentVersion() {
+    const out = this._exec(this.cfg.currentCmd, { allowNonZero: true })
+    return { current: this.cfg.parseCurrent(out) || out.trim() }
+  }
+
+  /**
+   * 设置默认版本
+   * @param {string} version
+   * @returns {Promise<{ version: string, action: string }>}
+   */
+  async setDefault(version) {
+    this._execInherit(this.cfg.defaultCmd(version))
+    return { version, action: 'default set' }
+  }
+}