@lppx/nlearn 1.1.0

package/dist/src/demo/commander/03-/351/253/230/347/272/247/347/211/271/346/200/247.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * Commander.js 高级特性
+ * ======================
+ * 本文件涵盖：自定义事件处理、错误处理、异步命令、配置文件、环境变量
+ * 适用版本：commander ^12.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+// #region 示例1: 异步命令处理
+async function demoAsyncCommands() {
+    const program = new commander_1.Command();
+    program
+        .name('async-cli')
+        .description('异步命令示例')
+        .version('1.0.0');
+    // 异步命令：模拟文件下载
+    program
+        .command('download <url>')
+        .description('下载文件')
+        .option('-o, --output <path>', '输出路径', './downloads')
+        .action(async (url, options) => {
+        console.log('\n示例1: 开始下载...');
+        console.log('URL:', url);
+        console.log('输出路径:', options.output);
+        // 模拟异步操作
+        await new Promise(resolve => setTimeout(resolve, 1000));
+        console.log('下载完成！');
+    });
+    // 异步命令：模拟数据库查询
+    program
+        .command('query <table>')
+        .description('查询数据库表')
+        .option('-l, --limit <number>', '限制结果数量', '10')
+        .action(async (table, options) => {
+        console.log('\n示例1: 查询数据库...');
+        console.log('表名:', table);
+        console.log('限制:', options.limit);
+        // 模拟异步查询
+        await new Promise(resolve => setTimeout(resolve, 800));
+        console.log('查询结果: [模拟数据]');
+    });
+    await program.parseAsync(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/03-高级特性.ts 1 download https://example.com/file.zip');
+}
+// #endregion
+// #region 示例2: 全局错误处理
+function demoErrorHandling() {
+    const program = new commander_1.Command();
+    program
+        .name('error-handler')
+        .description('错误处理示例')
+        .version('1.0.0')
+        .configureOutput({
+        // 自定义错误输出
+        outputError: (str, write) => {
+            write(`[错误] ${str}`);
+        }
+    })
+        .exitOverride(); // 阻止自动退出，便于错误处理
+    program
+        .command('divide <a> <b>')
+        .description('除法运算')
+        .action((a, b) => {
+        const numA = parseFloat(a);
+        const numB = parseFloat(b);
+        if (isNaN(numA) || isNaN(numB)) {
+            throw new Error('参数必须是数字');
+        }
+        if (numB === 0) {
+            throw new Error('除数不能为零');
+        }
+        console.log('\n示例2: 计算结果:', numA / numB);
+    });
+    try {
+        program.parse(process.argv);
+    }
+    catch (err) {
+        console.error('\n捕获到错误:', err.message);
+        console.log('\n提示: 尝试运行 ts-node src/demo/commander/03-高级特性.ts 2 divide 10 0');
+    }
+}
+// #endregion
+// #region 示例3: 命令执行前后的钩子
+function demoCommandHooks() {
+    const program = new commander_1.Command();
+    program
+        .name('hook-demo')
+        .description('命令钩子示例')
+        .version('1.0.0');
+    // 全局前置钩子
+    program.hook('preAction', (thisCommand) => {
+        console.log('\n[全局前置钩子] 准备执行命令:', thisCommand.name());
+        console.log('[全局前置钩子] 开始时间:', new Date().toISOString());
+    });
+    // 全局后置钩子
+    program.hook('postAction', (thisCommand) => {
+        console.log('[全局后置钩子] 命令执行完成:', thisCommand.name());
+        console.log('[全局后置钩子] 结束时间:', new Date().toISOString());
+    });
+    program
+        .command('process <file>')
+        .description('处理文件')
+        .hook('preAction', () => {
+        console.log('[命令前置钩子] 验证文件权限...');
+    })
+        .hook('postAction', () => {
+        console.log('[命令后置钩子] 清理临时文件...');
+    })
+        .action((file) => {
+        console.log('\n示例3: 正在处理文件:', file);
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/03-高级特性.ts 3 process data.txt');
+}
+// #endregion
+// #region 示例4: 从配置文件读取选项
+function demoConfigFileLoading() {
+    const program = new commander_1.Command();
+    // 模拟配置文件内容
+    const mockConfig = {
+        host: 'localhost',
+        port: 3000,
+        debug: true,
+        database: {
+            name: 'mydb',
+            user: 'admin'
+        }
+    };
+    program
+        .name('config-loader')
+        .description('配置文件加载示例')
+        .version('1.0.0');
+    program
+        .command('start')
+        .description('启动服务')
+        .option('-c, --config <path>', '配置文件路径')
+        .option('-h, --host <host>', '主机地址')
+        .option('-p, --port <port>', '端口号')
+        .action((options) => {
+        console.log('\n示例4: 加载配置...');
+        // 优先级：命令行参数 > 配置文件 > 默认值
+        let config = { ...mockConfig };
+        if (options.config) {
+            console.log('从配置文件加载:', options.config);
+            // 实际应用中这里会读取真实文件
+            // config = JSON.parse(fs.readFileSync(options.config, 'utf-8'));
+        }
+        // 命令行参数覆盖配置文件
+        const finalConfig = {
+            host: options.host || config.host,
+            port: options.port || config.port,
+            debug: config.debug
+        };
+        console.log('最终配置:', finalConfig);
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/03-高级特性.ts 4 start -h 0.0.0.0 -p 8080');
+}
+// #endregion
+// #region 示例5: 环境变量集成
+function demoEnvironmentVariables() {
+    const program = new commander_1.Command();
+    program
+        .name('env-demo')
+        .description('环境变量集成示例')
+        .version('1.0.0');
+    program
+        .command('deploy')
+        .description('部署应用')
+        .option('-e, --env <environment>', '部署环境', process.env.NODE_ENV || 'development')
+        .option('--api-key <key>', 'API 密钥', process.env.API_KEY)
+        .option('--region <region>', '部署区域', process.env.AWS_REGION || 'us-east-1')
+        .action((options) => {
+        console.log('\n示例5: 部署配置');
+        console.log('环境:', options.env);
+        console.log('API 密钥:', options.apiKey ? '***已设置***' : '未设置');
+        console.log('区域:', options.region);
+        // 验证必需的环境变量
+        if (!options.apiKey) {
+            console.error('\n错误: 缺少 API 密钥');
+            console.log('请设置环境变量 API_KEY 或使用 --api-key 选项');
+        }
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 API_KEY=secret123 ts-node src/demo/commander/03-高级特性.ts 5 deploy -e production');
+}
+// #endregion
+// #region 示例6: 自定义帮助和版本显示
+function demoCustomOutput() {
+    const program = new commander_1.Command();
+    program
+        .name('custom-output')
+        .description('自定义输出示例')
+        .version('1.0.0')
+        .configureOutput({
+        // 自定义标准输出
+        writeOut: (str) => {
+            process.stdout.write(`[输出] ${str}`);
+        },
+        // 自定义错误输出
+        writeErr: (str) => {
+            process.stdout.write(`[错误] ${str}`);
+        }
+    })
+        .configureHelp({
+        // 自定义帮助信息格式
+        sortSubcommands: true,
+        sortOptions: true,
+        subcommandTerm: (cmd) => `${cmd.name()} ${cmd.usage()}`,
+    })
+        .addHelpText('beforeAll', `
+╔════════════════════════════════════════╗
+║     自定义 CLI 工具 v1.0.0             ║
+╚════════════════════════════════════════╝
+    `)
+        .addHelpText('afterAll', `
+示例:
+  $ custom-output process --input data.txt
+  $ custom-output analyze --verbose
+  
+文档: https://example.com/docs
+    `);
+    program
+        .command('process')
+        .description('处理数据')
+        .option('-i, --input <file>', '输入文件')
+        .action((options) => {
+        console.log('\n示例6: 处理数据');
+        console.log('输入文件:', options.input);
+    });
+    program
+        .command('analyze')
+        .description('分析数据')
+        .option('-v, --verbose', '详细输出')
+        .action((options) => {
+        console.log('\n示例6: 分析数据');
+        console.log('详细模式:', options.verbose || false);
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/03-高级特性.ts 6 --help');
+}
+// #endregion
+if (require.main === module) {
+    const exampleNumber = process.env.EXAMPLE || process.argv[2];
+    // console.log('='.repeat(60));
+    // console.log('Commander.js 高级特性示例');
+    // console.log('='.repeat(60));
+    switch (exampleNumber) {
+        case '1':
+            process.argv.splice(2, 1);
+            demoAsyncCommands();
+            break;
+        case '2':
+            process.argv.splice(2, 1);
+            demoErrorHandling();
+            break;
+        case '3':
+            process.argv.splice(2, 1);
+            demoCommandHooks();
+            break;
+        case '4':
+            process.argv.splice(2, 1);
+            demoConfigFileLoading();
+            break;
+        case '5':
+            process.argv.splice(2, 1);
+            demoEnvironmentVariables();
+            break;
+        case '6':
+            process.argv.splice(2, 1);
+            demoCustomOutput();
+            break;
+        default:
+            console.log('\n请指定要运行的示例编号 (1-6)');
+            console.log('用法: ts-node src/demo/commander/03-高级特性.ts <示例编号> [命令] [选项]');
+            console.log('\n可用示例:');
+            console.log('  1 - 异步命令处理');
+            console.log('  2 - 全局错误处理');
+            console.log('  3 - 命令执行前后的钩子');
+            console.log('  4 - 从配置文件读取选项');
+            console.log('  5 - 环境变量集成');
+            console.log('  6 - 自定义帮助和版本显示');
+    }
+}

package/dist/src/demo/commander/04-/345/256/236/346/210/230/346/241/210/344/276/213.js

@@ -0,0 +1,408 @@
+"use strict";
+/**
+ * Commander.js 实战案例
+ * ======================
+ * 本文件涵盖：完整的 CLI 工具实现案例
+ * 包括：文件管理工具、项目脚手架、任务管理器
+ * 适用版本：commander ^12.0.0
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// #region 示例1: 简单的文件管理 CLI
+function demoFileManagerCLI() {
+    const program = new commander_1.Command();
+    program
+        .name('fman')
+        .description('简单的文件管理工具')
+        .version('1.0.0');
+    // 列出文件
+    program
+        .command('list [dir]')
+        .alias('ls')
+        .description('列出目录内容')
+        .option('-a, --all', '显示隐藏文件')
+        .action((dir = '.', options) => {
+        console.log('\n示例1: 列出文件');
+        console.log('目录:', path.resolve(dir));
+        try {
+            const files = fs.readdirSync(dir);
+            const filtered = options.all ? files : files.filter(f => !f.startsWith('.'));
+            console.log('\n文件列表:');
+            filtered.forEach(file => {
+                const stats = fs.statSync(path.join(dir, file));
+                const type = stats.isDirectory() ? '[目录]' : '[文件]';
+                console.log(`  ${type} ${file}`);
+            });
+        }
+        catch (err) {
+            console.error('错误:', err.message);
+        }
+    });
+    // 创建目录
+    program
+        .command('mkdir <dirs...>')
+        .description('创建目录')
+        .option('-p, --parents', '创建父目录')
+        .action((dirs, options) => {
+        console.log('\n示例1: 创建目录');
+        dirs.forEach((dir) => {
+            try {
+                if (options.parents) {
+                    fs.mkdirSync(dir, { recursive: true });
+                }
+                else {
+                    fs.mkdirSync(dir);
+                }
+                console.log('✓ 已创建:', dir);
+            }
+            catch (err) {
+                console.error('✗ 失败:', dir, '-', err.message);
+            }
+        });
+    });
+    // 删除文件
+    program
+        .command('remove <files...>')
+        .alias('rm')
+        .description('删除文件或目录')
+        .option('-r, --recursive', '递归删除目录')
+        .option('-f, --force', '强制删除')
+        .action((files, options) => {
+        console.log('\n示例1: 删除文件');
+        files.forEach((file) => {
+            try {
+                const stats = fs.statSync(file);
+                if (stats.isDirectory()) {
+                    if (options.recursive) {
+                        fs.rmSync(file, { recursive: true, force: options.force });
+                        console.log('✓ 已删除目录:', file);
+                    }
+                    else {
+                        console.error('✗ 是目录，需要 -r 选项:', file);
+                    }
+                }
+                else {
+                    fs.unlinkSync(file);
+                    console.log('✓ 已删除文件:', file);
+                }
+            }
+            catch (err) {
+                if (!options.force) {
+                    console.error('✗ 失败:', file, '-', err.message);
+                }
+            }
+        });
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/04-实战案例.ts 1 ls . -a');
+}
+// #endregion
+// #region 示例2: 项目脚手架工具
+function demoProjectScaffolder() {
+    const program = new commander_1.Command();
+    const templates = {
+        'node-basic': {
+            files: ['index.js', 'package.json', 'README.md'],
+            description: '基础 Node.js 项目'
+        },
+        'express-api': {
+            files: ['server.js', 'routes/', 'models/', 'package.json'],
+            description: 'Express API 项目'
+        },
+        'react-app': {
+            files: ['src/', 'public/', 'package.json', 'README.md'],
+            description: 'React 应用'
+        }
+    };
+    program
+        .name('create-project')
+        .description('项目脚手架工具')
+        .version('1.0.0');
+    // 创建项目
+    program
+        .command('init <name>')
+        .description('初始化新项目')
+        .option('-t, --template <template>', '项目模板', 'node-basic')
+        .option('--git', '初始化 Git 仓库')
+        .option('--install', '自动安装依赖')
+        .action((name, options) => {
+        console.log('\n示例2: 创建项目');
+        console.log('项目名称:', name);
+        console.log('模板:', options.template);
+        const template = templates[options.template];
+        if (!template) {
+            console.error('错误: 未知模板');
+            console.log('可用模板:', Object.keys(templates).join(', '));
+            return;
+        }
+        console.log('\n创建文件结构:');
+        template.files.forEach(file => {
+            console.log(`  ✓ ${file}`);
+        });
+        if (options.git) {
+            console.log('\n初始化 Git 仓库...');
+            console.log('  ✓ .git/');
+            console.log('  ✓ .gitignore');
+        }
+        if (options.install) {
+            console.log('\n安装依赖...');
+            console.log('  ✓ npm install');
+        }
+        console.log('\n项目创建完成！');
+        console.log(`\n下一步:\n  cd ${name}\n  npm start`);
+    });
+    // 列出模板
+    program
+        .command('list')
+        .description('列出可用模板')
+        .action(() => {
+        console.log('\n示例2: 可用模板\n');
+        Object.entries(templates).forEach(([name, info]) => {
+            console.log(`${name}`);
+            console.log(`  ${info.description}`);
+            console.log(`  文件: ${info.files.join(', ')}\n`);
+        });
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/04-实战案例.ts 2 init my-app -t express-api --git');
+}
+// #endregion
+// #region 示例3: 任务管理 CLI
+function demoTaskManagerCLI() {
+    const program = new commander_1.Command();
+    // 模拟任务数据库
+    let tasks = [
+        { id: 1, title: '学习 Commander.js', done: false, priority: 'high' },
+        { id: 2, title: '编写示例代码', done: true, priority: 'medium' },
+        { id: 3, title: '测试 CLI 工具', done: false, priority: 'low' }
+    ];
+    program
+        .name('todo')
+        .description('任务管理工具')
+        .version('1.0.0');
+    // 添加任务
+    program
+        .command('add <title>')
+        .description('添加新任务')
+        .option('-p, --priority <level>', '优先级 (high/medium/low)', 'medium')
+        .action((title, options) => {
+        const newTask = {
+            id: tasks.length + 1,
+            title,
+            done: false,
+            priority: options.priority
+        };
+        tasks.push(newTask);
+        console.log('\n示例3: 任务已添加');
+        console.log(`ID: ${newTask.id} | ${newTask.title} [${newTask.priority}]`);
+    });
+    // 列出任务
+    program
+        .command('list')
+        .alias('ls')
+        .description('列出所有任务')
+        .option('-a, --all', '显示所有任务')
+        .option('-d, --done', '只显示已完成')
+        .option('-p, --pending', '只显示未完成')
+        .action((options) => {
+        console.log('\n示例3: 任务列表\n');
+        let filtered = tasks;
+        if (options.done) {
+            filtered = tasks.filter(t => t.done);
+        }
+        else if (options.pending) {
+            filtered = tasks.filter(t => !t.done);
+        }
+        if (filtered.length === 0) {
+            console.log('没有任务');
+            return;
+        }
+        filtered.forEach(task => {
+            const status = task.done ? '✓' : '○';
+            const priority = `[${task.priority}]`;
+            console.log(`${status} ${task.id}. ${task.title} ${priority}`);
+        });
+    });
+    // 完成任务
+    program
+        .command('done <id>')
+        .description('标记任务为已完成')
+        .action((id) => {
+        const task = tasks.find(t => t.id === parseInt(id));
+        if (!task) {
+            console.error('\n错误: 任务不存在');
+            return;
+        }
+        task.done = true;
+        console.log('\n示例3: 任务已完成');
+        console.log(`✓ ${task.id}. ${task.title}`);
+    });
+    // 删除任务
+    program
+        .command('delete <id>')
+        .alias('rm')
+        .description('删除任务')
+        .action((id) => {
+        const index = tasks.findIndex(t => t.id === parseInt(id));
+        if (index === -1) {
+            console.error('\n错误: 任务不存在');
+            return;
+        }
+        const deleted = tasks.splice(index, 1)[0];
+        console.log('\n示例3: 任务已删除');
+        console.log(`✗ ${deleted.id}. ${deleted.title}`);
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/04-实战案例.ts 3 list');
+}
+// #endregion
+// #region 示例4: 完整的部署工具
+async function demoDeploymentTool() {
+    const program = new commander_1.Command();
+    program
+        .name('deployer')
+        .description('应用部署工具')
+        .version('1.0.0');
+    // 部署命令
+    program
+        .command('deploy')
+        .description('部署应用')
+        .argument('<environment>', '部署环境 (dev/staging/prod)')
+        .option('-b, --branch <branch>', 'Git 分支', 'main')
+        .option('--skip-tests', '跳过测试')
+        .option('--skip-build', '跳过构建')
+        .option('-y, --yes', '跳过确认')
+        .action(async (environment, options) => {
+        console.log('\n示例4: 开始部署流程');
+        console.log('='.repeat(50));
+        const steps = [
+            { name: '检查环境', skip: false },
+            { name: '拉取代码', skip: false },
+            { name: '运行测试', skip: options.skipTests },
+            { name: '构建应用', skip: options.skipBuild },
+            { name: '上传文件', skip: false },
+            { name: '重启服务', skip: false }
+        ];
+        console.log(`\n环境: ${environment}`);
+        console.log(`分支: ${options.branch}`);
+        if (!options.yes) {
+            console.log('\n部署步骤:');
+            steps.forEach((step, i) => {
+                const status = step.skip ? '[跳过]' : '[执行]';
+                console.log(`  ${i + 1}. ${step.name} ${status}`);
+            });
+            console.log('\n(实际应用中这里会等待用户确认)');
+        }
+        console.log('\n执行部署...');
+        for (const step of steps) {
+            if (step.skip)
+                continue;
+            console.log(`\n▶ ${step.name}...`);
+            await new Promise(resolve => setTimeout(resolve, 500));
+            console.log(`  ✓ 完成`);
+        }
+        console.log('\n' + '='.repeat(50));
+        console.log('部署成功！');
+        console.log(`应用已部署到 ${environment} 环境`);
+    });
+    // 回滚命令
+    program
+        .command('rollback')
+        .description('回滚到上一个版本')
+        .argument('<environment>', '环境')
+        .option('-v, --version <version>', '指定版本')
+        .action(async (environment, options) => {
+        console.log('\n示例4: 回滚部署');
+        console.log('环境:', environment);
+        console.log('版本:', options.version || '上一个版本');
+        console.log('\n执行回滚...');
+        await new Promise(resolve => setTimeout(resolve, 1000));
+        console.log('✓ 回滚完成');
+    });
+    // 查看状态
+    program
+        .command('status')
+        .description('查看部署状态')
+        .argument('[environment]', '环境（可选）')
+        .action((environment) => {
+        console.log('\n示例4: 部署状态\n');
+        const envs = environment ? [environment] : ['dev', 'staging', 'prod'];
+        envs.forEach(env => {
+            console.log(`${env}:`);
+            console.log(`  版本: v1.2.3`);
+            console.log(`  状态: 运行中`);
+            console.log(`  更新时间: 2024-01-15 10:30:00\n`);
+        });
+    });
+    await program.parseAsync(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/04-实战案例.ts 4 deploy staging -b develop');
+}
+// #endregion
+if (require.main === module) {
+    const exampleNumber = process.env.EXAMPLE || process.argv[2];
+    console.log('='.repeat(60));
+    console.log('Commander.js 实战案例');
+    console.log('='.repeat(60));
+    switch (exampleNumber) {
+        case '1':
+            process.argv.splice(2, 1);
+            demoFileManagerCLI();
+            break;
+        case '2':
+            process.argv.splice(2, 1);
+            demoProjectScaffolder();
+            break;
+        case '3':
+            process.argv.splice(2, 1);
+            demoTaskManagerCLI();
+            break;
+        case '4':
+            process.argv.splice(2, 1);
+            demoDeploymentTool();
+            break;
+        default:
+            console.log('\n请指定要运行的示例编号 (1-4)');
+            console.log('用法: ts-node src/demo/commander/04-实战案例.ts <示例编号> [命令] [选项]');
+            console.log('\n可用示例:');
+            console.log('  1 - 文件管理 CLI (fman)');
+            console.log('  2 - 项目脚手架工具 (create-project)');
+            console.log('  3 - 任务管理 CLI (todo)');
+            console.log('  4 - 应用部署工具 (deployer)');
+            console.log('\n每个示例都是一个完整的 CLI 工具，包含多个子命令');
+    }
+}