مشروع: التحقق من المدخلات

Input Validation Lab

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

مشروع: التحقق من المدخلات — Input Validation Lab

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

ابدأ بدالة is_positive_integer. هذه الدالة لا تطبع شيئاً. ترجع status فقط. إذا كانت القيمة أرقاماً فقط وأكبر من صفر، تنجح. ثم استخدمها داخل if. هذا يجعل الدالة قابلة لإعادة الاستخدام في أي سكربت يحتاج عدداً مثل عدد محاولات أو مهلة.

ثم فكر في القيم المسموحة. كثير من السكربتات تقبل mode مثل plan أو apply. لا تقبل أي نص. استخدم case وارجع فشلاً للقيم غير المعروفة. الرفض المبكر أفضل من تفسير خاطئ لاحق.

نموذج حل

script.sh

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

is_positive_integer() {
	local value="$1"
	[[ "$value" =~ ^[0-9]+$ ]] && ((value > 0))
}

mode="${1:-plan}"
retries="${2:-3}"

case "$mode" in
	plan|apply) ;;
	*) echo "mode غير مسموح: $mode" >&2; exit 1 ;;
esac

if ! is_positive_integer "$retries"; then
	echo "retries يجب أن يكون رقماً موجباً" >&2
	exit 1
fi

echo "mode=$mode retries=$retries"

Output:

لاحظ أن الرسائل دقيقة: خطأ mode مختلف عن خطأ retries. هذا يساعد المستخدم ويجعل التصحيح أسرع.

تحدي — Challenge

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

mode="plan"

is_allowed_mode() {
	# استخدم case — Use case
}

if is_allowed_mode "$mode"; then
	echo "valid"
else
	echo "invalid"
fi