مشروع: أداة CLI

CLI Tool Lab

مشروع ~24 دقيقة

مشروع: أداة CLI — CLI Tool Lab

سنصمم command router صغيراً. لدينا أوامر greet وsum. بدلاً من switch على string عشوائي في كل مكان، نعرف CommandName ونكتب دالة runCommand. هذا النمط يشبه أدوات CLI الحقيقية، لكنه صغير بما يكفي للتعلم.

الفكرة المهمة: parse عند الحدود، ثم نفذ منطقاً typed. لا تمرر process.argv الخام إلى كل دالة.

نموذج أداة

index.ts

type CommandName = "greet" | "sum";

function runCommand(command: CommandName, args: string[]): string {
  switch (command) {
    case "greet":
      return `Hello ${args[0] ?? "friend"}`;
    case "sum":
      return String(args.map(Number).reduce((total, value) => total + value, 0));
  }
}

console.log(runCommand("greet", ["Sara"]));
console.log(runCommand("sum", ["2", "3"]));

Output:

في production، تحتاج تحققاً أفضل من Number, لكن المثال يثبت الهيكل.

تحدي — Challenge

type Command = "greet";

function run(command: Command, args: string[]): string {
  switch (command) {
    case "greet":
      /* TODO */
      return ""; // أرجع Hello <name> — Return Hello <name>
    default:
      return "";
  }
}

console.log(run("greet", ["Sara"]));