@lppx/nlearn 1.1.0

package/dist/scripts/sync-repo.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env ts-node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+// #region 颜色定义
+const colors = {
+    red: '\x1b[0;31m',
+    green: '\x1b[0;32m',
+    yellow: '\x1b[1;33m',
+    reset: '\x1b[0m',
+};
+// #endregion
+// #region 辅助函数
+function printSuccess(message) {
+    console.log(`${colors.green}✓ ${message}${colors.reset}`);
+}
+function printError(message) {
+    console.error(`${colors.red}✗ ${message}${colors.reset}`);
+}
+function printWarning(message) {
+    console.log(`${colors.yellow}⚠ ${message}${colors.reset}`);
+}
+// #endregion
+// #region Git 操作
+function execGit(command) {
+    try {
+        return (0, child_process_1.execSync)(`git ${command}`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe']
+        }).trim();
+    }
+    catch (error) {
+        throw new Error(error.stderr || error.message);
+    }
+}
+async function syncRepo() {
+    const dir = process.cwd();
+    console.log('开始同步仓库...');
+    // 检查是否在 git 仓库中
+    if (!(0, fs_1.existsSync)((0, path_1.join)(dir, '.git'))) {
+        printError('当前目录不是 git 仓库');
+        process.exit(1);
+    }
+    // 执行 git pull
+    console.log('正在拉取远程更改...');
+    try {
+        execGit('pull');
+        printSuccess('成功拉取远程更改');
+    }
+    catch (error) {
+        printError('拉取失败，可能存在冲突');
+        printWarning('请手动解决冲突后再运行此脚本');
+        console.error(error.message);
+        process.exit(1);
+    }
+    // 检查是否有更改需要提交
+    const status = execGit('status --porcelain');
+    if (!status) {
+        printWarning('没有需要提交的更改');
+        process.exit(0);
+    }
+    // 添加所有更改
+    console.log('正在添加所有更改...');
+    execGit('add -A');
+    printSuccess('已添加所有更改');
+    // 生成 commit message（当前日期和时间）
+    const now = new Date();
+    const commitMsg = now.toLocaleString('zh-CN', {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+    }).replace(/\//g, '-');
+    console.log('正在提交更改...');
+    execGit(`commit -m "${commitMsg}"`);
+    printSuccess(`提交成功: ${commitMsg}`);
+    // 推送到远程仓库
+    console.log('正在推送到远程仓库...');
+    try {
+        execGit('push');
+        printSuccess('成功推送到远程仓库');
+    }
+    catch (error) {
+        printError('推送失败');
+        console.error(error.message);
+        process.exit(1);
+    }
+    printSuccess('仓库同步完成！');
+}
+// #endregion
+// 执行主函数
+syncRepo().catch((error) => {
+    printError(`发生错误: ${error.message}`);
+    process.exit(1);
+});

package/dist/src/cli/cli.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const program = new commander_1.Command();
+program
+    .name('nlearn')
+    .description('nodejs 生态学习工具')
+    .version('1.0.0');
+program.parse(process.argv);

package/dist/src/demo/commander/01-/345/237/272/347/241/200/346/246/202/345/277/265.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * Commander.js 基础概念
+ * ======================
+ * Commander.js 是 Node.js 中最流行的命令行接口（CLI）解决方案
+ * 本文件涵盖：程序初始化、版本号、描述、基本选项和参数
+ * 适用版本：commander ^12.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+// #region 示例1: 最简单的 CLI 程序
+function demoSimplestCLI() {
+    const program = new commander_1.Command();
+    // 设置程序名称、描述和版本
+    program
+        .name('my-cli')
+        .description('我的第一个 CLI 工具')
+        .version('1.0.0');
+    // 解析命令行参数
+    program.parse(process.argv);
+    console.log('示例1: 最简单的 CLI 程序已运行');
+    console.log('提示: 尝试运行 ts-node src/demo/commander/01-基础概念.ts --version');
+}
+// #endregion
+// #region 示例2: 添加选项（Options）
+function demoOptionsUsage() {
+    const program = new commander_1.Command();
+    program
+        .name('file-processor')
+        .description('文件处理工具')
+        .version('1.0.0')
+        // 添加布尔选项（flag）
+        .option('-d, --debug', '启用调试模式')
+        // 添加带值的选项
+        .option('-p, --port <number>', '指定端口号', '3000')
+        // 添加可选值的选项
+        .option('-e, --env [environment]', '指定环境', 'development');
+    program.parse(process.argv);
+    const options = program.opts();
+    console.log('\n示例2: 选项解析结果:');
+    console.log('调试模式:', options.debug || false);
+    console.log('端口号:', options.port);
+    console.log('环境:', options.env);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/01-基础概念.ts 2 -d -p 8080 -e production');
+}
+// #endregion
+// #region 示例3: 必需参数和可选参数
+function demoRequiredAndOptionalArgs() {
+    const program = new commander_1.Command();
+    program
+        .name('file-copy')
+        .description('文件复制工具')
+        .version('1.0.0')
+        // <> 表示必需参数，[] 表示可选参数
+        .argument('<source>', '源文件路径')
+        .argument('[destination]', '目标文件路径', './output')
+        .action((source, destination) => {
+        console.log('\n示例3: 参数解析结果:');
+        console.log('源文件:', source);
+        console.log('目标文件:', destination);
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/01-基础概念.ts 3 input.txt output.txt');
+}
+// #endregion
+// #region 示例4: 变长参数
+function demoVariadicArgs() {
+    const program = new commander_1.Command();
+    program
+        .name('file-merger')
+        .description('合并多个文件')
+        .version('1.0.0')
+        // ... 表示可以接收多个参数
+        .argument('<files...>', '要合并的文件列表')
+        .option('-o, --output <file>', '输出文件名', 'merged.txt')
+        .action((files, options) => {
+        console.log('\n示例4: 变长参数解析:');
+        console.log('输入文件:', files);
+        console.log('输出文件:', options.output);
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/01-基础概念.ts 4 file1.txt file2.txt file3.txt -o result.txt');
+}
+// #endregion
+// #region 示例5: 自定义帮助信息
+function demoCustomHelp() {
+    const program = new commander_1.Command();
+    program
+        .name('custom-help')
+        .description('演示自定义帮助信息')
+        .version('1.0.0')
+        .option('-c, --config <path>', '配置文件路径')
+        // 添加额外的帮助信息
+        .addHelpText('after', `
+示例用法:
+  $ custom-help -c ./config.json
+  $ custom-help --help
+  
+更多信息请访问: https://github.com/tj/commander.js
+    `);
+    program.parse(process.argv);
+    console.log('\n示例5: 自定义帮助信息');
+    console.log('提示: 尝试运行 ts-node src/demo/commander/01-基础概念.ts 5 --help');
+}
+// #endregion
+// #region 示例6: 选项的默认值和类型转换
+function demoTypeConversion() {
+    const program = new commander_1.Command();
+    program
+        .name('type-converter')
+        .description('演示选项的类型转换')
+        .version('1.0.0')
+        // 使用自定义函数进行类型转换
+        .option('-n, --number <value>', '整数值', parseInt)
+        .option('-f, --float <value>', '浮点数值', parseFloat)
+        .option('-l, --list <items>', '逗号分隔的列表', (value) => value.split(','))
+        .option('-r, --range <a>..<b>', '范围值', (value) => {
+        const [start, end] = value.split('..').map(Number);
+        return { start, end };
+    });
+    program.parse(process.argv);
+    const options = program.opts();
+    console.log('\n示例6: 类型转换结果:');
+    console.log('整数:', options.number, typeof options.number);
+    console.log('浮点数:', options.float, typeof options.float);
+    console.log('列表:', options.list);
+    console.log('范围:', options.range);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/01-基础概念.ts 6 -n 42 -f 3.14 -l a,b,c -r 1..10');
+}
+// #endregion
+if (require.main === module) {
+    // 从环境变量读取示例编号，避免与 commander 参数冲突
+    const exampleNumber = process.env.EXAMPLE || process.argv[2];
+    // console.log('='.repeat(60));
+    // console.log('Commander.js 基础概念示例');
+    // console.log('='.repeat(60));
+    switch (exampleNumber) {
+        case '1':
+            // 移除示例编号参数，避免 commander 解析错误
+            process.argv.splice(2, 1);
+            demoSimplestCLI();
+            break;
+        case '2':
+            process.argv.splice(2, 1);
+            demoOptionsUsage();
+            break;
+        case '3':
+            process.argv.splice(2, 1);
+            demoRequiredAndOptionalArgs();
+            break;
+        case '4':
+            process.argv.splice(2, 1);
+            demoVariadicArgs();
+            break;
+        case '5':
+            process.argv.splice(2, 1);
+            demoCustomHelp();
+            break;
+        case '6':
+            process.argv.splice(2, 1);
+            demoTypeConversion();
+            break;
+        default:
+            console.log('\n请指定要运行的示例编号 (1-6)');
+            console.log('用法: ts-node src/demo/commander/01-基础概念.ts <示例编号> [选项]');
+            console.log('\n可用示例:');
+            console.log('  1 - 最简单的 CLI 程序');
+            console.log('  2 - 添加选项（Options）');
+            console.log('  3 - 必需参数和可选参数');
+            console.log('  4 - 变长参数');
+            console.log('  5 - 自定义帮助信息');
+            console.log('  6 - 选项的默认值和类型转换');
+    }
+}

package/dist/src/demo/commander/02-/345/221/275/344/273/244/347/263/273/347/273/237.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * Commander.js 命令系统
+ * ======================
+ * 本文件涵盖：子命令、命令别名、命令参数、命令选项
+ * 适用版本：commander ^12.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+// #region 示例1: 基本子命令
+function demoBasicSubcommands() {
+    const program = new commander_1.Command();
+    program
+        .name('git-like')
+        .description('类似 Git 的命令行工具')
+        .version('1.0.0');
+    // 添加 clone 子命令
+    program
+        .command('clone <repository>')
+        .description('克隆一个仓库')
+        .action((repository) => {
+        console.log('\n示例1: 执行 clone 命令');
+        console.log('克隆仓库:', repository);
+    });
+    // 添加 init 子命令
+    program
+        .command('init')
+        .description('初始化一个新仓库')
+        .action(() => {
+        console.log('\n示例1: 执行 init 命令');
+        console.log('初始化新仓库...');
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/02-命令系统.ts 1 clone https://github.com/user/repo.git');
+}
+// #endregion
+// #region 示例2: 命令别名
+function demoCommandAliases() {
+    const program = new commander_1.Command();
+    program
+        .name('npm-like')
+        .description('类似 NPM 的命令行工具')
+        .version('1.0.0');
+    // install 命令，别名为 i
+    program
+        .command('install [packages...]')
+        .alias('i')
+        .description('安装包')
+        .action((packages) => {
+        console.log('\n示例2: 执行 install 命令');
+        console.log('安装包:', packages.length > 0 ? packages : '所有依赖');
+    });
+    // uninstall 命令，别名为 un 和 remove
+    program
+        .command('uninstall <packages...>')
+        .aliases(['un', 'remove', 'rm'])
+        .description('卸载包')
+        .action((packages) => {
+        console.log('\n示例2: 执行 uninstall 命令');
+        console.log('卸载包:', packages);
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/02-命令系统.ts 2 i express lodash');
+    console.log('或: ts-node src/demo/commander/02-命令系统.ts 2 rm express');
+}
+// #endregion
+// #region 示例3: 命令特定选项
+function demoCommandSpecificOptions() {
+    const program = new commander_1.Command();
+    program
+        .name('docker-like')
+        .description('类似 Docker 的命令行工具')
+        .version('1.0.0');
+    // run 命令带有自己的选项
+    program
+        .command('run <image>')
+        .description('运行容器')
+        .option('-d, --detach', '后台运行')
+        .option('-p, --port <port>', '端口映射')
+        .option('--name <name>', '容器名称')
+        .action((image, options) => {
+        console.log('\n示例3: 执行 run 命令');
+        console.log('镜像:', image);
+        console.log('后台运行:', options.detach || false);
+        console.log('端口映射:', options.port || '未指定');
+        console.log('容器名称:', options.name || '自动生成');
+    });
+    // build 命令带有不同的选项
+    program
+        .command('build <path>')
+        .description('构建镜像')
+        .option('-t, --tag <tag>', '镜像标签')
+        .option('-f, --file <dockerfile>', 'Dockerfile 路径', 'Dockerfile')
+        .action((path, options) => {
+        console.log('\n示例3: 执行 build 命令');
+        console.log('构建路径:', path);
+        console.log('镜像标签:', options.tag || '未指定');
+        console.log('Dockerfile:', options.file);
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/02-命令系统.ts 3 run nginx -d -p 8080 --name my-nginx');
+}
+// #endregion
+// #region 示例4: 嵌套子命令
+function demoNestedSubcommands() {
+    const program = new commander_1.Command();
+    program
+        .name('cloud-cli')
+        .description('云服务命令行工具')
+        .version('1.0.0');
+    // 创建 database 命令组
+    const database = program
+        .command('database')
+        .alias('db')
+        .description('数据库管理命令');
+    // database 的子命令
+    database
+        .command('create <name>')
+        .description('创建数据库')
+        .option('--type <type>', '数据库类型', 'mysql')
+        .action((name, options) => {
+        console.log('\n示例4: 执行 database create 命令');
+        console.log('数据库名称:', name);
+        console.log('数据库类型:', options.type);
+    });
+    database
+        .command('delete <name>')
+        .description('删除数据库')
+        .option('-f, --force', '强制删除')
+        .action((name, options) => {
+        console.log('\n示例4: 执行 database delete 命令');
+        console.log('数据库名称:', name);
+        console.log('强制删除:', options.force || false);
+    });
+    // 创建 storage 命令组
+    const storage = program
+        .command('storage')
+        .description('存储管理命令');
+    storage
+        .command('upload <file>')
+        .description('上传文件')
+        .option('-b, --bucket <bucket>', '存储桶名称')
+        .action((file, options) => {
+        console.log('\n示例4: 执行 storage upload 命令');
+        console.log('文件:', file);
+        console.log('存储桶:', options.bucket || '默认');
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/02-命令系统.ts 4 db create mydb --type postgres');
+}
+// #endregion
+// #region 示例5: 默认命令和命令钩子
+function demoDefaultCommand() {
+    const program = new commander_1.Command();
+    program
+        .name('server-cli')
+        .description('服务器管理工具')
+        .version('1.0.0');
+    program
+        .command('start')
+        .description('启动服务器')
+        .option('-p, --port <port>', '端口号', '3000')
+        .action((options) => {
+        console.log('\n示例5: 启动服务器');
+        console.log('端口:', options.port);
+    });
+    program
+        .command('stop')
+        .description('停止服务器')
+        .action(() => {
+        console.log('\n示例5: 停止服务器');
+    });
+    // 设置默认命令
+    program
+        .command('status', { isDefault: true })
+        .description('查看服务器状态（默认命令）')
+        .action(() => {
+        console.log('\n示例5: 查看服务器状态');
+        console.log('服务器运行中...');
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 直接运行 ts-node src/demo/commander/02-命令系统.ts 5 将执行默认命令');
+}
+// #endregion
+// #region 示例6: 命令参数验证
+function demoArgumentValidation() {
+    const program = new commander_1.Command();
+    program
+        .name('user-manager')
+        .description('用户管理工具')
+        .version('1.0.0');
+    program
+        .command('create <username>')
+        .description('创建用户')
+        .option('-a, --age <age>', '年龄', (value) => {
+        const age = parseInt(value);
+        if (isNaN(age) || age < 0 || age > 150) {
+            throw new Error('年龄必须是 0-150 之间的数字');
+        }
+        return age;
+    })
+        .option('-e, --email <email>', '邮箱', (value) => {
+        if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)) {
+            throw new Error('邮箱格式不正确');
+        }
+        return value;
+    })
+        .action((username, options) => {
+        console.log('\n示例6: 创建用户');
+        console.log('用户名:', username);
+        console.log('年龄:', options.age || '未指定');
+        console.log('邮箱:', options.email || '未指定');
+    });
+    program.parse(process.argv);
+    console.log('\n提示: 尝试运行 ts-node src/demo/commander/02-命令系统.ts 6 create john -a 25 -e john@example.com');
+    console.log('或尝试错误输入: ts-node src/demo/commander/02-命令系统.ts 6 create john -a 200');
+}
+// #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);
+            demoBasicSubcommands();
+            break;
+        case '2':
+            process.argv.splice(2, 1);
+            demoCommandAliases();
+            break;
+        case '3':
+            process.argv.splice(2, 1);
+            demoCommandSpecificOptions();
+            break;
+        case '4':
+            process.argv.splice(2, 1);
+            demoNestedSubcommands();
+            break;
+        case '5':
+            process.argv.splice(2, 1);
+            demoDefaultCommand();
+            break;
+        case '6':
+            process.argv.splice(2, 1);
+            demoArgumentValidation();
+            break;
+        default:
+            console.log('\n请指定要运行的示例编号 (1-6)');
+            console.log('用法: ts-node src/demo/commander/02-命令系统.ts <示例编号> [命令] [选项]');
+            console.log('\n可用示例:');
+            console.log('  1 - 基本子命令');
+            console.log('  2 - 命令别名');
+            console.log('  3 - 命令特定选项');
+            console.log('  4 - 嵌套子命令');
+            console.log('  5 - 默认命令和命令钩子');
+            console.log('  6 - 命令参数验证');
+    }
+}