موجه أوامر فرعية

Command Router

تطبيق ~20 دقيقة

موجه أوامر فرعية — Command Router

عندما يكبر السكربت، تصبح الأوامر الفرعية أوضح من مجموعة خيارات متداخلة. مثال: tool status, tool check, tool plan. كل أمر له دالة مستقلة، وcase يوجه التنفيذ. هذا النمط يجعل السكربت قريباً من أدوات CLI الحقيقية دون تعقيد كبير.

ابدأ بأمر help، ثم أضف الأوامر واحدة واحدة. لا تجعل الأمر الافتراضي ينفذ شيئاً خطيراً. إذا لم يعرف المستخدم الأمر، اطبع help واخرج بخطأ.

مثال موجه

script.sh

#!/usr/bin/env bash
set -euo pipefail

show_help() {
	echo "Commands: help, status, plan"
}

status() {
	echo "status: ready"
}

plan() {
	echo "plan: no changes will be applied"
}

command_name="${1:-help}"

case "$command_name" in
	help) show_help ;;
	status) status ;;
	plan) plan ;;
	*) echo "unknown command: $command_name" >&2; show_help; exit 1 ;;
esac

Output:

لاحظ أن الأوامر الخطيرة غير موجودة. في درس الإنتاج، نفضل أن تبدأ الأدوات بالقراءة والتخطيط.

ملاحظة تسمية: تجنب تسمية دوالك بأسماء مدمجة مثل command أو type أو read. status ليست كلمة محجوزة في Bash، لكن في أدوات أكبر قد تتعارض مع متغير أو دالة أخرى تحمل نفس الاسم. مبدأ جيد: أضف بادئة تعبّر عن السكربت مثل tool_status() أو run_status() لتجنب التعارض في السكربتات الطويلة.

تحدي — Challenge

#!/usr/bin/env bash
set -euo pipefail

status() {
	echo "status: ok"
}

command_name="status"

# استخدم case — Use case