مشروع: وضع dry-run

Dry Run Lab

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

مشروع: وضع dry-run — Dry Run Lab

في هذا المشروع ستبني نمطاً ستستخدمه كثيراً: دالة run_cmd تطبع الأمر إذا كان dry_run=true، وتنفذه إذا كان false. هذه الفكرة تجعل السكربتات التشغيلية أكثر أماناً لأن المستخدم يستطيع مراجعة الخطة قبل تغيير النظام.

لا تجعل dry-run يطبع نصاً مختلفاً تماماً عن التنفيذ الحقيقي. الأفضل أن يمر كل شيء عبر دالة واحدة حتى ترى نفس الأوامر التي ستنفذ. في المشاريع الحساسة، يمكن أن تجعل الوضع الافتراضي dry-run، ولا يتم التنفيذ إلا بخيار صريح مثل --apply.

نموذج حل

script.sh

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

dry_run="${DRY_RUN:-true}"

run_cmd() {
	if [[ "$dry_run" == "true" ]]; then
		printf 'DRY-RUN:'
		printf ' %q' "$@"
		printf '\n'
	else
		"$@"
	fi
}

run_cmd mkdir -p "public"
run_cmd echo "build complete"

Output:

استخدام %q يطبع الأمر بطريقة توضّح الاقتباس. لا تعتمد عليه كواجهة مستخدم جميلة دائماً، لكنه مفيد للمراجعة التقنية.

تطبيق عملي — dry-run للأرشفة

أبرز حالة استخدام لهذا النمط هي الأرشفة. السكربت التالي يطبع ما سيفعله بشكل افتراضي، ويُنفّذ tar الحقيقي فقط عند --apply:

script.sh

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

source="${1:-public}"
archive="backups/$(basename "$source")-$(date +%Y%m%d).tar.gz"

if [[ "${2:-}" == "--apply" ]]; then
  mkdir -p backups
  tar -czf "$archive" -C "$(dirname "$source")" "$(basename "$source")"
  echo "تم: $source → $archive"
else
  echo "Would archive: tar -czf \"$archive\" -C \"$(dirname "$source")\" \"$(basename "$source")\""
  echo "أعد التشغيل مع --apply للتنفيذ."
fi

Output:

الوضع الافتراضي dry-run يمنع أي تغيير غير مقصود. الخيار --apply هو “المفتاح الصريح” الذي يُحوّل الخطة إلى تنفيذ.

قرار التصميم

في بيئات الإنتاج، اجعل التنفيذ الحقيقي يحتاج موافقة أو خياراً واضحاً. لا تجعل خطأ إملائياً يحول الخطة إلى تنفيذ.

تحدي — Challenge

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

dry_run=true
command="deploy"

# اطبع الخطة — Print the plan