قالب سكربت شل

قالب Bash حديث مع تنسيق مخرجات ملون ووظائف مساعدة لإنشاء أدوات سطر أوامر احترافية.

الميزات

• 🎨 مخرجات ملونة: أنظمة ألوان ووظائف تنسيق محددة مسبقًا
• 📝 رسائل موحدة: تنسيقات رسائل متسقة للمعلومات والنجاح والتحذيرات والأخطاء
• 🔧 وظائف مساعدة: وظائف جاهزة للاستخدام لعمليات سكربت شل الشائعة
• 📦 تصميم معياري: ملف مكتبة منفصل لإعادة الاستخدام بسهولة عبر المشاريع
• ⚡ إعداد سهل: آلية استيراد بسيطة للاستخدام الفوري

بداية سريعة

1. استنسخ أو حمّل هذا القالب
2. اجعل السكربت الخاص بك قابلاً للتنفيذ:
   root@kitploit:~

   chmod +x script.sh
   

3. شغّل السكربت النموذجي:
   root@kitploit:~

   ./script.sh
   

الاستخدام

هيكل القالب الأساسي

#!/bin/bash

LIB="lib"
source $LIB/format.sh

section "Your Script Section"
info "Information message"
ok "Success message" 
warn "Warning message"
error "Error message"

الوظائف المتاحة

أنواع الرسائل

• info "message" - يعرض رسائل معلوماتية ببادئة سماوية [i]
• ok "message" - يعرض رسائل نجاح ببادئة خضراء [+]
• warn "message" - يعرض رسائل تحذير ببادئة صفراء [!]
• error "message" - يعرض رسائل خطأ ببادئة حمراء [-] (يُرسل إلى stderr)

وظائف تفاعلية

• prompt "question" - يعرض موجهًا ببادئة أرجوانية [?] وينتظر إدخال المستخدم
• section "title" - ينشئ رأس قسم منسق

تنسيق النص

• bold "text" - يعرض النص بتنسيق عريض

ثوابت الألوان

ثوابت الألوان التالية متاحة للتنسيق المخصص:

RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
MAGENTA='\033[0;35m'
CYAN='\033[0;36m'
WHITE='\033[1;37m'
BOLD='\033[1m'
UNDERLINE='\033[4m'
RESET='\033[0m'

مثال على المخرجات

عند تشغيل السكربت النموذجي، سترى:

=== Start ===
[i] Running exploit setup...
[+] Everything is ready
[!] This might break your system
[-] Something failed
[?] Continue? [y/N]:

هيكل الملفات

shell_template/
├── script.sh          # Example script demonstrating usage
├── lib/
│   └── format.sh       # Core formatting library
├── LICENSE             # MIT License
└── README.md          # This file

التخصيص

إضافة أنواع رسائل جديدة

يمكنك توسيع المكتبة بإضافة أنواع رسائل جديدة في lib/format.sh:

DEBUG="${BLUE}[D]${RESET}"
debug() { echo -e "${DEBUG} $*"; }

ألوان مخصصة

حدد أنظمة ألوان خاصة بك عن طريق تعديل ثوابت الألوان أو إنشاء ثوابت جديدة:

PURPLE='\033[0;35m'
CUSTOM_PREFIX="${PURPLE}[*]${RESET}"
custom() { echo -e "${CUSTOM_PREFIX} $*"; }

أفضل الممارسات

1. استورد المكتبة دائمًا: أضف source $LIB/format.sh في بداية سكربتاتك
2. استخدم أنواع الرسائل المناسبة: اختر الوظيفة الصحيحة حسب السياق (info, ok, warn, error)
3. نظم باستخدام الأقسام: استخدم section لتنظيم مخرجات السكربت
4. تعامل مع الأخطاء بشكل صحيح: استخدم error للرسائل الخطأ وأعد توجيهها إلى stderr
5. اجعل السكربتات قابلة للتنفيذ: لا تنسَ chmod +x لسكربتاتك

المساهمة

لا تتردد في تقديم المشكلات، وعمل fork للمستودع، وإنشاء طلبات سحب لأي تحسينات.

الترخيص

هذا المشروع مرخص بموجب رخصة MIT - انظر ملف LICENSE للتفاصيل.

المؤلف

أنشأه Christoph Huy