حذف ملف أو مجلد في Python يتطلب معرفة نوع العنصر ومعنى العملية. ملف عادي يختلف عن مجلد فارغ أو مجلد يحتوي ملفات أو رابط رمزي. في المثال السابق كان استدعاء rmtree ثم remove على المسار نفسه غير صحيح، وقد يؤدي أول استدعاء إلى حذف نهائي قبل فهم النتيجة. سنستبدله بمسار يبدأ بالمعاينة ولا ينفذ حذفًا دائمًا، ثم ينقل العنصر المحدد إلى سلة النظام عند طلب –trash.
أوامر التجهيز والتشغيل
python -m pip install Send2Trash
python trash_path.py demo-files demo-files/old.txt
# Move the reviewed target to Trash:
python trash_path.py demo-files demo-files/old.txt --trashالفرق بين unlink وrmdir وrmtree
تستخدم Path.unlink أو os.remove لإزالة اسم ملف، ولا تستخدمهما لحذف مجلد عادي. تزيل Path.rmdir مجلدًا فارغًا فقط، بينما shutil.rmtree تزيل شجرة مجلدات بمحتوياتها وقد لا يمكن استعادتها عبر سلة النظام. لا تجمع الأوامر الثلاثة في سلسلة تحاول كل الأنواع حتى ينجح أحدها؛ حدد النوع أولًا وعالج الخطأ المتوقع. السكربت الكامل أدناه لا يستخدم rmtree ولا يرجع إلى حذف دائم إذا فشل نقل السلة.
تحديد مجلد عمل وحدود المسار
يمرر الأمر مجلد عمل مخصصًا ثم مسار الهدف. تتحقق checked_target أن الأب الحقيقي للهدف داخل ذلك المجلد وترفض اختيار جذر نظام الملفات أو حذف مجلد العمل نفسه. هذا يقلل أخطاء كتابة مسار واسع أو الخروج عبر رابط في المجلد الأب. اختر مجلد تجربة صغيرًا، ولا تمرر القرص أو مجلد المنزل لمجرد أنه يحتوي كل ملفاتك. المسارات النسبية تفسر من مجلد تشغيل الأمر، لذلك راجع المسار الكامل المطبوع قبل التطبيق.
الكود: trash_path.py
import argparse
import os
from pathlib import Path
def checked_target(root_path, target_path):
root = Path(root_path).resolve(strict=True)
if not root.is_dir() or root == Path(root.anchor):
raise ValueError("Choose a dedicated non-root working folder")
target = Path(os.path.abspath(target_path))
try:
target.parent.resolve(strict=True).relative_to(root)
except ValueError:
raise ValueError("Target must be inside the chosen working folder")
if target == root or not (target.exists() or target.is_symlink()):
raise ValueError("Target is missing or is the working folder itself")
if not (target.is_file() or target.is_dir() or target.is_symlink()):
raise ValueError("Only regular files, folders or symbolic links are supported")
return target
def process(root_path, target_path, execute=False):
target = checked_target(root_path, target_path)
kind = "symbolic link" if target.is_symlink() else "folder" if target.is_dir() else "file"
print("Target:", target, "Type:", kind)
if not execute:
print("Preview only; nothing removed")
return target
from send2trash import send2trash
send2trash(str(target)) # No fallback to permanent deletion.
print("Moved to system Trash; check recovery availability on your storage")
return target
if __name__ == "__main__":
parser = argparse.ArgumentParser()
parser.add_argument("root")
parser.add_argument("target")
parser.add_argument("--trash", action="store_true")
args = parser.parse_args()
process(args.root, args.target, execute=args.trash)
الرابط الرمزي لا يساوي محتوى هدفه
نتجنب resolve على العنصر النهائي كي لا يتحول اختيار رابط رمزي إلى اختيار الملف الذي يشير إليه. تفحص الدالة الروابط بما فيها الرابط المكسور، ويُنقل اسم الرابط المحدد بدل اتباعه إلى مكان آخر. أما المسار الأب فيفحص بعد حل الروابط لمنع الخروج من نطاق مجلد العمل. لا تختبر هذا السلوك على ملفات مهمة؛ جهز رابطًا تجريبيًا وراجع ما بقي في موقعه قبل أي استخدام أوسع.
المعاينة والنقل إلى السلة
احفظ الملف باسم trash_path.py خارج بيانات التجربة وثبت Send2Trash في البيئة نفسها. شغله دون –trash لترى المسار والنوع فقط؛ هذا الوضع لا يستورد دالة النقل ولا يزيل شيئًا. بعد المراجعة أضف الخيار ليستخدم سلة المهملات المتاحة على النظام. قد تفشل العملية في وحدة شبكة أو وسيط لا يتيح سلة مناسبة، ويجب عرض الفشل بدل افتراض نجاح الاستعادة. سلة المهملات ليست بديلًا عن نسخة احتياطية مستقلة.
الأخطاء التي ينبغي توقعها
FileNotFoundError قد يعني أن المسار تغير أو أن أحد المجلدات الأب غير موجود. PermissionError يتطلب مراجعة الصلاحيات أو إغلاق التطبيق الذي يستخدم الملف، وليس تشغيل السكربت بصلاحيات أعلى مباشرة. تغير الملفات بالتزامن قد يجعل الفحص الأولي قديمًا، لذلك أوقف التعديل على المجلد أثناء العملية ولا تعتبر هذا المثال حماية كاملة من ظروف السباق. اطبع اسم الهدف المحدد ولا تنفذ إزالة جماعية باستخدام نجمة أو بحث متكرر دون معاينة مستقلة.
اختبار واضح والرجوع عند الحاجة
جهز ملفًا ومجلدًا فارغًا وآخر يحتوي ملفًا داخل demo-files، وجرب المعاينة على كل منها. اختبر رفض مسار خارج المجلد ورفض مجلد العمل ذاته. الاختبارات هنا تستخدم بديلًا وهميًا للنقل ولا تمس سلة المستخدم. إذا نفذت نقلًا حقيقيًا على جهازك، افتح سلة النظام وتأكد أن العنصر متاح وأن الاستعادة تعمل على نوع التخزين المستخدم. لا تفرغ السلة كجزء من برنامج تعليمي للتنظيف.






