مشروع: أداة 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";

// parse عند الحدود: Number("abc") يرجع NaN بصمت، وNaN ينتشر في كل عملية
// جمع بعده — فيطبع sum قيمة NaN بدل أن يخبرك أين الخطأ. الفحص هنا يحوّل
// الإدخال الفاسد إلى خطأ صريح عند نقطة الدخول، قبل أن يلمس المنطق.
function parseNumber(value: string): number {
  const parsed = Number(value);
  if (!Number.isFinite(parsed)) {
    throw new Error(`Invalid number: ${value}`);
  }
  return parsed;
}

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

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

Output:

جرّب runCommand("sum", ["2", "abc"]) — مع Number الخام كانت النتيجة NaN صامتة؛ مع parseNumber تحصل على خطأ يسمّي القيمة الفاسدة. هذا هو النمط نفسه في تمرين إعادة البناء 19-command-router.

تحدي — 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"]));