معاملات CLI

CLI Arguments

مفهوم ~18 دقيقة

معاملات CLI — CLI Arguments

في Node، معاملات CLI تأتي عادة من process.argv كنصوص. TypeScript لا يعرف معناها وحده. لذلك اكتب parser صغيراً يحول النصوص إلى config typed. لا تجعل بقية البرنامج تتعامل مع array خام من النصوص.

ابدأ ببساطة: اقرأ الأمر الأول، تحقق أنه ضمن قائمة مسموحة، ثم ارجع object. إذا أصبحت الخيارات كثيرة، استخدم مكتبة CLI، لكن الفكرة نفسها: boundary parsing ثم typed core.

مثال parser صغير

index.ts

type Command = "help" | "status";

const COMMANDS: Command[] = ["help", "status"];

function parseCommand(input: string): Command {
  const cmd = COMMANDS.find((c) => c === input);
  if (!cmd) throw new Error(`unknown command: ${input}`);
  return cmd;
}

console.log(parseCommand("status"));

Output:

الدالة ترجع Command وليس string عاماً. إذا أُعطيت أمراً غير معروف تُلقي خطأ — أفضل من إرجاع قيمة صامتة تُخفي مشكلة.

لا تثق بالمدخلات

حتى لو كان CLI داخلياً، تحقق. الخطأ الإملائي يجب أن يُلقي خطأً واضحاً، لا سلوكاً غريباً صامتاً.

تحدي — Challenge

type Command = "help" | "status";

const COMMANDS: Command[] = ["help", "status"];

function parse(args: string[]): Command {
  /* TODO */
  return "help"; // أرجع command آمن — Return safe command
}

console.log(parse(["status"]));