@lppx/nlearn 1.1.0

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

@@ -0,0 +1,276 @@
+"use strict";
+/**
+ * yargs 实战案例
+ * ================
+ * 综合运用 yargs 构建完整的 CLI 工具
+ * 适用版本: yargs ^17.0.0 或 ^18.0.0
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+// #region 示例1: 文件管理工具
+function demoFileManagerTool() {
+    console.log('\n=== 示例1: 文件管理工具 ===');
+    // 模拟一个简单的文件管理 CLI
+    // 运行: ts-node 04-实战案例.ts 1 create --name=test.txt --content="Hello World"
+    (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv.slice(1)))
+        .scriptName('filemgr')
+        .usage('$0 <命令> [选项]')
+        .command('create', '创建文件', (yargs) => {
+        return yargs
+            .option('name', {
+            alias: 'n',
+            type: 'string',
+            description: '文件名',
+            demandOption: true
+        })
+            .option('content', {
+            alias: 'c',
+            type: 'string',
+            description: '文件内容',
+            default: ''
+        });
+    }, (argv) => {
+        console.log(`✓ 创建文件: ${argv.name}`);
+        console.log(`  内容: ${argv.content}`);
+    })
+        .command('read <filename>', '读取文件', (yargs) => {
+        return yargs.positional('filename', {
+            describe: '文件名',
+            type: 'string'
+        });
+    }, (argv) => {
+        console.log(`✓ 读取文件: ${argv.filename}`);
+    })
+        .demandCommand(1)
+        .help()
+        .argv;
+}
+// #endregion
+// #region 示例2: 数据库迁移工具
+function demoDatabaseMigrationTool() {
+    console.log('\n=== 示例2: 数据库迁移工具 ===');
+    // 模拟数据库迁移 CLI（类似 Prisma、TypeORM）
+    // 运行: ts-node 04-实战案例.ts 2 migrate up --env=production
+    (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv.slice(1)))
+        .scriptName('dbmigrate')
+        .command('migrate <action>', '执行数据库迁移', (yargs) => {
+        return yargs
+            .positional('action', {
+            describe: '迁移操作',
+            type: 'string',
+            choices: ['up', 'down', 'status']
+        })
+            .option('env', {
+            alias: 'e',
+            type: 'string',
+            description: '环境',
+            choices: ['development', 'staging', 'production'],
+            default: 'development'
+        })
+            .option('steps', {
+            alias: 's',
+            type: 'number',
+            description: '迁移步数',
+            default: 1
+        });
+    }, (argv) => {
+        console.log(`✓ 执行迁移: ${argv.action}`);
+        console.log(`  环境: ${argv.env}`);
+        console.log(`  步数: ${argv.steps}`);
+    })
+        .demandCommand(1)
+        .help()
+        .argv;
+}
+// #endregion
+// #region 示例3: 项目脚手架工具
+function demoProjectScaffolder() {
+    console.log('\n=== 示例3: 项目脚手架工具 ===');
+    // 模拟项目生成器（类似 create-react-app）
+    // 运行: ts-node 04-实战案例.ts 3 init my-project --template=react --typescript
+    (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv.slice(1)))
+        .scriptName('create-app')
+        .command('init <project-name>', '初始化新项目', (yargs) => {
+        return yargs
+            .positional('project-name', {
+            describe: '项目名称',
+            type: 'string'
+        })
+            .option('template', {
+            alias: 't',
+            type: 'string',
+            description: '项目模板',
+            choices: ['react', 'vue', 'angular', 'express'],
+            default: 'react'
+        })
+            .option('typescript', {
+            type: 'boolean',
+            description: '使用 TypeScript',
+            default: false
+        })
+            .option('git', {
+            type: 'boolean',
+            description: '初始化 Git 仓库',
+            default: true
+        });
+    }, (argv) => {
+        console.log(`✓ 创建项目: ${argv['project-name']}`);
+        console.log(`  模板: ${argv.template}`);
+        console.log(`  TypeScript: ${argv.typescript ? '是' : '否'}`);
+        console.log(`  Git: ${argv.git ? '是' : '否'}`);
+    })
+        .demandCommand(1)
+        .help()
+        .argv;
+}
+// #endregion
+// #region 示例4: 部署工具
+function demoDeploymentTool() {
+    console.log('\n=== 示例4: 部署工具 ===');
+    // 模拟应用部署 CLI
+    // 运行: ts-node 04-实战案例.ts 4 deploy --target=production --branch=main --force
+    (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv.slice(1)))
+        .scriptName('deployer')
+        .command('deploy', '部署应用', (yargs) => {
+        return yargs
+            .option('target', {
+            alias: 't',
+            type: 'string',
+            description: '部署目标',
+            choices: ['development', 'staging', 'production'],
+            demandOption: true
+        })
+            .option('branch', {
+            alias: 'b',
+            type: 'string',
+            description: 'Git 分支',
+            default: 'main'
+        })
+            .option('force', {
+            alias: 'f',
+            type: 'boolean',
+            description: '强制部署',
+            default: false
+        })
+            .check((argv) => {
+            if (argv.target === 'production' && !argv.force) {
+                console.log('⚠️  警告: 部署到生产环境，请确认！');
+            }
+            return true;
+        });
+    }, (argv) => {
+        console.log(`✓ 开始部署...`);
+        console.log(`  目标: ${argv.target}`);
+        console.log(`  分支: ${argv.branch}`);
+        console.log(`  强制: ${argv.force ? '是' : '否'}`);
+    })
+        .demandCommand(1)
+        .help()
+        .argv;
+}
+// #endregion
+// #region 示例5: 完整的 CLI 应用
+function demoCompleteTaskManager() {
+    console.log('\n=== 示例5: 完整的 CLI 应用 ===');
+    // 综合示例：一个完整的任务管理 CLI
+    // 运行: ts-node 04-实战案例.ts 5 task add "完成项目文档" --priority=high
+    // 运行: ts-node 04-实战案例.ts 5 task list --status=pending
+    (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv.slice(1)))
+        .scriptName('taskmgr')
+        .version('1.0.0')
+        .usage('$0 <命令> [选项]')
+        .command('task', '任务管理', (yargs) => {
+        return yargs
+            .command('add <title>', '添加任务', (yargs) => {
+            return yargs
+                .positional('title', {
+                describe: '任务标题',
+                type: 'string'
+            })
+                .option('priority', {
+                alias: 'p',
+                type: 'string',
+                description: '优先级',
+                choices: ['low', 'medium', 'high'],
+                default: 'medium'
+            })
+                .option('tags', {
+                alias: 't',
+                type: 'array',
+                description: '标签',
+                default: []
+            });
+        }, (argv) => {
+            console.log(`✓ 添加任务: ${argv.title}`);
+            console.log(`  优先级: ${argv.priority}`);
+            console.log(`  标签: ${argv.tags?.join(', ') || '无'}`);
+        })
+            .command('list', '列出任务', (yargs) => {
+            return yargs
+                .option('status', {
+                alias: 's',
+                type: 'string',
+                description: '任务状态',
+                choices: ['pending', 'completed', 'all'],
+                default: 'all'
+            })
+                .option('limit', {
+                alias: 'l',
+                type: 'number',
+                description: '显示数量',
+                default: 10
+            });
+        }, (argv) => {
+            console.log(`✓ 列出任务 (状态: ${argv.status}, 限制: ${argv.limit})`);
+        })
+            .command('complete <id>', '完成任务', (yargs) => {
+            return yargs.positional('id', {
+                describe: '任务ID',
+                type: 'number'
+            });
+        }, (argv) => {
+            console.log(`✓ 完成任务 ID: ${argv.id}`);
+        })
+            .demandCommand(1, '请指定子命令');
+    })
+        .demandCommand(1, '请指定命令')
+        .help()
+        .alias('help', 'h')
+        .alias('version', 'v')
+        .epilogue('更多信息请访问: https://github.com/yargs/yargs')
+        .argv;
+}
+// #endregion
+if (require.main === module) {
+    const exampleNum = process.argv[2];
+    switch (exampleNum) {
+        case '1':
+            demoFileManagerTool();
+            break;
+        case '2':
+            demoDatabaseMigrationTool();
+            break;
+        case '3':
+            demoProjectScaffolder();
+            break;
+        case '4':
+            demoDeploymentTool();
+            break;
+        case '5':
+            demoCompleteTaskManager();
+            break;
+        default:
+            console.log('请指定示例编号 (1-5)');
+            console.log('用法: ts-node 04-实战案例.ts <示例编号> [命令] [参数...]');
+            console.log('\n可用示例:');
+            console.log('  1 - 文件管理工具');
+            console.log('  2 - 数据库迁移工具');
+            console.log('  3 - 项目脚手架工具');
+            console.log('  4 - 部署工具');
+            console.log('  5 - 完整的 CLI 应用');
+    }
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@lppx/nlearn",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "1.1.0",
+  "description": "一个nodejs学习工具",
+  "bin": {
+    "nlearn": "dist/src/cli/cli.js"
+  },
+  "scripts": {
+    "sync": "ts-node scripts/sync-repo.ts",
+    "build": "tsc",
+    "start": "node dist/src/cli/cli.js"
+  },
+  "author": "lipanpanx",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@types/inquirer": "^9.0.9",
+    "commander": "^14.0.2",
+    "inquirer": "^9.3.8",
+    "isomorphic-git": "^1.36.3",
+    "yargs": "^18.0.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "devDependencies": {
+    "@types/commander": "^2.12.0",
+    "@types/node": "^25.0.10",
+    "@types/yargs": "^17.0.35",
+    "nodemon": "^3.1.11",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}