@fexd/toolchain 0.1.0 → 0.1.2

package/README.md

@@ -1,5 +1,7 @@
 # @fexd/toolchain
 
+[![npm version](https://img.shields.io/npm/v/@fexd/toolchain.svg)](https://www.npmjs.com/package/@fexd/toolchain)
+
 `@fexd/toolchain` 是一个面向前端项目的工具链运行器，用于让项目脚本固定使用指定版本的 Node.js 和 pnpm。
 
 它适合这种场景：不同项目依赖不同的 Node.js / pnpm 版本，但开发者希望自己的全局 shell 环境保持不变。通过 `tc` 执行的命令只会在当前子进程中使用项目指定的工具链，不会切换或污染全局 `node` / `pnpm`。
@@ -60,6 +62,7 @@ tc-version-pnpm=9.15.9
 常用命令：
 
 ```bash
+tc --version
 tc doctor
 tc node -v
 tc node scripts/build.js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fexd/toolchain",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Run project scripts with a project-pinned Node.js and pnpm toolchain.",
   "repository": {
     "type": "git",

package/src/cli.cjs

@@ -4,6 +4,7 @@ const { readToolchainConfig } = require('./config.cjs');
 const { getDefaultCacheRoot } = require('./cache.cjs');
 const { ensureNode, ensurePnpm } = require('./install.cjs');
 const { ensurePnpmShim, buildToolchainPath } = require('./shims.cjs');
+const packageJson = require('../package.json');
 
 async function runCli(argv, dependencies) {
   const deps = dependencies || {};
@@ -16,6 +17,11 @@ async function runCli(argv, dependencies) {
   const env = Object.assign({}, deps.env || process.env);
   const cwd = deps.cwd || process.cwd();
 
+  if (command === '--version' || command === '-v' || command === 'version') {
+    stdout.write(packageJson.version + '\n');
+    return 0;
+  }
+
   if (!command || command === '--help' || command === '-h') {
     stdout.write(usage());
     return 0;
@@ -69,6 +75,7 @@ async function runCli(argv, dependencies) {
     });
 
     if (command === 'node') {
+      stderr.write(formatAppliedVersions({ nodeVersion: config.nodeVersion }) + '\n');
       return spawnAndReturn({
         spawnSync: deps.spawnSync || childProcess.spawnSync,
         command: node.executablePath,
@@ -93,6 +100,11 @@ async function runCli(argv, dependencies) {
       pnpmCliPath: pnpm.executablePath
     });
 
+    stderr.write(formatAppliedVersions({
+      nodeVersion: config.nodeVersion,
+      pnpmVersion: config.pnpmVersion
+    }) + '\n');
+
     return spawnAndReturn({
       spawnSync: deps.spawnSync || childProcess.spawnSync,
       command: node.executablePath,
@@ -146,6 +158,16 @@ function getPathDelimiter(platform) {
   return platform === 'win32' ? ';' : ':';
 }
 
+function formatAppliedVersions(options) {
+  const parts = ['[tc] using', 'node@' + options.nodeVersion];
+
+  if (options.pnpmVersion) {
+    parts.push('pnpm@' + options.pnpmVersion);
+  }
+
+  return parts.join(' ');
+}
+
 function formatError(error) {
   return error && error.message ? error.message : String(error);
 }
@@ -153,6 +175,7 @@ function formatError(error) {
 function usage() {
   return [
     'Usage:',
+    '  tc --version',
     '  tc doctor',
     '  tc node <args...>',
     '  tc pnpm <args...>',
@@ -166,5 +189,6 @@ function usage() {
 
 module.exports = {
   runCli,
-  usage
+  usage,
+  formatAppliedVersions
 };

package/src/install.cjs

@@ -110,10 +110,12 @@ function downloadFile(url, destination) {
   });
 }
 
-function extractArchive(archivePath, destination) {
+function extractArchive(archivePath, destination, options) {
+  const opts = options || {};
   fs.mkdirSync(destination, { recursive: true });
 
-  const result = childProcess.spawnSync('tar', ['-xf', archivePath, '-C', destination], {
+  const spawn = opts.spawnSync || childProcess.spawnSync;
+  const result = spawn(getTarCommand(opts), ['-xf', archivePath, '-C', destination], {
     stdio: 'inherit'
   });
 
@@ -126,9 +128,23 @@ function extractArchive(archivePath, destination) {
   }
 }
 
+function getTarCommand(options) {
+  const opts = options || {};
+  const platform = opts.platform || process.platform;
+
+  if (platform !== 'win32') {
+    return 'tar';
+  }
+
+  const env = opts.env || process.env;
+  const systemRoot = env.SystemRoot || env.SYSTEMROOT || 'C:\\Windows';
+  return path.win32.join(systemRoot, 'System32', 'tar.exe');
+}
+
 module.exports = {
   ensureNode,
   ensurePnpm,
   downloadFile,
-  extractArchive
+  extractArchive,
+  getTarCommand
 };