تطبيق: هيكل main

Main Function Walkthrough

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

تطبيق: هيكل main — Main Function Walkthrough

في السكربتات الصغيرة جداً، يمكنك كتابة الأوامر من أعلى إلى أسفل. لكن عندما يظهر لديك أكثر من دالة، يصبح من الأفضل أن تجعل نقطة الدخول واضحة: main "$@" في آخر الملف. هذا النمط مألوف في لغات كثيرة، ويجعل القارئ يعرف أين يبدأ التنفيذ الفعلي.

الهيكل المقترح: إعدادات الأمان في الأعلى، ثوابت إن وجدت، دوال مساعدة، ثم دالة main، وفي النهاية main "$@". لا تضع تنفيذات عشوائية بين الدوال. هذا يحافظ على قابلية القراءة، ويجعل إعادة استخدام الدوال أسهل.

داخل main تقرأ المعاملات، تتحقق منها، ثم تستدعي الدوال. إذا فشل شيء، اطبع رسالة واخرج. لا تجعل الدوال كلها تعتمد على متغيرات عامة؛ مرر القيم قدر الإمكان.

سكربت منظم

script.sh

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

usage() {
	echo "Usage: report.sh NAME" >&2
}

print_report() {
	local name="$1"
	echo "تقرير: $name"
	echo "الحالة: جاهز"
}

main() {
	if (($# != 1)); then
		usage
		return 1
	fi

	print_report "$1"
}

# شغّل main فقط عندما يُنفّذ الملف مباشرة، لا عند sourcing — Run main only when executed, not when sourced
if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
	main "$@"
fi

Output:

لاحظ أن main تستخدم return 1 بدل exit 1. هذا مع حارس BASH_SOURCE يجعل السكربت قابلاً لـsource-ing من اختبار خارجي (مثل ملف *.bats) دون أن يتم استدعاء main تلقائياً. عند تشغيل الملف مباشرة (./report.sh Aziz) يدخل الشرط ويُستدعى main؛ عند source ./report.sh تبقى الدوال متاحة لكن main لا يعمل.

لماذا هذا مهم؟

لأن السكربتات التشغيلية تعيش أكثر مما تتوقع. ما يبدأ بخمسة أسطر قد يصبح خمسين. إذا بدأت بهيكل واضح، يكبر السكربت بدون أن يتحول إلى فوضى.

تحدي — Challenge

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

main() {
	# اطبع main: <القيمة> — Print main: <value>
	echo "main: $1"
}

# أضف حارس BASH_SOURCE هنا — Add BASH_SOURCE guard here